From 9e7d28280b195face167381cc1e2ccf6933688f6 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Fr=C3=A9d=C3=A9ric=20Demians?= Date: Mon, 21 Dec 2009 10:55:55 +0100 Subject: [PATCH] Update Debian Lenny installation procedure - Install Debian Lenny packages required by Koha directly with apt-get rather than with dselect. - Update documentation about Zebra indexer configuration via rebuild_zebra.pl rather than zebraqueue_daemon.pl script. --- INSTALL.debian-lenny | 76 ++++++++--------- install_misc/apt-get-debian-lenny.sh | 118 +++++++++++++++++++++++++++ install_misc/debian-lenny.packages | 116 -------------------------- 3 files changed, 157 insertions(+), 153 deletions(-) create mode 100755 install_misc/apt-get-debian-lenny.sh delete mode 100644 install_misc/debian-lenny.packages diff --git a/INSTALL.debian-lenny b/INSTALL.debian-lenny index 2d2997a7ea..da6c023ba8 100644 --- a/INSTALL.debian-lenny +++ b/INSTALL.debian-lenny @@ -5,7 +5,7 @@ Installation Guide for Installing Koha on Debian Lenny with MySQL 5 Feedback/bug reports: Koha Developer's List: http://lists.koha.org/mailman/listinfo/koha-devel -This document last modified: 13 March 2009 +This document last modified: 19 December 2009 Installation Instructions ============================= @@ -50,35 +50,25 @@ Note: for more information about Git, please see the Koha Git Usage Guide: Find the latest Koha stable version on http://download.koha.org and get it: - $ wget http://download.koha.org/koha-3.00.01-stable.tar.gz + $ wget found on download.koha.org 1.5 Install additional Debian dependencies IMPORTANT: You should only use CPAN for Perl dependencies which are NOT available from the package maintainer. You have been warned! -Using the debian-lenny.packages file included in the Koha source tree, -run the following: +Run shell script installing all necessary Debian packages, MySQL Server, +Zebra and all Debian packaged Perl module required by Koha: - $ sudo dpkg --set-selections < install_misc/debian-lenny.packages - -Now start dselect: - - $ sudo apt-get install 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. + $ sudo install_misc/apt-get-debian-lenny.sh 1.6 Install Perl dependencies that aren't packaged into Debian Lenny sources Run the following command: - $ sudo cpan Algorithm::CheckDigits SMS::Send HTTP::OAI + $ sudo cpan Algorithm::CheckDigits SMS::Send HTTP::OAI IPC::Cmd \\ + Memoize::Memcached PDF::API2::Simple PDF::Table Storable Test::More Note: you may need to run CPAN initialization if you've not run cpan before: @@ -187,27 +177,37 @@ configured to run as the root user. Option 1: run the Zebra processes from the command line: - Zebra Server: +1.1 Zebra Search Server + +This process send responses to search requests sent by Koha or +Z39.50/SRU/SRW clients. + $ 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. + + $ sudo -u ${KOHA_USER} misc/migration_tools/rebuild_zebra -z -b -a 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). -Option 2: run the Zebra processes as daemons, and add to startup process: +Option 2: run automatically Zebra processes as daemons: 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 @@ -215,12 +215,14 @@ Koha's command-line scripts are installed, e.g., /usr/share/koha/bin. $ 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: + + /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. 6. Run the Web Installer, populate the database, initial configuration of settings @@ -239,10 +241,14 @@ Koha's command-line scripts are installed, e.g., /usr/share/koha/bin. (note: use the correct path to your koha-conf.xml) 7.1 Import: - Bibliographic data in MARC21 format + +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 + +Authority data in MARC21 format + + $ misc/migration-tools/bulkmarcimport.pl -a -file /path/to/auth.iso2709 7.2 Fast Index: $ misc/migration-tools/rebuild_zebra.pl -b -w @@ -296,10 +302,6 @@ Tested on the following operating environments ============================================== - Debian Lenny 5.0 -Installer Bug reports -===================== -Please send any installer bug reports to jmf AT liblime DOT com - Other Notes ===================== This file is part of Koha diff --git a/install_misc/apt-get-debian-lenny.sh b/install_misc/apt-get-debian-lenny.sh new file mode 100755 index 0000000000..eb3aa70a84 --- /dev/null +++ b/install_misc/apt-get-debian-lenny.sh @@ -0,0 +1,118 @@ +apt-get install \ +apache2 \ +apache2-mpm-worker \ +at \ +bzip2 \ +daemon \ +gcc \ +gettext \ +idzebra-2.0-common \ +idzebra-2.0-doc \ +idzebra-2.0 \ +idzebra-2.0-utils \ +libalgorithm-checkdigits-perl \ +libbiblio-endnotestyle-perl \ +libcgi-session-perl \ +libcgi-session-serialize-yaml-perl \ +libclass-accessor-perl \ +libclass-factory-util-perl \ +libdata-ical-perl \ +libdate-calc-perl \ +libdate-calc-perl \ +libdate-ical-perl \ +libdate-ical-perl \ +libdate-manip-perl \ +libdatetime-format-mail-perl \ +libdatetime-format-strptime-perl \ +libdatetime-format-w3cdtf-perl \ +libdatetime-locale-perl \ +libdatetime-perl \ +libdatetime-timezone-perl \ +libdbd-mysql-perl \ +libdbd-mysql-perl \ +libdbd-sqlite2-perl \ +libdbi-perl \ +libdigest-sha-perl \ +libemail-date-perl \ +libemail-date-perl \ +libgcrypt11-dev \ +libgcrypt11 \ +libgd2-xpm-dev \ +libgd-barcode-perl \ +libgd-barcode-perl \ +libgd-gd2-perl \ +libhtml-scrubber-perl \ +libhtml-scrubber-perl \ +libhtml-template-pro-perl \ +libidzebra-2.0-dev \ +libidzebra-2.0 \ +libidzebra-2.0-mod-alvis \ +libidzebra-2.0-mod-grs-marc \ +libidzebra-2.0-mod-grs-regx \ +libidzebra-2.0-mod-grs-xml \ +libidzebra-2.0-mod-text \ +libidzebra-2.0-modules \ +libimage-magick-perl \ +libjson-perl \ +libjson-xs-perl \ +liblingua-ispell-perl \ +liblingua-stem-perl \ +liblingua-stem-perl \ +liblist-moreutils-perl \ +liblocale-gettext-perl \ +liblocale-po-perl \ +libmail-sendmail-perl \ +libmail-sendmail-perl \ +libmail-sendmail-perl \ +libmarc-charset-perl \ +libmarc-crosswalk-dublincore-perl \ +libmarc-record-perl \ +libmarc-xml-perl \ +libmime-lite-perl \ +libmime-lite-perl \ +libmime-lite-perl \ +libmysqlclient15-dev \ +libnet-ldap-perl \ +libnet-ldap-perl \ +libnet-z3950-zoom-perl \ +libnumber-format-perl \ +libpdf-api2-perl \ +libpdf-api2-perl \ +libpdf-reuse-barcode-perl \ +libpdf-reuse-perl \ +libpoe-perl \ +libpoe-perl \ +libschedule-at-perl \ +libtext-charwidth-perl \ +libtext-csv-perl \ +libtext-iconv-perl \ +libtext-wrapi18n-perl \ +libtimedate-perl \ +libtime-duration-perl \ +libtime-format-perl \ +libunix-syslog-perl \ +libxml2-dev \ +libxml2 \ +libxml2-utils \ +libxml-dom-perl \ +libxml-dumper-perl \ +libxml-libxml-perl \ +libxml-libxslt-perl \ +libxml-namespacesupport-perl \ +libxml-parser-perl \ +libxml-perl \ +libxml-regexp-perl \ +libxml-rss-perl \ +libxml-sax-writer-perl \ +libxml-simple-perl \ +libxml-xslt-perl \ +libxslt1.1 \ +libxslt1-dev \ +libyaml-perl \ +libyaml-syck-perl \ +libyaz-dev \ +libyaz3 \ +make \ +mysql-server \ +yaz-doc \ +yaz diff --git a/install_misc/debian-lenny.packages b/install_misc/debian-lenny.packages deleted file mode 100644 index d8b43964ed..0000000000 --- a/install_misc/debian-lenny.packages +++ /dev/null @@ -1,116 +0,0 @@ -apache2 install -apache2-mpm-worker install -at install -daemon install -gcc install -gettext install -idzebra-2.0-common install -idzebra-2.0-doc install -idzebra-2.0 install -idzebra-2.0-utils install -libbiblio-endnotestyle-perl install -libcgi-session-perl install -libcgi-session-serialize-yaml-perl install -libclass-accessor-perl install -libclass-factory-util-perl install -libdata-ical-perl install -libdate-calc-perl install -libdate-calc-perl install -libdate-ical-perl install -libdate-ical-perl install -libdate-manip-perl install -libdatetime-format-mail-perl install -libdatetime-format-strptime-perl install -libdatetime-format-w3cdtf-perl install -libdatetime-locale-perl install -libdatetime-perl install -libdatetime-timezone-perl install -libdbd-mysql-perl install -libdbd-mysql-perl install -libdbd-sqlite2-perl install -libdbi-perl install -libdigest-sha-perl install -libemail-date-perl install -libemail-date-perl install -libgcrypt11-dev install -libgcrypt11 install -libgd2-noxpm-dev install -libgd-barcode-perl install -libgd-barcode-perl install -libgd-gd2-perl install -libhtml-scrubber-perl install -libhtml-scrubber-perl install -libhtml-template-pro-perl install -libidzebra-2.0-dev install -libidzebra-2.0 install -libidzebra-2.0-mod-alvis install -libidzebra-2.0-mod-grs-marc install -libidzebra-2.0-mod-grs-regx install -libidzebra-2.0-mod-grs-xml install -libidzebra-2.0-mod-text install -libidzebra-2.0-modules install -libimage-magick-perl install -libjson-perl install -libjson-xs-perl install -liblingua-ispell-perl install -liblingua-stem-perl install -liblingua-stem-perl install -liblist-moreutils-perl install -liblocale-gettext-perl install -liblocale-po-perl install -libmail-sendmail-perl install -libmail-sendmail-perl install -libmail-sendmail-perl install -libmarc-charset-perl install -libmarc-crosswalk-dublincore-perl install -libmarc-record-perl install -libmarc-xml-perl install -libmime-lite-perl install -libmime-lite-perl install -libmime-lite-perl install -libmysqlclient15-dev install -libnet-ldap-perl install -libnet-ldap-perl install -libnet-z3950-zoom-perl install -libparam-util-perl install -libpdf-api2-perl install -libpdf-api2-perl install -libpdf-reuse-barcode-perl install -libpdf-reuse-perl install -libpoe-perl install -libpoe-perl install -libschedule-at-perl install -libtext-charwidth-perl install -libtext-csv-perl install -libtext-iconv-perl install -libtext-wrapi18n-perl install -libtimedate-perl install -libtime-duration-perl install -libtime-format-perl install -libunix-syslog-perl install -libxml2-dev install -libxml2 install -libxml2-utils install -libxml-dom-perl install -libxml-dumper-perl install -libxml-libxml-perl install -libxml-libxslt-perl install -libxml-namespacesupport-perl install -libxml-parser-perl install -libxml-perl install -libxml-regexp-perl install -libxml-rss-perl install -libxml-sax-writer-perl install -libxml-simple-perl install -libxml-xslt-perl install -libxslt1.1 install -libxslt1-dev install -libyaml-perl install -libyaml-syck-perl install -libyaz-dev install -libyaz install -make install -mysql-server install -perl-doc install -yaz-doc install -yaz install -- 2.39.5