Koha-Library-Management-System/C2/Koha-installation-on-Linux-16.04/English-timed
From Script | Spoken-Tutorial
| 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. |
