View | Details | Raw Unified | Return to bug 7764
Collapse All | Expand All

(-)a/INSTALL.ubuntu (-290 / +522 lines)
Lines 1-448 Link Here
1
=============================
1
=================================================================
2
Installation Guide for Installing Koha on Ubuntu Jaunty (9.04) with MySQL 5
2
Instructions for Installing Koha from Source
3
=============================
3
=================================================================
4
4
5
Copyright (C) 2007, 2008 LibLime (http://liblime.com)
5
BUG REPORTS AND FEEDBACK
6
Some parts copyright 2010 Chris Nighswonger
6
=================================================================
7
8
This document last modified: 01 September 2013
9
10
Given the nature of documentation to become outdated, or have
11
problems, please either submit feedback or bug reports.
7
12
8
Original author: Joshua Ferraro
13
Bug reports can be posted at http://bugs.koha-community.org
9
Modified for Ubuntu by: Chris Nighswonger (cnighswonger AT foundations DOT edu)
10
14
11
Feedback/bug reports: Koha Developer's List:
15
Feedback can be posted on the Koha Developer's List:
12
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
16
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
13
17
14
This document last modified: 20 March 2010
15
18
16
Installation Instructions
19
INTRODUCTION
17
=============================
20
=================================================================
21
22
These are the instructions for installing Koha from source. They
23
have been tested using Ubuntu 12.04 LTS. The copyright,
24
licensing, and other details have been put at the end, so the
25
installation can be started as soon as possible.
26
27
'nano' is a generic text editor. Please feel free to substitute
28
your favourite editor (vi, emacs, gedit, or etc.).
29
30
To install Koha for production, it is recommended that you use
31
packages. Installing from packages is not the same as installing
32
from source. These are not your recommended instructions for
33
production servers.
34
35
To help assist with the development and improvement of Koha,
36
continue with these instructions and read more about version
37
control using git! See USEFUL REFERENCE LINKS below.
38
39
These instructions are intended for those who are skilled.
40
They can be used to set up a development system. This install
41
may not be as easy or smooth as you wish. This is to be expected
42
when installing from source.
43
44
45
NOTATION
46
=================================================================
47
48
Commands are indented by 4 spaces, and should be relately obvious
49
as commands. Commands may have blank lines between them to
50
indicate that you should not just copy and paste the entire block
51
of commands.
52
53
File contents will be surrounded by the plus symbols with a
54
"FILE FULL" or "FILE PARTIAL" and the filename above the plus
55
symbols surrounding file contents.
56
57
Koha is released monthly, so keeping documentation up to date
58
is difficult. The convention is to replace the last number with
59
an x. For example, the current version is part of the 3.14.x
60
series and the former stable version is the 3.12.x series.
61
62
63
INSTALL UBUNTU
64
=================================================================
65
66
These instructions assume that you have already installed Ubuntu
67
from the official site: http://www.ubuntu.com/download/server
68
69
There is no need to install extra packages during the Ubuntu
70
installation. Apache2 and MySQL will be installed in the
71
instructions later.
72
73
Installing a mail transfer agent before installing Koha will
74
prevent the installation of nullmailer. Such an installation
75
and configuration of a mail transfer agent is beyond the
76
scope of this document. Consult your system administrator,
77
network administrator, or IT Department for assistance as needed.
78
79
These instructions assume you created a user account with your
80
login in credentials and not one called koha. This is to prevent
81
the system user koha from having more permissions than it should.
82
18
83
19
All commands can be performed as a system user with sudo privileges,
84
ADD A KOHA COMMUNITY REPOSITORY
20
as indicated or by running the command directly as root.
85
=================================================================
21
86
22
1. Prepare System and Install Dependencies
87
These instructions still function even though the latest version
88
of Debian is wheezy. If the version has changed again, please
89
confirm these instructions on the mailing list or IRC channel.
23
90
24
1.1 Install Ubuntu Jaunty via CD
91
To avoid getting prompted for a password in the middle of a
92
chain of commands type the following:
93
    sudo ls
25
94
26
See http://www.ubuntu.com/getubuntu/download
95
IF YOU ARE DOING A STANDARD (tarball) INSTALL use the following
96
command:
97
    echo deb http://debian.koha-community.org/koha squeeze main | sudo tee /etc/apt/sources.list.d/koha.list
27
98
28
1.2 Set up your locale
99
IF YOU ARE DOING A DEV (typically git) INSTALL use the following
100
command:
101
    echo deb http://debian.koha-community.org/koha squeeze-dev main | sudo tee /etc/apt/sources.list.d/koha.list
29
102
30
Your locale should be set to UTF-8, as should Apache2 and MySQL 5.
103
To use the older stable release:
31
This step is VERY IMPORTANT for a UNICODE compliant system. Please
104
echo deb http://debian.koha-community.org/koha oldstable main | sudo tee /etc/apt/sources.list.d/koha.list
32
read over the following document carefully:
105
Intentionally not indented, as the others are preferred.
33
106
34
http://wiki.koha-community.org/wiki/Encoding_and_Character_Sets_in_Koha
107
FOR EITHER INSTALLATION:
108
Add the key in gpg.asc to your APT trusted keys to avoid
109
warning messages on installation:
110
    wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -
35
111
36
You can verify your system locale by typing the following command:
37
112
38
    $ locale
113
UPDATE UBUNTU
114
=================================================================
39
115
40
IMPORTANT:  You _MUST_ follow all the steps outlined there for
116
This process, particularly the upgrade step, may take a while.
41
            Apache2, MySQL 5, etc. BEFORE you install Koha.
42
117
43
1.3 Install the Yaz and Zebra packages
118
    sudo apt-get update
44
119
45
Run the following command to update your system:
120
    sudo apt-get upgrade
46
121
47
    $ sudo apt-get update
122
    sudo apt-get clean
48
    $ sudo apt-get install yaz idzebra-2.0 idzebra-2.0-doc
49
123
50
1.4 Get Koha
51
124
52
1.4.1 Option A: Download Koha via Git (optional)
125
DOWNLOAD THE LATEST KOHA RELEASE
126
=================================================================
53
127
54
    $ sudo apt-get install git-core git-email
128
There are two ways to grab the source, either by using git
55
    $ git clone git://git.koha-community.org/koha.git kohaclone
129
or by downloading the .tar.gz file. Git is recommended for a
56
    $ cd kohaclone
130
development environment.
57
    $ git checkout -b myinstall origin
58
131
59
Note: for more information about Git, please see the Koha Git Usage Guide:
132
IF YOU ARE DOING A STANDARD INSTALLATION:
133
Downloading Source Via Tarball
134
=================================================================
60
135
61
    http://wiki.koha-community.org/wiki/Version_Control_Using_Git
136
    wget http://download.koha-community.org/koha-latest.tar.gz
137
    tar xvf koha-latest.tar.gz
138
    ls
62
139
63
1.4.2 Option B: Download Koha from http://download.koha-community.org
140
NOTE: You need to cd into the koha directory, but since the
141
version changes, you'll know by the ls command what it is.
64
142
65
    $ wget http://download.koha-community.org/koha-3.00.02.tar.gz
143
IF YOU ARE DOING A DEV INSTALLATION:
66
    ( Note: use the latest stable version)
144
Downloading Source Via Git
145
=================================================================
67
146
68
1.5 Install additional Ubuntu dependencies
147
Please see the following wiki page, following the instructions up
148
to and including "git checkout -b mywork origin".
149
http://wiki.koha-community.org/wiki/Version_Control_Using_Git
69
150
70
IMPORTANT:  You should only use CPAN for Perl dependencies which are NOT
71
            available from the package maintainer. You have been warned!
72
151
73
Using the ubuntu.packages file included in the Koha source tree,
152
INSTALL DEPENDENCIES
74
run the following:
153
=================================================================
75
154
76
    $ sudo dpkg --set-selections < install_misc/ubuntu.packages
155
Dependencies from Repository
156
=================================================================
77
157
78
Now start dselect (you may need to 'sudo apt-get install dselect'):
158
The repository added has koha-deps and koha-perldeps packages
159
which make it very easy. Type the following:
160
    sudo apt-get install koha-deps koha-perldeps make
79
161
80
    $ sudo dselect
162
Check For Missing Dependencies
163
=================================================================
81
164
82
Choose [I]nstall and accept packages to be installed (hit return)
165
Check everything was installed, by running the test script to
166
identifty missing libraries:
167
    ./koha_perl_deps.pl -m -u
83
168
84
(may take a while)
169
Install any required libraries that are missing. It is a good
170
idea to install optional ones that are easily found as well.
85
171
86
Choose [C]onfigure, [R]emove and [Q]uit until dselect has completed.
87
172
88
1.6 Install Perl dependencies that aren't packaged into Ubuntu Jaunty
173
CREATE MYSQL DATABASE AND GRANT PRIVILEGES
89
sources
174
=================================================================
90
175
91
Run the following command:
176
Create MySQL Database
177
=================================================================
92
178
93
    $ sudo cpan GD GD::Barcode::UPCE Algorithm::CheckDigits::M43_001 CHI CHI::Driver::Memcached
179
If you have difficulty accessing MySQL's root acount, perhaps
180
this Ubuntu page on resetting the root password may help.
181
https://help.ubuntu.com/community/MysqlPasswordReset
94
182
95
Note: you may need to run CPAN initialization if you've not run cpan
183
    mysql -u root -p
96
before:
97
184
98
    /etc/perl/CPAN/Config.pm initialized.
185
    CREATE DATABASE kohadata;
99
186
100
    CPAN is the world-wide archive of perl resources. It consists of about
187
The koha database has now been created with the name kohadata.
101
    100 sites that all replicate the same contents all around the globe.
102
    Many countries have at least one CPAN site already. The resources
103
    found on CPAN are easily accessible with the CPAN.pm module. If you
104
    want to use CPAN.pm, you have to configure it properly.
105
188
106
    If you do not want to enter a dialog now, you can answer 'no' to this
189
Create User and Grant Permissions
107
    question and I'll try to autoconfigure. (Note: you can revisit this
190
=================================================================
108
    dialog anytime later by typing 'o conf init' at the cpan prompt.)
