[Koha-patches] [PATCH 2/2] Update Debian Lenny installation procedure
Frédéric Demians
f.demians at tamil.fr
Mon Dec 21 10:55:55 CET 2009
- 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 2d2997a..da6c023 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 <URL> 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:
+
+ <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.
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 0000000..eb3aa70
--- /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 d8b4396..0000000
--- 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
--
1.6.4.3
More information about the Koha-patches
mailing list