Difference between revisions of "Koha-Library-Management-System/C2/Koha-installation-on-Linux-16.04/English-timed"
PoojaMoolya (Talk | contribs) (Created page with " {| border=1 || '''Time''' || '''Narration''' |- || 00:01 || Welcome to this spoken tutorial on '''Installation '''of '''Koha '''on '''Ubuntu Linux OS'''. |- || 00:09 || In...") |
Nancyvarkey (Talk | contribs) m (Protected "Koha-Library-Management-System/C2/Koha-installation-on-Linux-16.04/English-timed" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))) |
||
(6 intermediate revisions by 3 users not shown) | |||
Line 6: | Line 6: | ||
|- | |- | ||
|| 00:01 | || 00:01 | ||
− | || Welcome to this spoken tutorial on '''Installation '''of '''Koha '''on '''Ubuntu Linux OS'''. | + | || Welcome to this '''spoken tutorial''' on '''Installation '''of '''Koha '''on '''Ubuntu Linux OS'''. |
|- | |- | ||
|| 00:09 | || 00:09 | ||
− | || In this tutorial, we will learn to | + | || In this tutorial, we will learn to install '''Koha Library Management System''' on '''Ubuntu Linux OS 16.04''' and cross-verify the installation. |
|- | |- | ||
|| 00:24 | || 00:24 | ||
− | || This tutorial is recorded using '''Ubuntu Linux''' OS 16.04 | + | || This tutorial is recorded using: '''Ubuntu Linux''' OS 16.04, |
− | '''Koha''' version 16.05 | + | '''Koha''' version 16.05, |
|- | |- | ||
|| 00:35 | || 00:35 | ||
− | || '''gedit text editor''' and '''Firefox web browser''' | + | || '''gedit text editor''' and '''Firefox web browser'''. |
|- | |- | ||
− | ||00: | + | ||00:41 |
− | || Before you start, please ensure that your machine has- '''Ubuntu Linux OS 16.04''' | + | || Before you start, please ensure that your machine has- '''Ubuntu Linux OS 16.04''', |
|- | |- | ||
||00:50 | ||00:50 | ||
− | || | + | || any '''text editor''', |
− | + | either '''Firefox''' or''' Google Chrome web browser'''. | |
|- | |- | ||
|| 00:57 | || 00:57 | ||
− | || The minimum hardware requirements are- i3 processor or above | + | || The minimum '''hardware''' requirements are- '''i3 processor''' or above, |
|- | |- | ||
|| 01:05 | || 01:05 | ||
− | || 500GB hard disk or more | + | || '''500GB hard disk''' or more, |
|- | |- | ||
||01:09 | ||01:09 | ||
− | || Minimum 4GB RAM and Network facility | + | || Minimum '''4GB RAM''' and '''Network''' facility. |
|- | |- | ||
− | || 01:15 | + | ||01:15 |
− | || | + | || The '''command'''s used in this tutorial are available in the '''Code Files''' link below the '''player'''. |
|- | |- | ||
− | || 01: | + | ||01:22 |
− | || | + | || I have opened this file in '''gedit text editor''' on my machine. |
+ | |||
+ | And, I will use the same file to copy paste the '''commands''' during the demonstration. | ||
|- | |- | ||
− | || 01: | + | || 01:33 |
+ | || Let’s begin. | ||
+ | |||
+ | Open the '''terminal '''by pressing '''Ctrl+Alt+T''' keys simultaneously on the keyboard. | ||
+ | |||
+ | |- | ||
+ | || 01:43 | ||
|| We have to first of all ensure that our '''Ubuntu Linux '''installation is up-to-date. | || We have to first of all ensure that our '''Ubuntu Linux '''installation is up-to-date. | ||
|- | |- | ||
− | ||01: | + | ||01:50 |
− | || For that | + | || For that, '''copy''' this '''command''' from the '''Code file''' and '''paste''' it in the '''terminal'''. |
+ | |||
+ | And, press '''Enter.''' | ||
|- | |- | ||
− | || 01: | + | || 01:59 |
− | || | + | || From now on, type the '''System password '''whenever prompted during this installation. |
+ | |||
+ | And, press '''Enter'''. | ||
|- | |- | ||
− | || | + | ||02:10 |
− | || | + | || This '''command''' will create a file named '''koha.list''' and update the '''package repository.''' |
|- | |- | ||
− | || | + | ||02:19 |
|| Please note: '''Koha 16.05''' was the stable version at the time of creation of this tutorial. | || Please note: '''Koha 16.05''' was the stable version at the time of creation of this tutorial. | ||
|- | |- | ||
− | ||02: | + | || 02:28 |
− | || | + | || Copy this '''command''' from the '''Code file''' and '''paste''' it in the '''terminal'''. |
+ | |||
+ | And, press '''Enter.''' | ||
|- | |- | ||
− | || 02: | + | || 02:37 |
− | || Then | + | || Then, this will download '''gpg.asc file''' and update the '''signature key'''. |
|- | |- | ||
− | ||02: | + | ||02:47 |
− | || | + | || Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. |
+ | |||
+ | And, press '''Enter.''' | ||
|- | |- | ||
− | || 02: | + | ||02:57 |
− | || Now, | + | || Now, copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. |
− | And press '''Enter.''' | + | And, press '''Enter.''' |
|- | |- | ||
− | || | + | ||03:07 |
|| This will update the new '''repositories'''. | || This will update the new '''repositories'''. | ||
|- | |- | ||
− | || | + | || 03:11 |
− | || Now type | + | || Now, type '''sudo apt-get install koha-common''' and press '''Enter.''' |
|- | |- | ||
− | || 03: | + | || 03:22 |
− | || Press '''Y '''when asked if you want to continue and | + | || Press '''Y '''when asked if you want to continue and press '''Enter'''. |
|- | |- | ||
− | || 03: | + | || 03:30 |
|| This will install '''Koha''' on your system. | || This will install '''Koha''' on your system. | ||
− | + | Wait for the installation to complete. This will take some time. | |
− | + | ||
− | + | ||
|- | |- | ||
− | || 03: | + | || 03:40 |
− | || Now we have to open the '''conf file '''in a '''text editor '''to change the | + | || Now, we have to open the '''conf file '''in a '''text editor '''to change the port number for '''Koha'''. |
|- | |- | ||
− | || 03: | + | || 03:49 |
|| I will use '''gedit text editor'''. You can use any '''text editor '''of your choice. | || I will use '''gedit text editor'''. You can use any '''text editor '''of your choice. | ||
|- | |- | ||
− | || 03: | + | || 03:57 |
− | || | + | || Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. |
− | + | And, press '''Enter.''' | |
|- | |- | ||
− | || | + | || 04:06 |
|| The file opens in the '''text editor'''. | || The file opens in the '''text editor'''. | ||
|- | |- | ||
− | || | + | || 04:10 |
− | || Locate the line that says '''INTRAPORT = 80''' | + | || Locate the line that says '''INTRAPORT = 80'''. |
|- | |- | ||
− | || 04: | + | || 04:16 |
− | || Change '''80''' to '''8080'''. | + | || Change '''80''' to '''8080'''. This will change the '''port''' number to '''8080'''. |
|- | |- | ||
− | || 04: | + | || 04:26 |
− | || Then save and close the file. | + | || Then '''save''' and close the file. |
|- | |- | ||
− | || 04: | + | || 04:30 |
|| Come back to the '''terminal'''. | || Come back to the '''terminal'''. | ||
|- | |- | ||
− | || 04: | + | || 04:33 |
− | || Now we have to set up the '''database'''. | + | || Now, we have to set up the '''database'''. |
|- | |- | ||
− | || 04: | + | ||04:38 |
− | || | + | || Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. Press '''Enter.''' |
|- | |- | ||
− | || 04: | + | ||04:47 |
− | || | + | ||Press''' Y '''when asked if you want to continue and press '''Enter'''. |
|- | |- | ||
− | ||04: | + | || 04:57 |
− | || | + | || Next, set the '''password''' for''' root user''' as '''admin123 '''for the '''database'''. |
|- | |- | ||
− | || | + | ||05:05 |
− | || | + | ||You could give a different '''password''' if you wish. |
|- | |- | ||
− | ||05: | + | ||05:10 |
− | || | + | ||Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. Press '''Enter.''' |
|- | |- | ||
− | ||05: | + | || 05:19 |
− | || | + | || Next, copy these two '''commands''' one by one, paste them on the '''terminal''' and press '''Enter'''. |
|- | |- | ||
− | || 05: | + | ||05:26 |
− | || | + | ||'''sudo a2enmod rewrite ''' |
|- | |- | ||
− | ||05: | + | ||05:35 |
− | || | + | ||'''sudo a2enmod cgi ''' |
|- | |- | ||
− | || 05: | + | ||05:43 |
− | || | + | ||This will enable the '''modules''' of '''Koha'''. |
− | + | |- | |
+ | || 05:48 | ||
+ | || Then type: '''sudo service apache2 restart''' | ||
|- | |- | ||
− | || 05: | + | ||05:55 |
− | || | + | ||This will restart '''apache services. ''' Then press '''Enter'''. |
|- | |- | ||
− | || | + | || 06:02 |
− | || | + | || To create a '''Koha instance''' named '''library'''- |
− | + | copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. | |
+ | |||
+ | And press '''Enter.''' | ||
|- | |- | ||
− | ||06: | + | || 06:16 |
− | || | + | || Next, we have to tell '''Apache server '''that we are using '''port 8080'''. |
|- | |- | ||
− | || 06: | + | ||06:24 |
− | || | + | ||For that, we have to open the '''ports.conf''' file in a '''text editor'''. |
|- | |- | ||
− | || 06: | + | ||06:31 |
− | || | + | ||Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. |
+ | |||
+ | And press '''Enter.''' | ||
|- | |- | ||
− | || 06: | + | || 06:40 |
− | || | + | || In the '''ports.conf''' file, search for the line '''Listen 80'''. |
|- | |- | ||
− | || 06: | + | ||06:47 |
− | || | + | ||Next to that line, add '''Listen 8080'''. |
|- | |- | ||
− | || 06: | + | || 06:53 |
− | || | + | || Then '''save''' and close the file. |
|- | |- | ||
− | || 06: | + | || 06:57 |
+ | || Then restart '''apache services.''' | ||
+ | |||
+ | Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. | ||
+ | |||
+ | Press '''Enter.''' | ||
+ | |||
+ | |- | ||
+ | || 07:10 | ||
+ | || Next, copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. | ||
+ | |||
+ | And press '''Enter.''' | ||
+ | |||
+ | |- | ||
+ | ||07:20 | ||
||This is to disable the '''000-default''' site. | ||This is to disable the '''000-default''' site. | ||
|- | |- | ||
− | || 07: | + | || 07:27 |
− | || The message confirms that it is | + | || The message confirms that it is disabled. |
+ | |||
+ | Let's move on. | ||
|- | |- | ||
− | || 07: | + | || 07:34 |
− | || | + | || Copy these two '''commands''' one by one, paste them on the '''terminal''' and press '''Enter'''. |
|- | |- | ||
− | ||07: | + | ||07:41 |
− | || | + | ||'''sudo a2enmod deflate '''and press '''Enter'''. |
|- | |- | ||
− | ||07: | + | ||07:52 |
− | || | + | ||'''sudo a2ensite library '''and press '''Enter'''. |
|- | |- | ||
− | || | + | ||08:03 |
− | || The message on the '''terminal''' confirms that the''' site library''' is enabled. | + | ||The message on the '''terminal''' confirms that the''' site library''' is enabled. |
|- | |- | ||
− | || | + | || 08:10 |
− | || | + | || Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. |
+ | |||
+ | And press '''Enter.''' | ||
|- | |- | ||
− | || | + | ||08:20 |
− | || Then type '''sudo su '''and press '''Enter'''. | + | || Then type '''sudo su '''and press''' Enter'''. |
|- | |- | ||
− | || | + | ||08:26 |
||We are now in the '''superuser''' that is '''root user''' mode. | ||We are now in the '''superuser''' that is '''root user''' mode. | ||
|- | |- | ||
− | || | + | || 08:33 |
− | || | + | || Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. Press '''Enter.''' |
− | + | ||
|- | |- | ||
− | || 08: | + | ||08:41 |
− | || Type the | + | || Type the password when prompted, '''admin123 '''and press '''Enter'''. |
|- | |- | ||
− | ||08: | + | ||08:49 |
|| We are now inside our '''MariaDB prompt'''. | || We are now inside our '''MariaDB prompt'''. | ||
|- | |- | ||
− | ||08: | + | || 08:54 |
− | || At the '''MariaDB prompt''', type '''use mysql semicolon ''' | + | || At the '''MariaDB prompt''', type: '''use mysql semicolon '''and press '''Enter'''. |
|- | |- | ||
− | || | + | ||09:03 |
− | || This is to tell '''MariaDB''' to use '''mysql database.''' | + | ||This is to tell '''MariaDB''' to use '''mysql database.''' |
− | + | ||
− | + | ||
|- | |- | ||
− | || | + | || 09:09 |
|| The message displayed on the '''terminal '''says '''Database changed.''' | || The message displayed on the '''terminal '''says '''Database changed.''' | ||
|- | |- | ||
− | || | + | || 09:15 |
|| Notice that the '''MariaDB prompt '''says '''mysql.''' | || Notice that the '''MariaDB prompt '''says '''mysql.''' | ||
|- | |- | ||
− | || | + | || 09:22 |
|| Now type the following command carefully as shown and press '''Enter'''. | || Now type the following command carefully as shown and press '''Enter'''. | ||
|- | |- | ||
− | || | + | ||09:30 |
|| This will set the '''password''' for the '''user koha_library''' as '''koha123'''. | || This will set the '''password''' for the '''user koha_library''' as '''koha123'''. | ||
|- | |- | ||
− | || 09: | + | || 09:39 |
|| We see a message on the '''terminal''' that says “'''Query OK'''”. | || We see a message on the '''terminal''' that says “'''Query OK'''”. | ||
|- | |- | ||
− | || 09: | + | || 09:45 |
− | || Next type '''flush privileges semicolon '''and press '''Enter'''. | + | || Next, type: '''flush privileges semicolon '''and press '''Enter'''. |
This will update the latest changes. | This will update the latest changes. | ||
|- | |- | ||
− | || 09: | + | || 09:58 |
|| Once again we see a message on the '''terminal''' that says “'''Query OK'''”. | || Once again we see a message on the '''terminal''' that says “'''Query OK'''”. | ||
|- | |- | ||
− | || | + | || 10:04 |
− | || Lastly, type '''quit semicolon''' and press '''Enter '''to exit from '''Mariadb'''. | + | || Lastly, type: '''quit semicolon''' and press '''Enter '''to exit from '''Mariadb'''. |
|- | |- | ||
− | || | + | || 10:13 |
− | || We are now back in the '''root user | + | || We are now back in the '''root user''' prompt. |
|- | |- | ||
− | || | + | || 10:17 |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
|| We will now open the '''koha-conf.xml '''file in a '''text editor.''' | || We will now open the '''koha-conf.xml '''file in a '''text editor.''' | ||
− | |||
− | |||
|- | |- | ||
− | ||10: | + | ||10:25 |
− | || | + | ||I will be doing so using '''gedit text editor.''' |
|- | |- | ||
− | || 10: | + | || 10:30 |
− | || In this file, search for the '''keyword ' | + | || In this file, search for the '''keyword 'mysql''''. |
|- | |- | ||
− | ||10: | + | || 10:37 |
− | || Scroll down and | + | || Scroll down and locate this line. |
− | + | ||
− | + | ||
|- | |- | ||
|| 10:41 | || 10:41 | ||
− | || Replace the | + | || Replace the alphanumeric value with ''''koha123''''. |
|- | |- | ||
− | || 10:47 | + | ||10:47 |
||Recall that this is the '''password''' we had set for our '''database''' earlier via the '''terminal'''. | ||Recall that this is the '''password''' we had set for our '''database''' earlier via the '''terminal'''. | ||
Line 360: | Line 381: | ||
|- | |- | ||
|| 10:59 | || 10:59 | ||
− | || Now open any '''web browser.''' | + | || Now open any '''web browser.''' I will be opening '''Firefox web browser.''' |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
|- | |- | ||
− | || 11: | + | ||11:06 |
− | || In the '''address bar''', type '''127.0. | + | || In the '''address bar''', type: '''127.0.0.1:8080''' and press '''Enter'''. |
|- | |- | ||
Line 380: | Line 397: | ||
|- | |- | ||
||11:31 | ||11:31 | ||
− | || I will type '''username''' as '''koha_library''' and '''password''' as '''koha123'''. | + | ||I will type '''username''' as '''koha_library''' and '''password''' as '''koha123'''. |
|- | |- | ||
− | ||11: | + | ||11:42 |
− | || If you had given a different '''username''' and '''password''', then type that in. | + | ||If you had given a different '''username''' and '''password''', then type that in. |
|- | |- | ||
− | || 11: | + | || 11:48 |
|| Now click on the '''Login''' button at the bottom right. | || Now click on the '''Login''' button at the bottom right. | ||
|- | |- | ||
− | || 11: | + | || 11:53 |
|| We are in '''Step 1''' of '''Koha web installer'''. | || We are in '''Step 1''' of '''Koha web installer'''. | ||
|- | |- | ||
− | || 11: | + | || 11:58 |
|| In the '''language''' drop-down, select '''en '''for '''English, '''if it’s not already selected, by default. | || In the '''language''' drop-down, select '''en '''for '''English, '''if it’s not already selected, by default. | ||
|- | |- | ||
− | || 12: | + | || 12:06 |
|| Now click on the '''Next''' button at the bottom right. | || Now click on the '''Next''' button at the bottom right. | ||
|- | |- | ||
− | || 12: | + | || 12:10 |
|| The window now displays 2 messages. | || The window now displays 2 messages. | ||
− | + | The messages confirm that all '''Perl modules''' and all '''dependencies '''are installed. | |
− | + | ||
− | + | ||
|- | |- | ||
− | ||12: | + | || 12:21 |
|| Click on the '''Next''' button at the bottom right. | || Click on the '''Next''' button at the bottom right. | ||
|- | |- | ||
− | ||12: | + | || 12:25 |
|| We are now in '''Step 2 – Database settings''' | || We are now in '''Step 2 – Database settings''' | ||
|- | |- | ||
− | || 12: | + | || 12:30 |
− | || Notice here all the values are what we gave earlier. | + | || Notice here, all the values are what we gave earlier. |
|- | |- | ||
− | || 12: | + | || 12:36 |
|| Then click on the '''Next''' button at the bottom. | || Then click on the '''Next''' button at the bottom. | ||
|- | |- | ||
− | || 12: | + | || 12:40 |
|| On doing so, we see a message that says “'''Connection established'''”. | || On doing so, we see a message that says “'''Connection established'''”. | ||
|- | |- | ||
− | || 12: | + | || 12:46 |
|| This is followed by 2 more confirmation messages. | || This is followed by 2 more confirmation messages. | ||
|- | |- | ||
− | || 12: | + | || 12:51 |
|| Click on the '''Next''' button at the bottom. | || Click on the '''Next''' button at the bottom. | ||
|- | |- | ||
− | || 12: | + | || 12:54 |
|| We are brought to '''Step 3.''' | || We are brought to '''Step 3.''' | ||
|- | |- | ||
− | || 12: | + | || 12:57 |
|| Read what is displayed on the screen and then click on the '''Next '''button. | || Read what is displayed on the screen and then click on the '''Next '''button. | ||
|- | |- | ||
− | || 13: | + | || 13:03 |
|| Soon we will see a '''Success''' message on our screen. | || Soon we will see a '''Success''' message on our screen. | ||
− | + | This confirms that our '''database tables''' are created. | |
− | + | ||
− | + | ||
|- | |- | ||
− | || | + | || 13:13 |
|| Now click on the '''Next''' button at the bottom to continue. | || Now click on the '''Next''' button at the bottom to continue. | ||
|- | |- | ||
− | || 13: | + | || 13:18 |
− | || Immediately, we are brought to this screen. | + | || Immediately, we are brought to this '''screen'''. |
|- | |- | ||
Line 473: | Line 486: | ||
|- | |- | ||
− | || 13: | + | || 13:38 |
|| Then click on the '''Next''' button at the bottom. | || Then click on the '''Next''' button at the bottom. | ||
|- | |- | ||
− | || 13: | + | || 13:42 |
− | || | + | || In this screen, scroll-down to the section '''Mandatory.''' |
|- | |- | ||
− | ||13: | + | ||13:47 |
− | || Here, we see that the '''Default MARC21 | + | ||Here, we see that the '''Default MARC21 '''check-boxes are selected. |
|- | |- | ||
− | || 13: | + | || 13:54 |
− | || Under Optional section, select all the options as shown. | + | || Under '''Optional '''section, select all the options as shown. |
|- | |- | ||
− | ||14:01 | + | || 14:01 |
− | || As we scroll down, we see that under '''Other data''', all the | + | || As we scroll down, we see that under '''Other data''', all the check-boxes are already selected. |
|- | |- | ||
− | || 14: | + | || 14:09 |
|| Keep scrolling to the bottom of the page. | || Keep scrolling to the bottom of the page. | ||
|- | |- | ||
− | || 14: | + | || 14:13 |
|| There is one more '''Optional '''section below, which is very long. | || There is one more '''Optional '''section below, which is very long. | ||
|- | |- | ||
− | ||14: | + | ||14:18 |
|| Here, locate the option “'''Some basic currencies'''” and select it. | || Here, locate the option “'''Some basic currencies'''” and select it. | ||
|- | |- | ||
− | ||14: | + | || 14:24 |
|| After this, select the option “'''Useful patron attribute types'''”. | || After this, select the option “'''Useful patron attribute types'''”. | ||
|- | |- | ||
− | || 14: | + | || 14:30 |
|| Now go to the bottom of the page and click on the '''Import '''button. | || Now go to the bottom of the page and click on the '''Import '''button. | ||
|- | |- | ||
− | || 14: | + | || 14:36 |
|| This will enable all the selected functionalities in '''Koha'''. | || This will enable all the selected functionalities in '''Koha'''. | ||
|- | |- | ||
− | || 14: | + | || 14:41 |
− | || We are now brought to a new page. | + | || We are now brought to a new page. Scroll down this page and read all the text displayed on the screen. |
|- | |- | ||
− | || 14: | + | || 14:50 |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
|| We can see a success message “'''All done'''”. | || We can see a success message “'''All done'''”. | ||
|- | |- | ||
− | || 14: | + | || 14:54 |
|| Now, click on the '''Finish '''button. | || Now, click on the '''Finish '''button. | ||
|- | |- | ||
− | || | + | || 14:57 |
− | + | || We see the final message on our screen which confirms that our installation is successful. | |
− | + | ||
− | + | ||
− | + | ||
− | || We see the final message on our screen | + | |
|- | |- | ||
− | || 15: | + | ||15:04 |
|| We will now be moved to the '''Koha interface.''' | || We will now be moved to the '''Koha interface.''' | ||
|- | |- | ||
− | || 15: | + | || 15:08 |
|| Type the '''username '''as '''koha_library''' and '''password '''as '''koha123.''' | || Type the '''username '''as '''koha_library''' and '''password '''as '''koha123.''' | ||
|- | |- | ||
− | || 15: | + | || 15:16 |
|| Select '''My Library''' from the drop-down. | || Select '''My Library''' from the drop-down. | ||
|- | |- | ||
− | || 15: | + | ||15:20 |
− | || Then click on | + | || Then click on the '''Login''' button. |
|- | |- | ||
− | || 15: | + | || 15:23 |
|| We are brought to the '''Koha Administration page.''' | || We are brought to the '''Koha Administration page.''' | ||
|- | |- | ||
− | || 15: | + | ||15:27 |
− | || We can see various | + | || We can see various tabs on this page. |
|- | |- | ||
− | ||15: | + | ||15:31 |
− | || We will learn how to use many of these | + | ||We will learn how to use many of these later in this series. |
|- | |- | ||
− | || 15: | + | || 15:37 |
|| Now, click on '''No Library Set''' and select the '''Logout''' option. | || Now, click on '''No Library Set''' and select the '''Logout''' option. | ||
|- | |- | ||
− | || 15: | + | || 15:45 |
− | || This brings us to the end of this tutorial. | + | || This brings us to the end of this tutorial. Let us summarize. |
− | + | ||
− | Let us summarize. | + | |
|- | |- | ||
− | || 15: | + | || 15:50 |
− | || In this tutorial, we have learnt to | + | || In this tutorial, we have learnt to install '''Koha Library Management System''' on '''Ubuntu Linux OS 16.04''' and cross-verify the installation. |
|- | |- | ||
− | || 16: | + | || 16:03 |
− | || The video at the following link | + | || The video at the following link summarizes the '''Spoken Tutorial''' project. |
Please download and watch it. | Please download and watch it. | ||
|- | |- | ||
− | || 16: | + | || 16:12 |
− | || The '''Spoken Tutorial | + | || The '''Spoken Tutorial''' Project team: conducts workshops and gives certificates. |
For more details, please write to us. | For more details, please write to us. | ||
|- | |- | ||
− | ||16: | + | || 16:22 |
− | || | + | || Post your timed queries in this Forum. |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
|- | |- | ||
− | || 16: | + | || 16:26 |
− | ||'''Spoken Tutorial '''project is funded by '''NMEICT, MHRD, Government of India. | + | || '''Spoken Tutorial '''project is funded by '''NMEICT, MHRD,''' Government of India. |
More information on this mission is available at this link. | More information on this mission is available at this link. | ||
|- | |- | ||
− | || | + | || 16:39 |
|| The script has been contributed by Nancy and video by Praveen. | || The script has been contributed by Nancy and video by Praveen. | ||
− | This is Nancy from IIT Bombay signing off. | + | This is Nancy from '''IIT Bombay''', signing off. |
Thank you for joining. | Thank you for joining. | ||
|} | |} |
Latest revision as of 16:35, 21 February 2019
Time | Narration |
00:01 | Welcome to this spoken tutorial on Installation of Koha on Ubuntu Linux OS. |
00:09 | In this tutorial, we will learn to install Koha Library Management System on Ubuntu Linux OS 16.04 and cross-verify the installation. |
00:24 | This tutorial is recorded using: Ubuntu Linux OS 16.04,
Koha version 16.05, |
00:35 | gedit text editor and Firefox web browser. |
00:41 | Before you start, please ensure that your machine has- Ubuntu Linux OS 16.04, |
00:50 | any text editor,
either Firefox or Google Chrome web browser. |
00:57 | The minimum hardware requirements are- i3 processor or above, |
01:05 | 500GB hard disk or more, |
01:09 | Minimum 4GB RAM and Network facility. |
01:15 | The commands used in this tutorial are available in the Code Files link below the player. |
01:22 | I have opened this file in gedit text editor on my machine.
And, I will use the same file to copy paste the commands during the demonstration. |
01:33 | Let’s begin.
Open the terminal by pressing Ctrl+Alt+T keys simultaneously on the keyboard. |
01:43 | We have to first of all ensure that our Ubuntu Linux installation is up-to-date. |
01:50 | For that, copy this command from the Code file and paste it in the terminal.
And, press Enter. |
01:59 | From now on, type the System password whenever prompted during this installation.
And, press Enter. |
02:10 | This command will create a file named koha.list and update the package repository. |
02:19 | Please note: Koha 16.05 was the stable version at the time of creation of this tutorial. |
02:28 | Copy this command from the Code file and paste it in the terminal.
And, press Enter. |
02:37 | Then, this will download gpg.asc file and update the signature key. |
02:47 | Copy this command from the Code file and paste it in the terminal.
And, press Enter. |
02:57 | Now, copy this command from the Code file and paste it in the terminal.
And, press Enter. |
03:07 | This will update the new repositories. |
03:11 | Now, type sudo apt-get install koha-common and press Enter. |
03:22 | Press Y when asked if you want to continue and press Enter. |
03:30 | This will install Koha on your system.
Wait for the installation to complete. This will take some time. |
03:40 | Now, we have to open the conf file in a text editor to change the port number for Koha. |
03:49 | I will use gedit text editor. You can use any text editor of your choice. |
03:57 | Copy this command from the Code file and paste it in the terminal.
And, press Enter. |
04:06 | The file opens in the text editor. |
04:10 | Locate the line that says INTRAPORT = 80. |
04:16 | Change 80 to 8080. This will change the port number to 8080. |
04:26 | Then save and close the file. |
04:30 | Come back to the terminal. |
04:33 | Now, we have to set up the database. |
04:38 | Copy this command from the Code file and paste it in the terminal. Press Enter. |
04:47 | Press Y when asked if you want to continue and press Enter. |
04:57 | Next, set the password for root user as admin123 for the database. |
05:05 | You could give a different password if you wish. |
05:10 | Copy this command from the Code file and paste it in the terminal. Press Enter. |
05:19 | Next, copy these two commands one by one, paste them on the terminal and press Enter. |
05:26 | sudo a2enmod rewrite |
05:35 | sudo a2enmod cgi |
05:43 | This will enable the modules of Koha. |
05:48 | Then type: sudo service apache2 restart |
05:55 | This will restart apache services. Then press Enter. |
06:02 | To create a Koha instance named library-
copy this command from the Code file and paste it in the terminal. And press Enter. |
06:16 | Next, we have to tell Apache server that we are using port 8080. |
06:24 | For that, we have to open the ports.conf file in a text editor. |
06:31 | Copy this command from the Code file and paste it in the terminal.
And press Enter. |
06:40 | In the ports.conf file, search for the line Listen 80. |
06:47 | Next to that line, add Listen 8080. |
06:53 | Then save and close the file. |
06:57 | Then restart apache services.
Copy this command from the Code file and paste it in the terminal. Press Enter. |
07:10 | Next, copy this command from the Code file and paste it in the terminal.
And press Enter. |
07:20 | This is to disable the 000-default site. |
07:27 | The message confirms that it is disabled.
Let's move on. |
07:34 | Copy these two commands one by one, paste them on the terminal and press Enter. |
07:41 | sudo a2enmod deflate and press Enter. |
07:52 | sudo a2ensite library and press Enter. |
08:03 | The message on the terminal confirms that the site library is enabled. |
08:10 | Copy this command from the Code file and paste it in the terminal.
And press Enter. |
08:20 | Then type sudo su and press Enter. |
08:26 | We are now in the superuser that is root user mode. |
08:33 | Copy this command from the Code file and paste it in the terminal. Press Enter. |
08:41 | Type the password when prompted, admin123 and press Enter. |
08:49 | We are now inside our MariaDB prompt. |
08:54 | At the MariaDB prompt, type: use mysql semicolon and press Enter. |
09:03 | This is to tell MariaDB to use mysql database. |
09:09 | The message displayed on the terminal says Database changed. |
09:15 | Notice that the MariaDB prompt says mysql. |
09:22 | Now type the following command carefully as shown and press Enter. |
09:30 | This will set the password for the user koha_library as koha123. |
09:39 | We see a message on the terminal that says “Query OK”. |
09:45 | Next, type: flush privileges semicolon and press Enter.
This will update the latest changes. |
09:58 | Once again we see a message on the terminal that says “Query OK”. |
10:04 | Lastly, type: quit semicolon and press Enter to exit from Mariadb. |
10:13 | We are now back in the root user prompt. |
10:17 | We will now open the koha-conf.xml file in a text editor. |
10:25 | I will be doing so using gedit text editor. |
10:30 | In this file, search for the keyword 'mysql'. |
10:37 | Scroll down and locate this line. |
10:41 | Replace the alphanumeric value with 'koha123'. |
10:47 | Recall that this is the password we had set for our database earlier via the terminal. |
10:55 | Save the file and close the editor window. |
10:59 | Now open any web browser. I will be opening Firefox web browser. |
11:06 | In the address bar, type: 127.0.0.1:8080 and press Enter. |
11:21 | The Koha web installer page appears on the browser. |
11:26 | To login, use the credentials we set earlier. |
11:31 | I will type username as koha_library and password as koha123. |
11:42 | If you had given a different username and password, then type that in. |
11:48 | Now click on the Login button at the bottom right. |
11:53 | We are in Step 1 of Koha web installer. |
11:58 | In the language drop-down, select en for English, if it’s not already selected, by default. |
12:06 | Now click on the Next button at the bottom right. |
12:10 | The window now displays 2 messages.
The messages confirm that all Perl modules and all dependencies are installed. |
12:21 | Click on the Next button at the bottom right. |
12:25 | We are now in Step 2 – Database settings |
12:30 | Notice here, all the values are what we gave earlier. |
12:36 | Then click on the Next button at the bottom. |
12:40 | On doing so, we see a message that says “Connection established”. |
12:46 | This is followed by 2 more confirmation messages. |
12:51 | Click on the Next button at the bottom. |
12:54 | We are brought to Step 3. |
12:57 | Read what is displayed on the screen and then click on the Next button. |
13:03 | Soon we will see a Success message on our screen.
This confirms that our database tables are created. |
13:13 | Now click on the Next button at the bottom to continue. |
13:18 | Immediately, we are brought to this screen. |
13:21 | Read the displayed text and then click on the link install basic configuration settings. |
13:29 | On doing so, we are asked to select our MARC flavor.
I am going to select MARC21. |
13:38 | Then click on the Next button at the bottom. |
13:42 | In this screen, scroll-down to the section Mandatory. |
13:47 | Here, we see that the Default MARC21 check-boxes are selected. |
13:54 | Under Optional section, select all the options as shown. |
14:01 | As we scroll down, we see that under Other data, all the check-boxes are already selected. |
14:09 | Keep scrolling to the bottom of the page. |
14:13 | There is one more Optional section below, which is very long. |
14:18 | Here, locate the option “Some basic currencies” and select it. |
14:24 | After this, select the option “Useful patron attribute types”. |
14:30 | Now go to the bottom of the page and click on the Import button. |
14:36 | This will enable all the selected functionalities in Koha. |
14:41 | We are now brought to a new page. Scroll down this page and read all the text displayed on the screen. |
14:50 | We can see a success message “All done”. |
14:54 | Now, click on the Finish button. |
14:57 | We see the final message on our screen which confirms that our installation is successful. |
15:04 | We will now be moved to the Koha interface. |
15:08 | Type the username as koha_library and password as koha123. |
15:16 | Select My Library from the drop-down. |
15:20 | Then click on the Login button. |
15:23 | We are brought to the Koha Administration page. |
15:27 | We can see various tabs on this page. |
15:31 | We will learn how to use many of these later in this series. |
15:37 | Now, click on No Library Set and select the Logout option. |
15:45 | This brings us to the end of this tutorial. Let us summarize. |
15:50 | In this tutorial, we have learnt to install Koha Library Management System on Ubuntu Linux OS 16.04 and cross-verify the installation. |
16:03 | The video at the following link summarizes the Spoken Tutorial project.
Please download and watch it. |
16:12 | The Spoken Tutorial Project team: conducts workshops and gives certificates.
For more details, please write to us. |
16:22 | Post your timed queries in this Forum. |
16:26 | Spoken Tutorial project is funded by NMEICT, MHRD, Government of India.
More information on this mission is available at this link. |
16:39 | The script has been contributed by Nancy and video by Praveen.
This is Nancy from IIT Bombay, signing off. Thank you for joining. |