Koha-Library-Management-System/C2/Koha-installation-on-Linux-16.04/English
.
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.
|