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
Line 23: Line 23:
  
 
|-
 
|-
−
||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'''
  
Line 45: Line 45:
  
 
|-
 
|-
−
|| 01:15
+
||01:15
−
|| Let’s begin.
+
|| The commands 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 '''codefile''' 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 '''codefile''' 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 '''codefile''' 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 '''codefile''' 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 '''codefile '''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 '''codefile '''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 '''codefile '''and paste it in the '''terminal. '''Press '''Enter.'''
  
 
|-
 
|-
−
||05:18
+
|| 05:19
−
|| This will enable the '''modules''' of '''Koha'''.
+
|| Next Copy this two command 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 '''and 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'''.  
+
|-
 +
||06:07
 +
||Copy this command from the '''codefile '''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:24
 +
||For that, we have to open the '''ports.conf''' file in a '''text editor'''.
 +
 
 +
|-
 +
||06:31
 +
||Copy this command from the '''codefile '''and paste it in the '''terminal''' and Press '''Enter.'''
  
 
|-
 
|-
−
|| 06:20
+
|| 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:27
+
||06:47
 
||Next to that line, add '''Listen 8080'''
 
||Next to that line, add '''Listen 8080'''
  
 
|-
 
|-
−
|| 06:33
+
|| 06:53
 
|| Then save and close the file.
 
|| Then save and close the file.
  
 
|-
 
|-
−
|| 06:37
+
|| 06:57
−
|| Then type '''sudo service apache2 restart '''and press '''Enter'''.
+
|| Then restart '''apache services.'''
 +
 
 +
Copy this command from the '''codefile '''and paste it in the '''terminal'''. Press '''Enter.'''
  
 
|-
 
|-
−
|| 06:46
+
|| 07:10
−
|| Next type '''sudo a2dissite 000-default '''and press '''Enter'''.
+
|| Next copy this command from the '''codefile '''and paste it in the '''terminal''' and Press '''Enter.'''
  
 
|-
 
|-
−
|| 06:58
+
||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 this two command 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 '''codefile '''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 '''codefile '''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'''.
  
Line 305: Line 319:
  
 
|-
 
|-
−
|| 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 do 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.
+
  
 
|-
 
|-
Line 351: Line 351:
  
 
|-
 
|-
−
|| 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 360:
 
|-
 
|-
 
|| 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 376:
 
|-
 
|-
 
||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.
+
  
 
|-
 
|-
−
|| 13: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 465:
  
 
|-
 
|-
−
|| 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 checkboxes '''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 checkboxes 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'''.
+
−
 
+
−
|-
+
−
|| 15:06
+
 
|| 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.
  
 
|-
 
|-
−
|| 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''' at the top right 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 summarises the '''Spoken Tutorial''' project.
  
Line 589: Line 571:
  
 
|-
 
|-
−
|| 16:21
+
|| 16:12
−
|| The '''Spoken Tutorial Project''' team conducts workshops and gives certificates.
+
|| The '''Spoken Tutorial''' Project team:  conducts 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.
  

Revision as of 21:47, 9 October 2018

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 codefile 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 codefile 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 codefile and paste it in the terminal and Press Enter.
02:57 Now Copy this command from the codefile 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 codefile 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 codefile 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 codefile and paste it in the terminal. Press Enter.
05:19 Next Copy this two command 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 and Press Enter
06:02 To create a Koha instance named library,
06:07 Copy this command from the codefile 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 codefile 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 codefile and paste it in the terminal. Press Enter.

07:10 Next copy this command from the codefile 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 this two command 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 codefile 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 codefile 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 do 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 checkboxes 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 checkboxes 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 at the top right 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 summarises 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

Retrieved from "https://script.spoken-tutorial.org/index.php?title=Koha-Library-Management-System/C2/Koha-installation-on-Linux-16.04/English-timed&oldid=44712"