Quantcast
Channel: Koha Geek
Viewing all articles
Browse latest Browse all 155

Install Koha on Debian 9 (Stretch)

$
0
0
Install Debian Linux
Download Debian 64 bit from the following link and burn in a CD/DVD/Pen Drive.
https://cdimage.debian.org/debian-cd/current/amd64/iso-cd/debian-9.0.0-amd64-xfce-CD-1.iso

See the below video and familiar with the installation process of Debian 9.



Write down root password and usernames in a diary or a piece of paper.

Prepare Debian sources list
After installation, Debian sources list might not be enabled.

Open a command terminal,
Applications > System Tools > XFCE Terminal and open sources list.

Become Root user,

su  [Enter Root Password]

nano /etc/apt/sources.list


Notice step 1 and 2 marking.
Move the cursor using up and down arrow key board button.
Delete the # character from the beginning of the lines.

Notice Step 3.
Copy and paste following two lines at the bottom of the file,

deb http://ftp.us.debian.org/debian/ stretch main contrib non-free
deb-src http://ftp.us.debian.org/debian/ stretch main contrib non-free

Save the file, Press Ctrl+O button.
Exit from the file, Press Ctl+X button.

Update Debian Linux
Apply following commands,

apt-get update [If any error show, please check again the sources.list]
apt-get upgrade

Install Chromium browser
Default browser has a problem [bug] while open. Install Chromium browser.

apt-get install chromium

Install sudo in Debian
Sudo is a tool available default with Ubuntu, which allows users to execute administrative tasks (e.g. installation, remove etc). Sudo tool can ease the input of commands same like in Ubuntu.

Apply following commands,

apt-get update
apt-get install sudo
adduser username sudo [Replace username with the username of your pc, e.g. koha]

Restart/Logout computer to start sudo tool.

Install Leafpad text editor
Leafpad is a lightweight text editor, which required to open configuration files while the installation process of Koha. 

sudo su
apt-get install leafpad 

Add Koha community repository
Add Koha software channel into Ubuntu. 

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 -


apt-get update

Install Koha
The following command will install latest release of Koha.

apt-get install koha-common 

Server configuration
In this step, need to edit network information like domain name and port numbers.

sudo leafpad /etc/koha/koha-sites.conf

Here I change port number of Koha staff client to 8080. Find the following line in the file and make changes.

INTRAPORT="8080"


Install MySQL server
Apply the following command to install MySQL server.

sudo apt-get install mysql-server

Give a new password for root user while installation.

Koha instance creation
Apply following commands to create Apache configuration files.

sudo a2enmod rewrite
sudo a2enmod cgi
sudo service apache2 restart


Create a Koha instance with the name library. 

sudo koha-create --create-db library

Add new port
We have assigned 8080 port for the Koha staff client and 80 for OPAC.
Open following file and add new port.

sudo leafpad /etc/apache2/ports.conf

Copy paste following line below Listen 80

Listen 8080

Restart Apache,

sudo service apache2 restart


Enable modules and sites

sudo a2dissite 000-default
sudo a2enmod deflate
sudo a2ensite library
sudo service apache2 restart


Change Koha default master password
See the following link
http://kohageek.blogspot.in/2013/05/how-to-change-master-password-of-koha.html


Install missing PERL modules
After install need to install some PERL PERL modules using CPAN.

Koha > About Koha > Perl Modules

Find missing PERL modules in different colors.

Open a terminal and apply following command to enable CPAN.

sudo su
cpan

To install a particular PERL module, e.g.

install Test::DBix::Class

How to start Koha
Open following links,

http://127.0.1.1:8080 (Stff client)
http://127.0.1.1:80 (Online catalogue)


Reference
https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages
https://wiki.koha-community.org/wiki/Koha_on_Debian






Viewing all articles
Browse latest Browse all 155

Trending Articles