109
191
110
    Are you ready for manual configuration? [yes]
192
Continue entering MySQL commands. SUBSTITUTE A PASSWORD OF YOUR
193
CHOICE FOR THE {KOHA USER PASSWORD}'S IN THE FOLLOWING COMMANDS:
111
194
112
When the configuration is completed CPAN will install the Perl modules.
195
    CREATE user 'koha'@'localhost' IDENTIFIED by '{KOHA USER PASSWORD}';
196
    GRANT ALL ON kohadata.* TO 'koha'@'localhost' IDENTIFIED BY '{KOHA USER PASSWORD}';
197
    FLUSH PRIVILEGES;
198
    QUIT
113
199
114
2. Configuration of dependencies
200
The koha administrative user has now been created with the name
201
koha and the password of your choosing.
115
202
116
2.1 Update root MySQL password (if dselect didn't do it for you already)
117
203
118
    $ sudo mysqladmin password <password>
204
CONFIGURE KOHA
205
=================================================================
119
206
120
2.2 Create the Koha database
207
User/Group Environment Variables
208
=================================================================
121
209
122
    Create the database and user with associated privileges:
210
IF YOU ARE DOING A STANDARD INSTALLATION, then create a
211
seperate koha system user:
212
    sudo adduser koha
123
213
124
    $ mysqladmin -uroot -p<password> create <kohadatabasename>
214
There is no need to set the following environment variables,
125
    $ mysql -uroot -p<password>
215
because koha is the default account to use.
126
216
127
    Welcome to the MySQL monitor.  Commands end with ; or \g.
217
IF YOU ARE DOING A DEV INSTALLATION, then create some
128
    Your MySQL connection id is 22
218
environment variables for the process to pick up and use later:
129
    Server version: 5.0.32-Debian_7etch3-log Debian etch distribution
219
    export __KOHA_USER__=$USER
220
    export __KOHA_GROUP__=$USER
221
    echo $USER
130
222
131
    Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
223
The output of the echo command should match your user id,
224
and since the user id and group id are generally the same for
225
a freshly created account, this will make sure the indexing
226
happens as this account.
132
227
133
    mysql> grant all on <kohadatabasename>.* to '<kohadatabaseuser>'@'localhost' identified by '<kohadatabaseuserpassword>';
134
    Query OK, 0 rows affected (0.00 sec)
135
228
136
    mysql> flush privileges;
229
GENERATE MAKE FILE
137
    Query OK, 0 rows affected (0.00 sec)
230
=================================================================
138
231
139
    mysql> quit
232
    perl Makefile.PL
140
233
141
2.3 Test your SAX Parser and correct where necessary
234
How you answer the first question will affect where things will
235
end up being placed. It is recommended that choose 'standard' if
236
you are doing a tarball install, and 'dev' if you are doing a
237
git install.
142
238
143
    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:
239
Answering the resulting questions requires thinking. Here are
240
some hints.
144
241
145
    $ cd koha
242
Recall that the database created is kohadata set in the Create
146
    $ misc/sax_parser_print.pl
243
MySQL Database step. The username and password were set up in
244
the Create User and Grant Permissions step.
147
245
148
    You should see something like::
246
Give some thought should be given to the MARC format desired
247
and the method of character normalization (chr or icu), though
248
the defaults will work as MARC21 just fine.
149
249
150
    XML::LibXML::SAX::Parser=HASH(0x81fe220)
250
Use the same username and password for the Zebra questions.
151
251
152
    If you're using PurePerl or Expat, you'll need to edit your
252
Don't worry about warnings generated by optional components.
153
    ini file, typically located at:
154
253
155
    /etc/perl/XML/SAX/ParserDetails.ini
156
254
157
    You will need to move the entire section for '[XML::LibXML::SAX::Parser]' to the bottom of the ini file.
255
BUILD AND TEST KOHA
256
=================================================================
158
257
159
2.4 Install DBD::mysql Perl module
258
Having configured Koha, build it using the following command:
259
    make
160
260
161
In order to handle UTF-8 correctly, Koha requires at least version 4.004
261
Once this has successfully run, test Koha using the following command:
162
of the DBD::mysql Perl module. However, Debian Etch has a stable package
262
    make test
163
only for version 3.0008, so it is necessary to install the module  from CPAN.
164
DBD::mysql's test suite needs to use a MySQL 'test' DB which doesn't exist
165
anymore. So there are two options to install DBD::mysql:
166
263
167
  (1) install without test suite,
264
Don't worry about the large number of scary warning scrolling
168
  (2) install with test suite requiring a test MySQL DB creation.
265
by. All that matters is "PASS" or "FAIL".
169
266
170
2.4.1 Install without test suite
267
If this fails, it is likely due to a failed dependency. Remember,
268
a source installation is not always smooth. You can determine the
269
missing dependency by scrolling back and looking for something
270
like: Can't locate Cache/Memcached/Fast.pm in @INC
271
Install it, and try to build and test again.
171
272
172
Force install DBD::mysql:
173
273
174
    $ sudo cpan
274
INSTALL KOHA
175
    cpan> force install DBD::mysql
275
=================================================================
176
276
177
2.4.2 Create test database in order to install DBD::mysql
277
Once the make test has successfully run, install Koha.
178
278
179
Because of DBD::mysql's test suite, it is necessary to temporarily create a
279
IF YOU ARE DOING A STANDARD INSTALLATION, using the
180
test database and user:
280
following command (follow any on screen prompts):
281
    sudo make install
181
282
182
    $ mysql -uroot -p<password>
283
Once this has successfully run, Koha is almost installed. There
284
are only a few more steps left.
183
285
184
    Create the database and user with associated privileges:
286
IF YOU ARE DOING A DEV INSTALLATION, using the
287
following command (follow any on screen prompts):
288
    make install
185
289
186
    Welcome to the MySQL monitor.  Commands end with ; or \g.
290
No sudo is required as you have access to the directories
187
    Your MySQL connection id is 22
291
listed above.
188
    Server version: 5.0.32-Debian_7etch3-log Debian etch distribution
189
292
190
    Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
293
FOR EITHER INSTALLATION:
294
Near the end of this command, the output will have two lines
295
containing KOHA_CONF and PERL5LIB in them.  Take note of the two
296
export commands as you will need them for a later step.
191
297
192
    mysql> create database test;
193
    Query OK, 1 row affected (0.00 sec)
194
298
195
    mysql> grant all on test.* to 'test'@'localhost' identified by 'test';
299
PRE-WEB INSTALL SETUP
196
    Query OK, 0 rows affected (0.00 sec)
300
=================================================================
197
    (test database, user, and password can be different if need be)
198
301
199
    mysql> flush privileges;
302
UBUNTU MYSQL SECURITY TWEAK
200
    Query OK, 0 rows affected (0.00 sec)
303
=================================================================
201
304
202
    mysql> quit
305
There is a security risk in Ubuntu's MySQL default set up. Type
306
the following commands:
307
    mysql -u root -p
203
308
204
Next install DBD::mysql:
309
    USE mysql;
310
    DELETE FROM user WHERE user='';
311
    FLUSH PRIVILEGES;
312
    QUIT
205
313
206
    $ sudo cpan
314
The anonymous connections are now removed.
207
315
208
    cpan> o conf makepl_arg
209
    (get current value of this CPAN parameter)
210
316
211
    cpan> o conf makepl_arg "--testdb=test --testuser=test --testpass=test"
317
CONFIGURE SYSTEM WIDE ENVIRONMENT VARIABLES
318
=================================================================
212
319
213
    cpan> install DBD::mysql
320
Running scripts and cron jobs requires environment variables set.
321
Use the following commands:
322
    sudo nano /etc/environment
214
323
215
    cpan> o conf makepl_arg ''
324
IF YOU ARE DOING A DEV INSTALLATON:
325
FILE PARTIAL (ADD): /etc/environment
326
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
327
KOHA_CONF=/home/{YOUR USER NAME}/koha-dev/etc/koha-conf.xml
328
KOHA_PATH=/home/{YOUR USER NAME}/kohaclone
329
PERL5LIB=/home/{YOUR USER NAME}/kohaclone
330
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
331
NOTE: CHANGE {YOUR USER NAME} TO YOUR ACTUAL USER NAME!
216
332
217
    OR
333
IF YOU ARE DOING A STANDARD INSTALLATON:
334
FILE PARTIAL (ADD): /etc/environment
335
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
336
KOHA_CONF=/etc/koha/koha-conf.xml
337
KOHA_PATH=/usr/share/koha
338
PERL5LIB=/usr/share/koha/lib
339
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
218
340
219
    cpan> o conf makepl_arg '<old setting>'
341
    logout
220
342
221
    (restore this setting so as to not interfere with future CPAN installs).
343
You need to logout and back in in order to get the environment
344
variables values to be recognized.
222
345
223
346
224
Finally, remove the test database:
347
CONFIGURE AND START APACHE
348
=================================================================
225
349
226
    $ mysql -uroot -p<password>
350
Place Koha Site File
351
=================================================================
227
352
228
    mysql> drop database test;
353
IF YOU ARE DOING A DEV INSTALLATION, use the following command:
229
    Query OK, 1 row affected (0.00 sec)
354
    sudo ln -s ~/koha-dev/etc/koha-httpd.conf /etc/apache2/sites-available/koha
230
355
231
    mysql> exit
356
IF YOU ARE DOING A STANDARD INSTALLATION, use the following command:
232
    Bye
357
    sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
233
358
234
3. Run the Koha installer
359
Tweak Koha Site File
360
=================================================================
235
361
236
    $ perl Makefile.PL
362
The default file limits connections to those from 127.0.1.1
237
    ( answer questions )
363
(or 127.0.0.1), which is rather difficult to test/use in a
238
    $ make
364
server environment. Edit the file:
239
    $ make test
365
    sudo nano /etc/apache2/sites-available/koha
240
    $ sudo make install
241
366
242
4. Configure and start Apache
367
/etc/apache2/sites-available/koha will have a line
243
    $ sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
368
that should have the IP address changed to a *.
244
    (note that the path to koha-httpd.conf may be different depending on your
369
FILE PARTIAL (CHANGE): /etc/apache2/sites-available/koha
245
    installation choices)
370
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
371
<VirtualHost *:80>
372
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
246
373
247
Add the following lines to /etc/apache2/ports.conf:
374
/etc/apache2/sites-available/koha will have another line
375
that should have the IP address changed to a *
376
FILE PARTIAL (CHANGE): /etc/apache2/sites-available/koha
377
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
378
<VirtualHost *:8080>
379
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
248
380
249
    Listen 80
381
Setup Default Ports
250
    Listen 8080
382
=================================================================
251
383
252
If not running named virtual hosts (The default koha installation does not use named virtual hosts.), comment out the following line:
384
    sudo nano /etc/apache2/ports.conf
253
385
254
    NameVirtualHost *:80
386
/etc/apache2/ports.conf must have two lines exactly like
387
the following.  Do not add them if they are already there.
255
388
256
Run the following commands:
389
FILE PARTIAL (CONFIRM/ADD/CHANGE): /etc/apache2/ports.conf
390
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
391
Listen 80
392
Listen 8080
393
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
257
394
258
    $ sudo a2enmod rewrite deflate
395
/etc/apache2/ports.conf does not require NameVirtualHost.
259
    $ sudo a2ensite koha
396
Do not add it if it is missing or already there. Just
260
    $ sudo apache2ctl restart
397
prepend # accordingly.
261
398
262
Note: you may still see the usual Apache default site if your VirtualHost
399
FILE PARTIAL (CONFIRM/ADD/CHANGE): /etc/apache2/ports.conf
263
configuration isn't correct.  The command "sudo a2dissite default" may be a
400
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
264
quick fix, but may have side-effects.  See the Apache HTTPD manual section on
401
#NameVirtualHost *:80
265
virtual hosts for full instructions.
402
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
266
403
267
5. Configure and start Zebra
404
Disable Default Site
405
=================================================================
268
406
269
Note: it's recommended that you daemonize the Zebra process and add it to your
407
These short instructions assume that the default site is
270
startup profile. For a non-production test/development installation, running
408
not needed.  Talk with your system administrator, network
271
Zebra from the command line can be useful. Pick from the two available options
409
administrator, or IT Department to CONFIRM THIS BEFORE RUNNING
272
below, or roll your own :-)
410
the following command:
411
    sudo a2dissite 000-default
