Difference between revisions of "Koha-Library-Management-System/C2/Koha-installation-on-Linux-16.04/English"
Pravin1389 (Talk | contribs) |
Nancyvarkey (Talk | contribs) |
||
Line 15: | Line 15: | ||
* 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 26: | Line 24: | ||
# '''gedit text editor''' | # '''gedit text editor''' | ||
# '''Firefox web browser''' | # '''Firefox web browser''' | ||
− | |||
− | |||
|- | |- | ||
Line 36: | Line 32: | ||
# any '''text editor''' | # any '''text editor''' | ||
# either '''Firefox''' or''' Google Chrome web browser''' | # either '''Firefox''' or''' Google Chrome web browser''' | ||
− | |||
− | |||
|- | |- | ||
Line 47: | Line 41: | ||
* minimum 4GB RAM and | * minimum 4GB RAM and | ||
* Network facility | * Network facility | ||
− | |||
− | |||
|- | |- | ||
Line 62: | Line 54: | ||
sudo apt-get update >> Enter | sudo apt-get update >> Enter | ||
− | |||
Line 92: | Line 83: | ||
|- | |- | ||
|| Type | || Type | ||
− | |||
''wget -O- [http://debian.koha-community.org/koha/gpg.asc http://debian.koha-community.org/koha/gpg.asc] | sudo apt-key add -'' | ''wget -O- [http://debian.koha-community.org/koha/gpg.asc http://debian.koha-community.org/koha/gpg.asc] | sudo apt-key add -'' | ||
− | |||
Press Enter. | Press Enter. | ||
Line 117: | Line 106: | ||
− | This | + | This will update the new '''repositories'''. |
|- | |- | ||
Line 141: | Line 130: | ||
|- | |- | ||
− | || | + | || |
− | || 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 171: | Line 160: | ||
− | This will change the port number to '''8080'''. | + | This will change the '''port number''' to '''8080'''. |
|- | |- | ||
Line 200: | Line 189: | ||
− | You could give a different password if you wish. | + | You could give a different '''password''' if you wish. |
Line 221: | Line 210: | ||
|- | |- | ||
− | || | + | || Type |
− | + | ||
− | Type | + | |
sudo service apache2 restart >> Enter | sudo service apache2 restart >> Enter | ||
Line 344: | Line 331: | ||
− | + | || Type the '''password''' when prompted - '''admin123'''. | |
− | || Type the '''password''' when prompted. | + | |
Line 356: | Line 342: | ||
|| At the '''MariaDB prompt''', type | || At the '''MariaDB prompt''', type | ||
− | '''use mysql semicolon ''' | + | '''use mysql semicolon ''' |
This is to tell '''MariaDB''' to use '''mysql database.''' | This is to tell '''MariaDB''' to use '''mysql database.''' | ||
+ | |||
+ | Press '''Enter'''. | ||
|- | |- | ||
Line 367: | Line 355: | ||
|- | |- | ||
|| Point to mysql | || Point to mysql | ||
− | || Notice the '''MariaDB prompt '''says '''mysql.''' | + | || Notice that the '''MariaDB prompt '''says '''mysql.''' |
|- | |- | ||
Line 434: | Line 422: | ||
− | I will | + | I will be doing so using '''gedit text editor.''' |
Line 446: | Line 434: | ||
koha_library >> Enter | koha_library >> Enter | ||
|| In this file, search for the '''keyword 'koha_library'''' and press '''Enter'''. | || In this file, search for the '''keyword 'koha_library'''' and press '''Enter'''. | ||
− | |||
|- | |- | ||
− | || | + | ||Highlight mysql |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | Highlight mysql | + | |
|| Scroll down and locate this line. | || Scroll down and locate this line. | ||
Line 534: | Line 515: | ||
|- | |- | ||
− | || | + | ||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 | + | || Notice here all the values are what we gave earlier. |
|- | |- | ||
Line 639: | Line 618: | ||
|- | |- | ||
− | || | + | || Click on '''Import '''button |
− | + | ||
− | Click on '''Import '''button | + | |
|| 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. | ||
Line 649: | Line 626: | ||
|- | |- | ||
− | || | + | || |
|| We are now brought to a new page. | || We are now brought to a new page. | ||
Line 688: | Line 665: | ||
|- | |- | ||
− | || Click on | + | || Click on '''Login '''button |
|| Then click on the '''Login''' button. | || Then click on the '''Login''' button. | ||
Line 697: | Line 674: | ||
|- | |- | ||
|| 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. |
|- | |- | ||
|| 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 718: | Line 695: | ||
* 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 729: | Line 704: | ||
* 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 748: | Line 719: | ||
* 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 | + | |
− | + | ||
− | + | ||
− | + | ||
For more details, please write to us. | For more details, please write to us. | ||
Line 767: | Line 733: | ||
* 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 780: | Line 744: | ||
* More information on this Mission is available at http://spoken-tutorial.org/NMEICT-Intro | * More information on this Mission is available at http://spoken-tutorial.org/NMEICT-Intro | ||
− | '''Spoken Tutorial '''project is funded by '''NMEICT, MHRD, Government of India.''' | + | |'''Spoken Tutorial '''project is funded by '''NMEICT, MHRD, Government of India.''' |
Revision as of 07:34, 26 September 2018
.
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-
|
Let’s begin. | |
Ctrl+Alt+T keys | Open the terminal by pressing Ctrl+Alt+T keys simultaneously on the keyboard. |
Type
sudo apt-get update >> Enter
|
We have to first of all ensure that our Ubuntu Linux installation is up-to-date.
|
Type admin password >> Enter | Type the admin password when prompted. |
Type
|
Now type this command carefully and press Enter.
|
Type
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add - Press Enter. |
Then type this command as shown on the terminal and press Enter.
|
Type
|
Now press up arrow key to recall this command on the terminal.
|
Type
sudo apt-get install koha-common >> Enter |
Now type-
sudo apt-get install koha-common and press Enter. |
Press Y | Press Y when asked if you want to continue. |
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. | |
type
sudo gedit /etc/koha/koha-sites.conf >> Enter |
So on the terminal I will type
sudo gedit /etc/koha/koha-sites.conf 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. | |
Type
sudo apt-get install mariadb-server >> Enter |
So type sudo apt-get install mariadb-server and press Enter. |
Type
sudo mysqladmin -u root password admin123 >> Enter |
Then type-
sudo mysqladmin -u root password admin123 and press Enter.
|
Type
sudo a2enmod rewrite >> Enter sudo a2enmod cgi >> Enter |
Next type
sudo a2enmod rewrite and press Enter. sudo a2enmod cgi and press Enter.
|
Type
sudo service apache2 restart >> Enter |
Then type
sudo service apache2 restart and press Enter.
|
Type:
|
To create a Koha instance named library, type the following command
|
Type:
|
Next we have to tell Apache server that we are using port 8080.
Once again, I will use gedit text editor. So type-
|
Add 8080 | In the ports.conf file, search for the line Listen 80
|
Ctrl+S >> close file | Then save and close the file. |
Type
sudo service apache2 restart >> Enter |
Now type
sudo service apache2 restart and press Enter.
|
Type
sudo a2dissite 000-default |
Next type
sudo a2dissite 000-default and press Enter.
|
Point to message | The message confirms that it is already disabled. |
Let's move on. | |
Type
sudo a2enmod deflate >> Enter sudo a2ensite library >> Enter |
Type
sudo a2enmod deflate and press Enter. sudo a2ensite library and press Enter.
|
sudo service apache2 restart and press Enter. | Using the up arrow key, recall the command shown on the screen. |
Type
sudo su >> Enter |
Then type
sudo su and press Enter.
|
Type
mysql -u root -p >> Enter |
At the prompt, type
mysql -u root -p and press Enter. |
Type password >> Enter
|
Type the password when prompted - admin123.
|
Type
use mysql; >> Enter |
At the MariaDB prompt, type
use mysql semicolon
Press Enter. |
Point to message | The message displayed on the terminal says Database changed. |
Point to mysql | Notice that the MariaDB prompt says mysql. |
Now type the following command carefully as shown and press Enter.
| |
Only to be shown in Visual Cue and not to be narrated.
SET PASSWORD FOR 'koha_library'@'localhost' = PASSWORD('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.
|
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. |
Type exit; >> Enter | Type exit semicolon and press Enter. |
User prompt | This will exit us from root user login.
|
Type
sudo gedit /etc/koha/sites/library/koha-conf.xml Press Enter |
We will now open the koha-conf.xml file in a text editor.
sudo gedit /etc/koha/sites/library/koha-conf.xml and press Enter. |
Type
koha_library >> Enter |
In this file, search for the keyword 'koha_library' and press Enter. |
Highlight mysql | Scroll down and locate this line. |
Highlight <pass>5NT......</pass> | Then 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.1.1:8080
Press Enter |
In the address bar, type 127.0.1.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. | |
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 conducts workshops and gives certificates.
For more details, please write to us. |
Slide:
Forum for specific questions
|
Post your timed queries in this Forum. |
Slide 17
Acknowledgement
|
Spoken Tutorial project is funded by NMEICT, MHRD, Government of India.
|
The script has been contributed by Nancy and video by Praveen.
|