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

From Script | Spoken-Tutorial
Revision as of 12:06, 26 September 2018 by PoojaMoolya (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
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:42 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 Let’s begin.
01:17 Open the terminal by pressing Ctrl+Alt+T keys simultaneously on the keyboard.
01:26 We have to first of all ensure that our Ubuntu Linux installation is up-to-date.
01:34 For that type sudo apt-get update and Press Enter
01:44 Type the admin password when prompted and Press Enter
01:52 Now type this command carefully
01:57 Please note: Koha 16.05 was the stable version at the time of creation of this tutorial.
02:06 This command will create a file named koha.list and update the package repository. Press Enter
02:18 Then type this command as shown on the terminal .
02:23 This will download gpg.asc file and update the signature key. Press Enter
02:35 Now, Press up arrow key to recall this command on the terminal.

And press Enter.

02:45 This will update the new repositories.
02:50 Now type- sudo apt-get install koha-common and press Enter.
03:01 Press Y when asked if you want to continue and Press Enter.
03:09 This will install Koha on your system.
03:13 Wait for the installation to complete. This will take some time.
03:19 Now we have to open the conf file in a text editor to change the port number for Koha.
03:28 I will use gedit text editor. You can use any text editor of your choice.
03:35 So on the terminal I will type sudo gedit /etc/koha/koha-sites.conf

and press Enter.

03:51 The file opens in the text editor.
03:55 Locate the line that says INTRAPORT = 80
04:01 Change 80 to 8080. This will change the port number to 8080.
04:11 Then save and close the file.
04:15 Come back to the terminal.
04:18 Now we have to set up the database.
04:22 So type sudo apt-get install mariadb-server and press Enter.
04:32 Then type sudo mysqladmin -u root password admin123 and press Enter.
04:46 This will set the password for root user as admin123 for the database. You could give a different password if you wish.
04:58 Next type sudo a2enmod rewrite and press Enter.
05:08 Then type, sudo a2enmod cgi and press Enter.
05:18 This will enable the modules of Koha.
05:22 Then type sudo service apache2 restart and press Enter.
05:31 This will restart apache services.
05:35 To create a Koha instance named library, type the following command

And press Enter.

05:46 Next we have to tell Apache server that we are using port 8080.
05:54 For that, we have to open the ports.conf file in a text editor.

Once again, I will use gedit text editor.

06:06 So type- sudo gedit /etc/apache2/ports.conf and press Enter.
06:20 In the ports.conf file, search for the line Listen 80
06:27 Next to that line, add Listen 8080
06:33 Then save and close the file.
06:37 Then type sudo service apache2 restart and press Enter.
06:46 Next type sudo a2dissite 000-default and press Enter.
06:58 This is to disable the 000-default site.
07:05 The message confirms that it is already disabled.
07:10 Let's move on.
07:12 Type sudo a2enmod deflate and press Enter.
07:21 Next type, sudo a2ensite library and press Enter.
07:31 The message on the terminal confirms that the site library is enabled.
07:37 Using the up arrow key, recall the command shown on the screen and Press Enter.
07:46 Then type sudo su and press Enter.
07:52 We are now in the superuser that is root user mode.
07:58 At the prompt, type mysql -u root -p and press Enter.
08:08 Type the password when prompted – admin123 and Press Enter
08:16 We are now inside our MariaDB prompt.
08:21 At the MariaDB prompt, type use mysql semicolon
08:29 This is to tell MariaDB to use mysql database.

Press Enter.

08:37 The message displayed on the terminal says Database changed.
08:43 Notice that the MariaDB prompt says mysql.
08:49 Now type the following command carefully as shown and press Enter.
08:56 This will set the password for the user koha_library as koha123.
09:05 We see a message on the terminal that says “Query OK”.
09:11 Next type flush privileges semicolon and press Enter.

This will update the latest changes.

09:23 Once again we see a message on the terminal that says “Query OK”.
09:29 Lastly, type quit semicolon and press Enter to exit from Mariadb.
09:38 We are now back in the root user prompt.
09:42 Type exit semicolon and press Enter.
09:46 This will exit us from root user login.

And we are brought back to our normal user prompt.

09:55 We will now open the koha-conf.xml file in a text editor.

I will be doing so using gedit text editor.

10:07 So I will type sudo gedit /etc/koha/sites/library/koha-conf.xml and press Enter.
10:26 In this file, search for the keyword 'koha_library' and press Enter.
10:34 Scroll down and locate this line.

Then 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.
11:02 I will be opening Firefox web browser.
11:07 In the address bar, type 127.0.1.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:41 If you had given a different username and password, then type that in.
11:47 Now click on the Login button at the bottom right.
11:52 We are in Step 1 of Koha web installer.
11:57 In the language drop-down, select en for English, if it’s not already selected, by default.
12:05 Now click on the Next button at the bottom right.
12:09 The window now displays 2 messages.
12:13 The messages confirm that all Perl modules and all dependencies are installed.
12:20 Click on the Next button at the bottom right.
12:24 We are now in Step 2 – Database settings
12:29 Notice here all the values are what we gave earlier.
12:35 Then click on the Next button at the bottom.
12:39 On doing so, we see a message that says “Connection established”.
12:45 This is followed by 2 more confirmation messages.
12:50 Click on the Next button at the bottom.
12:53 We are brought to Step 3.
12:56 Read what is displayed on the screen and then click on the Next button.
13:02 Soon we will see a Success message on our screen.
13:06 This confirms that our database tables are created.
03:12 Now click on the Next button at the bottom to continue.
13:17 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:37 Then click on the Next button at the bottom.
13:41 Scroll down to the section Mandatory.
13:45 Here, we see that the Default MARC21 checkboxes are selected.
13:52 Under Optional section, select all the options as shown.
14:01 As we scroll down, we see that under Other data, all the checkboxes are already selected.
14:10 Keep scrolling to the bottom of the page.
14:14 There is one more Optional section below, which is very long.
14:19 Here, locate the option “Some basic currencies” and select it.
14:25 After this, select the option “Useful patron attribute types”.
14:31 Now go to the bottom of the page and click on the Import button.
14:37 This will enable all the selected functionalities in Koha.
14:42 We are now brought to a new page.
14:46 Scroll down this page and read all the text displayed on the screen.
14:53 We can see a success message “All done”.
14:57 Now, click on the Finish button.
15:00 This will complete and load the Koha Staff Interface.
15:06 We see the final message on our screen, which confirms that our installation is successful.
15:13 We will now be moved to the Koha interface.
15:18 Type the username as koha_library and password as koha123.
15:26 Select My Library from the drop-down.
15:30 Then click on Login button.
15:33 We are brought to the Koha Administration page.
15:37 We can see various tabs on this page.
15:41 We will learn how to use many of these, later in this series.
15:47 Now, click on No Library Set and select the Logout option.
15:53 This brings us to the end of this tutorial.

Let us summarize.

15:58 In this tutorial, we have learnt to Install Koha Library Management System on Ubuntu Linux OS 16.04 and cross-verify the installation
16:12 The video at the following link summarises the Spoken Tutorial project.

Please download and watch it.

16:21 The Spoken Tutorial Project team conducts workshops and gives certificates.

For more details, please write to us.

16:31 Do you have questions in THIS Spoken Tutorial ?Please visit this webpage.
16:38 Choose the minute and second where you have the question. Explain your question briefly
16:45 Someone from our team will answer them.
16:49 Spoken Tutorial project is funded by NMEICT, MHRD, Government of India.

More information on this mission is available at this link.

17:02 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