Test major Koha Wiki changes or bug fixes here without fear of breaking the production wiki.
For the current Koha Wiki, visit https://wiki.koha-community.org .Koha 3.4 on Debian Squeeze (Git Method)
WARNING! This page is obsolete.
This page is no longer correct and exists for historical reasons only.
This guide assumes you are familiar with Debian, and that you have already setup a server with apache2 and mysql and have created a user (koha in this case) to install koha under and that said user has full sudo permissions. It is also tailored to those doing "dev" type installs, but can easily be adapted for "production" type installs.
Installing Koha
All the below steps can be and should be undertaken as the koha user!
su - koha
Software Dependencies
Update the apt sources to include "Indexdata"
sudo vim /etc/apt/sources.list
add the lines:
# Index Data
deb http://ftp.indexdata.dk/debian squeeze main
deb-src http://ftp.indexdata.dk/debian squeeze main
The Index Data packages are signed with a key you can install as follows;[note 1]
sudo wget http://ftp.indexdata.dk/debian/indexdata.asc --directory-prefix=/root
sudo apt-key add /root/indexdata.asc
Install dependencies: example script
Configure the cpan to enable installation of remaining perl module dependencies
cpan
This will take you through cpan configuration script, accepting the defaults is fine. Once complete, run;
install Bundle::CPAN
This installs the latest CPAN module and lots of helper modules and is a good test that cpan is working correctly.
Now install Perl Dependency Modules via CPAN: example script
Installing and Configuring MySQL
Ensureing the correct character encoding for koha;
sudo cp /usr/share/mysql/config.medium.ini /etc/my.cnf
Then add the following lines to the my.cnf;
[client]
default-character-set=utf8
[mysql]
default-character-set=utf8
[mysqld]
default-character-set=utf8
default-collation=utf8_unicode_ci
Restart mysql for changes to take effect:
sudo /etc/init.d/mysql restart
Creating the koha database (replace **** by your chosen kohaadmin password);
mysql -uroot -p'******'
mysql> CREATE DATABASE koha CHARACTER SET utf8 COLLATE utf8_bin;
mysql> GRANT ALL ON koha.* TO 'kohaadmin'@'localhost' IDENTIFIED BY '****';
mysql> FLUSH PRIVILEGES;
Koha
Download
Change to Koha home directory and download Koha source via git.
cd /home/koha
git clone git://git.koha-community.org/koha.git kohaclone
To keep things clean, create a new release tracking branch. (replace INSTALLNAME with whatever you want to call your install);
cd kohaclone
git checkout -b INSTALLNAME --track tag/v3.04.00
Installation
This follows the standard perl conventions. From within the kohaclone repository:
perl Makefile.PL
make
make install
To run from the git clone select a dev install. See the Koha INSTALL documentation for more info.
Fix any Dependancy issues mentioned after running Makefile.PL using instructions How_to_install_missing_Perl_modules_on_Debian and re-run Makefile.PL until no issues are flagged.
Setting Environment Variable
Add environment variables to ~/.bashrc (the actual values will differ depending on the answers to Makefile.PL) For a dev install:
export KOHA_CONF=/home/koha/koha-dev/etc/koha-conf.xml
export PERL5LIB=/home/koha/kohaclone
Configuring Apache2
Link /home/koha/koha-dev/etc/koha/koha-httpd.conf to /etc/apache2/sites-available/koha
sudo ln -s /home/koha/koha-dev/etc/koha-httpd.conf /etc/apache2/sites-available/koha
Add "Listen" on port 8080 directive to /etc/apache2/ports.conf;
sudo nano /etc/apache2/ports.conf
Configure final apache2 Settings, link the Koha site and Restart service to make settings stick;
sudo a2enmod rewrite
sudo a2ensite koha
sudo apache2ctl restart
You should now find the Koha on-line setup page at YOURHOST:8080.
- Notes
- ↑ file is downloaded and installed to roots home directory for cleanliness in this example
WARNING! This page is obsolete.
This page is no longer correct and exists for historical reasons only.