X-Git-Url: http://git.rot13.org/?a=blobdiff_plain;f=INSTALL.debian;h=bfb94e269e2352adbf91ca087c565f5e3c9295d8;hb=3287252c0f71a10091995beff4eeb18257bbbc04;hp=c6e20032fda0dd2249eeaae65a0eca8d20f8c246;hpb=3f560e44ce8a8b6a19a69048746ebf22d624dc38;p=koha.git diff --git a/INSTALL.debian b/INSTALL.debian index c6e20032fd..bfb94e269e 100644 --- a/INSTALL.debian +++ b/INSTALL.debian @@ -110,11 +110,21 @@ 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 + XML::RSS Algorithm::CheckDigits::M43_001 Biblio::EndnoteStyle POE \ + Schedule::At DBD::SQLite GD SMS::Send HTTP::OAI IPC::Cmd -There is a known but benign error in the test case for Barcode::Code128, -which is required by PDF::Reuse::Barcode. If this module is not installed, -you can do a forced installation of Barcode::Code128. + + 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 + 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, + which is required by PDF::Reuse::Barcode. If this module is not installed, + you can do a forced installation of Barcode::Code128. Note: you may need to run CPAN initialization if you've not run cpan before: @@ -259,7 +269,7 @@ Finally, remove the test database: ( 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 @@ -269,7 +279,11 @@ Finally, remove the test database: 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: @@ -277,12 +291,17 @@ Run the following commands: $ 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 @@ -299,7 +318,7 @@ Option 1: run the Zebra processes from the command line: 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 @@ -318,7 +337,7 @@ Koha's command-line scripts are installed, e.g., /usr/share/koha/bin. $ 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 ) @@ -341,19 +360,46 @@ Koha's command-line scripts are installed, e.g., /usr/share/koha/bin. $ 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 + Authority data in MARC21 format + $ misc/migration-tools/bulkauthimport.pl -file /path/to/auth.iso2709 7.2 Fast Index: $ 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 zebraqueue - daemon running, the indexin process will happen in the background, but it will be - orders of magnitude slower. - - To enable the SRU servers, you'll need to edit your koha-conf.xml and change the - options to listen on a TCP port; then restart the zebra daemon. + 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. + +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. 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 options to listen on a TCP port; then restart the zebra daemon. UPGRADE ======= @@ -373,11 +419,9 @@ Uninstall Instructions $ sudo apache2ctl restart $ sudo update-rc.d koha-zebra-daemon remove - $ sudo update-rc.d koha-zebraqueue-daemon remove $ sudo rm /etc/init.d/koha-zebra-daemon - $ sudo rm /etc/init.d/koha-zebraqueue-daemon -2) Remove Koha Databases +2) Remove Database and Indexes # MySQL $ mysql -u -p @@ -388,6 +432,7 @@ Uninstall Instructions $ zebraidx -c /etc/zebradb/zebra-authorities.cfg -g iso2709 -d authorities init 3) Remove Koha Install Directories and Configuration Files + Don't forget about any crontab entries Tested on the following operating environments ==============================================