Bugzilla – Attachment 11081 Details for
Bug 8478
Update Ubuntu related files
Home
|
New
|
Browse
|
Search
|
[?]
|
Reports
|
Help
|
New Account
|
Log In
[x]
|
Forgot Password
Login:
[x]
[patch]
Bug 8478 - Create an INSTALL file for 12.04
Bug-8478---Create-an-INSTALL-file-for-1204.patch (text/plain), 28.74 KB, created by
Tomás Cohen Arazi (tcohen)
on 2012-07-23 15:06:43 UTC
(
hide
)
Description:
Bug 8478 - Create an INSTALL file for 12.04
Filename:
MIME Type:
Creator:
Tomás Cohen Arazi (tcohen)
Created:
2012-07-23 15:06:43 UTC
Size:
28.74 KB
patch
obsolete
>From 75386e553ea3b9bb1871e5f58e83e562cd77f4b5 Mon Sep 17 00:00:00 2001 >From: Tomas Cohen Arazi <tomascohen@gmail.com> >Date: Mon, 23 Jul 2012 11:52:45 -0300 >Subject: [PATCH] Bug 8478 - Create an INSTALL file for 12.04 >Content-Type: text/plain; charset="utf-8" > >Created a INSTALL.ubuntu.precise file, based on the old (9.04) file present >in the source tree. >--- > INSTALL.ubuntu | 448 ------------------------------------------------ > INSTALL.ubuntu.precise | 399 ++++++++++++++++++++++++++++++++++++++++++ > 2 files changed, 399 insertions(+), 448 deletions(-) > delete mode 100644 INSTALL.ubuntu > create mode 100644 INSTALL.ubuntu.precise > >diff --git a/INSTALL.ubuntu b/INSTALL.ubuntu >deleted file mode 100644 >index 050d15d..0000000 >--- a/INSTALL.ubuntu >+++ /dev/null >@@ -1,448 +0,0 @@ >-============================= >-Installation Guide for Installing Koha on Ubuntu Jaunty (9.04) with MySQL 5 >-============================= >- >-Copyright (C) 2007, 2008 LibLime (http://liblime.com) >-Some parts copyright 2010 Chris Nighswonger >- >-Original author: Joshua Ferraro >-Modified for Ubuntu by: Chris Nighswonger (cnighswonger AT foundations DOT edu) >- >-Feedback/bug reports: Koha Developer's List: >-http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel >- >-This document last modified: 20 March 2010 >- >-Installation Instructions >-============================= >- >-All commands can be performed as a system user with sudo privileges, >-as indicated or by running the command directly as root. >- >-1. Prepare System and Install Dependencies >- >-1.1 Install Ubuntu Jaunty via CD >- >-See http://www.ubuntu.com/getubuntu/download >- >-1.2 Set up your locale >- >-Your locale should be set to UTF-8, as should Apache2 and MySQL 5. >-This step is VERY IMPORTANT for a UNICODE compliant system. Please >-read over the following document carefully: >- >-http://wiki.koha-community.org/wiki/Encoding_and_Character_Sets_in_Koha >- >-You can verify your system locale by typing the following command: >- >- $ locale >- >-IMPORTANT: You _MUST_ follow all the steps outlined there for >- Apache2, MySQL 5, etc. BEFORE you install Koha. >- >-1.3 Install the Yaz and Zebra packages >- >-Run the following command to update your system: >- >- $ sudo apt-get update >- $ sudo apt-get install yaz idzebra-2.0 idzebra-2.0-doc >- >-1.4 Get Koha >- >-1.4.1 Option A: Download Koha via Git (optional) >- >- $ sudo apt-get install git-core git-email >- $ git clone git://git.koha-community.org/koha.git kohaclone >- $ cd kohaclone >- $ git checkout -b myinstall origin >- >-Note: for more information about Git, please see the Koha Git Usage Guide: >- >- http://wiki.koha-community.org/wiki/Version_Control_Using_Git >- >-1.4.2 Option B: Download Koha from http://download.koha-community.org >- >- $ wget http://download.koha-community.org/koha-3.00.02.tar.gz >- ( Note: use the latest stable version) >- >-1.5 Install additional Ubuntu dependencies >- >-IMPORTANT: You should only use CPAN for Perl dependencies which are NOT >- available from the package maintainer. You have been warned! >- >-Using the ubuntu.packages file included in the Koha source tree, >-run the following: >- >- $ sudo dpkg --set-selections < install_misc/ubuntu.packages >- >-Now start dselect (you may need to '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. >- >-1.6 Install Perl dependencies that aren't packaged into Ubuntu Jaunty >-sources >- >-Run the following command: >- >- $ sudo cpan GD GD::Barcode::UPCE Algorithm::CheckDigits::M43_001 CHI CHI::Driver::Memcached >- >-Note: you may need to run CPAN initialization if you've not run cpan >-before: >- >- /etc/perl/CPAN/Config.pm initialized. >- >- CPAN is the world-wide archive of perl resources. It consists of about >- 100 sites that all replicate the same contents all around the globe. >- Many countries have at least one CPAN site already. The resources >- found on CPAN are easily accessible with the CPAN.pm module. If you >- want to use CPAN.pm, you have to configure it properly. >- >- If you do not want to enter a dialog now, you can answer 'no' to this >- question and I'll try to autoconfigure. (Note: you can revisit this >- dialog anytime later by typing 'o conf init' at the cpan prompt.) >- >- Are you ready for manual configuration? [yes] >- >-When the configuration is completed CPAN will install the Perl modules. >- >-2. Configuration of dependencies >- >-2.1 Update root MySQL password (if dselect didn't do it for you already) >- >- $ sudo mysqladmin password <password> >- >-2.2 Create the Koha database >- >- Create the database and user with associated privileges: >- >- $ mysqladmin -uroot -p<password> create <kohadatabasename> >- $ mysql -uroot -p<password> >- >- Welcome to the MySQL monitor. Commands end with ; or \g. >- Your MySQL connection id is 22 >- Server version: 5.0.32-Debian_7etch3-log Debian etch distribution >- >- Type 'help;' or '\h' for help. Type '\c' to clear the buffer. >- >- mysql> grant all on <kohadatabasename>.* to '<kohadatabaseuser>'@'localhost' identified by '<kohadatabaseuserpassword>'; >- Query OK, 0 rows affected (0.00 sec) >- >- mysql> flush privileges; >- Query OK, 0 rows affected (0.00 sec) >- >- mysql> quit >- >-2.3 Test your SAX Parser and correct where necessary >- >- You must be sure you're using the XML::LibXML SAX parser, not Expat or PurePerl, both of which have outstanding bugs with pre-composed characters. You can test your SAX parser by running: >- >- $ cd koha >- $ misc/sax_parser_print.pl >- >- You should see something like:: >- >- XML::LibXML::SAX::Parser=HASH(0x81fe220) >- >- If you're using PurePerl or Expat, you'll need to edit your >- ini file, typically located at: >- >- /etc/perl/XML/SAX/ParserDetails.ini >- >- You will need to move the entire section for '[XML::LibXML::SAX::Parser]' to the bottom of the ini file. >- >-2.4 Install DBD::mysql Perl module >- >-In order to handle UTF-8 correctly, Koha requires at least version 4.004 >-of the DBD::mysql Perl module. However, Debian Etch has a stable package >-only for version 3.0008, so it is necessary to install the module from CPAN. >-DBD::mysql's test suite needs to use a MySQL 'test' DB which doesn't exist >-anymore. So there are two options to install DBD::mysql: >- >- (1) install without test suite, >- (2) install with test suite requiring a test MySQL DB creation. >- >-2.4.1 Install without test suite >- >-Force install DBD::mysql: >- >- $ sudo cpan >- cpan> force install DBD::mysql >- >-2.4.2 Create test database in order to install DBD::mysql >- >-Because of DBD::mysql's test suite, it is necessary to temporarily create a >-test database and user: >- >- $ mysql -uroot -p<password> >- >- Create the database and user with associated privileges: >- >- Welcome to the MySQL monitor. Commands end with ; or \g. >- Your MySQL connection id is 22 >- Server version: 5.0.32-Debian_7etch3-log Debian etch distribution >- >- Type 'help;' or '\h' for help. Type '\c' to clear the buffer. >- >- mysql> create database test; >- Query OK, 1 row affected (0.00 sec) >- >- mysql> grant all on test.* to 'test'@'localhost' identified by 'test'; >- Query OK, 0 rows affected (0.00 sec) >- (test database, user, and password can be different if need be) >- >- mysql> flush privileges; >- Query OK, 0 rows affected (0.00 sec) >- >- mysql> quit >- >-Next install DBD::mysql: >- >- $ sudo cpan >- >- cpan> o conf makepl_arg >- (get current value of this CPAN parameter) >- >- cpan> o conf makepl_arg "--testdb=test --testuser=test --testpass=test" >- >- cpan> install DBD::mysql >- >- cpan> o conf makepl_arg '' >- >- OR >- >- cpan> o conf makepl_arg '<old setting>' >- >- (restore this setting so as to not interfere with future CPAN installs). >- >- >-Finally, remove the test database: >- >- $ mysql -uroot -p<password> >- >- mysql> drop database test; >- Query OK, 1 row affected (0.00 sec) >- >- mysql> exit >- Bye >- >-3. Run the Koha installer >- >- $ perl Makefile.PL >- ( answer questions ) >- $ make >- $ make test >- $ sudo make install >- >-4. Configure and start Apache >- $ sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha >- (note that the path to koha-httpd.conf may be different depending on your >- installation choices) >- >-Add the following lines to /etc/apache2/ports.conf: >- >- Listen 80 >- Listen 8080 >- >-If not running named virtual hosts (The default koha installation does not use named virtual hosts.), comment out the following line: >- >- NameVirtualHost *:80 >- >-Run the following commands: >- >- $ sudo a2enmod rewrite deflate >- $ 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 :-) >- >-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. >- >-To add a user do: >- >- $ sudo adduser koha >- >-Option 1: run the Zebra processes from the command line: >- >-5.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. >- >-5.1.2 Zebra Indexer >- >-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: This script should be run as the kohauser (the default is 'koha'). >- >-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. >- >-5.2.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 >- >-5.2.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 >- >-See check misc/cronjobs/crontab.example for usage examples. >-NOTE: This job should be setup under the kohauser (the default is 'koha'). >- >-You can also configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra >- >-6. Run the Web Installer, populate the database, initial configuration of settings >- >- Point your browser to http://<servername>:8080/ >- >- It should redirect you to the Web Installer where you can continue the setup. >- You can install the sample data for libraries, patrons, etc. via the Web Installer >- >-7. What next? >- >- Once the installer has completed, you can import and index MARC records from the >- command line thusly (Note: you can also use the 'Stage MARC records for import' from >- the Tools area of Koha's Staff Client to import a batch of MARC records): >- >- $ export KOHA_CONF=/usr/share/koha/etc/koha-conf.xml >- (note: use the correct path to your koha-conf.xml) >- >-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: This script should be run as the kohauser (the default is 'koha'). >- >-7.3 Schedule regular index updates >- >- 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'). >- >- You can also indexing in background, see 5.2.2 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. >- >-UPGRADE >-======= >-If you are running in another language other than english, please >-switch to english before doing the upgrade, the templating system has >-changed and the templates will need to be regenerated. >-Once you have upgraded, please regenerate your templates in your >-chosen languages. >- >-If you are upgrading from a previous installation of Koha 3.x, you can >-use the following: >- >- ./koha_perl_deps.pl -u -m # to identify new Perl dependencies >- >-Install any missing modules >-IMPORTANT: Koha 3.6.x uses Template::Toolkit, this must be installed >-before the webinstaller can run >- >- sudo apt-get install libtemplate-perl >- >- perl Makefile.PL --prev-install-log /path/to/koha-install-log >- make >- make test >- sudo make upgrade >- >-Koha 3.4.x or later no longer stores items in biblio records so >-if you are upgrading from an older version as part of the >-upgrade you will need to do the following two steps, they can take a >-long time (several hours) to complete for large databases >- >- misc/maintenance/remove_items_from_biblioitems.pl --run >- misc/migration_tools/rebuild_zebra.pl -b -r >- >-Uninstall Instructions >-============================= >-1) Stop Services: >- $ sudo a2dissite koha >- $ sudo rm /etc/apache2/sites-available/koha >- $ sudo apache2ctl restart >- >- $ sudo update-rc.d koha-zebra-daemon remove >- $ sudo rm /etc/init.d/koha-zebra-daemon >- >-2) Remove Database and Indexes >- >- # MySQL >- $ mysql -u<kohauser> -p<kohapassword> >- > drop database koha; >- >- # Zebra Indexes >- $ zebraidx -c <prefix>/etc/zebradb/zebra-biblios.cfg -g iso2709 -d biblios init >- $ zebraidx -c <prefix>/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 >-============================================== >-- Ubuntu Jaunty Jackalope 9.04 >- >-Installer Bug reports >-===================== >-Please log any installer bug reports at http://bugs.koha-community.org >- >-Other Notes >-===================== >-This file is part of Koha >- >-Koha is free software; you can redistribute it and/or modify it under the >-terms of the GNU General Public License as published by the Free Software >-Foundation; either version 2 of the License, or (at your option) any later >-version. >- >-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., >-51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. >diff --git a/INSTALL.ubuntu.precise b/INSTALL.ubuntu.precise >new file mode 100644 >index 0000000..80ab7ff >--- /dev/null >+++ b/INSTALL.ubuntu.precise >@@ -0,0 +1,399 @@ >+============================= >+Installation Guide for Installing Koha on Ubuntu Precise Pangolin (12.04 LTS) with MySQL 5.5 >+============================= >+ >+Copyright (C) 2007, 2008 LibLime (http://liblime.com) >+Some parts copyright 2010 Chris Nighswonger >+ >+Original author: Joshua Ferraro >+Modified for Ubuntu by: Chris Nighswonger (cnighswonger AT foundations DOT edu) >+ Tomas Cohen Arazi (tomascohen@gmail.com) >+ >+Feedback/bug reports: Koha Developer's List: >+http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel >+ >+This document last modified: 20 July 2012 >+ >+Installation Instructions >+============================= >+ >+Mostof the commands can be performed as a system user with sudo privileges, >+as indicated or by running the command directly as root. >+ >+1. Prepare System and Install Dependencies >+ >+1.1 Install Ubuntu 12.04 LTS via CD/DVD/USB >+ >+ Download and install Ubuntu from the official site. >+ >+ - Server edition (command-line only): http://www.ubuntu.com/download/server >+ - Desktop edition: http://www.ubuntu.com/download/desktop >+ >+1.2 Add koha-stable repository to your apt sources (as root) >+ >+ $ echo "deb http://debian.koha-community.org/koha squeeze main" > /etc/apt/sources.list.d/koha-community.list >+ $ wget -O- http://debian.koha-community.org/koha/gpg.asc | apt-key add - >+ $ sudo apt-get update ; sudo apt-get upgrade >+ >+1.3 Install Apache2 and MySQL 5.5 >+ >+ If you plan to use a separate server for MySQL skip the last command. >+ >+ $ sudo apt-get install apache2 >+ $ sudo apt-get install mysql-server >+ >+ Note: You will be prompted to set your root password for MySQL. >+ >+1.4 Set up your locale >+ >+ Your locale should be set to UTF-8, as should Apache2 and MySQL 5.5. >+ This step is VERY IMPORTANT for a UNICODE compliant system. You _MUST_ >+ be sure to set this BEFORE you install Koha. >+ >+ $ sudo update-locale en_US.UTF-8 >+ >+ (You have to log out and back in to see locale change reflected in the locale command) >+ >+ You can verify your system local by running the following command: >+ >+ $ locale >+ >+ Please read over the following document carefully for more information: >+ >+ http://wiki.koha-community.org/wiki/Encoding_and_Character_Sets_in_Koha >+ >+1.5 Get Koha >+ >+ 1.5.1 Download Koha released tarball >+ >+ You can get the sources from http://download.koha-community.org. Issuing the >+ following command you can get the latest stable release (recommended): >+ >+ Download Koha: >+ >+ $ mkdir koha_src ; cd koha_src >+ $ wget http://download.koha-community.org/koha-latest.tar.gz >+ >+ Unpack: >+ >+ $ tar xvzf koha-latest.tar.gz >+ >+ 1.5.2 Download Koha via Git (optional) >+ >+ Install Git: >+ >+ $ sudo apt-get install git-core >+ >+ Download Koha: >+ >+ $ git clone git://git.koha-community.org/koha.git kohaclone >+ $ cd kohaclone >+ $ git checkout -b myinstall origin >+ >+ Note: for more information about Git, please see the Koha Git Usage Guide: >+ >+ http://wiki.koha-community.org/wiki/Version_Control_Using_Git >+ >+1.6 Install additional Ubuntu dependencies >+ >+ Several Koha dependencies have been conveniently packaged and will be installed >+ issuing the following commands: >+ >+ $ sudo dpkg --set-selections < install_misc/ubuntu.precise.packages >+ $ sudo apt-get install dselect >+ $ sudo dselect install >+ >+1.7 Install Perl dependencies that aren't packaged >+ >+ Run the test script to identify missing libraries >+ >+ $ perl koha_perl_deps.pl -m -u >+ >+ This will list whether any Perl dependencies are missing or need a >+ later version and whether they are required. They can be installed >+ using the 'cpan' command. For example: >+ >+ $ sudo cpan GD GD::Barcode::UPCE Algorithm::CheckDigits::M43_001 >+ >+ Note: you may need to run CPAN initialization if you've not run cpan before. >+ >+ >+2. Configuration of dependencies >+ >+2.1 Update root MySQL password (if dselect didn't do it for you already) >+ >+ $ sudo mysqladmin password <password> >+ >+2.2 Create the Koha database >+ >+ Create the database and user with associated privileges: >+ >+ $ mysqladmin -uroot -p<password> create <kohadatabasename> >+ $ mysql -uroot -p<password> >+ >+ Welcome to the MySQL monitor. Commands end with ; or \g. >+ Your MySQL connection id is 42 >+ Server version: 5.5.24-0ubuntu0.12.04.1 (Ubuntu) >+ >+ Copyright (c) 2000, 2011, Oracle and/or its affiliates. All rights reserved. >+ >+ Oracle is a registered trademark of Oracle Corporation and/or its >+ affiliates. Other names may be trademarks of their respective >+ owners. >+ >+ Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. >+ >+ mysql> GRANT ALL ON <kohadatabasename>.* TO '<kohadatabaseuser>'@'localhost' IDENTIFIED BY '<kohadatabaseuserpassword>'; >+ Query OK, 0 rows affected (0.00 sec) >+ >+ mysql> FLUSH PRIVILEGES; >+ Query OK, 0 rows affected (0.00 sec) >+ >+ mysql> quit >+ >+2.3 Test your SAX Parser and correct where necessary >+ >+ You must be sure you're using the XML::LibXML SAX parser, not Expat or PurePerl, both of which have outstanding >+ bugs with pre-composed characters. You can test your SAX parser by running: >+ >+ $ cd koha >+ $ misc/sax_parser_print.pl >+ >+ If your setup is wrong, the script will output something like this: >+ >+ Koha wants something like: >+ XML::LibXML::SAX::Parser=HASH(0x81fe220) >+ You have: >+ XML::SAX::Expat=HASH(0x1a94e88) >+ Looks bad, check INSTALL.* documentation. >+ >+ It means you are using Expat (it could also say PurePerl). You'll need to edit your >+ ini file, located at: >+ >+ /etc/perl/XML/SAX/ParserDetails.ini >+ >+ and move the entire section for '[XML::LibXML::SAX::Parser]' to the bottom of the ini file. Then run >+ the script again. The output should look like this: >+ >+ $ misc/sax_parser_print.pl >+ Koha wants something like: >+ XML::LibXML::SAX::Parser=HASH(0x81fe220) >+ You have: >+ XML::LibXML::SAX::Parser=HASH(0x16dfee8) >+ Looks good. >+ >+3. Run the Koha installer >+ >+ $ perl Makefile.PL >+ ( answer questions ) >+ $ make >+ $ make test >+ $ sudo make install >+ >+4. Configure and start Apache >+ >+ $ sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha >+ >+ Note: the path to koha-httpd.conf may be different depending on your installation choices. >+ >+ Make sure you have this lines in /etc/apache2/ports.conf: >+ >+ Listen 80 >+ Listen 8080 >+ >+ Add the missing one. >+ >+ If not running named virtual hosts (The default koha installation does not use named >+ virtual hosts.), comment out the following line: >+ >+ NameVirtualHost *:80 >+ >+ Run the following commands: >+ >+ $ sudo a2enmod rewrite deflate >+ $ 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 >+ >+ This process send responses to search requests sent by Koha or Z39.50/SRU/SRW clients. >+ >+ 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. >+ >+ >+5.1 Zebra Search Server >+ >+ Add a user for running zebra >+ >+ $ sudo adduser koha >+ >+ Set the zebra daemon to run on start: >+ >+ $ sudo ln -s /usr/share/koha/bin/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon >+ $ sudo update-rc.d koha-zebra-daemon defaults >+ $ sudo /etc/init.d/koha-zebra-daemon start >+ >+ Note: change the path to koha-zebra-ctl.sh to match your setup if not using the default. >+ >+5.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 >+ >+ See check misc/cronjobs/crontab.example for usage examples. >+ >+ Note: This job should be setup under the kohauser (the default is 'koha'). >+ >+ You can also configure zebra-indexing as an background daemon, see >+ http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra >+ >+6. Run the Web Installer, populate the database, initial configuration of settings >+ >+ Point your browser to http://<servername>:8080/ >+ >+ It should redirect you to the Web Installer where you can continue the setup. >+ You can install the sample data for libraries, patrons, etc. via the Web Installer >+ >+7. Install additional languages >+ >+ In your install directory you can run this commands to have your Koha setup translated >+ to your language: >+ >+ Set your environment variables: >+ >+ $ export KOHA_CONF=/etc/koha/sites/koha/koha-conf.xml >+ $ export PERL5LIB=/usr/share/koha/lib/ >+ >+ Run the translator script: >+ >+ $ cd /usr/share/koha/misc/translator >+ $ perl translate install <language-code> >+ >+ <language-code> must be one of the included in the misc/translator/po directory. >+ >+ Note: You can add as many languages as you need. In order to use them you will have >+ to enable them first in the 'I18N/L10N' section of the Koha preferences. >+ >+8. What next? >+ >+ Once the installer has completed, you can import and index MARC records from the >+ command line thusly (Note: you can also use the 'Stage MARC records for import' from >+ the Tools area of Koha's Staff Client to import a batch of MARC records): >+ >+ $ export KOHA_CONF=/usr/share/koha/etc/koha-conf.xml >+ >+ Note: use the correct path to your koha-conf.xml >+ >+8.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 >+ >+8.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: This script should be run as the kohauser (the default is 'koha'). >+ >+8.3 Public Z39.50/SRU server >+ >+ 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. >+ >+UPGRADE >+======= >+ >+ If you are running in another language other than english, please >+ switch to english before doing the upgrade, the templating system has >+ changed and the templates will need to be regenerated. >+ Once you have upgraded, please regenerate your templates in your >+ chosen languages. >+ >+1. Install new Perl dependencies >+ >+ If you are upgrading from a previous installation of Koha 3.x, you can >+ use the following to identify new Perl dependencies: >+ >+ $ ./koha_perl_deps.pl -u -m >+ >+ Install any missing modules using the instructions on sections 1.6 and 1.7. >+ >+2. Upgrade Koha >+ >+ $ perl Makefile.PL --prev-install-log /path/to/koha-install-log >+ $ make >+ $ make test >+ $ sudo make upgrade >+ >+3. Pre-3.4 upgrades >+ >+ Koha 3.4.x or later no longer stores items in biblio records so >+ if you are upgrading from an older version as part of the >+ upgrade you will need to do the following two steps, they can take a >+ long time (several hours) to complete for large databases: >+ >+ $ misc/maintenance/remove_items_from_biblioitems.pl --run >+ $ misc/migration_tools/rebuild_zebra.pl -b -r >+ >+Uninstall Instructions >+============================= >+ >+1. Stop Services: >+ >+ $ sudo a2dissite koha >+ $ sudo rm /etc/apache2/sites-available/koha >+ $ sudo apache2ctl restart >+ >+ $ sudo update-rc.d koha-zebra-daemon remove >+ $ sudo rm /etc/init.d/koha-zebra-daemon >+ >+. Remove Database and Indexes >+ >+ # MySQL >+ $ mysql -u<kohauser> -p<kohapassword> >+ > drop database koha; >+ >+ # Zebra Indexes >+ $ zebraidx -c <prefix>/etc/zebradb/zebra-biblios.cfg -g iso2709 -d biblios init >+ $ zebraidx -c <prefix>/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 >+============================================== >+ >+ - Ubuntu Precise Pangolin 12.04 >+ >+Installer Bug reports >+===================== >+ >+ Please log any installer bug reports at http://bugs.koha-community.org >+ >+Other Notes >+===================== >+This file is part of Koha >+ >+Koha is free software; you can redistribute it and/or modify it under the >+terms of the GNU General Public License as published by the Free Software >+Foundation; either version 2 of the License, or (at your option) any later >+version. >+ >+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., >+51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. >-- >1.7.9.5
You cannot view the attachment while viewing its details because your browser does not support IFRAMEs.
View the attachment on a separate page
.
View Attachment As Diff
View Attachment As Raw
Actions:
View
|
Diff
|
Splinter Review
Attachments on
bug 8478
:
11081
|
11082
|
11104
|
11152
|
11204
|
11205
|
11207
|
11536