$ 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
+
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),
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
Add the following lines to /etc/apache2/ports.conf:
Listen 80
- Listen 8080
+ 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:
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
on the Zebra index; in development mode, you may wish to use your system
user.
- Zebraqueue Daemon:
+ Zebraqueue Daemon (not recommended -- use rebuild_zebra in crontab instead):
$ sudo -u ${KOHA_USER} misc/bin/zebraqueue_daemon.pl
Note: if you are running in this mode, you may wish to defer starting the
$ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start
- Zebraqueue Daemon:
+ Zebraqueue Daemon (not recommended -- use rebuild_zebra in crontab instead):
$ 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 )
$ 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.
+
7.1 Import:
Bibliographic data in MARC21 format
$ misc/migration-tools/bulkmarcimport.pl -file /path/to/marc.iso2709
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
+ for usage examples. Do not schedule rebuild_zebra AND run zebraqueue. Pick one or the other.
+ See 7.0 above.
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.