e6ee69b4a3
[1] Map new directory misc/bin to SCRIPT_DIR
instead of SCRIPT_DIR/bin.
[2] rewrite-config.PL no longer removes execute mode
[3] Add new Zebra startup script to rewrite-config.PL
list.
[4] Added KOHA_USER and KOHA_GROUP to rewrite-config.PL
Signed-off-by: Joshua Ferraro <jmf@liblime.com>
229 lines
7.6 KiB
Text
229 lines
7.6 KiB
Text
=============================
|
|
Installation Guide for Installing Koha on Debian Etch with MySQL 5
|
|
=============================
|
|
|
|
Copyright (C) 2007, LibLime
|
|
|
|
Maintainer: Joshua Ferraro (jmf AT liblime DOT com)
|
|
Feedback/bug reports: jmf AT liblime DOT com
|
|
This document last modified: 22 December 2007
|
|
|
|
Installation Instructions
|
|
=============================
|
|
|
|
All commands can be performed as a system user with sudo privileges,
|
|
or by running the command directly as root.
|
|
|
|
Your locale should be set to UTF-8, as should Apache and MySQL.
|
|
This step is VERY IMPORTANT for a UNICODE compliant system. Please
|
|
read over the following document carefully:
|
|
|
|
http://wiki.koha.org/doku.php?id=encodingscratchpad
|
|
|
|
1. Prepare System and Install Dependencies
|
|
|
|
1.1 Install Debian Etch via Businesscard CD
|
|
|
|
See http://www.debian.org/devel/debian-installer/
|
|
|
|
1.2 Set up apt sources for Git, Yaz and Zebra packages
|
|
|
|
Edit your /etc/apt/sources.list file and add the following:
|
|
|
|
# Index Data
|
|
deb http://ftp.indexdata.dk/debian etch main
|
|
deb-src http://ftp.indexdata.dk/debian etch main
|
|
|
|
# Backports
|
|
deb http://www.backports.org/debian etch-backports main contrib non-free
|
|
|
|
Backports packages are signed with a key you can install as follows:
|
|
|
|
$ sudo apt-get install debian-backports-keyring
|
|
|
|
The Index Data packages are signed with a key you can install as follows:
|
|
|
|
$ wget http://ftp.indexdata.dk/debian/indexdata.asc
|
|
$ sudo apt-key add indexdata.asc
|
|
|
|
Run the following command to update your system:
|
|
|
|
$ sudo apt-get update
|
|
$ sudo apt-get -t etch-backports install git-core git-email
|
|
$ sudo apt-get install yaz idzebra-2.0 idzebra-2.0-doc
|
|
|
|
1.3 Download Koha via Git
|
|
|
|
$ git clone git://git.koha.org/pub/scm/koha.git kohaclone
|
|
$ cd kohaclone
|
|
$ git checkout -b myinstall origin
|
|
|
|
Note: for more information about Git, please see the Koha Git Usage Guide:
|
|
|
|
http://wiki.koha.org/doku.php?id=en:development:git_usage
|
|
|
|
1.4 Install additional Debian dependencies
|
|
|
|
Using the debian.packages file included in the Koha source tree,
|
|
run the following:
|
|
|
|
$ sudo dpkg --set-selections < install_misc/debian.packages
|
|
|
|
Now start dselect:
|
|
|
|
$ sudo dselect
|
|
|
|
Choose [I]nstall and accept packages to be installed (hit return)
|
|
|
|
(may take a while)
|
|
|
|
Choose [C]onfigure, [R]emove and [Q]uit until dselect has completed.
|
|
|
|
1.5 Install Perl dependencies that aren't packaged into Debian Etch
|
|
sources
|
|
|
|
Run the following command:
|
|
|
|
$ sudo cpan MARC::Record Class::Accessor MARC::Charset MARC::File::XML Net::Z3950::ZOOM HTML::Template::Pro MARC::Crosswalk::DublinCore PDF::Reuse PDF::Reuse::Barcode Data::ICal GD::Barcode::UPCE XML::RSS Algorithm::CheckDigits::M43_001 Biblio::EndnoteStyle POE Schedule::At
|
|
|
|
Note: you may need to run CPAN initialization if you've not run cpan
|
|
before:
|
|
|
|
/etc/perl/CPAN/Config.pm initialized.
|
|
|
|
CPAN is the world-wide archive of perl resources. It consists of about
|
|
100 sites that all replicate the same contents all around the globe.
|
|
Many countries have at least one CPAN site already. The resources
|
|
found on CPAN are easily accessible with the CPAN.pm module. If you
|
|
want to use CPAN.pm, you have to configure it properly.
|
|
|
|
If you do not want to enter a dialog now, you can answer 'no' to this
|
|
question and I'll try to autoconfigure. (Note: you can revisit this
|
|
dialog anytime later by typing 'o conf init' at the cpan prompt.)
|
|
|
|
Are you ready for manual configuration? [yes]
|
|
|
|
When the configuration is completed CPAN will install the Perl modules.
|
|
|
|
2. Configuration of dependencies
|
|
|
|
2.1 Update root MySQL password (if dselect didn't do it for you already)
|
|
|
|
$ sudo mysqladmin password <password>
|
|
|
|
2.2 Create the Koha database
|
|
|
|
$ mysqladmin -uroot -p<password> create database <kohadatabasename>
|
|
$ mysql -uroot -p<password>
|
|
|
|
Create the database and user with associated privileges:
|
|
|
|
Welcome to the MySQL monitor. Commands end with ; or \g.
|
|
Your MySQL connection id is 22
|
|
Server version: 5.0.32-Debian_7etch3-log Debian etch distribution
|
|
|
|
Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
|
|
|
|
mysql> create database <kohadatabasename>;
|
|
Query OK, 1 row affected (0.00 sec)
|
|
|
|
mysql> grant all on <kohadatabasename>.* to <kohadatabaseuser> identified by '<kohadatabaseuserpassword>';
|
|
Query OK, 0 rows affected (0.00 sec)
|
|
|
|
mysql> flush privileges;
|
|
Query OK, 0 rows affected (0.00 sec)
|
|
|
|
mysql> quit
|
|
|
|
3. Run the Koha installer
|
|
|
|
$ perl Makefile.PL
|
|
( answer questions )
|
|
$ make
|
|
$ make test
|
|
$ sudo make install
|
|
|
|
4. Configure and start Apache
|
|
$ sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
|
|
(note that the path to koha-httpd.conf may be different depending on your
|
|
installation choices)
|
|
|
|
$ sudo a2enmod rewrite
|
|
$ sudo a2ensite koha && /etc/init.d/apache2 reload
|
|
|
|
5. Configure and start Zebra
|
|
|
|
Note: it's recommended that you daemonize the Zebra process and add it to your
|
|
startup profile. For a non-production test/development installation, running
|
|
Zebra from the command line can be useful. Pick from the two available options
|
|
below, or roll your own :-)
|
|
|
|
Note: it's also recommended that you create a Koha system user, which you will
|
|
have specified during the install process. Alternatively, Zebra can be
|
|
configured to run as the root user.
|
|
|
|
Option 1: run the Zebra processes from the command line:
|
|
|
|
Zebra Server:
|
|
$ sudo ${KOHA_USER} zebrasrv -f /etc/koha/koha-conf.xml
|
|
(note that the path to koha-conf.xml may be different depending on your
|
|
installation choices)
|
|
|
|
Zebraqueue Daemon:
|
|
$ sudo ${KOHA_USER} misc/bin/zebraqueue_daemon.pl
|
|
|
|
Option 2: run the Zebra processes as daemons, and add to startup process:
|
|
|
|
Note that references to $SCRIPT_DIR refer to the directory where
|
|
Koha's command-line scripts are installed, e.g., /usr/share/koha/bin.
|
|
|
|
Zebra Server:
|
|
$ sudo ln -s ${SCRIPT_DIR}/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon
|
|
$ update-rc.d koha-zebra-daemon defaults
|
|
( Note: see man chkconfig(8) on other distros )
|
|
$ ${SCRIPT_DIR}/koha-zebra-ctl.sh start
|
|
|
|
Zebraqueue Daemon:
|
|
$ sudo ln -s ${SCRIPT_DIR}/koha-zebraqueue-ctl.sh /etc/init.d/koha-zebraqueue-daemon
|
|
$ update-rc.d koha-zebraqueue-daemon defaults
|
|
( Note: see man chkconfig(8) on other distros )
|
|
|
|
$ ${SCRIPT_DIR}/koha-zebraqueue-ctl.sh start
|
|
|
|
|
|
6. Run the Web Installer, populate the database, initial configuration of settings
|
|
|
|
Point your browser to http://<servername>:8080/
|
|
|
|
It should redirect you to the Web installer where you can continue the setup.
|
|
|
|
Uninstall Instructions
|
|
=============================
|
|
1) Stop Zebra
|
|
2) Remove install folder for Koha
|
|
3) Remove /etc/apache2/sites-available/koha
|
|
4) Restart Apache2
|
|
|
|
Tested on the following operating environments
|
|
==============================================
|
|
- Debian Etch 4.0
|
|
|
|
Installer Bug reports
|
|
=====================
|
|
Please send any installer bug reports to jmf AT liblime DOT com
|
|
|
|
Other Notes
|
|
=====================
|
|
This file is part of Koha
|
|
|
|
Koha is free software; you can redistribute it and/or modify it under the
|
|
terms of the GNU General Public License as published by the Free Software
|
|
Foundation; either version 2 of the License, or (at your option) any later
|
|
version.
|
|
|
|
Koha is distributed in the hope that it will be useful, but WITHOUT ANY
|
|
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
|
|
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
|
You should have received a copy of the GNU General Public License along with
|
|
Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
|
|
Suite 330, Boston, MA 02111-1307 USA
|