273
412
274
Note: it's also recommended that you create a Koha system user, which you will
413
Enable Modules and Site
275
have specified during the install process. Alternatively, Zebra can be
414
=================================================================
276
configured to run as the root user.
277
415
278
To add a user do:
416
Now enable the apache modules this config needs, enable koha's
417
configuration, and restart apache.
418
    sudo a2enmod rewrite
419
    sudo a2enmod deflate
420
    sudo a2ensite koha
421
    sudo service apache2 restart
279
422
280
    $ sudo adduser koha
281
423
282
Option 1: run the Zebra processes from the command line:
424
SETUP ZEBRA
425
=================================================================
283
426
284
5.1.1 Zebra Search Server
427
The zebra process send responses to search requests sent by Koha
428
or Z39.50/SRU/SRW clients.
285
429
286
This process send responses to search requests sent by Koha or
430
The user you run Zebra as will be the only user with write
287
Z39.50/SRU/SRW clients.
431
permission on the Zebra index. For a standard installation, this
432
should be the system user 'koha'. For a dev installation, this
433
should be your system user.
288
434
289
    $ sudo -u ${KOHA_USER} zebrasrv -f /etc/koha/koha-conf.xml
435
Start Zebra Server on Boot
290
    (note that the path to koha-conf.xml may be different depending on your
436
=================================================================
291
    installation choices)
292
437
293
Note: the user you run Zebra as will be the only user with write permission
438
IF YOU ARE DOING A STANDARD INSTALLATION, use this command:
294
      on the Zebra index; in development mode, you may wish to use your
439
    sudo ln -s /usr/share/koha/bin/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon
295
      system user.
296
440
297
5.1.2 Zebra Indexer
441
IF YOU ARE DOING A DEV INSTALLATION, use this command:
442
    sudo ln -s ~/koha-dev/bin/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon
298
443
299
Added/updated/deleted records in Koha MySQL database must be indexed
444
FOR EITHER INSTALLATION:
300
into Zebra. A specific script must be launched each time a bibliographic
445
    sudo update-rc.d koha-zebra-daemon defaults
301
or an authority record is edited.
446
    sudo service koha-zebra-daemon start
302
447
303
    $ sudo -u ${KOHA_USER} misc/migration_tools/rebuild_zebra -z -b -a
448
Configuring Zebra Indexing
304
    NOTE: This script should be run as the kohauser (the default is 'koha').
449
=================================================================
305
450
306
Option 2: run the Zebra process as a daemon, and add to startup process:
451
IF YOU ARE DOING A STANDARD INSTALLATION, use this command:
452
    sudo nano /etc/cron.d/koha
307
453
308
Note that references to $SCRIPT_DIR refer to the directory where
454
FILE FULL: /etc/cron.d/koha
309
Koha's command-line scripts are installed, e.g., /usr/share/koha/bin.
455
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
456
# The cronjobs -- $KOHA_PATH is defined in /etc/environment, and gets set when this process runs as a user (koha).
457
*/5 * * * * koha $KOHA_PATH/bin/migration_tools/rebuild_zebra.pl -b -a -z &> /dev/null
458
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
310
459
311
5.2.1 Zebra Search Server
460
IF YOU ARE DOING A DEV INSTALLATION, use this command:
461
    crontab -e
312
462
313
    $ sudo ln -s ${SCRIPT_DIR}/koha-zebra-ctl.sh  /etc/init.d/koha-zebra-daemon
463
FILE PARTIAL (ADD):
314
    (Note: ${SCRIPT_DIR} is /usr/share/koha/bin/ by default in a standard install)
464
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
315
    $ sudo update-rc.d koha-zebra-daemon defaults
465
# The cronjobs -- $KOHA_PATH is defined in /etc/environment, and gets set when this process runs.
316
    ( Note: see man chkconfig(8) on other distros )
466
*/5 * * * *	$KOHA_PATH/misc/migration_tools/rebuild_zebra.pl -b -a -z &> /dev/null
467
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
317
468
318
    $ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start
319
469
320
5.2.2 Zebra Indexer
470
SETUP ADDITIONAL LANGUAGES
471
=================================================================
321
472
322
Add an entry in Koha user crontab to scheduled added/updated/deleted records
473
To use multi-lingual sample data, please install languages
323
indexing by Zebra with this command:
474
which may be useful for use in the Koha system.
324
475
325
  <path/to/koha>/misc/migration_tools/rebuild_zebra -z -b -a
476
Information on this can be found:
477
http://wiki.koha-community.org/wiki/Installation_of_additional_languages_for_OPAC_and_INTRANET_staff_client
326
478
327
See check misc/cronjobs/crontab.example for usage examples.
328
NOTE: This job should be setup under the kohauser (the default is 'koha').
329
479
330
You can also configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra
480
WEB INSTALLATION
481
=================================================================
331
482
332
6. Run the Web Installer, populate the database, initial configuration of settings
483
Now you can visit your staff client website to continue with the
484
Koha web installer. The user name to log in with will be koha.
333
485
334
    Point your browser to http://<servername>:8080/
486
The password will be what you set in the 'Create User and
487
Grant Permissions' section above.
335
488
336
    It should redirect you to the Web Installer where you can continue the setup.
