Difference between revisions of "Koha-Library-Management-System/C2/Koha-installation-on-Linux-16.04/English-timed"

From Script | Spoken-Tutorial
Jump to: navigation, search
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)))
 
(2 intermediate revisions by 2 users not shown)
Line 148: Line 148:
 
|-
 
|-
 
|| 04:16
 
|| 04:16
|| Change '''80''' to '''8080'''. This will change the port number to '''8080'''.
+
|| Change '''80''' to '''8080'''. This will change the '''port''' number to '''8080'''.
  
 
|-
 
|-
 
|| 04:26
 
|| 04:26
|| Then save and close the file.
+
|| Then '''save''' and close the file.
  
 
|-
 
|-
Line 160: Line 160:
 
|-
 
|-
 
|| 04:33
 
|| 04:33
|| Now we have to set up the '''database'''.
+
|| Now, we have to set up the '''database'''.
  
 
|-
 
|-
 
||04:38
 
||04:38
|| Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
+
|| Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. Press '''Enter.'''
 
+
And press '''Enter.'''
+
  
 
|-
 
|-
 
||04:47
 
||04:47
||Press''' Y '''when asked if you want to continue and Press '''Enter'''
+
||Press''' Y '''when asked if you want to continue and press '''Enter'''.
  
 
|-
 
|-
 
|| 04:57
 
|| 04:57
|| Next set the '''password''' for''' root user''' as '''admin123 '''for the '''database'''.
+
|| Next, set the '''password''' for''' root user''' as '''admin123 '''for the '''database'''.
  
 
|-
 
|-
Line 182: Line 180:
 
|-
 
|-
 
||05:10
 
||05:10
||Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
+
||Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. Press '''Enter.'''
 
+
And press '''Enter.'''
+
  
 
|-
 
|-
 
|| 05:19
 
|| 05:19
|| Next copy these two '''commands''' one by one, paste them on the '''terminal''' and press '''Enter'''.
+
|| Next, copy these two '''commands''' one by one, paste them on the '''terminal''' and press '''Enter'''.
  
 
|-
 
|-
Line 204: Line 200:
 
|-
 
|-
 
|| 05:48
 
|| 05:48
|| Then type '''sudo service apache2 restart'''
+
|| Then type: '''sudo service apache2 restart'''
  
 
|-
 
|-
 
||05:55
 
||05:55
||This will restart '''apache services '''and Press '''Enter'''
+
||This will restart '''apache services. ''' Then press '''Enter'''.
  
 
|-
 
|-
 
|| 06:02
 
|| 06:02
|| To create a '''Koha instance''' named '''library''',
+
|| To create a '''Koha instance''' named '''library'''-
  
Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
+
copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
  
 
And press '''Enter.'''
 
And press '''Enter.'''
Line 220: Line 216:
 
|-
 
|-
 
|| 06:16
 
|| 06:16
|| Next we have to tell '''Apache server '''that we are using '''port 8080'''.
+
|| Next, we have to tell '''Apache server '''that we are using '''port 8080'''.
  
 
|-
 
|-
Line 234: Line 230:
 
|-
 
|-
 
|| 06:40
 
|| 06:40
|| In the '''ports.conf''' file, search for the line '''Listen 80'''
+
|| In the '''ports.conf''' file, search for the line '''Listen 80'''.
  
 
|-
 
|-
 
||06:47
 
||06:47
||Next to that line, add '''Listen 8080'''
+
||Next to that line, add '''Listen 8080'''.
  
 
|-
 
|-
 
|| 06:53
 
|| 06:53
|| Then save and close the file.
+
|| Then '''save''' and close the file.
  
 
|-
 
|-
Line 254: Line 250:
 
|-
 
|-
 
|| 07:10
 
|| 07:10
|| Next copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
+
|| Next, copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
  
 
And press '''Enter.'''
 
And press '''Enter.'''
Line 270: Line 266:
 
|-
 
|-
 
|| 07:34
 
|| 07:34
|| Copy these two '''commands''' one by one, paste them on the '''terminal''' and press '''Enter'''
+
|| Copy these two '''commands''' one by one, paste them on the '''terminal''' and press '''Enter'''.
  
 
|-
 
|-
Line 292: Line 288:
 
|-
 
|-
 
||08:20
 
||08:20
|| Then type '''sudo su '''and press''' Enter'''
+
|| Then type '''sudo su '''and press''' Enter'''.
  
 
|-
 
