Difference between revisions of "Koha-Library-Management-System/C2/Koha-installation-on-Linux-16.04/English"
PoojaMoolya (Talk | contribs) |
Nancyvarkey (Talk | contribs) m (Protected "Koha-Library-Management-System/C2/Koha-installation-on-Linux-16.04/English" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))) |
||
(2 intermediate revisions by 2 users not shown) | |||
Line 14: | Line 14: | ||
* Install '''Koha Library Management System''' on '''Ubuntu Linux OS 16.04''' | * Install '''Koha Library Management System''' on '''Ubuntu Linux OS 16.04''' | ||
* and cross-verify the installation | * and cross-verify the installation | ||
− | |||
− | |||
|- | |- | ||
Line 25: | Line 23: | ||
# '''gedit text editor''' and | # '''gedit text editor''' and | ||
# '''Firefox web browser''' | # '''Firefox web browser''' | ||
− | |||
− | |||
|- | |- | ||
Line 35: | Line 31: | ||
# any '''text editor''' | # any '''text editor''' | ||
# either '''Firefox''' or''' Google Chrome web browser''' | # either '''Firefox''' or''' Google Chrome web browser''' | ||
− | |||
− | |||
|- | |- | ||
Line 42: | 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 72: | Line 68: | ||
− | For that copy this command from the ''' | + | For that copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. |
+ | |||
+ | And press '''Enter.''' | ||
|- | |- | ||
|| System password >> Enter | || System password >> Enter | ||
− | || From now on type the '''System password '''whenever prompted during installation | + | || From now on, type the '''System password '''whenever prompted during installation. |
+ | |||
+ | And press '''Enter''' | ||
|- | |- | ||
Line 83: | Line 83: | ||
''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.''' | + | || This '''command''' will create a file named '''koha.list''' and update the '''package repository.''' |
Line 95: | Line 95: | ||
''Paste in '''terminal '''''and Press '''Enter.''' | ''Paste in '''terminal '''''and Press '''Enter.''' | ||
− | || Copy this command from the ''' | + | || Copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. |
− | + | ||
− | + | ||
+ | And press '''Enter.''' | ||
|- | |- | ||
Line 108: | Line 107: | ||
Paste in '''terminal''' and Press '''Enter.''' | Paste in '''terminal''' and Press '''Enter.''' | ||
− | || Then this will download '''gpg.asc file''' and update the '''signature key'''. | + | || 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.''' | |
|- | |- | ||
Line 120: | Line 121: | ||
Paste in '''terminal''' and Press '''Enter.''' | Paste in '''terminal''' and Press '''Enter.''' | ||
+ | || Now copy this '''command''' from the '''Code file''' and paste it in the '''terminal'''. | ||
− | + | And press '''Enter.''' | |
− | + | ||
− | + | ||
Line 135: | Line 135: | ||
Paste in '''terminal''' and Press '''Enter.''' | Paste in '''terminal''' and Press '''Enter.''' | ||
− | || Now type sudo apt-get install koha-common and | + | || Now type '''sudo apt-get install koha-common''' and press '''Enter.''' |
|- | |- | ||
|| Press Y | || Press Y | ||
− | || Press '''Y '''when asked if you want to continue and | + | || Press '''Y '''when asked if you want to continue and press '''Enter''' |
|- | |- | ||
Line 153: | 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 166: | Line 166: | ||
Paste in '''terminal''' 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 208: | Line 204: | ||
Paste in '''terminal''' 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''' | |
− | + | ||
− | + | ||
− | Press''' Y '''when asked if you want to continue and | + | |
|- | |- | ||
Line 223: | Line 218: | ||
Paste in '''terminal''' and Press '''Enter.''' | 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.''' | |
|- | |- | ||
Line 243: | Line 237: | ||
Paste them on the '''terminal''' and press '''Enter'''. | Paste them on the '''terminal''' and press '''Enter'''. | ||
− | || Next | + | || Next copy these two commands one by one, paste them on the '''terminal''' and press '''Enter'''. |
− | + | ||
− | + | ||
Line 265: | Line 257: | ||
− | This will restart '''apache services ''' | + | This will restart '''apache services '''. |
+ | |||
+ | Then press '''Enter'''. | ||
|- | |- | ||
Line 274: | Line 268: | ||
Paste it in the '''terminal''' and Press '''Enter.''' | Paste it in the '''terminal''' and Press '''Enter.''' | ||
− | || To create a '''Koha instance''' named '''library''' | + | || To create a '''Koha instance''' named '''library'''- |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
+ | : Copy this '''command''' from the '''Code file '''and paste it in the '''terminal''' | ||
+ | : and press '''Enter.''' | ||
|- | |- | ||
Line 289: | Line 280: | ||
Paste it in the '''terminal''' and Press '''Enter.''' | 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.''' | |
|- | |- | ||
Line 317: | Line 307: | ||
paste it in the '''terminal''' and Press '''Enter.''' | paste it in the '''terminal''' and Press '''Enter.''' | ||
− | |||
− | |||
− | |||
|| Then restart '''apache services.''' | || Then restart '''apache services.''' | ||
− | Copy this command from the ''' | + | Copy this '''command''' from the '''Code file '''and paste it in the '''terminal'''. |
− | + | ||
− | + | ||
+ | And press '''Enter.''' | ||
|- | |- | ||
Line 335: | Line 321: | ||
Paste it in the '''terminal''' 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 348: | Line 330: | ||
|- | |- | ||
|| Point to message | || Point to message | ||
− | || The message confirms that it is | + | || The message confirms that it is disabled. |
|- | |- | ||
Line 363: | Line 345: | ||
Paste it in the '''terminal''' and Press '''Enter.''' | Paste it in the '''terminal''' and Press '''Enter.''' | ||
− | + | || Copy these two '''commands''' one by one, paste them on the '''terminal''' and press '''Enter'''. | |
− | + | ||
− | + | ||
− | || Copy | + | |
Line 379: | Line 358: | ||
|| Copy | || Copy | ||
− | sudo | + | 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'''. | |
− | + | ||
− | + | ||
− | Then type '''sudo | + | |
Line 401: | Line 382: | ||
Paste it in the '''terminal''' and Press '''Enter.''' | Paste it in the '''terminal''' and Press '''Enter.''' | ||
− | || Copy this command from the ''' | + | || 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'''. | ||
− | + | |- | |
− | || | + | | |
− | + | |We are now inside our '''MariaDB prompt'''. | |
− | + | ||
− | We are now inside our '''MariaDB prompt'''. | + | |
|- | |- | ||
Line 437: | Line 416: | ||
|- | |- | ||
|| | || | ||
− | || Now type the following command carefully as shown and press '''Enter'''. | + | || Now type the following '''command''' carefully as shown and press '''Enter'''. |
Line 466: | 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 490: | Line 467: | ||
mysql >> Enter | mysql >> Enter | ||
− | || In this file, search for the '''keyword mysql''' | + | || In this file, search for the '''keyword mysql'''. |
|- | |- | ||
Line 515: | Line 492: | ||
|- | |- | ||
− | || Firefox web browser >> 127.0. | + | || Firefox web browser >> 127.0.0.1:8080 |
Press Enter | Press Enter | ||
− | || In the '''address bar''', type '''127.0. | + | || In the '''address bar''', type '''127.0.0.1:8080''' and press '''Enter'''. |
|- | |- | ||
Line 692: | Line 669: | ||
|- | |- | ||
− | || Click on | + | || Click on '''Finish''' button |
|| Now, click on the '''Finish '''button. | || Now, click on the '''Finish '''button. | ||
Line 732: | Line 709: | ||
|- | |- | ||
|| Click on '''No Library Set''' >> select the '''Logout''' | || Click on '''No Library Set''' >> select the '''Logout''' | ||
− | || Now, click on '''No Library Set''' | + | || Now, click on '''No Library Set''' and select the '''Logout''' option. |
|- | |- | ||
Line 746: | Line 723: | ||
* Install '''Koha Library Management System''' on '''Ubuntu Linux OS 16.04''' | * Install '''Koha Library Management System''' on '''Ubuntu Linux OS 16.04''' | ||
* and cross-verify the installation | * and cross-verify the installation | ||
− | |||
− | |||
|- | |- | ||
Line 762: | Line 737: | ||
Please download and watch it. | Please download and watch it. | ||
− | |||
− | |||
− | |||
|- | |- |
Revision as of 16:35, 21 February 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
|
System requirements | This tutorial is recorded using
|
Pre-requisites | Before you start, please ensure that your machine has-
|
Hardware requirements | The minimum hardware requirements are-
|
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.
|
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.
And press Enter. |
System password >> Enter | From now on, type the System password whenever prompted during installation.
And press Enter |
Select
|
This command will create a file named koha.list and update the package repository.
|
Copy
echo deb http://debian.koha-community.org/koha 16.05 main | sudo tee /etc/apt/sources.list.d/koha.list
|
Copy this command from the Code file and paste it in the terminal.
And press Enter. |
Copy
|
Then, this will download gpg.asc file and update the signature key.
And press Enter. |
Copy
Paste in terminal and Press Enter. |
Now copy this command from the Code file and paste it in the terminal.
And press Enter.
|
Copy
sudo apt-get install koha-common
|
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.
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
|
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.
|
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
|
Copy this command from the Code file and paste it in the terminal.
And press Enter.
|
Copy
sudo mysqladmin -u root password admin123
|
Next set the password for root user as admin123 for the database.
Press Enter. |
Copy
sudo a2enmod rewrite sudo a2enmod cgi
|
Next copy these two commands one by one, paste them on the terminal and press Enter.
|
Type
sudo service apache2 restart >> Enter |
Then type
sudo service apache2 restart
Then press Enter. |
Copy
Paste it in the terminal and Press Enter. |
To create a Koha instance named library-
|
Copy:
Paste it in the terminal and Press Enter. |
Next, we have to tell Apache server that we are using port 8080.
And press Enter. |
Add 8080 | In the ports.conf file, search for the line Listen 80
|
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.
And press Enter. |
Copy
sudo a2dissite 000-default
|
Next copy this command from the Code file and paste it in the terminal.
And press Enter.
|
Point to message | The message confirms that it is disabled. |
Let's move on. | |
Copy
sudo a2enmod deflate sudo a2ensite library
|
Copy these two commands one by one, paste them on the terminal and press Enter.
sudo a2ensite library and press Enter.
|
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.
|
Copy
mysql -u root -p >> 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.
|
Point to message | The message displayed on the terminal says Database changed. |
Point to mysql | Notice the MariaDB prompt says mysql. |
Now type the following command carefully as shown and press Enter.
| |
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.
|
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.
|
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'.
|
Ctrl+S>> close the file | Save the file and close the editor window. |
Now open any 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.
|
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.
|
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.
|
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
|
On doing so, we are asked to select our MARC flavor.
|
Click on Next button | Then click on the Next button at the bottom. |
Highlight Mandatory section
|
In this screen, scroll down to the section Mandatory.
|
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.
|
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
|
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
|
The Spoken Tutorial Project team:
For more details, please write to us. |
Slide:
Forum for specific questions
|
Post your timed queries in this Forum. |
Slide 17
Acknowledgement
|
[1]Spoken Tutorial project is funded by NMEICT, MHRD, Government of India.
|
The script has been contributed by Nancy and video by Praveen.
|