Koha Installation

Koha-Installation of Koha18.05 on Ubuntu18.04 LTS


Step 1
: Open the Terminal:
To open the terminal, either you can search the Terminal or you can press CTRL+ALT+T together which will open terminal.

Step 2: Log in with Root Privilege:s
Once your terminal is ready, you need to log in with root privilege and for that run this command in terminal.
sudo su (Hit Enter) It will ask the password. Enter the password carefully as it will not be visible.
(Enter Password)

Step 3: Update the Ubuntu
In order to proceed with the Installation of koha, you need to update the system with the following command.
Run this command in terminal:
apt-get update



Step 4: Add a Koha community repository to the System:
Now, you need to add the koha channel into Ubuntu
Run the following command one after another in terminal
echo deb http://debian.koha-community.org/koha stable main | sudo tee /etc/apt/sources.list.d/koha.list
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -


After adding the channel successfully, update the system again with the following command:

apt-get update
Step 5: Installation of Koha:
Once your system is updated, run the following command to install the latest release of koha.

apt-get install koha-common
This command will enable the system to start downloading the koha with the required files and packages.
During downloading and installing, it may ask you to provide some input. Proceed with default values.
Step 7: Important Configuration on koha Server:
Koha Library Management System has two interfaces:
a. Koha Staff Interface which allows the Library Staff to carry out the library work in the system.
b. Koha Online Public Access Catalogue which works as a mirror to display the bibliographical details of the items entered in the system. Generally, the Online Public Access Catalogue is for library users to know about details of the items and their personal checkout history as well.
In this you have to configure two different ports for Koha Interface and Koha OPAC:
In order to change the port, open the (koha-sites.conf) file with any editor.
sudo nano /etc/koha/koha-sites.conf

Generally, I use two ports 80 for OPAC and 8000 for Interface. The reason I do this because I want to keep the port 80 free so that I can run any other application without any difficulty.
When the file is open I change the port
8000 - Koha OPAC (OPACPORT)
8001 - Koha Interface (INTRAPORT)
Find the lines in the file and make the changes accordingly.
OPACPORT="8000"
INTRAPORT="8001"

Step 8: Installation of MySQL Database:
To store the information, we require a database where we can store the information and use the same accordingly. This database will also enable us to take the backup for future use.
Run the following command in the terminal to install the MySQL database.
sudo apt-get install MySQL-server
          

While installing, the system may ask you to provide the password for root user of MySQL. Enter the password and keep the password safe as you will require this when you have to connect the MySQL database for any purpose mostly taking the backup.
or

Install MariaDB server
Here we use the MariaDB server instead of the MySQL server. Apply the following command to install the MariaDB server.
    sudo apt install mariadb-client-10.1
    sudo apt install mariadb-server
Assign Root password for MySQL
Apply following command,
sudo mysqladmin -u root password 
Enter Password

Step 9: Create the Koha Instance:
To stand in the safer side and avoid error before you create Koha Instance, run the following commands in order one after another.
sudo a2enmod rewrite
sudo a2enmod cgi

Step 10:Restart the Apache Server:
Run this command to restart the Apache Server.
sudo service apache2 stop
sudo service apache2 start
OR
sudo service apache2 restart

Step 11: Create an Instance with the name 'library':
To create the same, run this command:
sudo koha-create --create-db library

Step 12: Adding ports:
The ports which you have opted to run the Koha Interface and Koha OPAC, the same ports you will have to configure in Apache Server also.
To make changes, open the following file with any editor.
sudo nano /etc/apache2/ports.conf

Find the line Listen 80 in the file. You can use(CTRL+F) command to locate the words in the file.
Listen 80
Listen 8000
Listen 8001

Step 13:Now, Restart Apache Web Server,

sudo service apache2 restart
Enable modules and sites

sudo a2dissite 000-default
sudo a2enmod deflate
sudo a2ensite library
Now, Restart Apache Web Server,

sudo service apache2 restart

Generate the Master Password for Koha Web Installer:
Run this command to get the password:



Step 14: Start web installation of Koha
The username to log in with will be koha_library and the password can be located in the file /etc/koha/sites/library/koha-conf.xml
Apply the following command in terminal to see the koha login password,
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/library/koha-conf.xml
You may check the command at-/etc/koha/sites/library/koha-conf.xml



Step 15: Start Koha and finish the Installation with Web Installer:
Open following links,

http://127.0.1.1:8001 or http://localhost:8001 (Koha Staff client)
http://127.0.1.1:8000 or http://localhost:8000 (Koha Online Public Access Catalogue)

Once you log in with credentials, you will get the Web Installer of Koha. Just opt for the default settings and finish the Installation.

References:
  1. http://kohageek.blogspot.in/2015/05/install-koha-on-ubuntu-1404.html
  2. http://koha-community.org
  3. https://librarianadda.blogspot.com/p/koha.htm 


No comments:

Post a Comment