|-
Line 300: Line 296:
 
|-
 
|-
 
|| 08:33
 
|| 08:33
|| Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
+
|| Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. Press '''Enter.'''
 
+
And press '''Enter.'''
+
 
|-
 
|-
 
||08:41
 
||08:41
|| Type the '''password''' when prompted, '''admin123 '''and Press '''Enter'''
+
|| Type the password when prompted, '''admin123 '''and press '''Enter'''.
  
 
|-
 
|-
Line 313: Line 307:
 
|-
 
|-
 
|| 08:54
 
|| 08:54
|| At the '''MariaDB prompt''', type '''use mysql semicolon '''and press '''Enter'''.
+
|| At the '''MariaDB prompt''', type: '''use mysql semicolon '''and press '''Enter'''.
  
 
|-
 
|-
Line 341: Line 335:
 
|-
 
|-
 
|| 09:45
 
|| 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.
Line 351: Line 345:
 
|-
 
|-
 
|| 10:04
 
|| 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
 
|| 10:13
|| We are now back in the '''root user prompt.'''
+
|| We are now back in the '''root user''' prompt.
  
 
|-
 
|-
Line 363: Line 357:
 
|-
 
|-
 
||10:25
 
||10:25
||I will do so using '''gedit text editor.'''
+
||I will be doing so using '''gedit text editor.'''
  
 
|-
 
|-
 
|| 10:30
 
|| 10:30
|| In this file, search for the '''keyword mysql'''
+
|| In this file, search for the '''keyword 'mysql''''.
  
 
|-
 
|-
Line 375: Line 369:
 
|-
 
|-
 
|| 10:41
 
|| 10:41
|| Replace the '''alphanumeric''' value with ''''koha123''''.
+
|| Replace the alphanumeric value with ''''koha123''''.
  
 
|-
 
|-
Line 391: Line 385:
 
|-
 
|-
 
||11:06
 
||11:06
|| In the '''address bar''', type '''127.0.0.1:8080''' and press '''Enter'''.
+
|| In the '''address bar''', type: '''127.0.0.1:8080''' and press '''Enter'''.
  
 
|-
 
|-
Line 441: Line 435:
 
|-
 
|-
 
|| 12:30
 
|| 12:30
|| Notice here all the values''' '''are what we gave earlier.
+
|| Notice here, all the values are what we gave earlier.
  
 
|-
 
|-
Line 479: Line 473:
 
|-
 
|-
 
|| 13:18
 
|| 13:18
|| Immediately, we are brought to this screen.
+
|| Immediately, we are brought to this '''screen'''.
  
 
|-
 
|-
Line 497: Line 491:
 
|-
 
|-
 
|| 13:42
 
|| 13:42
|| In this screen, scroll down to the section '''Mandatory.'''
+
|| In this screen, scroll-down to the section '''Mandatory.'''
  
 
|-
 
|-
 
||13:47
 
||13:47
||Here, we see that the '''Default MARC21 checkboxes '''are selected.  
+
||Here, we see that the '''Default MARC21 '''check-boxes are selected.  
  
 
|-
 
|-
Line 509: Line 503:
 
|-
 
|-
 
|| 14:01
 
|| 14:01
|| As we scroll down, we see that under '''Other data''', all the checkboxes are already selected.
+
|| As we scroll down, we see that under '''Other data''', all the check-boxes are already selected.
  
 
|-
 
|-
Line 549: Line 543:
 
|-
 
|-
 
|| 14:57
 
|| 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 which confirms that our installation is successful.
  
 
|-
 
|-
Line 581: Line 575:
 
|-
 
|-
 
|| 15:37
 
|| 15:37
|| Now, click on '''No Library Set''' at the top right and select the '''Logout''' option.
+
|| Now, click on '''No Library Set''' and select the '''Logout''' option.
  
 
|-
 
|-
Line 589: Line 583:
 
|-
 
|-
 
|| 15:50
 
|| 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
+
|| 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
 
|| 16:03
|| The video at the following link summarises the '''Spoken Tutorial''' project.
+
|| The video at the following link summarizes the '''Spoken Tutorial''' project.
  
 
Please download and watch it.
 
Please download and watch it.
Line 609: Line 603:
 
|-
 
|-
 
||  16:26
 
||  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.
Line 617: Line 611:
 
|| 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.

Contributors and Content Editors

Nancyvarkey, PoojaMoolya, Sandhya.np14