Koha-Library-Management-System-24/C2/Installation-of-Koha-on-Ubuntu/English
Koha 24.05 installation on Linux 22.04
Title of the Script: Installation of Koha on Ubuntu
Author: Vaibhavi Satardekar and Maya Hans
Keywords: koha, koha library management system, koha installation step, MariaDB for Koha, Koha 24.05 tutorial, Koha database setup, video tutorial.
| Visual Cue | Narration |
| Slide 1
Title Slide |
Welcome to this Spoken Tutorial on Installation of Koha on Ubuntu. |
| Slide 2
Learning Objectives |
In this tutorial, we will learn to,
Install Koha Library Management System on Ubuntu Linux OS 22.04. |
| Slide 3
System Requirements |
This tutorial is recorded using:
|
| Slide 4
Pre-requisites |
Before you start, please ensure that your machine has the following:
|
| Slide 5
Hardware Requirements |
The minimum hardware requirements are:
|
| Slide 6
Code Files |
Commands used in this tutorial are provided in Code Files link below the player.
Please download and extract the file. Make a copy and use it while practising. |
| Switch to gedit text editor and open the file | I have opened the Code file using gedit text editor on my machine.
I will use the same file to copy-paste the commands during this tutorial. |
| Let’s begin. | |
| Ctrl + Alt + T keys | Press Ctrl, Alt, and T keys together to open the terminal. |
| Terminal:
sudo apt-get update >> Press Enter. |
Let us first update our Ubuntu Linux Installation.
For that, copy and paste the first command on the terminal. And press Enter. |
| Type System password >> Press Enter.
Terminal: copy and paste on the terminal and press Enter. |
From now on, type the System password whenever prompted during installation.
And press Enter. Wait for the update to complete. Now, on the prompt, I will copy and paste the next command and press Enter. |
| echo deb http://debian.koha-community.org/koha 24.05 main | sudo tee /etc/apt/sources.list.d/koha.list | This command will create a file named koha.list.
It updates the package repository. Please note: Koha 24.05 was the stable version at the time of creating this tutorial. |
| Terminal: copy and paste on the terminal and press Enter
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add - |
Let’s now copy and paste this command on the terminal and press Enter.
It will download the gpg.asc file and update the signature key. |
| Terminal: copy and paste on the terminal and press Enter
sudo apt-get update |
After this step is complete, copy this command, and paste it on the terminal.
And Press Enter. This will update the new repositories. |
| Terminal: copy and paste on the terminal and press Enter
sudo apt-get install koha-common |
Now copy the next command and paste it on the terminal and press Enter.
The command installs the main Koha package and its dependencies. |
| Press Y | When asked, Do you want to continue?
Type Y and press Enter. |
| Show the installation process. | This will install Koha on your system.
Please wait for the installation to complete. This may take some time depending on your internet connectivity. |
| sudo gedit /etc/koha/koha-sites.conf | Let us open the conf file in a text editor to change the port number for Koha. |
| Show text editor. | For this, I will use gedit text editor.
You can use any text editor of your choice. |
| Terminal: copy and paste on the terminal and press Enter | Copy this command and paste it on the terminal and press Enter.
koha-sites.conf file opens in the text editor. |
| Highlight INTRAPORT = "80" | Locate the line that says INTRAPORT = "80". |
| Show the Change 80 to 8080. | Change 80 to 8080.
This will change the port number to 8080. |
| Press Ctrl + S keys >> click on X button to close file | Now I will Save and close the file. |
| Cursor on the terminal. | Now we will move on to set up the database. |
| Terminal: copy and paste on the terminal and press Enter
sudo apt-get install mariadb-server |
Copy this command and paste it on the terminal and press Enter.
It installs a relational database management system known as MariaDB server. When asked, Do you want to continue? Type Y and press Enter. |
| Terminal: copy and paste on the terminal and press Enter
sudo mysqladmin -u root password admin123 |
Next copy this command and paste it on the terminal and press Enter.
This will set the password for the root user as admin123, for the database. For practicing this tutorial you may use the same password. However, if you wish to give a different password, please remember it. |
| Terminal: copy and paste on the terminal and press Enter
sudo a2enmod rewrite sudo a2enmod cgi |
Next copy-paste these two commands one by one on the terminal and press Enter.
This will enable the modules of Koha. |
| Type
sudo service apache2 restart >> Press Enter. |
Now copy-paste this command to restart the apache services. |
| Terminal: copy and paste on the terminal and press Enter
sudo koha-create --create-db library |
After this, let us create a Koha instance named library.
For this, copy and paste this command on the terminal and press Enter. |
| Terminal: copy and paste on the terminal and press Enter.
sudo gedit /etc/apache2/ports.conf |
Next, we have to tell the 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 and paste it on the terminal and press Enter. |
| Add 8080 | In the ports.conf file, search for the line Listen 80.
Next to that line, add Listen 8080. |
| Press Ctrl + S keys >> click on X button to close file | Now, Save and close the file. |
| Terminal: copy and paste on the terminal and press Enter
sudo service apache2 restart |
We will now restart the apache services.
Copy this command and paste it on the terminal and Press Enter. |
| Terminal: copy and paste on the terminal and press Enter
sudo a2dissite 000-default |
Command prompt will appear after the completion of this step.
Now, copy this command and paste it on the terminal and press Enter. This will disable the 000-default site. |
| Point to message | This message confirms that it is disabled. |
| Terminal: copy and paste on the terminal and press Enter
sudo a2enmod deflate >> press Enter. sudo a2ensite library >> press Enter. Point to the message. |
Let us move ahead.
Copy and paste these two commands one by one on the terminal and press Enter. The message on the terminal confirms that the site library is enabled. |
| Terminal: copy and paste on the terminal and press Enter
sudo service apache2 restart |
Copy this command and paste it on the terminal.
And press Enter. |
| Terminal: copy and paste on the terminal and press Enter.
sudo su >> Enter |
Then copy and paste this command on the terminal and press Enter.
This will make me a superuser, that is, I am now in the root user mode. |
| Terminal: copy and paste on the terminal and press Enter
mysql -u root -p >> press Enter. |
Now to login into MySQL as the root user.
Copy this command and paste it on the terminal. Then press Enter. |
| Type password >> press Enter. | Type the password as admin123 when prompted, and press Enter. |
| MariaDB prompt'. | We are now inside the MariaDB prompt. |
| Type
use mysql; >> press Enter. |
At the MariaDB prompt, copy and paste the following in the terminal and press Enter.
This is to tell MariaDB to use the mysql database. |
| Point to message | A message displayed on the terminal shows Database changed. |
| Point to mysql. | Notice the MariaDB prompt shows mysql. |
| SET PASSWORD FOR 'koha_library'@'localhost' = PASSWORD('koha123'); | Now copy-paste the following command carefully as shown and press Enter.
This will set the password for the user koha_library as koha123. |
| Point to “Query OK” | We see a message on the terminal that says Query OK. |
| Type
flush privileges; >> press Enter. |
Next copy-paste the following command
and press Enter. This will update the latest changes. |
| Point to “Query OK” | Once again we see a message on the terminal, Query OK. |
| Type quit; >> Enter | Lastly, copy and paste the following command on the terminal.
And press Enter to exit from the Mariadb. |
| Root user prompt | We are now back in the root user prompt. |
| Terminal: copy and paste on the terminal and press Enter
sudo gedit /etc/koha/sites/library/koha-conf.xml |
Now let us open the koha-conf.xml file using gedit text editor.
For that copy and paste the following command on the terminal and press Enter. This will open an editable Koha configuration file with superuser privileges. |
| Type
mysql >> press Enter. |
In this file, search for the keyword mysql. |
| Highlight mysql | Scroll down and locate the alphanumeric password. |
| Replace with koha123 | We will replace the alphanumeric value with koha123.
Recall that this is the password we had set for our database earlier. |
| Ctrl + S >> close the file | Now Save the file and close the editor window. |
| Terminal window | With this we have completed the basic setup for koha.
To check our koha installation, I will open Firefox web browser. |
| Firefox web browser >> 127.0.0.0:8080
Press Enter. |
In the address bar, type 127 point 0 point 0 point 0 colon 8080 and press Enter. |
| Show the webpage | The Koha web installer page appears on the browser.
This confirms the successful installation of Koha. In the tutorials ahead we will explore the Koha interface in detail. |
| Narration only | This brings us to the end of this tutorial. |
| Slide 7
Summary |
Let's summarize.
In this tutorial, we have learned to,
|
| Slide 8
About Spoken Tutorial project
|
The video at the following link summarises the Spoken Tutorial project.
Please download and watch it. |
| Slide 9
Spoken Tutorial workshops The Spoken Tutorial Project Team
|
The Spoken Tutorial Project team:
For more details, please write to us. |
| Slide 10
Forum for specific questions
|
|
| Slide 11
Acknowledgment The Spoken Tutorial project was established at IIT Bombay by the Ministry of Education Govt of India |
Thank you for joining. |