489
Lynx navigational keys include: tab to go between fields, enter
337
    You can install the sample data for libraries, patrons, etc. via the Web Installer
490
(when not on text fields) to toggle or click, space to change
491
pages (when not on text fields), Q to quit (when not on text
492
fields). Arrows also work.
338
493
339
7. What next?
494
    sudo apt-get install lynx
340
495
341
    Once the installer has completed, you can import and index MARC records from the
496
    lynx http://127.0.1.1:8080/
342
    command line thusly (Note: you can also use the 'Stage MARC records for import' from
343
    the Tools area of Koha's Staff Client to import a batch of MARC records):
344
497
345
    $ export KOHA_CONF=/usr/share/koha/etc/koha-conf.xml
346
      (note: use the correct path to your koha-conf.xml)
347
498
348
7.1 Import:
499
SETUP YOUR LIBRARY IN KOHA
349
    Bibliographic data in MARC21 format
500
=================================================================
350
    $ misc/migration_tools/bulkmarcimport.pl -file /path/to/marc.iso2709
351
    Authority data in MARC21 format
352
    $ misc/migration_tools/bulkauthimport.pl -file /path/to/auth.iso2709
353
501
354
7.2 Fast Index:
502
After the web install, you should be redirected to:
355
    $ misc/migration_tools/rebuild_zebra.pl -b -w
503
http://127.0.1.1:8080
504
Follow these steps:
505
- Login with koha user name and password.
506
- Click on the More dropdown menu.
507
- Select and click Administration.
508
- Click Libraries and groups
509
  under the Basic Parameters heading.
510
- Click New Library and enter your information into the form.
511
- Click Submit.
512
Your Library is now setup in Koha.
356
513
357
    Once the indexing has completed, you will be able to search for records in your system.
514
Take the time to read the documentation to do other necessary
358
    NOTE: This script should be run as the kohauser (the default is 'koha').
515
setup tasks such as creating a patron, and importing or entering
516
MARC data. The documentation for Koha can be found at:
517
http://koha-community.org/documentation/
359
518
360
7.3 Schedule regular index updates
361
519
362
    You need to run rebuild_zebra.pl -b -a -z as a regular cron job in orde to pick up new bibs
520
USEFUL REFERENCE LINKS
363
    and items as you add them. Check misc/cronjobs/crontab.example for usage examples. See 7.0 above.
521
=================================================================
364
    NOTE: This job should be setup under the kohauser (the default is 'koha').
365
522
366
    You can also indexing in background, see 5.2.2 above
523
Documentation:
524
http://koha-community.org/documentation/
367
525
368
7.4 To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and
526
Additional Languages:
369
    change the <listen> options to listen on a TCP port; then restart the zebra daemon.
527
http://wiki.koha-community.org/wiki/Installation_of_additional_languages_for_OPAC_and_INTRANET_staff_client
370
528
371
UPGRADE
529
Stage MARC Records for Import:
372
=======
530
http://manual.koha-community.org/3.14/en/catalogtools.html#stagemarc
373
If you are running in another language other than english, please
531
NOTE: The URL has been similar since Koha version 3.8
374
switch to english before doing the upgrade, the templating system has
375
changed and the templates will need to be regenerated.
376
Once you have upgraded, please regenerate your templates in your
377
chosen languages.
378
532
379
If you are upgrading from a previous installation of Koha 3.x, you can
533
Frequently Asked Questions:
380
use the following:
534
http://koha-community.org/documentation/faq
381
535
382
 ./koha_perl_deps.pl -u -m # to identify new Perl dependencies
536
Bug Reports:
537
http://bugs.koha-community.org/
383
538
384
Install any missing modules
539
Public Z39.50/SRU server:
385
IMPORTANT: Koha 3.6.x uses Template::Toolkit, this must be installed
540
http://wiki.koha-community.org/wiki/Troubleshooting_Koha_as_a_Z39.50_server
386
before the webinstaller can run
387
541
388
 sudo apt-get install libtemplate-perl
542
Alternate Indexing Method:
543
http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra
389
544
390
 perl Makefile.PL --prev-install-log /path/to/koha-install-log
391
 make
392
 make test
393
 sudo make upgrade
394
545
395
Koha 3.4.x or later no longer stores items in biblio records so 
546
UPGRADING
396
if you are upgrading from an older version as part of the
547
=================================================================
397
upgrade you will need to do the following two steps, they can take a
398
long time (several hours) to complete for large databases
399
548
400
 misc/maintenance/remove_items_from_biblioitems.pl --run
549
If you are running in another language other than English,
401
 misc/migration_tools/rebuild_zebra.pl -b -r
550
please switch to English before doing the upgrade, the
551
templating system has changed and the templates will need to
552
be regenerated.
402
553
403
Uninstall Instructions
554
Once you have upgraded, please regenerate your templates in
404
=============================
555
your chosen languages.
405
1) Stop Services:
406
   $ sudo a2dissite koha
407
   $ sudo rm /etc/apache2/sites-available/koha
408
   $ sudo apache2ctl restart
409
556
410
   $ sudo update-rc.d koha-zebra-daemon remove
557
First, ensure the most recent dependencies are installed:
411
   $ sudo rm /etc/init.d/koha-zebra-daemon
558
    sudo apt-get update
559
    sudo apt-get install koha-deps koha-perldeps
412
560
413
2) Remove Database and Indexes
561
IF YOU ARE DOING A STANDARD UPGRADE:
562
In order to upgrade, find the path to the koha install-log file:
563
    sudo find /usr/share/koha/ -name 'koha-install-log'
414
564
415
   # MySQL
565
Change directory into the latest koha source directory, and then:
416
   $ mysql -u<kohauser> -p<kohapassword>
566
    perl Makefile.PL --prev-install-log /path/to/koha-install-log
417
   > drop database koha;
418
567
419
   # Zebra Indexes
568
NOTE: Make sure to change the /path/to/koha-install-log to the
420
   $ zebraidx -c <prefix>/etc/zebradb/zebra-biblios.cfg -g iso2709 -d biblios init
569
one that was found.
421
   $ zebraidx -c <prefix>/etc/zebradb/zebra-authorities.cfg -g iso2709 -d authorities init
422
570
423
3) Remove Koha Install Directories and Configuration Files
571
    make
424
   Don't forget about any crontab entries
572
    make test
425
573
426
Tested on the following operating environments
574
And if that passes:
427
==============================================
575
    sudo make upgrade
428
- Ubuntu Jaunty Jackalope 9.04
429
576
430
Installer Bug reports
577
IF YOU ARE DOING A DEV UPGRADE:
431
=====================
578
In order to upgrade, find the path to the koha install-log file:
432
Please log any installer bug reports at http://bugs.koha-community.org
579
    find ~/koha-dev/ -name 'koha-install-log'
433
580
434
Other Notes
581
    cd ~/kohaclone
435
=====================
582
    perl Makefile.PL --prev-install-log /path/to/koha-install-log
436
This file is part of Koha
437
583
438
Koha is free software; you can redistribute it and/or modify it under the
584
NOTE: Make sure to change the /path/to/koha-install-log to the
439
terms of the GNU General Public License as published by the Free Software
585
one that was found.
440
Foundation; either version 2 of the License, or (at your option) any later
441
version.
442
586
443
Koha is distributed in the hope that it will be useful, but WITHOUT ANY
587
    make
444
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
588
    make test
445
A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
589
446
You should have received a copy of the GNU General Public License along
590
And if that passes:
447
with Koha; if not, write to the Free Software Foundation, Inc.,
591
    make upgrade
448
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
592
593
FOR EITHER UPGRADE TYPE:
594
If you are upgrading from a version of Koha earlier than 3.4.x,
595
Koha 3.4.x or later no longer stores items in biblio records:
596
./misc/maintenance/remove_items_from_biblioitems.pl --run
597
Intentionally not indented, in the hopes that most upgrades are
598
post 3.4.x.
599
600
Regardless of version you are upgrading from, a full reindex is
601
always the best option:
602
IF YOU ARE DOING A STANDARD UPGRADE
603
    sudo su -l koha --command="/usr/bin/perl /usr/share/koha/bin/migration_tools/rebuild_zebra.pl -b -a -r -v"
604
605
IF YOU ARE DOING A DEV UPGRADE
606
    ./misc/migration_tools/rebuild_zebra.pl -b -a -r -v
607
608
609
UNINSTALL INSTRUCTIONS
610
=================================================================
611
612
Stop Services
613
=================================================================
614
    sudo a2dissite koha
615
    sudo rm /etc/apache2/sites-available/koha
616
    sudo service apache2 restart
617
    sudo update-rc.d koha-zebra-daemon remove
618
    sudo rm /etc/init.d/koha-zebra-daemon
619
620
Remove Database
621
=================================================================
622
    mysql -u koha -p
623
624
    drop database kohadata;
625
    quit
626
627
Remove Indexes
628
=================================================================
629
630
IF DOING A STANDARD REMOVAL:
631
    zebraidx -c /etc/koha/zebradb/zebra-biblios.cfg -g iso2709 -d biblios init
632
    zebraidx -c /etc/koha/zebradb/zebra-authorities.cfg -g iso2709 -d authorities init
