Koha/Installation

From Libopedia
Jump to navigation Jump to search

Introduction

It is strongly recommended that you use the "packages" installation method which is designed to simplify and streamline the installation, configuration and upgrades of Koha.

Step 1 - Install Ubuntu 12.04 LTS server software on a bare metal or virtual machine.

  • During installation create a "koha" admin user.

Step 2 - Install the LAMP stack

Step 3 - Enable the Koha software repository

  • After installation add the following to /etc/apt/sources.list.d/koha.list.
echo deb http://debian.koha-community.org/koha squeeze main | sudo tee /etc/apt/sources.list.d/koha.list
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -
  • Do a software upgrade.
sudo apt-get update
sudo apt-get dist-upgrade

Step 4 - Install Koha packages

  • Install the koha packages
sudo apt-get install koha koha-common bibutils etckeeper

Step 5 - Initial configuration

Read the after installation README file for details.

cat /usr/share/doc/koha/README.Debian | less

Step 6 - Prepare the Apache2 web server

  • Setup apache2 modules
sudo a2enmod rewrite suexec deflate 
  • Disable the default websites.
sudo a2dissite 000-default default default-ssl

The only web site enabled should be koha in the /etc/apache2/sites-enabled folder.

  • Restart the apache2 web server
sudo service apache2 restart

Step 7 - Do the Koha web installation

  • Reboot the server and then connect to the following URL to configure the KOHA webapp.
http://name-of-koha-server:8080

The user name to log in with will be koha and the password will be near the end of /etc/koha/koha-conf.xml

To view the password, use this command:

sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/koha-conf.xml

Click on one of the screenshots below to view webapp config.

Koha-1.png

Koha-2.png

Koha-3.png

Koha-4.png

Koha-5.png

Koha-6.png

Koha-7.png

Koha-8.png

Koha-9.png

Koha-10.png

Return to Koha wiki page