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 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:41
 
||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
−
|| The '''commands''' used in this tutorial are available in the '''Code Files''' link below the player
+
|| The '''command'''s used in this tutorial are available in the '''Code Files''' link below the '''player'''.
  
 
|-
 
|-
Line 52: Line 52:
 
|| I have opened this file in '''gedit text editor''' on my machine.
 
|| 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.
+
And, I will use the same file to copy paste the '''commands''' during the demonstration.
  
 
|-
 
|-
Line 66: Line 66:
 
|-
 
|-
 
||01:50
 
||01:50
−
|| For that copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
+
|| For that, '''copy''' this '''command''' from the '''Code file''' and '''paste''' it in the '''terminal'''.
  
−
And press '''Enter.'''
+
And, press '''Enter.'''
  
 
|-
 
|-
Line 74: Line 74:
 
|| From now on, type the '''System password '''whenever prompted during this installation.
 
|| From now on, type the '''System password '''whenever prompted during this installation.
  
−
And press '''Enter'''.
+
And, press '''Enter'''.
  
 
|-
 
|-
Line 86: Line 86:
 
|-
 
|-
 
|| 02:28
 
|| 02:28
−
|| 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.'''
  
 
|-
 
|-
 
|| 02:37
 
|| 02:37
−
|| Then this will download '''gpg.asc file''' and update the '''signature key'''.
+
|| Then, this will download '''gpg.asc file''' and update the '''signature key'''.
  
 
|-
 
|-
Line 98: Line 98:
 
|| 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.'''
  
 
|-
 
|-
 
||02:57
 
||02:57
−
|| Now copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
+
|| Now, copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
  
−
And press '''Enter.'''
+
And, press '''Enter.'''
  
 
|-
 
|-
Line 112: Line 112:
 
|-
 
|-
 
|| 03:11
 
|| 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:22
 
|| 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'''.
  
 
|-
 
|-
Line 126: Line 126:
 
|-
 
|-
 
|| 03:40
 
|| 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'''.
  
 
|-
 
|-
Line 136: Line 136:
 
|| 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 144: Line 144:
 
|-
 
|-
 
|| 04:10
 
|| 04:10
−
|| Locate the line that says '''INTRAPORT = 80'''
+
|| Locate the line that says '''INTRAPORT = 80'''.
  
 
|-
 
|-

Revision as of 11:03, 12 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 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.

And 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.

And 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 and 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.

And 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=44744"