633
    sudo rm -rf /etc/koha
634
    sudo rm -rf /usr/share/koha
635
    sudo rm /etc/cron.d/koha
636
637
You may wish to follow up with:
638
    sudo find / -t d -name "koha"
639
to help find any remnants.
640
641
IF DOING A DEV REMOVAL:
642
The following will work, but is very dangerous! Please copy or
643
type this correctly.
644
    zebraidx -c ~/koha-dev/etc/zebradb/zebra-biblios.cfg -g iso2709 -d biblios init
645
    zebraidx -c ~/koha-dev/etc/zebradb/zebra-authorities.cfg -g iso2709 -d authorities init
646
    rm -rf ~/koha-dev
647
    rm -rf ~/kohaclone
648
NOTE: Don't forget to remove the crontab entries!
649
650
651
LICENSE
652
=================================================================
653
654
This file is part of Koha.
655
656
Major re-write by Mark Tompsett
657
Copyright (C) 2013
658
659
Based on remnants by:
660
Copyright (C) 2007, 2008 LibLime (http://liblime.com)
661
                          Original author: Joshua Ferraro
662
Some parts Copyright (C) 2010 Chris Nighswonger (modified for ubuntu)
663
                          (cnighswonger AT foundations DOT edu)
664
Some parts Copyright (C) 2012 Tomas Cohen Arazi
665
                          (tomascohen AT gmail DOT com)
666
Some parts Copyright (C) 2012 Mark Tompsett
667
                          (mtompset AT hotmail DOT com)
668
669
Koha is free software; you can redistribute it and/or modify it
670
under the terms of the GNU General Public License as published by
671
the Free Software Foundation; either version 3 of the License, or
672
(at your option) any later version.
673
674
Koha is distributed in the hope that it will be useful, but
675
WITHOUT ANY WARRANTY; without even the implied warranty of
676
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
677
GNU General Public License for more details.
678
679
You should have received a copy of the GNU General Public License
680
along with Koha; if not, see <http://www.gnu.org/licenses>.
(-)a/INSTALL.ubuntu.12.04 (-571 lines)
Lines 1-571 Link Here
1
=================================================================
2
Installation Guide for Installing Koha
3
on Ubuntu Precise Pangolin (12.04 LTS) with MySQL 5.5
4
=================================================================
5
6
Copyright (C) 2007, 2008 LibLime (http://liblime.com)
7
Some parts copyright 2010 Chris Nighswonger
8
Some parts copyright 2012 Tomas Cohen Arazi
9
Some parts copyright 2012 Mark Tompsett
10
11
Original author: Joshua Ferraro
12
Modified for Ubuntu by: Chris Nighswonger
13
                        (cnighswonger AT foundations DOT edu)
14
15
More updates by: Tomas Cohen Arazi (tomascohen AT gmail DOT com)
16
                 Mark Tompsett (mtompset AT hotmail DOT com)
17
18
Feedback/bug reports: Koha Developer's List:
19
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
20
21
This document last modified: 24 July 2012
22
23
Installation Instructions
24
=================================================================
25
26
Running commands can mostly be performed as a system user with
27
sudo privileges, however some need to be run directly as root.
28
29
1. Prepare System and Install Dependencies
30
31
1.1 Install Ubuntu 12.04 LTS via CD/DVD/USB
32
33
  Download and install Ubuntu from the official site.
34
    - Server edition (command-line only)
35
        http://www.ubuntu.com/download/server
36
    - Desktop edition
37
        http://www.ubuntu.com/download/desktop
38
  To keep your Koha installation minimal and to free resources
39
  for running, the Server edition is recommended, though the
40
  Desktop edition will work as well.
41
42
  As Apache and MySQL will be installed in the instructions
43
  later, there is no need to select any packages during the
44
  installation of Ubuntu.
45
46
1.2 Add koha repository to your apt sources
47
48
  NOTE: This is not required for koha 3.6.7 under Ubuntu 12.04
49
        if Zebra indexing (see step 5.2) is done via cron jobs.
50
  NOTE: 3.8.x is the recommended current stable release to use.
51
52
  There are currently three active repositories: oldstable,
53
  squeeze, and squeeze-dev. As of 2012-07-24, they represent
54
  3.6.x, 3.8.x, and master respectively. This will change when
55
  3.10.x is released. They will represent 3.8.x, 3.10.x, and
56
  master respectively.
57
58
  It is recommended to use squeeze at this time, as 3.8.x is the
59
  current stable release.
60
61
  Run these commands:
62
    $ echo "deb http://debian.koha-community.org/koha squeeze main" | sudo tee /etc/apt/sources.list.d/koha-community.list
63
    $ wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -
64
    $ sudo apt-get update ; sudo apt-get upgrade
65
66
1.3 Install Apache2 and MySQL 5.5
67
68
  Install the Apache2 server:
69
    $ sudo apt-get install apache2
70
71
  If your MySQL server will be on your Koha server, or this
72
  instruction is confusing:
73
    $ sudo apt-get install mysql-server
74
75
  NOTE: You will be prompted to set your root password for MySQL.
76
77
1.4 Set up your locale
78
79
  Your locale should be set to UTF-8, as should Apache2 and
80
  MySQL 5.5. This step is VERY IMPORTANT for a UNICODE compliant
81
  system. You _MUST_ be sure to set this BEFORE you install Koha.
82
83
1.4.1 Ubuntu Locale
84
85
  Verify you have a UTF-8 locale in use:
86
    $ locale
87
  You will recognize if it is UTF-8 or not. Ubuntu 12.04 should
88
  not generally require any further steps.
89
90
  If it is not set to something UTF-8, use:
91
    $ locale -a
92
93
  You can select one (note that utf8 becomes UTF-8) and use:
94
    $ sudo update-locale LANG=en_US.UTF-8
95
96
  You have to log out and back in to see locale change reflected
97
  in the locale command.
98
99
  Verify your system local by running the following command:
100
    $ locale
101
102
1.4.2 Apache2 and MySQL Locales
103
  Please read over the following document carefully for more
104
  information:
105
    http://wiki.koha-community.org/wiki/Koha_on_Ubuntu#Configuring_the_Character_Set
106
107
1.5 Get Koha
108
109
  There are two ways to install Koha. The easy way is using Debian/Ubuntu
110
  packages (check http://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages
111
  for further instructions).
112
113
  The other way is installing from sources. You can get Koha's source
114
  either using git (see 1.5.1) or downloading the stable release tarball.
115
116
  1.5.1 Download from Git
117
118
  Install Git:
119
    $ sudo apt-get install git
120
121
  Download Koha (the 3.10.x branch):
122
    $ git clone git://git.koha-community.org/koha.git kohaclone
123
    $ cd kohaclone
124
    $ git checkout -b myinstall origin/3.10.x
125
126
  NOTE: for more information about Git, please see the Koha Git
127
        Usage Guide:
128
   http://wiki.koha-community.org/wiki/Version_Control_Using_Git
129
130
  1.5.2 Download from Tarball
131
132
  You can get the sources from
133
   http://download.koha-community.org. Issuing the following
134
  command you can get the latest stable release (recommended):
135
136
  Download and Unpack Koha:
137
    $ wget http://download.koha-community.org/koha-latest.tar.gz
138
    $ tar xvf koha-latest.tar.gz
139
140
  Determine the version and change directory:
141
    $ ls
142
    koha-3.10.00  koha-latest.tar.gz
143
    $ cd koha-3.10.00
144
145
146
1.6 Install additional Ubuntu dependencies
147
148
  Several Koha dependencies have been conveniently packaged and
149
  will be installed issuing the following command:
150
151
    $ sudo apt-get install `cat install_misc/ubuntu.12.04.packages | \
152
            cut -f1 | grep -v '#' | grep -v -e '^$'`
153
154
  Confirm that you want to install the required packages when prompted,
155
156
1.7 Install Perl dependencies that aren't packaged
157
158
****************************************************************
159
  IMPORTANT:  You should only use CPAN for Perl dependencies
160
              which are NOT available from the package
161
              maintainer. You have been warned!
162
****************************************************************
163
164
  Run the test script to identify missing libraries
165
    $ ./koha_perl_deps.pl -m -u
166
167
  If there are any dependencies which are missing or need
168
  upgrading, first attempt aptitude searches:
169
    $ aptitude search libbusiness-isdn-perl
170
171
  Notice how the name transformed to 'lib' plus the lowercase
172
  library name using '-'s instead of '::'s plus '-perl'. This
173
  will generally help find what is missing. And then a simple
174
  apt-get install can be done:
175
    $ sudo apt-get install libbusiness-isdn-perl
176
177
  Do this for all the dependencies listed. Then re-run the
178
  command:
179
    $ ./koha_perl_deps.pl -m -u
180
181
  In general, the repositories on debian.koha-community.org
182
  should have any missing pieces. The list should be empty.
183
184
  If any are still listed, they can be installed using the 'cpan'
185
  command. If and only if you are unable to find any of the
186
  dependencies should you use the cpan command. For example:
187
    $ sudo cpan GD GD::Barcode::UPCE Algorithm::CheckDigits
188
189
  NOTE: you may need to run CPAN initialization if you've not run
190
        cpan before:
191
--------
192
    /etc/perl/CPAN/Config.pm initialized.
193
194
    CPAN is the world-wide archive of perl resources. It consists of about
195
    100 sites that all replicate the same contents all around the globe.
196
    Many countries have at least one CPAN site already. The resources
197
    found on CPAN are easily accessible with the CPAN.pm module. If you
198
    want to use CPAN.pm, you have to configure it properly.
199
200
    If you do not want to enter a dialog now, you can answer 'no' to this
201
    question and I'll try to autoconfigure. (Note: you can revisit this
202
    dialog anytime later by typing 'o conf init' at the cpan prompt.)
203
204
    Are you ready for manual configuration? [yes]
205
--------
206
  When the configuration is completed CPAN will install the Perl
207
  modules passed on the command-line.
208
209
  For further explanation and reading see:
210
     http://wiki.koha-community.org/wiki/Koha_on_Ubuntu#Ubuntu_Packages_for_Perl_Dependencies
211
212
213
2. Configuration of dependencies
214
215
2.1 Update root MySQL password
216
217
  If during the installation of MySQL you were not prompted to
218
  set the MySQL password:
219
    $ sudo mysqladmin password <password>
220
221
2.2 Create the Koha database
222
223
  Create the database and user with associated privileges. To do
224
  this, decide on the koha database name, the koha user name, and
225
  the koha user password. Substitute these into the following
226
  commands:
227
    $ mysql -u root -p
228
    Enter mysql root password:
229
    Welcome to the MySQL monitor.  Commands end with ; or \g.
230
    Your MySQL connection id is 42
231
    Server version: 5.5.24-0ubuntu0.12.04.1 (Ubuntu)
232
233
    Copyright (c) 2000, 2011, Oracle and/or its affiliates. All rights reserved.
234
235
    Oracle is a registered trademark of Oracle Corporation and/or its
236
    affiliates. Other names may be trademarks of their respective
237
    owners.
238
239
    Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
240
241
    mysql> CREATE DATABASE {kohadatabasename};
242
    mysql> SHOW DATABASES;
243
    mysql> CREATE user '{kohauserbasename}'@'localhost' IDENTIFIED by '{kohauserpassword}';
244
    mysql> GRANT ALL ON {kohadatabasename}.* TO '{kohausername}'@'localhost' IDENTIFIED BY '{kohauserpassword}';
245
    mysql> USE mysql;
246
    mysql> SELECT host,user FROM user;
247
    mysql> DELETE FROM user WHERE user='';
248
    mysql> SELECT host,user FROM user;
249
    mysql> FLUSH PRIVILEGES;
250
    mysql> QUIT
251
252
  For further explanation of these commands see:
253
    http://wiki.koha-community.org/wiki/Koha_on_Ubuntu#Create_MySQL_Database_and_Grant_Privileges
254
255
256
2.3 Test your SAX Parser and correct where necessary
257
258
  You must be sure you're using the XML::LibXML SAX parser, not
259
  Expat or PurePerl, both of which have outstanding bugs with
260
  pre-composed characters. Test your SAX parser by running:
261
    $ ./misc/sax_parser_print.pl
262
263
  If your setup is wrong, the script will output something like:
264
    Koha wants something like:
265
      XML::LibXML::SAX::Parser=HASH(0x81fe220)
266
    You have:
267
      XML::SAX::Expat=HASH(0x1a94e88)
268
    Looks bad, check INSTALL.* documentation.
269
270
  It means you are using Expat (it could also say PurePerl).
271
  You'll need to edit your ini file, located at:
272
    /etc/perl/XML/SAX/ParserDetails.ini
273
274
  Move the entire section for '[XML::LibXML::SAX::Parser]' to the
275
  bottom of the ini file. Then run the script again. The output
276
  should look like this:
277
    $ misc/sax_parser_print.pl
278
    Koha wants something like:
279
      XML::LibXML::SAX::Parser=HASH(0x81fe220)
280
    You have:
281
      XML::LibXML::SAX::Parser=HASH(0x16dfee8)
282
    Looks good.
283
284
  For further details see:
285
    http://wiki.koha-community.org/wiki/Koha_on_Ubuntu#Test_to_make_sure_the_SAX_Parser_is_setup_correctly
286
287
288
3. Run the Koha installer
289
290
  Add a user for installing koha and running zebra:
291
    $ sudo adduser koha
292
293
  Build and install Koha:
294
    $ perl Makefile.PL
295
    ( answer questions )
296
    $ make
297
    $ make test
298
    $ sudo make install
299
300
301
4. Configure and start Apache
302
303
  This will help make koha available to be a website:
304
   $ sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
305
306
  NOTE: the path to koha-httpd.conf may be different depending on
307
        your installation choices.
308
309
  Make sure you have this lines in /etc/apache2/ports.conf:
310
    Listen 80
311
    Listen 8080
312
  Add the missing one.
313
314
  The default installation of Koha does not use named virtual
315
  hosts. If you will not be running named virtual hosts, comment
316
  out the following line:
317
    NameVirtualHost *:80
318
319
  Run the following commands:
320
    $ sudo a2enmod rewrite deflate
321
    $ sudo a2ensite koha
322
    $ sudo apache2ctl restart
323
324
  Note: you may still see the usual Apache default site if your
325
        VirtualHost configuration isn't correct.  The command
326
        "sudo a2dissite default" may be a quick fix, but may have
327
        side-effects.  See the Apache HTTPD manual section on
328
        virtual hosts for full instructions.
329
330
331
5. Configure and start Zebra
332
333
  This process send responses to search requests sent by Koha or
334
  Z39.50/SRU/SRW clients.
335
336
  NOTE: the user you run Zebra as will be the only user with
337
        write permission on the Zebra index; in development mode,
338
        you may wish to use your system user.
339
340
341
5.1 Zebra Search Server
342
343
  Set the zebra daemon to run on start:
344
    $ sudo ln -s /usr/share/koha/bin/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon
345
    $ sudo update-rc.d koha-zebra-daemon defaults
346
    $ sudo /etc/init.d/koha-zebra-daemon start
347
348
  NOTE: change the path to koha-zebra-ctl.sh to match your setup
349
        if not using the default.
350
351
352
5.2 Zebra Indexer
353
354
  There are two ways to do this. ONLY DO ONE! DO NOT DO BOTH!
355
356
  Option 1:
357
    You can configure zebra-indexing as an background daemon, see
358
      http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra
359
360
  Option 2:
361
362
    Add an entry in Koha user crontab to scheduled
363
    added/updated/deleted records indexing by Zebra with this
364
    command:
365
      <path/to/koha>/misc/migration_tools/rebuild_zebra -z -b -a
366
367
    See check misc/cronjobs/crontab.example for usage examples.
368
369
    NOTE: This job should be setup under the kohauser
370
          (the default is 'koha').
371
372
373
6. Run the Web Installer, populate the database,
374
   initial configuration of settings
375
376
  The hope is that your server is accessible via a nice browser
377
  somewhere. If not, install lynx to finish the web install on
378
  your Koha server:
379
    $ sudo apt-get install lynx
380
381
  Point your browser to http://<servername>:8080/
382
383
  If you installed lynx, and are using defaults, it might be
384
  something like:
385
    $ lynx http://127.0.1.1:8080/
386
387
  It should redirect you to the Web Installer where you can
388
  continue the setup. You can install the sample data for
389
  libraries, patrons, etc. via the Web Installer
390
391
392
7. Install additional languages
393
394
  In your install directory you can run this commands to have
395
  your Koha setup translated to your language:
396
397
  Set your environment variables:
398
    $ export KOHA_CONF=/etc/koha/sites/koha/koha-conf.xml
399
    $ export PERL5LIB=/usr/share/koha/lib/
400
401
  NOTE: the path to koha-conf.xml may be different depending on
402
        your installation choices.
403
404
  Run the translator script:
405
    $ cd /usr/share/koha/misc/translator
406
    $ perl translate install <language-code>
407
408
  <language-code> must be one of the included in the
409
  misc/translator/po directory.
410
411
  NOTE: You can add as many languages as you need. In order to
412
        use them you will have to enable them first in the
413
        'I18N/L10N' section of the Koha preferences.
414
415
416
8. What next?
417
418
  NOTE: You can use the 'Stage MARC records for import' from the
419
        Tools area of Koha's Staff Client to import a batch of
420
        MARC records, rather than these instructions.
421
422
  Once the installer has completed, you can import and index MARC
423
  records from the command line thusly:
424
    $ export KOHA_CONF=/usr/share/koha/etc/koha-conf.xml
425
  NOTE: use the correct path to your koha-conf.xml
426
427
8.1 Import
428
429
  Bibliographic data in MARC21 format:
430
    $ misc/migration_tools/bulkmarcimport.pl -file /path/to/marc.iso2709
431
432
  Authority data in MARC21 format:
433
    $ misc/migration_tools/bulkauthimport.pl -file /path/to/auth.iso2709
434
435
8.2 Fast Index:
436
437
  NOTE: This script must be run as the kohauser otherwise
438
        permission errors and indexing problems will follow.
439
        (the default is 'koha' -- see step 3).
440
441
    $ misc/migration_tools/rebuild_zebra.pl -b -w
442
443
  Once the indexing has completed, you will be able to search for
444
  records in your system.
445
446
447
8.3 Public Z39.50/SRU server
448
449
  To enable public Z39.50/SRU servers, you'll need to edit your
450
  koha-conf.xml and change the <listen> options to listen on a
451
  TCP port; then restart the zebra daemon.
452
453
454
UPGRADE
455
=================================================================
456
457
  If you are running in another language other than English,
458
  please switch to English before doing the upgrade, the
459
  templating system has changed and the templates will need to be
460
  regenerated.
461
462
  Once you have upgraded, please regenerate your templates in
463
  your chosen languages.
464
465
466
1. Install new Perl dependencies
467
468
  If you are upgrading from a previous installation of Koha 3.x,
469
  you can use the following to identify new Perl dependencies:
470
    $ ./koha_perl_deps.pl -u -m
471
472
  Install any missing modules using the instructions on sections
473
  1.6 and 1.7.
474
475
476
2. Upgrade Koha
477
478
    $ perl Makefile.PL --prev-install-log /path/to/koha-install-log
479
    $ make
480
    $ make test
481
    $ sudo make upgrade
482
483
484
3. Pre-3.4 upgrades
485
486
  Koha 3.4.x or later no longer stores items in biblio records so
487
  if you are upgrading from an older version as part of the
488
  upgrade you will need to do the following two steps, they can
489
  take a long time (several hours) to complete for large
490
  databases:
491
    $ misc/maintenance/remove_items_from_biblioitems.pl --run
492
    $ misc/migration_tools/rebuild_zebra.pl -b -r
493
494
495
Uninstall Instructions
496
=================================================================
497
498
1. Stop Services:
499
500
  Firstly, remove the apache website:
501
    $ sudo a2dissite koha
502
    $ sudo rm /etc/apache2/sites-available/koha
503
    $ sudo apache2ctl restart
504
505
  Next, remove the koha-zebra-daemon:
506
    $ sudo update-rc.d koha-zebra-daemon remove
507
    $ sudo rm /etc/init.d/koha-zebra-daemon
508
509
510
2a. Remove Database:
511
512
  Remember the <kohauser>, <kohapassword, and <kohadatabasename>
513
  need to be substituted on the following commands:
514
   $ mysql -u<kohauser> -p<kohapassword>
515
   mysql> drop database <kohadatabasename>;
516
517
518
2b. Remove Indexes:
519
520
  To help determine what <prefix> should be substituted with,
521
  run the following command:
522
    $ sudo find / -name "zebra-biblios.cfg"
523
    /etc/koha/zebradb/zebra-biblios.cfg
524
    /home/user/koha-3.08.03/etc/zebradb/zebra-biblios.cfg
525
    /home/user/koha-3.08.03/blib/ZEBRA_CONF_DIR/zebra-biblios.cfg
526
  There may be three copies, two of which will likely be in the
527
  user account that installed Koha. In this example, our <prefix>
528
  is '/etc/koha'.
529
530
  Once you know the value of prefix, run these commands
531
  substituting in the correct value:
532
   $ zebraidx -c <prefix>/zebradb/zebra-biblios.cfg -g iso2709 -d biblios init
533
   $ zebraidx -c <prefix>/zebradb/zebra-authorities.cfg -g iso2709 -d authorities init
534
535
536
3. Remove Koha Install Directories and Configuration Files
537
   Don't forget about any crontab entries
538
539
540
Tested on the following operating environments
541
=================================================================
542
  - Ubuntu Precise Pangolin 12.04
543
544
545
Installer Bug reports
546
=================================================================
547
  Please log any installer bug reports at
548
  http://bugs.koha-community.org
549
550
551
Other Notes
552
=================================================================
553
This file is part of Koha
554
555
Koha is free software; you can redistribute it and/or modify it
556
under the terms of the GNU General Public License as published by
557
the Free Software Foundation; either version 2 of the License, or
558
(at your option) any later version.
559
560
Koha is distributed in the hope that it will be useful, but
561
WITHOUT ANY WARRANTY; without even the implied warranty of
562
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
563
GNU General Public License for more details.
564
565
You should have received a copy of the GNU General Public License
566
along with Koha; if not, write to the Free Software Foundation:
567
    Free Software Foundation
568
    51 Franklin Street, Fifth Floor
569
    Boston, MA 02110-1301
570
    USA
571
Or visit their website: http://www.fsf.org/
(-)a/INSTALL.ubuntu.lucid (-381 lines)
Lines 1-380 Link Here
1
=============================
2
Installation Guide for Installing Koha on Ubuntu Lucid Lynx (10.04 LTS) with MySQL 5
3
=============================
4
5
Copyright (C) 2007, 2008 LibLime (http://liblime.com)
6
Some parts copyright 2010 Chris Nighswonger
7
8
Original author: Joshua Ferraro
9
Modified for Ubuntu by: Chris Nighswonger (cnighswonger AT foundations DOT edu)
10
11
Feedback/bug reports: Koha Developer's List:
12
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
13
14
This document last modified: 20 Marchp 2012
15
16
Installation Instructions
17
=============================
18
19
All commands can be performed as a system user with sudo privileges,
20
as indicated or by running the command directly as root.
21
22
1. Prepare System and Install Dependencies
23
24
1.1 Install Ubuntu Lucid Lynx via CD
25
26
See http://www.ubuntu.com/getubuntu/download
27
28
1.2 Set up your locale
29
30
Your locale should be set to UTF-8, as should Apache2 and MySQL 5.
31
This step is VERY IMPORTANT for a UNICODE compliant system. Please
32
read over the following document carefully:
33
34
http://wiki.koha-community.org/wiki/Encoding_and_Character_Sets_in_Koha
35
36
You can verify your system locale by typing the following command:
37
38
    $ locale
39
40
IMPORTANT:  You _MUST_ follow all the steps outlined there for
41
            Apache2, MySQL 5, etc. BEFORE you install Koha.
42
43
1.3 Get Koha
44
45
1.3.1 Option A: Download Koha via Git (optional)
46
47
    $ sudo apt-get install git-core git-email
48
    $ git clone git://git.koha-community.org/koha.git kohaclone
49
    $ cd kohaclone
50
    $ git checkout -b myinstall origin
51
52
Note: for more information about Git, please see the Koha Git Usage Guide:
53
54
    http://wiki.koha-community.org/wiki/Version_Control_Using_Git
55
56
1.3.2 Option B: Download Koha from http://download.koha-community.org
57
58
    $ wget http://download.koha-community.org/koha-3.02.00.tar.gz
59
    ( Note: use the latest stable version)
60
61
1.4 Install additional Ubuntu dependencies
62
63
IMPORTANT:  You should only use CPAN for Perl dependencies which are NOT
64
            available from the package maintainer. You have been warned!
65
66
Using the ubuntu.packages file included in the Koha source tree,
67
run the following:
68
69
    $ sudo dpkg --set-selections < install_misc/ubuntu.packages
70
71
Now start dselect (you may need to 'sudo apt-get install dselect'):
72
73
    $ sudo dselect
74
75
Choose [I]nstall and accept packages to be installed (hit return)
76
77
(may take a while)
78
79
Choose [C]onfigure, [R]emove and [Q]uit until dselect has completed.
80
81
Note: If you are installing on an older version of Ubuntu, not all of the
82
      packages listed in ubuntu.packages may be available as packages.  You
83
      will want to verify which ones are installed and which ones not.
84
      This can be done by running the following command:
85
86
    $ install_misc/ubuntu-pkg-check.sh | grep none
87
88
When tracking down any "(none)" results, note that sometimes Ubuntu does the
89
right thing and installs a later, differently named version of the package in
90
place.  To see if this is happening, it is useful to run a command like:
91
92
    $ dpkg --get-selections | grep [base_package_name]
93
94
1.5 Install Perl dependencies that aren't packaged into Ubuntu Lucid Lynx
95
sources
96
97
Run the following command:
98
99
    $ sudo cpan HTTP::OAI Locale::Currency::Format Memoize::Memcached \
100
                PDF::API2::Simple Storable Text::CSV::Encoded CHI \
101
                CHI::Driver::Memcached
102
103
Note: you may need to run CPAN initialization if you've not run cpan
104
before:
105
106
    /etc/perl/CPAN/Config.pm initialized.
107
108
    CPAN is the world-wide archive of perl resources. It consists of about
109
    100 sites that all replicate the same contents all around the globe.
110
    Many countries have at least one CPAN site already. The resources
111
    found on CPAN are easily accessible with the CPAN.pm module. If you
112
    want to use CPAN.pm, you have to configure it properly.
113
114
    If you do not want to enter a dialog now, you can answer 'no' to this
115
    question and I'll try to autoconfigure. (Note: you can revisit this
116
    dialog anytime later by typing 'o conf init' at the cpan prompt.)
117
118
    Are you ready for manual configuration? [yes]
119
120
When the configuration is completed CPAN will install the Perl modules.
121
122
2. Configuration of dependencies
123
124
2.1 Update root MySQL password (if dselect didn't do it for you already)
125
126
    $ sudo mysqladmin password <password>
127
128
2.2 Create the Koha database
129
130
    Create the database and user with associated privileges:
131
132
    $ mysqladmin -uroot -p<password> create <kohadatabasename>
133
    $ mysql -uroot -p<password>
134
135
    Welcome to the MySQL monitor.  Commands end with ; or \g.
136
    Your MySQL connection id is 22
137
    Server version: 5.0.32-Debian_7etch3-log Debian etch distribution
138
139
    Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
140
141
    mysql> grant all on <kohadatabasename>.* to '<kohadatabaseuser>'@'localhost' identified by '<kohadatabaseuserpassword>';
142
    Query OK, 0 rows affected (0.00 sec)
143
144
    mysql> flush privileges;
145
    Query OK, 0 rows affected (0.00 sec)
146
147
    mysql> quit
148
149
2.3 Test your SAX Parser and correct where necessary
150
151
    You must be sure you're using the XML::LibXML SAX parser, not Expat or
152
    PurePerl, both of which have outstanding bugs with pre-composed
153
    characters. You can test your SAX parser by running:
154
155
    $ cd koha
156
    $ misc/sax_parser_print.pl
157
158
    You should see something like::
159
160
    XML::LibXML::SAX::Parser=HASH(0x81fe220)
161
162
    If you're using PurePerl or Expat, you'll need to edit your
163
    ini file, typically located at:
164
165
    /etc/perl/XML/SAX/ParserDetails.ini
166
167
    You will need to move the entire section for '[XML::LibXML::SAX::Parser]'
168
    to the bottom of the ini file.
169
170
3. Run the Koha installer
171
172
    $ perl Makefile.PL
173
    ( answer questions )
174
    $ make
175
    $ make test
176
    $ sudo make install
177
178
4. Configure and start Apache
179
    $ sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
180
    (note that the path to koha-httpd.conf may be different depending on your
181
    installation choices)
182
183
Add the following lines to /etc/apache2/ports.conf:
184
185
    Listen 80
186
    Listen 8080
187
188
If not running named virtual hosts (The default koha installation does not use
189
named virtual hosts.), comment out the following line:
190
191
    NameVirtualHost *:80
192
193
Run the following commands:
194
195
    $ sudo a2enmod rewrite deflate
196
    $ sudo a2ensite koha
197
    $ sudo apache2ctl restart
198
199
Note: you may still see the usual Apache default site if your VirtualHost
200
configuration isn't correct.  The command "sudo a2dissite default" may be a
201
quick fix, but may have side-effects.  See the Apache HTTPD manual section on
202
virtual hosts for full instructions.
203
204
5. Configure and start Zebra
205
206
Note: it's recommended that you daemonize the Zebra process and add it to your
207
startup profile. For a non-production test/development installation, running
208
Zebra from the command line can be useful. Pick from the two available options
209
below, or roll your own :-)
210
211
Note: it's also recommended that you create a Koha system user, which you will
212
have specified during the install process. Alternatively, Zebra can be
213
configured to run as the root user.
214
215
To add a user do:
216
217
    $ sudo adduser koha
218
219
Option 1: run the Zebra processes from the command line:
220
221
5.1.1 Zebra Search Server
222
223
This process send responses to search requests sent by Koha or
224
Z39.50/SRU/SRW clients.
225
226
    $ sudo -u ${KOHA_USER} zebrasrv -f /etc/koha/koha-conf.xml
227
    (note that the path to koha-conf.xml may be different depending on your
228
    installation choices)
229
230
Note: the user you run Zebra as will be the only user with write permission
231
      on the Zebra index; in development mode, you may wish to use your
232
      system user.
233
234
5.1.2 Zebra Indexer
235
236
Added/updated/deleted records in Koha MySQL database must be indexed
237
into Zebra. A specific script must be launched each time a bibliographic
238
or an authority record is edited.
239
240
    $ sudo -u ${KOHA_USER} misc/migration_tools/rebuild_zebra -z -b -a
241
    NOTE: This script should be run as the kohauser (the default is 'koha').
242
243
Option 2: run the Zebra process as a daemon, and add to startup process:
244
245
Note that references to $SCRIPT_DIR refer to the directory where
246
Koha's command-line scripts are installed, e.g., /usr/share/koha/bin.
247
248
5.2.1 Zebra Search Server
249
250
    $ sudo ln -s ${SCRIPT_DIR}/koha-zebra-ctl.sh  /etc/init.d/koha-zebra-daemon
251
    (Note: ${SCRIPT_DIR} is /usr/share/koha/bin/ by default in a standard install)
252
    $ sudo update-rc.d koha-zebra-daemon defaults
253
    ( Note: see man chkconfig(8) on other distros )
254
255
    $ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start
256
257
5.2.2 Zebra Indexer
258
259
Add an entry in Koha user crontab to scheduled added/updated/deleted records
260
indexing by Zebra with this command:
261
262
  <path/to/koha>/misc/migration_tools/rebuild_zebra -z -b -a
263
264
See check misc/cronjobs/crontab.example for usage examples.
265
NOTE: This job should be setup under the kohauser (the default is 'koha').
266
267
You can also configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra
268
269
6. Run the Web Installer, populate the database, initial configuration of settings
270
271
    Point your browser to http://<servername>:8080/
272
273
    It should redirect you to the Web Installer where you can continue the setup.
274
    You can install the sample data for libraries, patrons, etc. via the Web Installer
275
276
7. What next?
277
278
    Once the installer has completed, you can import and index MARC records from the
279
    command line thusly (Note: you can also use the 'Stage MARC records for import' from
280
    the Tools area of Koha's Staff Client to import a batch of MARC records):
281
282
    $ export KOHA_CONF=/usr/share/koha/etc/koha-conf.xml
283
      (note: use the correct path to your koha-conf.xml)
284
285
7.1 Import:
286
    Bibliographic data in MARC21 format
287
    $ misc/migration_tools/bulkmarcimport.pl -file /path/to/marc.iso2709
288
    Authority data in MARC21 format
289
    $ misc/migration_tools/bulkauthimport.pl -file /path/to/auth.iso2709
290
291
7.2 Fast Index:
292
    $ misc/migration_tools/rebuild_zebra.pl -b -w
293
294
    Once the indexing has completed, you will be able to search for records in your system.
295
    NOTE: This script should be run as the kohauser (the default is 'koha').
296
297
7.3 Schedule regular index updates
298
299
    You need to run rebuild_zebra.pl -b -a -z as a regular cron job in orde to pick up new bibs
300
    and items as you add them. Check misc/cronjobs/crontab.example for usage examples. See 7.0 above.
301
    NOTE: This job should be setup under the kohauser (the default is 'koha').
302
303
    You can also indexing in background, see 5.2.2 above
304
305
7.4 To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and
306
    change the <listen> options to listen on a TCP port; then restart the zebra daemon.
307
308
UPGRADE
309
=======
310
If you are running in another language other than english, please
311
switch to english before doing the upgrade, the templating system has
312
changed and the templates will need to be regenerated.
313
Once you have upgraded, please regenerate your templates in your
314
chosen languages.
315
316
If you are upgrading from a previous installation of Koha 3.x, you can
317
use the following:
318
319
 ./koha_perl_deps.pl -u -m # to identify new Perl dependencies
320
321
Install any missing modules
322
IMPORTANT: Koha 3.6.x uses Template::Toolkit, this must be installed
323
before the webinstaller can run
324
325
 sudo apt-get install libtemplate-perl
326
327
Koha 3.4.x or later no longer stores items in biblio records so
328
if you are upgrading from an older version as part of the
329
upgrade you will need to do the following two steps, they can take a
330
long time (several hours) to complete for large databases
331
332
 misc/maintenance/remove_items_from_biblioitems.pl --run
333
 misc/migration_tools/rebuild_zebra.pl -b -r
334
335
Uninstall Instructions
336
=============================
337
1) Stop Services:
338
   $ sudo a2dissite koha
339
   $ sudo rm /etc/apache2/sites-available/koha
340
   $ sudo apache2ctl restart
341
342
   $ sudo update-rc.d koha-zebra-daemon remove
343
   $ sudo rm /etc/init.d/koha-zebra-daemon
344
345
2) Remove Database and Indexes
346
347
   # MySQL
348
   $ mysql -u<kohauser> -p<kohapassword>
349
   > drop database koha;
350
351
   # Zebra Indexes
352
   $ zebraidx -c <prefix>/etc/zebradb/zebra-biblios.cfg -g iso2709 -d biblios init
353
   $ zebraidx -c <prefix>/etc/zebradb/zebra-authorities.cfg -g iso2709 -d authorities init
354
355
3) Remove Koha Install Directories and Configuration Files
356
   Don't forget about any crontab entries
357
358
Tested on the following operating environments
359
==============================================
360
- Ubuntu Jaunty Jackalope 9.04
361
362
Installer Bug reports
363
=====================
364
Please log any installer bug reports at http://bugs.koha-community.org
365
366
Other Notes
367
=====================
368
This file is part of Koha
369
370
Koha is free software; you can redistribute it and/or modify it under the
371
terms of the GNU General Public License as published by the Free Software
372
Foundation; either version 2 of the License, or (at your option) any later
373
version.
374
375
Koha is distributed in the hope that it will be useful, but WITHOUT ANY
376
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
377
A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
378
You should have received a copy of the GNU General Public License along
379
with Koha; if not, write to the Free Software Foundation, Inc.,
380
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
381
- 

Return to bug 7764