Koha Version- 3.06.02To install Koha latest version, visit this link.
Installation of Ubuntu 10.04 LTSVisit the link for installation steps with screen shots
http://techhamlet.com/2010/05/how-to-install-ubuntu-10-04/Installation of KohaType the following command in a terminal to get super user privilege.
To open terminal,
Application > Accessories > TerminalAll Linux commands should execute through Terminal.
sudo suUpdate your system,
sudo apt-get update Creating Koha system user
Open a Command Terminal and type following commands,
groupadd koha useradd -g koha koha sudo mkdir /build sudo chmod -R 777 /build Download Koha Download koha-3.06.02 package from
http://download.koha-community.org/koha-3.06.02.tar.gzExtract the package by right click and select "Extract to".
Copy Koha package to the folder /build
mv koha-3.06.02 /buildInstallation of dependenciesFollowing command will install MySQL, and Apache.
sudo apt-get install lamp-server^ yaz idzebra-2.0 dselect On the way, give root password for MySQL Root user when it ask.
cd /build/koha-3.06.02sudo dpkg --set-selections <install_misc/ubuntu.packages [Select Install from the list and Press Enter button] sudo dselect Select "
Install" option.
It began download packages from Internet. The length of this process depend on speed of your Internet connection.
Nullmailer will ask for email parameters. Accept the default values.
dselect menu will appear after the completion of the process. Select and press
Quit to exit from the deselect.
Configuration of UTF-8 in MySQL and Apache Enable UTF-8 at MySQL
Open a Terminal and type following command,
sudo gedit /etc/mysql/my.cnf [Under the Basic settings section, add the following,]
# UTF-8 Defaults for Koha init-connect='SET NAMES utf8' character-set-server=utf8 collation-server=utf8_general_ci Save the file
[ File > Save ] and close the editor.
UTF-8 encoding in Apache
Open a terminal and type the following command,
gedit /etc/apache2/conf.d/charset [Add the following two lines in]
AddCharset UTF-8 .utf8 AddDefaultCharset UTF-8 Save the file and close the editor.
Enter following command to set locale on Ubuntu
sudo update-locale LANG=en_IN.UTF-8 Creation of MySQL Database for KOHA
Open a terminal and login as root and enter following commands,
mysql -u root -p [enter mysql root password here]
Then type,
create database koha; grant all privileges on koha.* to 'kohaadmin'@'localhost' identified by 'katikoan'; flush privileges; quit;Test to make sure the SAX Parser is setup correctlyEnter the following commands,
cd /build/koha-3.06.02sudo gedit /etc/perl/XML/SAX/ParserDetails.iniCopy and paste the following command to the bottom of the file and save it.
[XML::LibXML::SAX::Parser]http://xml.org/sax/features/namespaces=1 Run the command again,
misc/sax_parser_print.plSetting environment variables gedit /etc/bash.bashrcAdd the following lines at the bottom and save the file
export KOHA_CONF=/etc/koha/koha-conf.xml export PERL5LIB=/usr/share/koha/libSave and close the file.
Koha Installation Now KOHA can be installed by following commands:
Enter into Koha folder
cd /build/koha-3.06.02perl Makefile.PL Answer all questions without any change. You can accepted the default values.
At the end you can see missing perl modules list. You have to install missing perl modules before proceed installation process.
Installation of remaining perl modulesOpen a terminal from Applications > Accessories > Terminal,
Enter the following command, it will give a CPAN command prompt.
sudo cpanAccept all default settings. Following is the example of CPAN command for installing a module.
install modulenamee.g.
install Business::ISBN
It ask for many confirmation on the way. Press Enter button for all questions.
In the same way install remaining perl modules.
Type
quit to Exit from the CPAN mode.
Type the following commands,
cd /build/koha-3.06.02perl Makefile.PL make make test sudo make install Add the following lines to /etc/apache2/ports.conf, just below the following line Listen 80
Open a Command Terminal and type following commands
sudo gedit /etc/apache2/ports.conf Listen 8000 Listen 8001save the file and close.
Open a terminal and login as root
sudo suln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha sudo a2enmod rewrite sudo a2ensite koha /etc/init.d/apache2 restart Zebra configuration Open a terminal copy paste the following commands.
sudo susudo ln -s /usr/share/koha/bin/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon sudo update-rc.d koha-zebra-daemon defaults sudo ln -s /usr/share/koha/bin/koha-zebraqueue-ctl.sh /etc/init.d/koha-zebraqueue-daemon sudo update-rc.d koha-zebraqueue-daemon defaults Open following files one by one and change the USER and GROUP parameters. And save the files.
sudo gedit /usr/share/koha/bin/koha-zebra-ctl.shsudo gedit /usr/share/koha/bin/koha-zebraqueue-ctl.shChange USER and GROUP to root.
#!/bin/bashUSER=rootGROUP=rootSet following folders ownership to Koha user
sudo chmod -R 777 /var/lock/kohasudo chown -R koha:koha /var/lock/kohasudo chmod -R 777 /var/lib/koha/sudo chown -R koha:koha /var/lib/koha Cronjob Settings sudo sucd /usr/share/koha/bin/cronjobs crontab -u root crontab.example crontab -u username
crontab.example [Username denotes name of your home user]
export EDITOR=geditcrontab -e Crontab will open in geditor.
You can change the timing of various automated activities like fine calculation, zebra etc.
Save and close the file.
Some settings for Apache,
sudo gedit /etc/koha/koha-httpd.confFind the following line,
## OPAC<VirtualHost 127.0.1.1:80>Change the port number
## OPAC<VirtualHost *:8001>Find this line too,
## Intranet<VirtualHost 127.0.1.1:8080>Change to
## Intranet<VirtualHost 127.0.1.1:8000>Save the file.
Goto command terminal and restart the Apaches server,
sudo /etc/init.d/apache2 restartRun the Web installer
http://127.0.1.1:8000It will open the Koha installer in you browser. To see the screen shots of Koha installer visit
http://openlib.org/home/krichel/courses/lis508/koha/installer_screens/Login the installer, User name:
kohaadmin Password:
katikoanRead the installer instructions carefully and proceed the post installation settings.
You can login to Koha after finishing this process
URL of OPAC is
http://127.0.1.1:8001Zebra Management These command are useful for rebuilding Zebra index while cataloging records.
Starting Zebra Server
Copy paste the following commands in a terminal and press enter button.
sudo susudo /etc/init.d/koha-zebra-daemon start sudo /etc/init.d/koha-zebraqueue-daemon startRebuilding Zebra Index
sudo KOHA_CONF=/etc/koha/koha-conf.xml PERL5LIB=/usr/share/koha/lib /usr/share/koha/bin/migration_tools/rebuild_zebra.pl -b -r -vQuick Indexing
sudo KOHA_CONF=/etc/koha/koha-conf.xml PERL5LIB=/usr/share/koha/lib /usr/share/koha/bin/migration_tools/rebuild_zebra.pl -b -w