=============================
Copyright (C) 2007, 2008 LibLime (http://liblime.com)
-
-Maintainer: Joshua Ferraro (jmf AT liblime DOT com)
+Some parts copyright 2010 Chris Nighswonger
Feedback/bug reports: Koha Developer's List:
-http://lists.koha.org/mailman/listinfo/koha-devel
+https://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
-This document last modified: 30 April 2008
+This document last modified: 19 May 2010
Installation Instructions
=============================
WARNING: use Perl 5.8 (a library Koha depends on,
MARC::File::XML may not work with Perl 5.10, see:
-http://bugs.koha.org/cgi-bin/bugzilla/show_bug.cgi?id=2309),
+http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=2309),
1.2 Set up your locale
1.4.1 Option A: Download Koha via Git (optional)
- $ git clone git://git.koha.org/pub/scm/koha.git kohaclone
+ $ git clone git://git.koha-community.org/pub/scm/koha.git kohaclone
$ cd kohaclone
$ git checkout -b myinstall origin
http://wiki.koha.org/doku.php?id=en:development:git_usage
-1.4.2 Option B: Download Koha from http://download.koha.org
+1.4.2 Option B: Download Koha from http://download.koha-community.org
- $ wget http://download.koha.org/koha-3.00.00-beta.tar.gz
+ $ wget http://download.koha-community.org/koha-3.00.00-beta.tar.gz
( Note: use the latest stable version)
1.5 Install additional Debian dependencies
$ 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
+ XML::RSS Algorithm::CheckDigits::M43_001 Biblio::EndnoteStyle POE \
+ Schedule::At DBD::SQLite GD SMS::Send HTTP::OAI IPC::Cmd Locale::Currency::Format
+
WARNINGS:
1.6.1 A Perl library Koha depends on, MARC::File::XML may not work with Perl
- 5.10, see: http://bugs.koha.org/cgi-bin/bugzilla/show_bug.cgi?id=2309),
+ 5.10, see: http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=2309),
1.6.2 Recent versions of CGI::Session have caused some issues for users;
- as of this release date, we suggest downloading the CGI::Session::serialize::yaml
+ as of this release date, we suggest downloading the CGI::Session::Serialize::yaml
tarball direct from CPAN and install it directly rather than using the cpan command
1.6.3 There is a known but benign error in the test case for Barcode::Code128,
( answer questions )
$ make
$ make test
- $ sudo make install
+ $ sudo make install #If doing a -dev install, skip the sudo!
4. Configure and start Apache
$ sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
Listen 80
Listen 8080
+(Note: It may be productive to use different DNS entries and NamedVirtualHosts
+directives in Apache to separate the staff and OPAC clients, to eliminate a
+cross-client authentication nuisance, but it will work fine like this.)
+
Run the following commands:
$ sudo a2enmod rewrite
$ sudo a2ensite koha
$ sudo apache2ctl restart
+Note: you may still see the usual Apache default site if your VirtualHost
+configuration isn't correct. The command "sudo a2dissite default" may be a
+quick fix, but may have side-effects. See the Apache HTTPD manual section on
+virtual hosts for full instructions.
+
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 :-)
+Zebra from the command line can be useful. Otherwise you will want zebrasrv
+running when Apache/Koha is.
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:
+Option 1: run the Zebra process from the command line:
+
+1.1 Zebra Search Server
+
+This process send responses to search requests sent by Koha or
+Z39.50/SRU/SRW clients.
- Zebra Server:
$ sudo -u ${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)
- Note: the user you run Zebra as will be the only user with write permission
- on the Zebra index; in development mode, you may wish to use your system
- user.
+Note: the user you run Zebra as will be the only user with write permission
+ on the Zebra index; in development mode, you may wish to use your
+ system user.
+
+1.2 Zebra Indexer
- Zebraqueue Daemon:
- $ sudo -u ${KOHA_USER} misc/bin/zebraqueue_daemon.pl
+Added/updated/deleted records in Koha MySQL database must be indexed
+into Zebra. A specific script must be launched each time a bibliographic
+or an authority record is edited.
- Note: if you are running in this mode, you may wish to defer starting the
- zebraqueue until you've run the web installer (see below).
+ $ sudo -u ${KOHA_USER} misc/migration_tools/rebuild_zebra -z -b -a
+ NOTE: This script should be run as the kohauser (the default is 'koha').
-Option 2: run the Zebra processes as daemons, and add to startup process:
+Option 2: run the Zebra process as a daemon, 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:
+1.1 Zebra Search Server
+
$ sudo ln -s ${SCRIPT_DIR}/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon
(Note: ${SCRIPT_DIR} is /usr/share/koha/bin/ by default in a standard install)
$ sudo update-rc.d koha-zebra-daemon defaults
( Note: see man chkconfig(8) on other distros )
-
+
$ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start
- Zebraqueue Daemon:
- $ sudo ln -s ${SCRIPT_DIR}/koha-zebraqueue-ctl.sh /etc/init.d/koha-zebraqueue-daemon
- $ sudo update-rc.d koha-zebraqueue-daemon defaults
- ( Note: see man chkconfig(8) on other distros )
+1.2 Zebra Indexer
+
+Add an entry in Koha user crontab to scheduled added/updated/deleted records
+indexing by Zebra with this command:
+
+ <path/to/koha>/misc/migration_tools/rebuild_zebra -z -b -a
- $ sudo ${SCRIPT_DIR}/koha-zebraqueue-ctl.sh start
+See check misc/cronjobs/crontab.example for usage examples.
+NOTE: This job should be setup under the kohauser (the default is 'koha').
6. Run the Web Installer, populate the database, initial configuration of settings
$ export KOHA_CONF=/usr/share/koha/etc/koha-conf.xml
(note: use the correct path to your koha-conf.xml)
+7.0 Schedule crontab jobs
+ Do you want Koha to:
+ send mail?
+ automatically index added records?
+ generate overdue or advance notices?
+ mark items lost after they are long overdue?
+ assess fines?
+
+ All these and other regularly scheduled background tasks are handled by crontab.
+ You need to examine the example crontab file, edit a copy to your liking, and schedule it.
+
+ $ crontab -l # just check if you have any other jobs already scheduled
+ $ cp ./misc/cronjobs/crontab.example my_crontab
+ $ vi my_crontab # select jobs or adjust times.
+ $ # If you had already scheduled lines, add them at the bottom.
+ $ crontab my_crontab # This overwrites your scheduled jobs with the new ones.
+
+ If you want to check to confirm, you can run crontab -l again.
+ NOTE: Be sure to add KOHA_CONF and PERL5LIB vars to the top of your cron jobs.
+
7.1 Import:
Bibliographic data in MARC21 format
- $ misc/migration-tools/bulkmarcimport.pl -file /path/to/marc.iso2709
+ $ misc/migration_tools/bulkmarcimport.pl -file /path/to/marc.iso2709
Authority data in MARC21 format
- $ misc/migration-tools/bulkauthimport.pl -file /path/to/auth.iso2709
+ $ misc/migration_tools/bulkauthimport.pl -file /path/to/auth.iso2709
7.2 Fast Index:
- $ misc/migration-tools/rebuild_zebra.pl -b -w
+ $ misc/migration_tools/rebuild_zebra.pl -b -w
- Once the indexing has completed, you will be able to search for records in your
- system. NOTE: if you don't run the Fast Index utility, and you have the index
- updates scheduled as per 7.3 the indexing process will happen in the background,
- but it will be orders of magnitude slower.
+ Once the indexing has completed, you will be able to search for records in your system.
+ NOTE: This script should be run as the kohauser (the default is 'koha').
7.3 Schedule regular index updates
- run rebuild_zebra.pl -b -a -z as a regular cron job, check misc/cronjobs/crontab.example
- for usage examples
-
+ You need to run rebuild_zebra.pl -b -a -z as a regular cron job in orde to pick up new bibs
+ and items as you add them. Check misc/cronjobs/crontab.example for usage examples. See 7.0 above.
+ NOTE: This job should be setup under the kohauser (the default is 'koha').
+
7.4 To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and
change the <listen> options to listen on a TCP port; then restart the zebra daemon.
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
+You should have received a copy of the GNU General Public License along
+with Koha; if not, write to the Free Software Foundation, Inc.,
+51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.