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
(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...")
 
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 Install '''Koha Library Management System''' on '''Ubuntu Linux OS 16.04'''  and cross-verify the installation
+
|| 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:42
+
||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'''
+
||  any '''text editor''',
  
Either '''Firefox''' or''' Google Chrome web browser'''
+
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
|| Let’s begin.
+
|| The '''command'''s used in this tutorial are available in the '''Code Files''' link below the '''player'''.
  
 
|-
 
|-
|| 01:17
+
||01:22
|| Open the '''terminal '''by pressing '''Ctrl+Alt+T''' keys simultaneously on the keyboard.
+
|| 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:26
+
|| 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:34
+
||01:50
|| For that type '''sudo apt-get update''' and Press '''Enter'''
+
|| For that, '''copy''' this '''command''' from the '''Code file''' and '''paste''' it in the '''terminal'''.
 +
 
 +
And, press '''Enter.'''
  
 
|-
 
|-
|| 01:44
+
|| 01:59
|| Type the '''admin password '''when prompted and Press '''Enter'''
+
|| From now on, type the '''System password '''whenever prompted during this installation.
 +
 
 +
And, press '''Enter'''.
  
 
|-
 
|-
|| 01:52
+
||02:10
|| Now type this command carefully
+
|| This '''command''' will create a file named '''koha.list''' and update the '''package repository.'''
  
 
|-
 
|-
||01:57
+
||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:06
+
|| 02:28
|| This command will create a file named '''koha.list''' and update the '''package repository.''' Press '''Enter'''
+
|| Copy this '''command''' from the '''Code file''' and '''paste''' it in the '''terminal'''.
 +
 
 +
And, press '''Enter.'''
  
 
|-
 
|-
|| 02:18
+
|| 02:37
|| Then type this command as shown on the '''terminal '''.  
+
|| Then, this will download '''gpg.asc file''' and update the '''signature key'''.
  
 
|-
 
|-
||02:23
+
||02:47
|| This will download '''gpg.asc file''' and update the '''signature key'''. Press '''Enter'''
+
|| Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
 +
 
 +
And, press '''Enter.'''
  
 
|-
 
|-
|| 02:35
+
||02:57
|| Now, Press up arrow key to recall this command on the '''terminal'''.
+
|| Now, copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
  
And press '''Enter.'''
+
And, press '''Enter.'''
  
 
|-
 
|-
|| 02:45
+
||03:07
 
|| This will update the new '''repositories'''.
 
|| This will update the new '''repositories'''.
  
 
|-
 
|-
|| 02:50
+
|| 03:11
|| Now type- '''sudo apt-get install koha-common''' and press '''Enter.'''
+
|| Now, type '''sudo apt-get install koha-common''' and press '''Enter.'''
  
 
|-
 
|-
|| 03:01
+
|| 03:22
|| Press '''Y '''when asked if you want to continue and Press '''Enter'''.
+
|| Press '''Y '''when asked if you want to continue and press '''Enter'''.
  
 
|-
 
|-
|| 03:09
+
|| 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:13
+
|| Wait for the installation to complete. This will take some time.
+
  
 
|-
 
|-
|| 03:19
+
|| 03:40
|| Now we have to open the '''conf file '''in a '''text editor '''to change the '''port number''' for '''Koha'''.
+
|| Now, we have to open the '''conf file '''in a '''text editor '''to change the port number for '''Koha'''.
  
 
|-
 
|-
|| 03:28
+
|| 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:35
+
|| 03:57
|| So on the '''terminal '''I will type '''sudo gedit /etc/koha/koha-sites.conf'''
+
|| Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
  
and press '''Enter'''.
+
And, press '''Enter.'''
  
 
|-
 
|-
|| 03:51
+
|| 04:06
 
|| The file opens in the '''text editor'''.
 
|| The file opens in the '''text editor'''.
  
 
|-
 
|-
||03:55
+
|| 04:10
|| Locate the line that says '''INTRAPORT = 80'''
+
|| Locate the line that says '''INTRAPORT = 80'''.
  
 
|-
 
|-
|| 04:01
+
|| 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:11
+
|| 04:26
|| Then save and close the file.
+
|| Then '''save''' and close the file.
  
 
|-
 
|-
|| 04:15
+
|| 04:30
 
|| Come back to the '''terminal'''.
 
|| Come back to the '''terminal'''.
  
 
|-
 
|-
|| 04:18
+
|| 04:33
|| Now we have to set up the '''database'''.
+
|| Now, we have to set up the '''database'''.
  
 
|-
 
|-
|| 04:22
+
||04:38
|| So type '''sudo apt-get install mariadb-server''' and press '''Enter'''.
+
|| Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. Press '''Enter.'''
  
 
|-
 
|-
|| 04:32
+
||04:47
|| Then type '''sudo mysqladmin -u root password admin123''' and press '''Enter'''.
+
||Press''' Y '''when asked if you want to continue and press '''Enter'''.
  
 
|-
 
|-
||04:46
+
|| 04:57
|| This will set the '''password''' for''' root user''' as '''admin123 '''for the '''database'''. You could give a different '''password''' if you wish.
+
|| Next, set the '''password''' for''' root user''' as '''admin123 '''for the '''database'''.
  
 
|-
 
|-
|| 04:58
+
||05:05
|| Next type '''sudo a2enmod rewrite '''and press '''Enter'''.
+
||You could give a different '''password''' if you wish.
  
 
|-
 
|-
||05:08
+
||05:10
|| Then type, '''sudo a2enmod cgi '''and press '''Enter'''.
+
||Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. Press '''Enter.'''
  
 
|-
 
|-
||05:18
+
|| 05:19
|| This will enable the '''modules''' of '''Koha'''.
+
|| Next, copy these two '''commands''' one by one, paste them on the '''terminal''' and press '''Enter'''.
  
 
|-
 
|-
|| 05:22
+
||05:26
|| Then type '''sudo service apache2 restart '''and press '''Enter'''.
+
||'''sudo a2enmod rewrite '''
  
 
|-
 
|-
||05:31
+
||05:35
|| This will restart '''apache services.'''
+
||'''sudo a2enmod cgi '''
  
 
|-
 
|-
|| 05:35
+
||05:43
|| To create a '''Koha instance''' named '''library''', type the following command
+
||This will enable the '''modules''' of '''Koha'''.
  
And press '''Enter.'''
+
|-
 +
|| 05:48
 +
|| Then type: '''sudo service apache2 restart'''
  
 
|-
 
|-
|| 05:46
+
||05:55
|| Next we have to tell '''Apache server '''that we are using '''port 8080'''.
+
||This will restart '''apache services. ''' Then press '''Enter'''.
  
 
|-
 
|-
||05:54
+
|| 06:02
|| For that, we have to open the '''ports.conf''' file in a '''text editor'''.
+
|| To create a '''Koha instance''' named '''library'''-
  
Once again, I will use '''gedit text editor'''.  
+
copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
 +
 
 +
And press '''Enter.'''
  
 
|-
 
|-
||06:06
+
|| 06:16
||So type- '''sudo gedit  /etc/apache2/ports.conf''' and press '''Enter'''.
+
|| Next, we have to tell '''Apache server '''that we are using '''port 8080'''.
  
 
|-
 
|-
|| 06:20
+
||06:24
|| In the '''ports.conf''' file, search for the line '''Listen 80'''
+
||For that, we have to open the '''ports.conf''' file in a '''text editor'''.
  
 
|-
 
|-
|| 06:27
+
||06:31
||Next to that line, add '''Listen 8080'''
+
||Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
 +
 
 +
And press '''Enter.'''
  
 
|-
 
|-
|| 06:33
+
|| 06:40
|| Then save and close the file.
+
|| In the '''ports.conf''' file, search for the line '''Listen 80'''.
  
 
|-
 
|-
|| 06:37
+
||06:47
|| Then type '''sudo service apache2 restart '''and press '''Enter'''.
+
||Next to that line, add '''Listen 8080'''.
  
 
|-
 
|-
|| 06:46
+
|| 06:53
|| Next type '''sudo a2dissite 000-default '''and press '''Enter'''.
+
|| Then '''save''' and close the file.
  
 
|-
 
|-
|| 06:58
+
|| 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:05
+
|| 07:27
|| The message confirms that it is already disabled.
+
|| The message confirms that it is disabled.
 +
 
 +
Let's move on.
  
 
|-
 
|-
|| 07:10
+
|| 07:34
|| Let's move on.
+
|| Copy these two '''commands''' one by one, paste them on the '''terminal''' and press '''Enter'''.
  
 
|-
 
|-
||07:12
+
||07:41
|| Type '''sudo a2enmod deflate '''and press '''Enter'''.
+
||'''sudo a2enmod deflate '''and press '''Enter'''.
  
 
|-
 
|-
||07:21
+
||07:52
|| Next type, '''sudo a2ensite library '''and press '''Enter'''.
+
||'''sudo a2ensite library '''and press '''Enter'''.
  
 
|-
 
|-
||07:31
+
||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.
  
 
|-
 
|-
|| 07:37
+
|| 08:10
|| Using the up arrow key, recall the command shown on the screen and Press Enter.
+
|| Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
 +
 
 +
And press '''Enter.'''
  
 
|-
 
|-
||07:46
+
||08:20
|| Then type '''sudo su '''and press '''Enter'''.
+
|| Then type '''sudo su '''and press''' Enter'''.
  
 
|-
 
|-
|| 07:52
+
||08:26
 
||We are now in the '''superuser''' that is '''root user''' mode.
 
||We are now in the '''superuser''' that is '''root user''' mode.
  
 
|-
 
|-
|| 07:58
+
|| 08:33
|| At the '''prompt''', type '''mysql -u root -p '''and press '''Enter'''.
+
|| Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. Press '''Enter.'''
 
+
 
|-
 
|-
|| 08:08
+
||08:41
|| Type the '''password''' when prompted '''admin123''' and Press '''Enter'''
+
|| Type the password when prompted, '''admin123 '''and press '''Enter'''.
  
 
|-
 
|-
||08:16
+
||08:49
 
|| We are now inside our '''MariaDB prompt'''.  
 
|| We are now inside our '''MariaDB prompt'''.  
  
 
|-
 
|-
||08:21
+
|| 08:54
|| At the '''MariaDB prompt''', type '''use mysql semicolon '''
+
|| At the '''MariaDB prompt''', type: '''use mysql semicolon '''and press '''Enter'''.
  
 
|-
 
|-
||08:29
+
||09:03
|| This is to tell '''MariaDB''' to use '''mysql database.'''
+
||This is to tell '''MariaDB''' to use '''mysql database.'''
 
+
Press '''Enter'''.
+
  
 
|-
 
|-
|| 08:37
+
|| 09:09
 
|| The message displayed on the '''terminal '''says '''Database changed.'''
 
|| The message displayed on the '''terminal '''says '''Database changed.'''
  
 
|-
 
|-
|| 08:43
+
|| 09:15
 
|| Notice that the '''MariaDB prompt '''says '''mysql.'''
 
|| Notice that the '''MariaDB prompt '''says '''mysql.'''
  
 
|-
 
|-
|| 08:49
+
|| 09:22
 
|| Now type the following command carefully as shown and press '''Enter'''.
 
|| Now type the following command carefully as shown and press '''Enter'''.
  
 
|-
 
|-
||08:56
+
||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:05
+
|| 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:11
+
|| 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:23
+
|| 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'''”.
  
 
|-
 
|-
|| 09:29
+
|| 10:04
|| Lastly, type '''quit semicolon''' and press '''Enter '''to exit from '''Mariadb'''.
+
|| Lastly, type: '''quit semicolon''' and press '''Enter '''to exit from '''Mariadb'''.
  
 
|-
 
|-
|| 09:38
+
|| 10:13
|| We are now back in the '''root user prompt.'''
+
|| We are now back in the '''root user''' prompt.
  
 
|-
 
|-
|| 09:42
+
|| 10:17
|| 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.'''
 
|| We will now open the '''koha-conf.xml '''file in a '''text editor.'''
 
I will be doing so using '''gedit text editor.'''
 
  
 
|-
 
|-
||10:07
+
||10:25
|| So I will type  '''sudo gedit /etc/koha/sites/library/koha-conf.xml '''and press '''Enter'''.
+
||I will be doing so using '''gedit text editor.'''
  
 
|-
 
|-
|| 10:26
+
|| 10:30
|| In this file, search for the '''keyword 'koha_library'''' and press '''Enter'''.
+
|| In this file, search for the '''keyword 'mysql''''.
  
 
|-
 
|-
||10:34
+
|| 10:37
|| Scroll down and locate this line. 
+
|| Scroll down and locate this line.
 
+
Then locate this line.
+
  
 
|-
 
|-
 
|| 10:41
 
|| 10:41
|| Replace the '''alphanumeric''' value with ''''koha123''''.
+
|| 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:02
+
|| I will be opening '''Firefox web browser.'''
+
  
 
|-
 
|-
|| 11:07
+
||11:06
|| In the '''address bar''', type '''127.0.1.1:8080''' and press '''Enter'''.
+
|| 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:41
+
||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:47
+
|| 11:48
 
|| Now click on the '''Login''' button at the bottom right.
 
|| Now click on the '''Login''' button at the bottom right.
  
 
|-
 
|-
|| 11:52
+
|| 11:53
 
|| We are in '''Step 1''' of '''Koha web installer'''.
 
|| We are in '''Step 1''' of '''Koha web installer'''.
  
 
|-
 
|-
|| 11:57
+
|| 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:05
+
|| 12:06
 
|| Now click on the '''Next''' button at the bottom right.
 
|| Now click on the '''Next''' button at the bottom right.
  
 
|-
 
|-
|| 12:09
+
|| 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:13
+
|| The messages confirm that all '''Perl modules''' and all '''dependencies '''are installed.
+
  
 
|-
 
|-
||12:20
+
|| 12:21
 
|| Click on the '''Next''' button at the bottom right.
 
|| Click on the '''Next''' button at the bottom right.
  
 
|-
 
|-
||12:24
+
|| 12:25
 
|| We are now in '''Step 2 – Database settings'''
 
|| We are now in '''Step 2 – Database settings'''
  
 
|-
 
|-
|| 12:29
+
|| 12:30
|| Notice here all the values are what we gave earlier.
+
|| Notice here, all the values are what we gave earlier.
  
 
|-
 
|-
|| 12:35
+
|| 12:36
 
|| Then click on the '''Next''' button at the bottom.
 
|| Then click on the '''Next''' button at the bottom.
  
 
|-
 
|-
|| 12:39
+
|| 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:45
+
|| 12:46
 
|| This is followed by 2 more confirmation messages.
 
|| This is followed by 2 more confirmation messages.
  
 
|-
 
|-
|| 12:50
+
|| 12:51
 
|| Click on the '''Next''' button at the bottom.
 
|| Click on the '''Next''' button at the bottom.
  
 
|-
 
|-
|| 12:53
+
|| 12:54
 
|| We are brought to '''Step 3.'''
 
|| We are brought to '''Step 3.'''
  
 
|-
 
|-
|| 12:56
+
|| 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:02
+
|| 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:06
+
||This confirms that our '''database tables''' are created.
+
  
 
|-
 
|-
|| 03:12
+
|| 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:17
+
|| 13:18
|| Immediately, we are brought to this screen.
+
|| Immediately, we are brought to this '''screen'''.
  
 
|-
 
|-
Line 473: Line 486:
  
 
|-
 
|-
|| 13:37
+
|| 13:38
 
|| Then click on the '''Next''' button at the bottom.
 
|| Then click on the '''Next''' button at the bottom.
  
 
|-
 
|-
|| 13:41
+
|| 13:42
||Scroll down to the section '''Mandatory.'''
+
|| In this screen, scroll-down to the section '''Mandatory.'''
  
 
|-
 
|-
||13:45
+
||13:47
|| Here, we see that the '''Default MARC21 checkboxes '''are selected.  
+
||Here, we see that the '''Default MARC21 '''check-boxes are selected.  
  
 
|-
 
|-
|| 13:52
+
|| 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 checkboxes are already selected.
+
|| As we scroll down, we see that under '''Other data''', all the check-boxes are already selected.
  
 
|-
 
|-
|| 14:10
+
|| 14:09
 
|| Keep scrolling to the bottom of the page.
 
|| Keep scrolling to the bottom of the page.
  
 
|-
 
|-
|| 14: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:19
+
||14:18
 
|| Here, locate the option “'''Some basic currencies'''” and select it.
 
|| Here, locate the option “'''Some basic currencies'''” and select it.
  
 
|-
 
|-
||14:25
+
|| 14:24
 
|| After this, select the option “'''Useful patron attribute types'''”.
 
|| After this, select the option “'''Useful patron attribute types'''”.
  
 
|-
 
|-
|| 14:31
+
|| 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:37
+
|| 14:36
 
|| This will enable all the selected functionalities in '''Koha'''.
 
|| This will enable all the selected functionalities in '''Koha'''.
  
 
|-
 
|-
|| 14:42
+
|| 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:46
+
|| 14:50
|| Scroll down this page and read all the text displayed on the screen.
+
 
+
|-
+
|| 14:53
+
 
|| We can see a success message “'''All done'''”.
 
|| We can see a success message “'''All done'''”.
  
 
|-
 
|-
|| 14:57
+
|| 14:54
 
|| Now, click on the '''Finish '''button.
 
|| Now, click on the '''Finish '''button.
  
 
|-
 
|-
||15:00
+
|| 14:57
|| This will complete and load the '''Koha Staff Interface'''.
+
|| We see the final message on our screen which confirms that our installation is successful.
 
+
|-
+
|| 15:06
+
|| We see the final message on our screen, which confirms that our installation is successful.
+
  
 
|-
 
|-
|| 15:13
+
||15:04
 
|| We will now be moved to the '''Koha interface.'''
 
|| We will now be moved to the '''Koha interface.'''
  
 
|-
 
|-
|| 15:18
+
|| 15:08
 
|| Type the '''username '''as '''koha_library''' and '''password '''as '''koha123.'''
 
|| Type the '''username '''as '''koha_library''' and '''password '''as '''koha123.'''
  
 
|-
 
|-
|| 15:26
+
|| 15:16
 
|| Select '''My Library''' from the drop-down.
 
|| Select '''My Library''' from the drop-down.
  
 
|-
 
|-
|| 15:30
+
||15:20
|| Then click on '''Login''' button.
+
|| Then click on the '''Login''' button.
  
 
|-
 
|-
|| 15:33
+
|| 15:23
 
|| We are brought to the '''Koha Administration page.'''
 
|| We are brought to the '''Koha Administration page.'''
  
 
|-
 
|-
|| 15:37
+
||15:27
|| We can see various '''tabs''' on this page.  
+
|| We can see various tabs on this page.  
  
 
|-
 
|-
||15:41
+
||15:31
|| We will learn how to use many of these, later in this series.
+
||We will learn how to use many of these later in this series.
  
 
|-
 
|-
|| 15:47
+
|| 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:53
+
|| 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:58
+
|| 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:12
+
|| 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.
  
 
|-
 
|-
|| 16:21
+
|| 16:12
|| The '''Spoken Tutorial Project''' team conducts workshops and gives certificates.
+
|| The '''Spoken Tutorial''' Project teamconducts workshops and gives certificates.
  
 
For more details, please write to us.
 
For more details, please write to us.
  
 
|-
 
|-
||16:31
+
|| 16:22
|| Do you have questions in THIS Spoken Tutorial ?Please visit this webpage.
+
|| Post your timed queries in this Forum.
 
+
|-
+
|| 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
+
|| 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.
  
 
|-
 
|-
|| 17:02
+
|| 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.

Contributors and Content Editors

Nancyvarkey, PoojaMoolya, Sandhya.np14