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

From Script | Spoken-Tutorial
Jump to: navigation, search
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
.
 
  
 
{| border=1
 
{| border=1
Line 22: Line 21:
 
# '''Ubuntu Linux''' OS 16.04
 
# '''Ubuntu Linux''' OS 16.04
 
# '''Koha''' version 16.05
 
# '''Koha''' version 16.05
−
# '''gedit text editor'''
+
# '''gedit text editor''' and
 
# '''Firefox web browser'''
 
# '''Firefox web browser'''
  
Line 37: Line 36:
 
|| The minimum hardware requirements are-
 
|| The minimum hardware requirements are-
  
−
* i3 processor or above
+
* '''i3 processor''' or above
−
* 500GB hard disk or more
+
* '''500GB hard disk''' or more
−
* minimum 4GB RAM and
+
* minimum '''4GB RAM''' and
−
* Network facility
+
* '''Network''' facility
 +
 
 +
|-
 +
|| Slide
 +
|| The commands used in this tutorial are available in the '''Code Files''' link below the player.
 +
 
 +
|-
 +
|Switch to gedit text editor and open the file
 +
|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.
  
 
|-
 
|-
Line 51: Line 61:
  
 
|-
 
|-
−
|| Type
+
|| sudo apt-get update >> Enter
  
−
sudo apt-get update >> Enter
 
  
  
Line 59: Line 68:
  
  
−
For that type '''sudo apt-get update'''
+
For that copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
 +
 
 +
And press '''Enter.'''
  
 
|-
 
|-
−
|| Type admin password >> Enter
+
|| System password >> Enter
−
|| Type the '''admin password '''when prompted.
+
|| From now on, type the '''System password '''whenever prompted during installation.
 +
 
 +
And press '''Enter'''
  
 
|-
 
|-
−
|| Type
+
|| Select
  
  
 
''echo deb [http://debian.koha-community.org/koha http://debian.koha-community.org/koha] 16.05 main | sudo tee /etc/apt/sources.list.d/koha.list''
 
''echo deb [http://debian.koha-community.org/koha http://debian.koha-community.org/koha] 16.05 main | sudo tee /etc/apt/sources.list.d/koha.list''
 +
|| This '''command''' will create a file named '''koha.list''' and update the '''package repository.'''
  
  
−
Press Enter.
+
Please note: '''Koha 16.05''' was the stable version at the time of creation of this tutorial.
−
|| Now type this command carefully and press '''Enter'''.
+
  
 +
|-
 +
|| Copy
  
−
Please note: '''Koha 16.05''' was the stable version at the time of creation of this tutorial.
+
''echo deb [http://debian.koha-community.org/koha http://debian.koha-community.org/koha] 16.05 main | sudo tee /etc/apt/sources.list.d/koha.list''
  
  
−
This command will create a file named '''koha.list''' and update the '''package repository.'''
+
''Paste in '''terminal '''''and Press '''Enter.'''
 +
|| Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
 +
 
 +
And press '''Enter.'''
  
 
|-
 
|-
−
|| Type
+
|| Copy
  
−
''wget -O- [http://debian.koha-community.org/koha/gpg.asc http://debian.koha-community.org/koha/gpg.asc] | sudo apt-key add -''
 
  
−
Press Enter.
+
''wget -O- [http://debian.koha-community.org/koha/gpg.asc http://debian.koha-][http://debian.koha-community.org/koha/gpg.asc community.org/koha/gpg.asc] | sudo apt-key add -''
−
|| Then type this command as shown on the '''terminal '''and press '''Enter'''.
+
  
  
−
This will download '''gpg.asc file''' and update the '''signature key'''.
+
Paste in '''terminal''' and Press '''Enter.'''
 +
|| Then, this will download '''gpg.asc file''' and update the '''signature key'''.
  
−
|-
 
−
|| Type
 
  
 +
Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
  
−
''sudo apt-get update'' >> Enter
+
And press '''Enter.'''
  
 +
|-
 +
|| Copy
  
  
−
|| Now press up arrow key to recall this command on the '''terminal'''.
+
''sudo apt-get update''  
  
 +
Paste in '''terminal''' and Press '''Enter.'''
 +
|| Now copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
  
 
And press '''Enter.'''
 
And press '''Enter.'''
Line 109: Line 129:
  
 
|-
 
|-
−
|| Type
+
|| Copy
 +
 
 +
sudo apt-get install koha-common
 +
 
  
−
sudo apt-get install koha-common >> Enter
+
Paste in '''terminal''' and Press '''Enter.'''
−
|| Now type-
+
|| Now type '''sudo apt-get install koha-common''' and press '''Enter.'''
  
−
'''sudo apt-get install koha-common''' and press '''Enter.'''
 
  
 
|-
 
|-
 
|| Press Y
 
|| Press Y
−
|| Press '''Y '''when asked if you want to continue.
+
|| Press '''Y '''when asked if you want to continue and press '''Enter'''
  
 
|-
 
|-
Line 131: Line 153:
 
|-
 
|-
 
||  
 
||  
−
|| 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 138: Line 160:
  
 
|-
 
|-
−
|| type
+
|| Copy
  
−
sudo gedit /etc/koha/koha-sites.conf >> Enter
+
sudo gedit /etc/koha/koha-sites.conf
−
|| So on the '''terminal '''I will type
+
  
−
'''sudo gedit /etc/koha/koha-sites.conf'''
 
  
−
and press '''Enter'''.
+
Paste in '''terminal''' and Press '''Enter.'''
 +
|| Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
 +
 
 +
And press '''Enter.'''
  
 
|-
 
|-
Line 160: Line 183:
  
  
−
This will change the '''port number''' to '''8080'''.
+
This will change the port number to '''8080'''.
  
 
|-
 
|-
Line 175: Line 198:
  
 
|-
 
|-
−
|| Type
+
|| Copy
  
−
sudo apt-get install mariadb-server >> Enter
+
sudo apt-get install mariadb-server
−
|| So type '''sudo apt-get install mariadb-server''' and press '''Enter'''.
+
 
 +
 
 +
Paste in '''terminal''' and Press '''Enter.'''
 +
|| Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
 +
 
 +
And press '''Enter.'''
 +
 
 +
 
 +
Press''' Y '''when asked if you want to continue and press '''Enter'''
  
 
|-
 
|-
−
|| Type
+
|| Copy
  
−
sudo mysqladmin -u root password admin123 >> Enter
+
sudo mysqladmin -u root password admin123  
−
|| Then type-
+
  
−
'''sudo mysqladmin -u root password admin123''' and press '''Enter'''.
+
 
 +
Paste in '''terminal''' and Press '''Enter.'''
 +
|| Next set the '''password''' for''' root user''' as '''admin123 '''for the '''database'''.
  
  
Line 192: Line 224:
  
  
−
This will set the '''password''' for''' root user''' as '''admin123 '''for the '''database'''.
+
Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''.
 +
 
 +
Press '''Enter.'''
  
 
|-
 
|-
−
|| Type
+
|| Copy
  
−
sudo a2enmod rewrite >> Enter
+
sudo a2enmod rewrite  
  
−
sudo a2enmod cgi >> Enter
+
sudo a2enmod cgi  
−
|| Next type
+
 
 +
 
 +
Paste them on the '''terminal''' and press '''Enter'''.
 +
|| Next copy these two commands one by one, paste them on the '''terminal''' and press '''Enter'''.
 +
 
 +
 
 +
'''sudo a2enmod rewrite '''
  
−
'''sudo a2enmod rewrite '''and press '''Enter'''.
 
  
−
'''sudo a2enmod cgi '''and press '''Enter'''.
+
'''sudo a2enmod cgi '''
  
  
Line 215: Line 254:
 
|| Then type
 
|| Then type
  
−
'''sudo service apache2 restart '''and press '''Enter'''.
+
'''sudo service apache2 restart'''
  
  
−
This will restart '''apache services.'''
+
This will restart '''apache services '''.
 +
 
 +
Then press '''Enter'''.
  
 
|-
 
|-
−
|| Type:
+
|| Copy
  
  
 
sudo koha-create --create-db library
 
sudo koha-create --create-db library
−
|| To create a '''Koha instance''' named '''library''', type the following command
 
  
 +
Paste it in the '''terminal''' and Press '''Enter.'''
 +
|| To create a '''Koha instance''' named '''library'''-
  
−
And press '''Enter.'''
+
# Copy this '''command''' from the '''Code file '''and paste it in the '''terminal'''
 +
# and press '''Enter.'''
  
 
|-
 
|-
−
|| Type:
+
|| Copy:
  
  
 
sudo gedit /etc/apache2/ports.conf
 
sudo gedit /etc/apache2/ports.conf
−
|| Next we have to tell '''Apache server '''that we are using '''port 8080'''.
+
 
 +
Paste it in the '''terminal''' and Press '''Enter.'''
 +
|| Next, we have to tell '''Apache server '''that we are using '''port 8080'''.
  
  
 
For that, we have to open the '''ports.conf''' file in a '''text editor'''.
 
For that, we have to open the '''ports.conf''' file in a '''text editor'''.
  
−
Once again, I will use '''gedit text editor'''. So type-
 
  
 +
Copy this '''command''' from the '''Code file '''and paste it in the '''terminal'''.
  
−
'''sudo gedit /etc/apache2/ports.conf'''
+
And press '''Enter.'''
−
 
+
−
 
+
−
and press '''Enter'''.
+
  
 
|-
 
|-
Line 260: Line 302:
  
 
|-
 
|-
−
|| Type
+
|| Copy
  
−
sudo service apache2 restart >> Enter
+
sudo service apache2 restart
−
|| Now type
+
  
−
'''sudo service apache2 restart '''and press '''Enter'''.
+
paste it in the '''terminal''' and Press '''Enter.'''
 +
|| Then restart '''apache services.'''
  
  
−
This will restart '''apache services.'''
+
Copy this '''command''' from the '''Code file '''and paste it in the '''terminal'''.
 +
 
 +
And press '''Enter.'''
  
 
|-
 
|-
−
|| Type
+
|| Copy
  
 
sudo a2dissite 000-default
 
sudo a2dissite 000-default
−
|| Next type
 
  
−
'''sudo a2dissite 000-default '''and press '''Enter'''.
+
 
 +
Paste it in the '''terminal''' and Press '''Enter.'''
 +
|| Next copy this '''command''' from the '''Code file '''and paste it in the '''terminal'''.
 +
 
 +
And press '''Enter.'''
  
  
Line 283: Line 330:
 
|-
 
|-
 
|| Point to message
 
|| Point to message
−
|| The message confirms that it is already disabled.
+
|| The message confirms that it is disabled.
  
 
|-
 
|-
Line 290: Line 337:
  
 
|-
 
|-
−
|| Type
+
|| Copy
  
−
sudo a2enmod deflate >> Enter
+
sudo a2enmod deflate  
 +
 
 +
sudo a2ensite library
 +
 
 +
 
 +
Paste it in the '''terminal''' and Press '''Enter.'''
 +
|| Copy these two '''commands''' one by one, paste them on the '''terminal''' and press '''Enter'''.
  
−
sudo a2ensite library >> Enter
 
−
|| Type
 
  
 
'''sudo a2enmod deflate '''and press '''Enter'''.
 
'''sudo a2enmod deflate '''and press '''Enter'''.
Line 305: Line 356:
  
 
|-
 
|-
−
|| sudo service apache2 restart and press Enter.
+
|| Copy
−
|| Using the up arrow key, recall the command shown on the screen.
+
  
−
|-
+
sudo service apache2 restart
−
|| Type
+
  
 +
Paste it in the '''terminal''' and press '''Enter.'''
 +
|| Copy this '''command''' from the '''Code file '''and paste it in the '''terminal'''.
 +
 +
And press '''Enter.'''
 +
 +
|-
 +
|| Copy
 
sudo su >> Enter
 
sudo su >> Enter
−
|| Then type
 
  
−
'''sudo su '''and press '''Enter'''.
+
Paste it in the '''terminal''' and press '''Enter.'''
 +
|Then type '''sudo s u '''and press''' Enter'''.
  
  
Line 320: Line 376:
  
 
|-
 
|-
−
|| Type
+
|| Copy
  
 
mysql -u root -p >> Enter
 
mysql -u root -p >> Enter
−
|| At the '''prompt''', type
 
  
−
'''mysql -u root -p '''and press '''Enter'''.
+
 
 +
Paste it in the '''terminal''' and Press '''Enter.'''
 +
|| Copy this command from the '''Code file '''and paste it in the '''terminal'''.
 +
 
 +
Press '''Enter.'''
  
 
|-
 
|-
 
|| Type password >> Enter
 
|| Type password >> Enter
  
 +
|| Type the '''password''' when prompted, '''admin123 '''and Press '''Enter'''.
  
−
|| Type the '''password''' when prompted - '''admin123'''.
+
|-
−
 
+
|
−
 
+
|We are now inside our '''MariaDB prompt'''.  
−
We are now inside our '''MariaDB prompt'''.  
+
  
 
|-
 
|-
Line 342: Line 401:
 
|| At the '''MariaDB prompt''', type  
 
|| At the '''MariaDB prompt''', type  
  
−
'''use mysql semicolon '''
+
'''use mysql semicolon '''and press '''Enter'''.
  
  
 
This is to tell '''MariaDB''' to use '''mysql database.'''
 
This is to tell '''MariaDB''' to use '''mysql database.'''
−
 
−
Press '''Enter'''.
 
  
 
|-
 
|-
Line 355: Line 412:
 
|-
 
|-
 
|| Point to mysql
 
|| Point to mysql
−
|| Notice that the '''MariaDB prompt '''says '''mysql.'''
+
|| Notice the '''MariaDB prompt '''says '''mysql.'''
  
 
|-
 
|-
−
||  
+
|| SET PASSWORD FOR 'koha_library'@'localhost' = PASSWORD('koha123');
−
|| Now type the following command carefully as shown and press '''Enter'''.
+
|| Now type the following '''command''' carefully as shown and press '''Enter'''.
  
  
 
This will set the '''password''' for the '''user koha_library''' as '''koha123'''.
 
This will set the '''password''' for the '''user koha_library''' as '''koha123'''.
−
 
−
|-
 
−
| colspan="2" | Only to be shown in Visual Cue and not to be narrated.
 
−
 
−
'''SET PASSWORD FOR 'koha_library'@'localhost' = PASSWORD('koha123');'''
 
  
 
|-
 
|-
Line 393: Line 445:
 
|-
 
|-
 
|| Type quit; >> Enter
 
|| Type quit; >> Enter
−
 
−
 
  
 
|| Lastly, type '''quit semicolon''' and press '''Enter '''to exit from '''Mariadb'''.
 
|| Lastly, type '''quit semicolon''' and press '''Enter '''to exit from '''Mariadb'''.
Line 403: Line 453:
  
 
|-
 
|-
−
|| Type exit; >> Enter
+
|| Copy
−
|| Type '''exit semicolon '''and press '''Enter'''.
+
−
 
+
−
|-
+
−
|| User prompt
+
−
|| This will exit us from '''root user login'''.
+
−
 
+
−
 
+
−
And we are brought back to our normal '''user prompt'''.
+
−
 
+
−
|-
+
−
|| Type
+
  
 
sudo gedit /etc/koha/sites/library/koha-conf.xml
 
sudo gedit /etc/koha/sites/library/koha-conf.xml
Line 422: Line 461:
  
  
−
I will be doing so using '''gedit text editor.'''
+
I will do so using '''gedit text editor.'''
−
 
+
−
 
+
−
So I will type
+
−
 
+
−
'''sudo gedit /etc/koha/sites/library/koha-conf.xml '''and press '''Enter'''.
+
  
 
|-
 
|-
 
|| Type
 
|| Type
  
−
koha_library >> Enter
+
mysql >> Enter
−
|| In this file, search for the '''keyword 'koha_library'''' and press '''Enter'''.
+
|| In this file, search for the '''keyword mysql'''.
 +
 
 
|-
 
|-
−
||Highlight mysql  
+
|| Highlight mysql  
 
|| Scroll down and locate this line.
 
|| Scroll down and locate this line.
−
 
−
|-
 
−
|| <nowiki>Highlight <pass>5NT......</pass></nowiki>
 
−
|| Then locate this line.
 
  
 
|-
 
|-
Line 461: Line 492:
  
 
|-
 
|-
−
|| Firefox web browser >> 127.0.1.1:8080
+
|| Firefox web browser >> 127.0.0.1:8080
  
 
Press Enter
 
Press Enter
−
|| 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 515: Line 546:
  
 
|-
 
|-
−
||Highlight Step 2
+
|| Highlight Step 2
 
|| We are now in '''Step 2 – Database settings'''
 
|| We are now in '''Step 2 – Database settings'''
  
 
|-
 
|-
 
|| Point to the values displayed
 
|| Point to the values displayed
−
|| Notice here all the values are what we gave earlier.
+
|| Notice here all the values''' '''are what we gave earlier.
  
 
|-
 
|-
Line 591: Line 622:
 
|-
 
|-
 
|| Highlight Optional section
 
|| Highlight Optional section
−
|| Under Optional section, select all the options as shown.
+
|| Under '''Optional '''section, select all the options as shown.
  
 
|-
 
|-
Line 626: Line 657:
  
 
|-
 
|-
−
||  
+
|| New page
 
|| We are now brought to a new page.
 
|| We are now brought to a new page.
  
Line 638: Line 669:
  
 
|-
 
|-
−
|| Click on Finish''' '''button
+
|| Click on '''Finish''' button
 
|| Now, click on the '''Finish '''button.
 
|| Now, click on the '''Finish '''button.
−
 
−
 
−
This will complete and load the '''Koha Staff Interface'''.
 
  
 
|-
 
|-
Line 661: Line 689:
  
 
|-
 
|-
−
|| Select My Library
+
|| Select '''My Library'''
 
|| Select '''My Library''' from the drop-down.
 
|| Select '''My Library''' from the drop-down.
  
 
|-
 
|-
−
|| Click on '''Login '''button
+
|| Click on Login''' '''button
 
|| Then click on the '''Login''' button.
 
|| Then click on the '''Login''' button.
  
Line 674: Line 702:
 
|-
 
|-
 
|| Point to the various tabs
 
|| Point to the various tabs
−
|| We can see various '''tabs''' on this page.  
+
|| We can see various tabs on this page.  
  
  
−
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.
  
 
|-
 
|-
Line 701: Line 729:
 
About '''Spoken Tutorial '''project
 
About '''Spoken Tutorial '''project
  
−
* Watch the video available at http://spoken-tutorial.org/What_is_a_Spoken_Tutorial
+
* Watch the video available at[http://spoken-tutorial.org/What_is_a_Spoken_Tutorial http://spoken-tutorial.org/What_is_a_Spoken_Tutorial]
 
* It summarises the '''Spoken Tutorial '''project.
 
* It summarises the '''Spoken Tutorial '''project.
 
* If you do not have good bandwidth, you can download and watch it.
 
* If you do not have good bandwidth, you can download and watch it.
 +
 +
 
|| The video at the following link summarises the '''Spoken Tutorial''' project.
 
|| The video at the following link summarises the '''Spoken Tutorial''' project.
  
 
Please download and watch it.
 
Please download and watch it.
−
 
  
 
|-
 
|-
Line 719: Line 748:
 
* Gives certificates for those who pass an online test
 
* Gives certificates for those who pass an online test
 
* For more details, please write to contact@spoken-tutorial.org
 
* For more details, please write to contact@spoken-tutorial.org
−
|| The '''Spoken Tutorial Project''' team conducts workshops and gives certificates.
+
 
 +
 
 +
|| The '''Spoken Tutoria'''l Project team:
 +
 
 +
* conducts workshops and
 +
* gives certificates.
  
 
For more details, please write to us.
 
For more details, please write to us.
Line 729: Line 763:
  
 
* Do you have questions in THIS '''Spoken Tutorial'''?
 
* Do you have questions in THIS '''Spoken Tutorial'''?
−
* Please visit http://forums.spoken-tutorial.org
+
* Please visit [http://forums.spoken-tutorial.org/ http://forums.spoken-tutorial.org]
 
* Choose the minute and second where you have the question
 
* Choose the minute and second where you have the question
 
* Explain your question briefly
 
* Explain your question briefly
 
* Someone from our team will answer them
 
* Someone from our team will answer them
 +
 +
 
|| Post your timed queries in this Forum.
 
|| Post your timed queries in this Forum.
  
Line 742: Line 778:
 
* '''Spoken Tutorial''' Project is a part of the '''Talk to a Teacher''' project
 
* '''Spoken Tutorial''' Project is a part of the '''Talk to a Teacher''' project
 
* It is supported by the '''National Mission on Education''' through '''ICT, MHRD, Government of India'''
 
* It is supported by the '''National Mission on Education''' through '''ICT, MHRD, Government of India'''
−
* More information on this Mission is available at http://spoken-tutorial.org/NMEICT-Intro
+
* More information on this Mission is available at
  
−
|'''Spoken Tutorial '''project is funded by '''NMEICT, MHRD, Government of India.'''
+
[http://spoken-tutorial.org/NMEICT-Intro http://spoken-tutorial.org/NMEICT-Intro]
 +
|| [http://spoken-tutorial.org/NMEICT-Intro ]'''Spoken Tutorial '''project is funded by '''NMEICT, MHRD, Government of India.'''
  
  

Latest revision as of 03:15, 8 November 2019

Visual Cue Narration
Title slide Welcome to this spoken tutorial on Installation of Koha on Ubuntu Linux OS.
Learning Objectives slide In this tutorial, we will learn to
  • Install Koha Library Management System on Ubuntu Linux OS 16.04
  • and cross-verify the installation
System requirements This tutorial is recorded using
  1. Ubuntu Linux OS 16.04
  2. Koha version 16.05
  3. gedit text editor and
  4. Firefox web browser
Pre-requisites Before you start, please ensure that your machine has-
  1. Ubuntu Linux OS 16.04
  2. any text editor
  3. either Firefox or Google Chrome web browser
Hardware requirements The minimum hardware requirements are-
  • i3 processor or above
  • 500GB hard disk or more
  • minimum 4GB RAM and
  • Network facility
Slide The commands used in this tutorial are available in the Code Files link below the player.
Switch to gedit text editor and open the file 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.

Let’s begin.
Ctrl+Alt+T keys Open the terminal by pressing Ctrl+Alt+T keys simultaneously on the keyboard.
sudo apt-get update >> Enter


We have to first of all ensure that our Ubuntu Linux installation is up-to-date.


For that copy this command from the Code file and paste it in the terminal.

And press Enter.

System password >> Enter From now on, type the System password whenever prompted during installation.

And press Enter

Select


echo deb http://debian.koha-community.org/koha 16.05 main | sudo tee /etc/apt/sources.list.d/koha.list

This command will create a file named koha.list and update the package repository.


Please note: Koha 16.05 was the stable version at the time of creation of this tutorial.

Copy

echo deb http://debian.koha-community.org/koha 16.05 main | sudo tee /etc/apt/sources.list.d/koha.list


Paste in terminal and Press Enter.

Copy this command from the Code file and paste it in the terminal.

And press Enter.

Copy


wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -


Paste in terminal and Press Enter.

Then, this will download gpg.asc file and update the signature key.


Copy this command from the Code file and paste it in the terminal.

And press Enter.

Copy


sudo apt-get update

Paste in terminal and Press Enter.

Now copy this command from the Code file and paste it in the terminal.

And press Enter.


This will update the new repositories.

Copy

sudo apt-get install koha-common


Paste in terminal and Press Enter.

Now type sudo apt-get install koha-common and press Enter.


Press Y Press Y when asked if you want to continue and press Enter
This will install Koha on your system.


Wait for the installation to complete.

This will take some time.

Now, we have to open the conf file in a text editor to change the port number for Koha.
I will use gedit text editor. You can use any text editor of your choice.
Copy

sudo gedit /etc/koha/koha-sites.conf


Paste in terminal and Press Enter.

Copy this command from the Code file and paste it in the terminal.

And press Enter.

The file opens in the text editor.
Locate INTRAPORT = 80 Locate the line that says INTRAPORT = 80
Change 80 to 8080. Change 80 to 8080.


This will change the port number to 8080.

Ctrl+S >> close file Then save and close the file.
Terminal Come back to the terminal.
Now we have to set up the database.
Copy

sudo apt-get install mariadb-server


Paste in terminal and Press Enter.

Copy this command from the Code file and paste it in the terminal.

And press Enter.


Press Y when asked if you want to continue and press Enter

Copy

sudo mysqladmin -u root password admin123


Paste in terminal and Press Enter.

Next set the password for root user as admin123 for the database.


You could give a different password if you wish.


Copy this command from the Code file and paste it in the terminal.

Press Enter.

Copy

sudo a2enmod rewrite

sudo a2enmod cgi


Paste them on the terminal and press Enter.

Next copy these two commands one by one, paste them on the terminal and press Enter.


sudo a2enmod rewrite


sudo a2enmod cgi


This will enable the modules of Koha.

Type

sudo service apache2 restart >> Enter

Then type

sudo service apache2 restart


This will restart apache services .

Then press Enter.

Copy


sudo koha-create --create-db library

Paste it in the terminal and Press Enter.

To create a Koha instance named library-
  1. Copy this command from the Code file and paste it in the terminal
  2. and press Enter.
Copy:


sudo gedit /etc/apache2/ports.conf

Paste it in the terminal and Press Enter.

Next, we have to tell Apache server that we are using port 8080.


For that, we have to open the ports.conf file in a text editor.


Copy this command from the Code file and paste it in the terminal.

And press Enter.

Add 8080 In the ports.conf file, search for the line Listen 80


Next to that line, add Listen 8080

Ctrl+S >> close file Then save and close the file.
Copy

sudo service apache2 restart

paste it in the terminal and Press Enter.

Then restart apache services.


Copy this command from the Code file and paste it in the terminal.

And press Enter.

Copy

sudo a2dissite 000-default


Paste it in the terminal and Press Enter.

Next copy this command from the Code file and paste it in the terminal.

And press Enter.


This is to disable the 000-default site.

Point to message The message confirms that it is disabled.
Let's move on.
Copy

sudo a2enmod deflate

sudo a2ensite library


Paste it in the terminal and Press Enter.

Copy these two commands one by one, paste them on the terminal and press Enter.


sudo a2enmod deflate and press Enter.

sudo a2ensite library and press Enter.


The message on the terminal confirms that the site library is enabled.

Copy

sudo service apache2 restart

Paste it in the terminal and press Enter.

Copy this command from the Code file and paste it in the terminal.

And press Enter.

Copy

sudo su >> Enter

Paste it in the terminal and press Enter.

Then type sudo s u and press Enter.


We are now in the superuser that is root user mode.

Copy

mysql -u root -p >> Enter


Paste it in the terminal and Press Enter.

Copy this command from the Code file and paste it in the terminal.

Press Enter.

Type password >> Enter Type the password when prompted, admin123 and Press Enter.
We are now inside our MariaDB prompt.
Type

use mysql; >> Enter

At the MariaDB prompt, type

use mysql semicolon and press Enter.


This is to tell MariaDB to use mysql database.

Point to message The message displayed on the terminal says Database changed.
Point to mysql Notice the MariaDB prompt says mysql.
SET PASSWORD FOR 'koha_library'@'localhost' = PASSWORD('koha123'); Now type the following command carefully as shown and press Enter.


This will set the password for the user koha_library as koha123.

Point to “Query OK” We see a message on the terminal that says “Query OK”.
Type

flush privileges; >> Enter


Next type

flush privileges semicolon and press Enter.


This will update the latest changes.

Point to “Query OK” Once again we see a message on the terminal that says “Query OK”.
Type quit; >> Enter Lastly, type quit semicolon and press Enter to exit from Mariadb.
Root user prompt We are now back in the root user prompt.
Copy

sudo gedit /etc/koha/sites/library/koha-conf.xml

Press Enter

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


I will do so using gedit text editor.

Type

mysql >> Enter

In this file, search for the keyword mysql.
Highlight mysql Scroll down and locate this line.
Replace with 'koha123' Replace the alphanumeric value with 'koha123'.


Recall that this is the password we had set for our database earlier via the terminal.

Ctrl+S>> close the file Save the file and close the editor window.
Now open any web browser.


I will be opening Firefox web browser.

Firefox web browser >> 127.0.0.1:8080

Press Enter

In the address bar, type 127.0.0.1:8080 and press Enter.
The Koha web installer page appears on the browser.
Login with

username = koha_library

password = koha123

To login, use the credentials we set earlier.


I will type username as koha_library and password as koha123.


If you had given a different username and password, then type that in.

Click on Login button Now click on the Login button at the bottom right.
Highlight Step 1 We are in Step 1 of Koha web installer.
language drop-down >> en


In the language drop-down, select en for English, if it’s not already selected, by default.
Click on Next button Now click on the Next button at the bottom right.
Point to the 2 messages The window now displays 2 messages.


The messages confirm that all Perl modules and all dependencies are installed.

Click on Next button Click on the Next button at the bottom right.
Highlight Step 2 We are now in Step 2 – Database settings
Point to the values displayed Notice here all the values are what we gave earlier.
Click on Next button Then click on the Next button at the bottom.
Point to the message On doing so, we see a message that says “Connection established”.
Point to the messages This is followed by 2 more confirmation messages.
Click on Next button Click on the Next button at the bottom.
Highlight Step 3 We are brought to Step 3.
Click on Next button Read what is displayed on the screen and then click on the Next button.
Point to the success message Soon we will see a Success message on our screen.


This confirms that our database tables are created.

Click on Next button Now click on the Next button at the bottom to continue.
Immediately, we are brought to this screen.
Click on the link install basic configuration settings Read the displayed text and then click on the link install basic configuration settings.
Highlight MARC flavor


Select MARC21

On doing so, we are asked to select our MARC flavor.


I am going to select MARC21.

Click on Next button Then click on the Next button at the bottom.
Highlight Mandatory section


Point to the selected Default MARC21 checkboxes

In this screen, scroll down to the section Mandatory.


Here, we see that the Default MARC21 checkboxes are selected.

Highlight Optional section Under Optional section, select all the options as shown.
Scroll down

Highlight Other Data section

Point to the selected checkboxes

As we scroll down, we see that under Other data, all the checkboxes are already selected.
Scroll down Keep scrolling to the bottom of the page.
Highlight Optional section There is one more Optional section below, which is very long.
Locate the option “Some basic currencies” >> select it Here, locate the option “Some basic currencies” and select it.
Select the option “Useful patron attribute types” After this, select the option “Useful patron attribute types”.
Click on Import button Now go to the bottom of the page and click on the Import button.
This will enable all the selected functionalities in Koha.
New page We are now brought to a new page.
Scroll down Scroll down this page and read all the text displayed on the screen.
Point to the success message We can see a success message “All done”.
Click on Finish button Now, click on the Finish button.
Point to the message We see the final message on our screen, which confirms that our installation is successful.
We will now be moved to the Koha interface.
Type

username=koha_library

password=koha123

Type the username as koha_library and password as koha123.
Select My Library Select My Library from the drop-down.
Click on Login button Then click on the Login button.
We are brought to the Koha Administration page.
Point to the various tabs We can see various tabs on this page.


We will learn how to use many of these later in this series.

Click on No Library Set >> select the Logout Now, click on No Library Set and select the Logout option.
This brings us to the end of this tutorial.

Let us summarize.

Summary slide In this tutorial, we have learnt to
  • Install Koha Library Management System on Ubuntu Linux OS 16.04
  • and cross-verify the installation
Slide

About Spoken Tutorial project


The video at the following link summarises the Spoken Tutorial project.

Please download and watch it.

Slide:

Spoken Tutorial workshops

The Spoken Tutorial Project Team

  • Conducts workshops using spoken tutorials
  • Gives certificates for those who pass an online test
  • For more details, please write to contact@spoken-tutorial.org


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

For more details, please write to us.

Slide:

Forum for specific questions

  • Do you have questions in THIS Spoken Tutorial?
  • Please visit http://forums.spoken-tutorial.org
  • Choose the minute and second where you have the question
  • Explain your question briefly
  • Someone from our team will answer them


Post your timed queries in this Forum.
Slide 17

Acknowledgement

  • Spoken Tutorial Project is a part of the Talk to a Teacher project
  • It is supported by the National Mission on Education through ICT, MHRD, Government of India
  • More information on this Mission is available at

http://spoken-tutorial.org/NMEICT-Intro

[1]Spoken Tutorial project is funded by NMEICT, MHRD, Government of India.


More information on this mission is available at this link.

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, Pravin1389

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