Koha-Library-Management-System/C2/Koha-installation-on-Linux-16.04/English-timed

From Script | Spoken-Tutorial
Jump to: navigation, search
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.

Contributors and Content Editors

Nancyvarkey, PoojaMoolya, Sandhya.np14