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: Login with Root Privilege:s
Once your terminal is ready, you need to login with root privilege and for that run this command in terminal.
sudo su (Hit Enter) It will ask password. Enter the password carefully as it will not be visible.
(Enter Password)
Step 3: Update the Ubuntu
In order to proceed with Installation of koha, you need to update the system with the following command.
Run this command in terminal:
apt-get update
Step 4: Add 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 required files and packages.
During downloading and installing, it may ask you 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, 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.
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)
Fine the lines in file and make the changes accordingly.
OPACPORT="8000"
INTRAPORT="8001"
To
store the information, we require a database where we can store the
information and use the same accordingly. This database will also enable
to take the backup for future use.
Run the following command in terminal to install the MySQL database.
sudo apt-get install mysql-server
While installing, system may ask you to provide the password for root user of MySQL. Enter the password and keep the password safely as you will require this when you have to connect the MySQL database for any purpose mostly taking the backup.
Step 9: Create the Koha Instance:
While installing, system may ask you to provide the password for root user of MySQL. Enter the password and keep the password safely 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 MariaDB server instead of MySQL server. Apply the following command to install the MariaDB server.
sudo apt install mariadb-client-10.3
sudo apt install mariadb-server
Assign Root password for MySQL
Apply following command,
sudo mysqladmin -u root password
Enter Password
To stand in 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
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 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.
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 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
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:
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:
http://127.0.1.1:8000 or http://localhost:8000 (Koha Online Public Access Catalogue)
Once you login with credentials, you will get the Web Installer of Koha. Just opt the default settings and finish the Installation.
References:
Once you login with credentials, you will get the Web Installer of Koha. Just opt the default settings and finish the Installation.
References:
