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

(-)a/INSTALL.debian (-396 lines)
Lines 1-396 Link Here
1
=============================
2
Installation Guide for Installing Koha on Debian
3
=============================
4
5
Some parts copyright 2010 Chris Nighswonger
6
Some parts copyright 2011 MJ Ray and software.coop
7
8
Feedback/bug reports: Koha Developer's List:
9
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
10
11
This document last modified: 2012-March-20
12
13
Installation Instructions
14
=============================
15
16
All commands can be performed as a system user with sudo privileges,
17
as indicated or by running the command directly as root.
18
19
1. Prepare System and Install Dependencies
20
21
1.1 Install Debian via Business Card CD
22
23
    See http://www.debian.org/CD/netinst/
24
25
1.2 Set up Indexdata apt sources for Yaz and Zebra packages
26
27
See the instructions from indexdata at
28
http://ftp.indexdata.com/pub/debian/README
29
30
At the time of writing, you need to create
31
/etc/apt/sources.list.d/indexdata.list containing the following:
32
33
    # Index Data
34
    deb http://ftp.indexdata.dk/debian squeeze main
35
    deb-src http://ftp.indexdata.dk/debian squeeze main
36
37
and add their archive signing key to your system:
38
39
    $ wget -O- http://ftp.indexdata.dk/debian/indexdata.asc | sudo apt-key add -
40
41
Finally, update your apt sources:
42
    $ sudo apt-get update
43
44
1.3 Get Koha
45
Choose one of these options:
46
47
1.3.1 Option A: Download Koha via Git (optional)
48
49
    $ sudo apt-get install git-core git-email
50
    $ git clone git://git.koha-community.org/koha.git koha
51
    $ cd koha
52
    $ git checkout -b myinstall origin
53
54
Note: for more information about Git, please see the Koha Git Usage Guide:
55
56
    http://wiki.koha-community.org/wiki/Version_Control_Using_Git
57
58
1.3.2 Option B: Download Koha from http://download.koha-community.org
59
60
Find the latest Koha stable version on http://download.koha-community.org
61
and download it to your server with something like:
62
63
    $ wget <URL found on download.koha-community.org>
64
65
1.4 Install additional Debian dependencies
66
67
IMPORTANT:  You should only use CPAN for Perl dependencies which are NOT
68
            available from the package maintainer. You have been warned!
69
70
Installing all necessary Debian packages, MySQL Server,
71
Zebra and all Debian packaged Perl module required by Koha:
72
73
    $ sudo dpkg --set-selections < install_misc/debian.packages
74
    $ sudo apt-get dselect-upgrade
75
76
1.5 Install Perl dependencies that aren't packaged into Debian
77
78
Run the following command:
79
80
    $ perl koha_perl_deps.pl -m -u
81
82
This will list whether any Perl dependencies are missing or need a
83
later version and whether they are required.  You can then install
84
them another way.  There may be packages on
85
http://debian.koha-community.org or maybe you can build packages
86
yourself or maybe you will need to install them locally with a command
87
similar to
88
89
    $ sudo cpan Graphics::Magick CHI CHI::Driver::Memcached
90
91
Note: you may need to run CPAN initialization if you've not run cpan
92
before.  See http://search.cpan.org/~andk/CPAN/lib/CPAN.pm#CONFIGURATION
93
94
When the configuration is completed CPAN will install the Perl modules.
95
96
2. Configuration of dependencies
97
98
2.1 Create the Koha database
99
100
 Create the database and user with associated privileges (information inside <> brackets is
101
 data you assign specifically to your installation. Do not include the <>'s when entering the commands):
102
103
    $ mysqladmin -uroot -p<password> create <kohadatabasename>
104
    $ mysql -uroot -p<password>
105
106
    Welcome to the MySQL monitor.  Commands end with ; or \g.
107
    Your MySQL connection id is 22
108
    Server version: 5.0.51a-24 (Debian)
109
110
    Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
111
112
    mysql> grant all on <kohadatabasename>.* to '<kohadatabaseuser>'@'localhost' identified by '<kohadatabaseuserpassword>';
113
    Query OK, 0 rows affected (0.00 sec)
114
115
    mysql> flush privileges;
116
    Query OK, 0 rows affected (0.00 sec)
117
118
    mysql> quit
119
120
You may want to document the database name, the database username, and the database password you just set.
121
Step 3 will require them.
122
123
2.2 Test your SAX Parser and correct where necessary
124
125
You must be sure you're using the XML::LibXML SAX parser, not Expat or
126
PurePerl, both of which have outstanding bugs with pre-composed characters.
127
You can test your SAX parser by running:
128
129
    $ cd koha
130
    $ misc/sax_parser_print.pl
131
132
You should see something like:
133
134
    XML::LibXML::SAX::Parser=HASH(0x81fe220)
135
136
If you are configured to use PurePerl or Expat, the script will say you have a problem and
137
you'll need to edit your ini file to correct it.
138
139
The file is typically located at:
140
141
    /etc/perl/XML/SAX/ParserDetails.ini
142
143
The correct parser entry will need to be moved to the bottom of the file.
144
The following is the entry you are looking for:
145
146
    [XML::LibXML::SAX::Parser]
147
	http://xml.org/sax/features/namespaces = 1
148
149
2.3 Create your Koha system user (if you haven't created one already)
150
151
    $ sudo adduser koha
152
153
You can substitute any username for "koha," just be sure to write it down, you will need to know what it is in step 3.
154
155
3. Run the Koha installer
156
157
    $ perl Makefile.PL
158
      ( answer questions )
159
    $ make
160
    $ make test
161
    $ sudo make install
162
163
3.1 Export the environment variables
164
Make install will tell you what the proper path for these environment variables is.
165
In case you missed it at the end of make install, here are some examples:
166
167
Example (for standard install):
168
    $ export KOHA_CONF=/etc/koha/koha-conf.xml
169
    $ export PERL5LIB=/usr/share/koha/lib
170
171
Example (for dev install. These paths are set during Makefile.PL.):
172
    $ export KOHA_CONF=/path/to/your/koha-conf.xml
173
    $ export PERL5LIB=/path/to/koha/lib
174
175
4. Configure and start Apache
176
    $ sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
177
(note that the path to koha-httpd.conf may be different if you chose a dev install)
178
179
Add the following lines to /etc/apache2/ports.conf:
180
181
    Listen 80
182
    Listen 8080
183
184
Run the following commands:
185
186
    $ sudo a2enmod rewrite deflate
187
    $ sudo a2ensite koha
188
    $ sudo apache2ctl restart
189
190
Note: you may still see the usual Apache default site if your VirtualHost
191
      configuration isn't correct.  If Koha is the only web application running on the server,
192
      the command "sudo a2dissite default" may be a quick fix. For servers running other sites
193
      alongside Koha, see the Apache HTTPD manual section on virtual hosts for full
194
      instructions (http://httpd.apache.org/docs/2.2/vhosts/).
195
196
5. Run the Web Installer, populate the database, initial configuration of settings
197
198
Point your browser to http://<servername>:8080/
199
200
Note: <servername> is (usually) the IP of your server, or localhost (if you are connecting
201
      from the same machine Koha is installed on. You can verify the location by checking
202
      the VirtualHost settings for both the opac and intranet virtual hosts in koha-httpd.conf
203
204
Koha will redirect you to the Web Installer where you can continue the setup. You will be prompted to enter in your DATABASE username and password. It is through this interface
205
that
206
you can install the sample data for libraries, patrons, and much more.
207
208
Be aware that removing sample data at a later time (when you may want to take the
209
server into production) may not be easy, and if your intent is to take this
210
install from testing to production, go with minimal sample data (no patrons or bibliographic records).
211
212
6. Configure and start Zebra
213
214
Note: it's recommended that you daemonize the Zebra process and add it to your
215
      startup profile. For a non-production test/development installation, running
216
      Zebra from the command line can be useful. Pick one of the options below (or roll your own).
217
218
Note: it's also recommended that you create a Koha system user, which you will
219
      have specified during the install process. Alternatively, Zebra can be
220
      configured to run as the root user.
221
222
Option 1: run the Zebra processes from the command line (manual indexing):
223
224
6.1.1 Zebra Search Server
225
226
This process send responses to search requests sent by Koha or
227
Z39.50/SRU/SRW clients.
228
229
    $ sudo -u <kohauser> zebrasrv -f /etc/koha/koha-conf.xml
230
    (note that the path to koha-conf.xml may be different if you chose a dev install, and that
231
    <kohauser> refers to the user you set up in step 2.3)
232
233
Note: the user you run Zebra as will be the only user with write permission
234
      on the Zebra index; in development mode, you may wish to use your
235
      system user.
236
237
238
6.1.2 Zebra Indexer
239
240
Added/updated/deleted records in Koha MySQL database must be indexed
241
into Zebra. A specific script must be launched each time a bibliographic
242
or an authority record is edited.
243
244
    $ sudo -u <kohauser> misc/migration_tools/rebuild_zebra.pl -z -b -a
245
246
Note: This script should be run as the kohauser (the default is 'koha', but
247
this is the user you set up in step 2.3).
248
249
Option 2: run the Zebra process as a daemon (automatic indexing):
250
251
Note: References to <script_dir> refer to the directory where
252
      Koha's command-line scripts are installed, the path
253
      is /usr/share/koha/bin/ by default in a standard install.
254
255
6.2.1 Zebra Search Server
256
257
    $ sudo ln -s <script_dir>/koha-zebra-ctl.sh  /etc/init.d/koha-zebra-daemon
258
    (Note: <script_dir> is /usr/share/koha/bin/ by default in a standard install)
259
    $ sudo update-rc.d koha-zebra-daemon defaults
260
261
    $ sudo <script_dir>/koha-zebra-ctl.sh start
262
    (Note: <script_dir> is /usr/share/koha/bin/ by default in a standard install)
263
264
265
6.2.2 Zebra Indexer
266
267
Add an entry in Koha user crontab to process scheduled added/updated/deleted records
268
indexing by Zebra. <script_dir>cronjobs/crontab.example contains examples for these cron jobs (and many more).
269
270
NOTE: The cronjobs should be setup under the kohauser (the default is 'koha', but
271
this is the user you set up in step 2.3).
272
273
Edit the crontab for the koha user by running
274
    $ sudo -u <kohauser> crontab -e
275
276
For Zebra indexing, you are looking for the example that begins with
277
278
    # ZEBRA INDEX UPDATES with -z option, incremental index updates throughout the day
279
    # for both authorities and bibs
280
281
It may be easiest to copy/paste the example into your own crontab and modify as necessary.
282
283
You can also configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra
284
285
7. What next?
286
287
    Once the installer has completed, you can import and index MARC records from the
288
    command line thusly (Note: you can also use the 'Stage MARC records for import' from
289
    the Tools area of Koha's Staff Client to import a batch of MARC records):
290
291
    $ export KOHA_CONF=/usr/share/koha/etc/koha-conf.xml
292
      (note: use the correct path to your koha-conf.xml)
293
294
7.1 Import:
295
296
Bibliographic data in MARC21 format
297
298
    $ misc/migration_tools/bulkmarcimport.pl -file /path/to/marc.iso2709
299
300
Authority data in MARC21 format
301
302
    $ misc/migration_tools/bulkmarcimport.pl -a -file /path/to/auth.iso2709
303
304
7.2 Fast Index:
305
    $ misc/migration_tools/rebuild_zebra.pl -b -w
306
307
    Once the indexing has completed, you will be able to search for records in your system.
308
    NOTE: This script should be run as the kohauser (the default is 'koha', this is the user we set up in step 2.3).
309
310
7.3 Schedule regular index updates with cron ,or configure zebra indexing as a background daemon
311
312
    You need to run rebuild_zebra.pl -b -a -z as a regular cron job in orde to pick up new bibs
313
    and items as you add them. Check misc/cronjobs/crontab.example for usage examples. See 7.0 above.
314
    NOTE: This job should be setup under the kohauser (the default is 'koha', this is the user we set up in step 2.3).
315
316
    To setup indexing in background see 6.2.2
317
318
7.4 To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and
319
    change the <listen> options to listen on a TCP port; then restart the zebra daemon.
320
321
UPGRADE
322
=======
323
If you are running in another language other than english, please
324
switch to english before doing the upgrade, the templating system has
325
changed and the templates will need to be regenerated.
326
Once you have upgraded, please regenerate your templates in your
327
chosen languages.
328
329
If you are upgrading from a previous installation of Koha 3.x, you can
330
use the following:
331
332
 ./koha_perl_deps.pl -u -m # to identify new Perl dependencies
333
334
Install any missing modules
335
IMPORTANT: Koha 3.6.x uses Template::Toolkit, this must be installed
336
before the webinstaller can run
337
338
 sudo apt-get install libtemplate-perl
339
340
 perl Makefile.PL --prev-install-log /path/to/koha-install-log
341
 make
342
 make test
343
 sudo make upgrade
344
345
Koha 3.4.x or later no longer stores items in biblio records so
346
if you upgrading from an old version as part of the
347
upgrade you will need to do the following two steps, they can take a
348
long time (several hours) to complete for large databases
349
350
 misc/maintenance/remove_items_from_biblioitems.pl --run
351
 misc/migration_tools/rebuild_zebra.pl -b -r
352
353
Uninstall Instructions
354
=============================
355
1) Stop Services:
356
   $ sudo a2dissite koha
357
   $ sudo rm /etc/apache2/sites-available/koha
358
   $ sudo apache2ctl restart
359
360
   $ sudo update-rc.d koha-zebra-daemon remove
361
   $ sudo rm /etc/init.d/koha-zebra-daemon
362
363
2) Remove Database and Indexes
364
365
   # MySQL
366
   $ mysql -u<kohauser> -p<kohapassword>
367
   > drop database koha;
368
369
   # Zebra Indexes
370
   $ zebraidx -c <prefix>/etc/zebradb/zebra-biblios.cfg -g iso2709 -d biblios init
371
   $ zebraidx -c <prefix>/etc/zebradb/zebra-authorities.cfg -g iso2709 -d authorities init
372
373
3) Remove Koha Install Directories and Configuration Files
374
   Don't forget about any crontab entries
375
376
Tested on the following operating environments
377
==============================================
378
- Debian Lenny 5.0
379
- Debian Squeeze 6.0
380
381
Other Notes
382
=====================
383
This file is part of Koha
384
385
Koha is free software; you can redistribute it and/or modify it under the
386
terms of the GNU General Public License as published by the Free Software
387
Foundation; either version 2 of the License, or (at your option) any later
388
version.
389
390
Koha is distributed in the hope that it will be useful, but WITHOUT ANY
391
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
392
A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
393
You should have received a copy of the GNU General Public License along with
394
Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
395
Suite 330, Boston, MA  02111-1307 USA
396
(-)a/INSTALL.fedora7 (-1267 lines)
Lines 1-1267 Link Here
1
THIS FILE IS TOO OLD AND NOT UPDATED.
2
CHECK KOHA WIKI:http://wiki.koha-community.org
3
CHECK OTHERS INSTALL FILES
4
ASK IN KOHA MAILING LIST
5
6
=============================
7
Installation Guide for Installing Koha on Fedora Core 7
8
=============================
9
10
Copyright (C) 2008, Department of Computer and Information
11
Science, Library of the University Lyon 2, France
12
13
Translated by: Google with help from Joshua Ferraro
14
(jmf AT liblime DOT com)
15
16
Feedback/bug reports: Koha Developer's List: 
17
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
18
19
This document last modified: 30 April 2008
20
21
Installation Instructions
22
=============================
23
This document was prepared in order to help you discover (or
24
test) Koha (Integrated Library System).
25
26
The installation of Linux system described below is a basic, 
27
it is not designed for a production server (e.g., security, 
28
load balancing .. are not described).
29
30
This document describes the different stages of installing 
31
the software to version 3.00 koha beta on a Fedora 7 Linux.
32
Your mileage may vary with different RedHat distributions.
33
34
1. LINUX SYSTEM INSTALLATION
35
36
System: Linux Fedora 7 (May 2007) Linux Redhat
37
The Linux distribution Fedora 7 is downloadable from the 
38
Fedora website:
39
40
http://fedoraproject.org/
41
42
The Fedora website also offers additional content such as
43
documentation, FAQ, etc.
44
45
Using the entire disk (removal of existing partitions and 
46
therefore permanent loss of data stored on the disk) is
47
the easiest method; This is not the best practice for a 
48
production system, but is useful for testing purposes.
49
50
Check that the computer is able to boot from a CD or DVD,
51
perhaps by changing the boot order in the bios.
52
53
Place the CD or DVD in the drive and restart the machine.
54
55
Settings when installing Linux (French specific, may not apply)
56
57
Language: French (French)
58
Choice of keyboard: French (Latin9) recognized by default.
59
Removal of existing Linux partitions
60
Host Name: NomMachine.NomDomaine.fr
61
Time zone: Europe/Paris. Click on the map or select from the
62
list and check system clock to UTC.
63
Informing the root password, which is the administrator account.
64
65
The installation of the system will automatically start and may
66
take between 15 to 30 minutes to complete.
67
68
Click Restart.
69
70
Enter the default options.
71
For Firewall, check www http server (configuration of the firewall).
72
Create a user koha with the password kohakoha (eg)
73
The koha is therefore created and the group koha which this user belongs.
74
75
Setting the homepage
76
Enter root, then the password root.
77
78
With Fedora, GNOME is the default environment.
79
80
To use KDE default (as we at Lyon 2 have done), close the session,
81
having recovered the KDE packages on Add/Remove software. For the
82
french interface,  go through the package manager and seek, then
83
install kde-french.
84
85
On the login prompt, go to Options è Select Session and choose KDE. A
86
the next connection, the system will ask if you want to use KDE or 
87
GNOME by default. Also on the login prompt, go to Languages and 
88
choose the French.
89
90
The installation of Linux system is complete. 
91
92
1.2 Verification of system settings
93
94
You must be logged in as administrator of the system (root).
95
96
-- Make sure the environment is KDE. The taskbar is at the
97
bottom of the screen and left of this bar is the menu K.
98
99
-- Check that the system is in french and click on K.
100
101
-- Create a few shortcuts in making a drag and drop the following
102
items in the taskbar:
103
104
Menu K è è Internet Firefox Web Browser
105
Menu K è è Terminal System
106
Menu K è è Services System Management Services
107
108
-- Check that the koha and the group koha are created:
109
Menu K è è System Users and Groups
110
111
-- Check that web servers Apache and MySQL are installed.
112
Menu K è è Services System Management Services
113
114
The lines httpd (demon Apache) and mysqld (demon MySQL) must be 
115
included in the line of services. You must configure these two 
116
services so that they are lançés automatically at boot. Check th
117
e box to the left of the service, click the Start button at the 
118
top of the list, if the two services start without any problem, 
119
validate the change of manager services by clicking on Save or 
120
File menu è save changes
121
122
Close the services manager.
123
124
If one or both services are absent, it is necessary to install Apache
125
and/or MySQL. To do so, go in the Package Manager, choose and 
126
select Apache server and/or MySQL. In the case of MySQL, we must
127
not forget MySQL-devel (available in packages optional). Finally,
128
start the installation.
129
130
1.3 Installation of additional software
131
132
The software installation Koha requires adding additional programs
133
to your system linux based on a standard installation. This list may
134
be slightly different depending on the version and support (Live
135
CD or DVD).
136
137
List of software to add
138
Libxml2-devel
139
Libxslt-devel
140
TCL
141
Bzip2-devel
142
GCC
143
Perl-CPAN
144
Perl-ExtUtils-AutoInstall
145
Ncftp
146
Wget
147
Gdbm-devel
148
Expat-devel
149
Tcp_wrappers-devel
150
Libicu (see below)
151
git-1.5.3.7-1.fc8 [is not necessary for the installation of koha, but
152
  useful if one participates in the development of koha.]
153
PhPMyAdmin
154
Libicu
155
Libicu-devel
156
157
To add software Linux Fedora, you have two tools
158
159
A graphical tool
160
Menu K è è System Add/Remove software
161
162
Click on the Search tab
163
Enter the name of the software in the zone entry and click the
164
Search button;
165
166
The software that match your search are listed.
167
Make sure the check box is checked if the tick and click Apply to
168
add software to your system.
169
170
A tool mode Terminal YUM
171
The YUM documentation is available on the Fedora site
172
173
Open a terminal window (K Menu è è Terminal System)
174
175
Examples of using YUM:
176
Is the web browser Firefox installed?
177
Type the command: yum list firefox
178
This command will launch the software yum, and asked it to list
179
the information on the Firefox.
180
Yum visit the various deposits of software for Fedora (fedora,
181
updates, etc.). And said that the firefox software is installed
182
on this machine (version 2.0.0.3-4.fc7) and there is a
183
downloadable version newer ( version 2.0.0.10-2.fc7)
184
185
************************************************** ****************
186
Screenshot
187
[root @ nomduserveur ~] # yum list firefox
188
Loading "installonlyn" plugin
189
fedora 100% |=========================| 2.1 kB 00:00
190
updates 100% |=========================| 2.3 kB 00:00
191
Installed Packages
192
firefox.i386 2.0.0.3-4.fc7 installed
193
Packages Available
194
firefox.i386 2.0.0.10-2.fc7 updates
195
************************************************** ****************
196
197
Updated software firefox by the command yum update firefox.
198
YUM inspect the system to check whether it is necessary to update
199
other software used by firefox.
200
confirm your request y
201
202
Installation of new software by the command yum install firefox.
203
204
205
Verification
206
Check whether these programs are installed using the command rpm
207
with option-q followed by the name of the software, possibly separated
208
by a space.
209
Example:
210
rpm-q libxml2-devel libxslt-devel tcl bzip2-devel gcc mysql-devel-perl CPAN perl-ExtUtils-AutoInstall ncftp wget gdbm devel-expat-devel tcp_wrappers-devel
211
212
NB: The tool rpm (Redhat Package Manager) allows facilities
213
management software under the Linux distribution Fedora.
214
215
Special case: the library libicu under Fedora 8
216
Under Fedora 8:
217
The library libicu, is standard in the distribution Fedora.
218
Version 3.8 of this library installed with Fedora 8 is too recent
219
and poses a problem when installing software and ZEBRA YAZ, the
220
company Indexdata who compiled these two programs with version 3.6
221
of the library, it is therefore necessary to remove the libicu 3.8
222
library and replace it with version 3.6.
223
224
Uninstall the library libicu - 3.8-1.fc8
225
226
With the web browser, download the library libicu-3.6-18.fc7.i386.rpm
227
(old version, choose the version Fedora 7 for i386) here:
228
229
  HYPERLINK "http://rpmfind.net/linux/rpm2html/search.php?query=libicutu.so.36" http://rpmfind.net/linux/rpm2html/search.php?query=libicutu.so.36
230
231
Download the package rpm
232
Open a terminal window, a menu K> System> Terminal
233
find the file libicu-3.6-18.fc7.i386.rpm
234
Desktop CD
235
ls-l
236
237
decompress the archive with the command: rpm-ivh libicu-3.6-18.fc7.i386.rpm
238
239
Setting 1.4 for the use of unicode
240
241
VERY IMPORTANT
242
UNICODE must be set up correctly before installing Koha.
243
244
1.4.1 The Linux system is it configured to use UNICODE?
245
246
For more information:
247
  HYPERLINK "http://wiki.koha-community.org/wiki/Encoding_and_Character_Sets_in_Koha" http://wiki.koha-community.org/wiki/Encoding_and_Character_Sets_in_Koha
248
249
To check, open a terminal window and type the locale.
250
You must obtain:
251
LANG = en_GB.UTF-8
252
...
253
254
1.4.2 The web server Apache 2 is it configured to use UNICODE?
255
256
To verify, using a text editor, open the httpd.conf file located
257
in /etc/httpd/conf and look if it contains the directive:
258
259
AddDefaultCharset UTF-8
260
261
1.4.3 The MySQL server is it configured to use UNICODE?
262
263
NB: mysqld service must be started.
264
In a Terminal window, type the command mysql, then an SQL
265
to display variables content server configuration.
266
Text of query:
267
268
show where variable_name variables like 'char%';
269
270
******************************************************************
271
Screenshot
272
mysql> show where variable_name variables like 'char%';
273
+--------------------------+----------------------------+
274
| Variable_name            | Value |
275
+--------------------------+----------------------------+
276
| Character_set_client     | latin1 |
277
| Character_set_connection | latin1 |
278
| Character_set_database   | latin1 |
279
| Character_set_filesystem | Binary |
280
| Character_set_results    | latin1 |
281
| Character_set_server     | latin1 |
282
| Character_set_system     | utf8   |
283
| Character_sets_dir       | /usr/share/mysql/charsets/ |
284
+--------------------------+----------------------------+
285
8 rows in set (0.00 sec)
286
******************************************************************
287
288
Some variables are not properly configured (latin1), so we have to
289
change the configuration file server MySQL.
290
Leaving the mysql client by the command quit.
291
292
Using a text editor, open the file my.cnf located in the directory /
293
etc and add these 3 lines in the section [mysqld]:
294
295
default-character-set = utf8
296
character-set-server = utf8
297
skip-character-set-client-handshake
298
299
To ensure that this change is taken into account, restart the server
300
Mysql using the following command in a terminal window:
301
mysqld restart service
302
303
Check that changing the parameters was taken into account by reconnecting
304
the MySQL server with the command mysql, then typing the query:
305
306
show where variable_name variables like 'char%';
307
The variables contain well utf8 /
308
Quit MySQL by the command quit
309
310
******************************************************************
311
Screenshot
312
  MySQL
313
Welcome to the MySQL monitor. Commands end with; or \g.
314
Your MySQL connection id is 2
315
Server version: 5.0.45 Source distribution
316
317
Type 'help,' or '\h' for help. Type '\c' to clear the buffer.
318
319
mysql> show where variable_name variables like 'char%';
320
+--------------------------+----------------------------+
321
| Variable_name            | Value |
322
+--------------------------+----------------------------+
323
| Character_set_client     | utf8   |
324
| Character_set_connection | utf8   |
325
| Character_set_database   | utf8   |
326
| Character_set_filesystem | Binary |
327
| Character_set_results    | utf8   |
328
| Character_set_server     | utf8   |
329
| Character_set_system     | utf8   |
330
| Character_sets_dir       | /usr/share/mysql/charsets/ |
331
+--------------------------+----------------------------+
332
8 rows in set (0.00 sec)
333
334
MySQL> quit
335
Bye
336
******************************************************************
337
338
Some information for the use of MySQL here: HYPERLINK "http://doc.ubuntu-fr.org/mysql" http://doc.ubuntu-fr.org/mysql
339
340
2 INSTALLATION OF ZEBRA SERVER INDEXING
341
342
For libraries that must manage several tens of thousands of bib records
343
it is recommended that you install the server indexing ZEBRA. Otherwise
344
(far fewer records to manage), it is not necessary to install ZEBRA.
345
346
The software installation ZEBRA requires prior installation of software
347
modules YAZ client and server Z3950.
348
349
The installation is as administrator (root).
350
351
NB: the creation of files yaz and zebra is only necessary if you use
352
the graphical
353
354
Website for downloads: HYPERLINK "http://www.indexdata.dk/software/" http://www.indexdata.dk/software/
355
356
357
2.1 Installation of the software YAZ
358
359
Creating a file needed for the installation of Yaz
360
Create files redhat in the directory /usr/src
361
SOURCES Create a folder in the directory /usr/src/redhat
362
NB: redhat lowercase and uppercase SOURCES.
363
364
Installing Yaz by the command:
365
rpm-ivh ftp://ftp.indexdata.dk/pub/yaz/redhat/fc6/ *- 3.0.24 *.*. rpm
366
Check the final published version and replace -3.0.24 by the number
367
of the current version.
368
369
Check the installation by the command:
370
rpm-q libyaz3 libyaz3-devel yaz yaz-debuginfo yaz-icu-yaz illclient yaz-3.0.24-1.src
371
372
373
2.2 Installation of the software ZEBRA
374
375
To install packages from the version 2.0.26-1:
376
rpm-ivh ftp://ftp.indexdata.dk/pub/zebra/redhat/fc6/ *- 2.0.26-1 .*. rpm
377
Check dernère published version and replace -2.0.26-1 by the
378
number of the current version.
379
380
Check the installation by the command:
381
rpm-q libidzebra-2.0-2.0-libidzebra modules idzebra-2.0 idzebra-2.0-debuginfo libidzebra-2.0-devel idzebra-2.0
382
383
3 INSTALLATION OF KOHA 3.0
384
385
Important Reminder:
386
Make sure, BEFORE you install koha, that the system Linux, the MySQL
387
server and the Apache server are configured to use the Unicode
388
format (cf. 1.4).
389
390
391
Download koha here: HYPERLINK "http://download.koha-community.org/koha-3.00.00-beta2.tar.gz" http://download.koha-community.org/koha-3.00.00-beta2.tar.gz
392
393
3.1 Decompression of the archive koha 3.0
394
395
Save the file in the directory /usr/share.
396
Opening a window Terminal, and placing himself in the directory /usr/share by the command:
397
cd /usr/share
398
verify the presence of compressed file koha by the command:
399
ls-l * Koha
400
Unzip the file with the command tar:
401
tar-xvf koha-3.00.00-beta2.tar.gz
402
You get a folder koha-3.00.00-beta2, which contains folders and files needed for the installation of software koha.
403
404
NB: the installation procedure is described in the text files "INSTALL"
405
and "INSTALL debian", the second is more complete.
406
407
408
3.2 Protect access to the database server MySQL
409
410
Update the password root server MySQL (by default, unprotected access to databases)
411
In a Terminal window:
412
sudo password mysqladmin Koha
413
414
3.3 Creation of a database MySQL test
415
416
The basic test is immediately under Fedora. We must remove the existing basic
417
test and then create a basic test MySQL provisional, which will be deleted
418
after installing koha.
419
420
mysql-u root-p
421
Enter password: kohakoha (eg)
422
423
mysql> drop test database;
424
Query OK, 0 rows affected (0.06 sec)
425
426
mysql> create database test;
427
Query OK, 1 row affected (0.00 sec)
428
429
mysql> grant all on test .* to 'test' @ 'localhost' identified by 'test';
430
Query OK, 0 rows affected (0.00 sec)
431
432
MySQL> flush privileges;
433
Query OK, 0 rows affected (0.00 sec)
434
435
MySQL> quit
436
Bye
437
438
439
3.4 Creation of the MySQL database koha
440
441
Creation of the database, a user kohaadmin with password and defining its
442
privileges.
443
444
In a Terminal window:
445
mysql-u root-p
446
Enter password: type kohakoha (eg a password for root)
447
Create Database Koha;
448
grant all on koha .* to 'kohaadmin' @ 'localhost' identified by 'kohakoha';
449
flush privileges;
450
quit;
451
452
3.5 Configuration CPAN
453
454
The koha software is written in Perl. You have access to deposits modules
455
written in perl (CPAN) to download some libraries on your system. The Perl
456
language of origin is installed on most Linux distributions, but some modules
457
must be installed.
458
During the first use of cpan, you must configure.
459
460
Open a terminal window and type the command cpan
461
462
During the installation of modules, validate the additions of modules when
463
necessary. Indicate the continent and the country. Select 3 or 4 CPAN deposits
464
in the proposed list.
465
466
It is possible to force the installation of a module. In this case, in a
467
Terminal window, type:
468
469
cpan
470
then force install NomDuModule
471
then quit
472
473
******************************************************************
474
Screenshot:
475
/usr/lib/perl5/5.8.8/CPAN/Config.pm initialized.
476
477
478
CPAN is the world-wide archive of perl resources. It consists of about
479
100 sites that all replicate the same contents all around the globe.
480
Many countries have at least one CPAN site already. The resources
481
found on CPAN are easily accessible with the CPAN.pm module. If you
482
want to use CPAN.pm, you have to configure it properly.
483
484
If you do not want to enter a dialog now, you can answer 'no' to this
485
question and I'll try to autoconfigure. (Note: you can revisit this
486
dialog anytime later by typing 'o conf init' at the cpan prompt.)
487
488
Are you ready for manual configuration? [yes]
489
490
491
The following questions are intended to help you with the
492
configuration. The CPAN module needs a directory of its own to cache
493
important index files and maybe keep a temporary mirror of CPAN files.
494
This may be a site-wide directory or a personal directory.
495
496
497
498
First of all, I'd like to create this directory. Where?
499
500
CPAN build and cache directory? [/ root/.cpan]
501
502
503
If you want, I can keep the source files after a build in the cpan
504
Home directory. If you choose so then future builds will take the
505
files from there. If you do not want to keep them, answer to the 0
506
Next question.
507
508
509
510
How big should the disk cache be for keeping the build directories
511
with all the intermediate files?
512
513
Cache size for build directory (in MB)? [10]
514
515
516
By default, each time the CPAN module is started, scanning cache
517
is performed to keep the cache size in sync. To prevent from this,
518
disable the cache scanning with 'never'.
519
520
Perform cache scanning (atstart or never)? [atstart]
521
522
523
To considerably speed up the initial CPAN shell startup, it is
524
Storable possible to use to create a cache of metadata. If Storable
525
is not available, the normal index mechanism will be used.
526
527
Cache metadata (yes/no)? [yes]
528
529
530
The next option deals with the charset your terminal supports. In
531
general CPAN is English speaking territory, thus the charset does not
532
matter much, but some of the aliens out there who upload their
533
software to CPAN bear names that are outside the ASCII range. If your
534
terminal supports UTF-8, you say no to the next question, if it
535
supports ISO-8859-1 (also known as LATIN1) then you say yes, and if it
536
neither supports nor, your answer does not matter, you will not be
537
able to read the names of some authors anyway. If you answer no, names
538
will be output in UTF-8.
539
Your terminal expects iso-8859-1 (yes/no) [yes]
540
541
If you have one of the readline packages (Term: ReadLine: Perl,
542
Term: ReadLine: Gnu, possibly others) installed, the interactive CPAN
543
Shell will have history support. The next two questions deal with the
544
filename of the history file and with its size. If you do not want to
545
set this variable, please hit SPACE RETURN to the following question.
546
547
File to save your history? [/root/.cpan/histfile]
548
Number of lines to save? [100]
549
550
551
The CPAN module can detect when a module that which you are trying to
552
build depends on prerequisites. If this happens, it can build the
553
prerequisites for you automatically ('follow'), ask you for
554
confirmation ('ask'), or just ignore them ('ignore'). Please set your
555
policy to one of the three values.
556
557
Policy on building prerequisites (follow, ask or ignore)? [ask]
558
559
560
The CPAN module will need a few external programs to work properly.
561
Please correct me, if I guess the wrong path for a program. Do not
562
panic if you do not have some of them, just press ENTER for those. To
563
disable the use of a download program, you can type a space followed
564
by ENTER.
565
566
567
Where is your gzip program?          [/bin/gzip]
568
Where is your tar program?           [/bin/tar]
569
Where is your unzip program?         [/usr/bin/unzip]
570
Where is your make program?          [/usr/bin/make]
571
Where is your links program?         [/usr/bin/links]
572
Where is your wget program?          [/usr/bin/wget]
573
Where is your ncftpget program?      [/usr/bin/ncftpget]
574
Where is your ftp program?           [/usr/bin/ftp]
575
Where is your gpg program?           [/usr/bin/gpg]
576
What is your favorite pager program? [/usr/bin/less]
577
What is your favorite shell?         [/bin/bash]
578
579
580
Every Makefile.PL is run by perl in a separate process. Likewise we
581
run 'make' and 'make install' in processes. If you have any
582
parameters (eg PREFIX, LIB, UNINST or the like) you want to pass
583
to the calls, please specify them here.
584
585
If you do not understand this question, just press ENTER.
586
587
Parameters for the 'perl Makefile.PL' command?
588
Typical frequently used settings:
589
590
     PREFIX = ~/perl non-root users (please see manual for more hints)
591
592
593
Every Makefile.PL is run by perl in a separate process. Likewise we
594
run 'make' and 'make install' in processes. If you have any
595
parameters (eg PREFIX, LIB, UNINST or the like) you want to pass
596
to the calls, please specify them here.
597
598
If you do not understand this question, just press ENTER.
599
600
Parameters for the 'perl Makefile.PL' command?
601
Typical frequently used settings:
602
603
     PREFIX = ~/perl non-root users (please see manual for more hints)
604
605
Your choice: []
606
Parameters for the 'make' command?
607
Typical frequently used setting:
608
609
     J3 dual-processor system
610
611
Your choice: []
612
Parameters for the 'make install' command?
613
Typical frequently used setting:
614
615
     UNINST = 1 to always uninstall potentially conflicting files
616
617
Your choice: []
618
619
620
Sometimes you may wish to leave the processes run by CPAN alone
621
without caring about them. As sometimes contains the Makefile.PL
622
question you're expected to answer, you can set a timer that will
623
kill a 'perl Makefile.PL' process after the specified time in seconds.
624
625
If you set this value to 0, these processes will wait forever. This is
626
the default and recommended setting.
627
628
629
Timeout for inactivity during Makefile.PL? [0]
630
631
632
If you're accessing the net via proxies, you can specify them in the
633
CPAN configuration or via environment variables. The variable in
634
the $ CPAN:: Config takes precedence.
635
636
Your ftp_proxy?
637
Your http_proxy?
638
Your no_proxy?
639
You have no/root/.cpan/sources/MIRRORED.BY
640
   I'm trying to fetch one
641
CPAN: LWP:: UserAgent loaded ok
642
Fetching with LWP:
643
   ftp://ftp.perl.org/pub/CPAN/MIRRORED.BY
644
Fetching with LWP:
645
   ftp://ftp.perl.org/pub/CPAN/MIRRORED.BY.gz
646
Fetching with Net: FTP:
647
   ftp://ftp.perl.org/pub/CPAN/MIRRORED.BY
648
649
650
Now we need to know where your favorite CPAN sites are located. Push
651
a few sites onto the array (just in case the first on the array will not
652
work). If you are mirroring CPAN to your local workstation, specify a
653
file: URL.
654
655
First, pick a nearby continent and country (you can pick several of
656
each, separated by spaces, or none if you just want to keep your
657
existing selections). Then, you will be presented with a list of URLs
658
CPAN of mirrors in the countries you selected, along with previously
659
selected URLs. Select some of those URLs, or just keep the old list.
660
Finally, you will be prompted for any extra URLs - file:, ftp:, or
661
http:-- that host a CPAN mirror.
662
663
(1) Africa
664
(2) Asia
665
(3) Central America
666
(4) Europe
667
(5) North America
668
(6) Oceania
669
(7) South America
670
Select your continent (or several nearby continents) [] 4
671
Sorry! since you do not have any existing picks, you must make a
672
Geographic selection.
673
674
(1) Austria
675
(2) Belgium
676
(3) Bosnia and Herzegovina
677
(4) Bulgaria
678
(5) Croatia
679
(6) Czech Republic
680
(7) Denmark
681
(8) Finland
682
(9) France
683
(10) Germany
684
(11) Greece
685
(12) Hungary
686
(13) Iceland
687
(14) Ireland
688
(15) Italy
689
(16) Latvia
690
15 more items, hit SPACE RETURN to show them
691
Select your country (or several nearby countries) [] 9
692
Sorry! since you do not have any existing picks, you must make a
693
Geographic selection.
694
695
(1) ftp://cpan.cict.fr/pub/CPAN/
696
(2) ftp://cpan.mirrors.easynet.fr/pub/ftp.cpan.org/
697
(3) ftp://distrib-coffee.ipsl.jussieu.fr/pub/mirrors/cpan/
698
(4) ftp://ftp.crihan.fr/mirrors/ftp.cpan.org/
699
(5) ftp://ftp.erasme.org/pub/CPAN/
700
(6) ftp://ftp.inria.fr/pub/CPAN/
701
(7) ftp://ftp.oleane.net/pub/CPAN/
702
(8) ftp://ftp.pasteur.fr/pub/computing/CPAN/
703
(9) ftp://ftp.u-strasbg.fr/CPAN
704
(10) ftp://mir1.ovh.net/ftp.cpan.org
705
(11) ftp://miroir-francais.fr/pub/cpan/
706
(12) http://cpan.ebsd.net/
707
(13) http://cpan.enstimac.fr/
708
(14) http://cpan.univ-paris.com
709
Select URLs as many as you like (by number),
710
put them on one line, separated by blanks, e.g. '1 4 5 [] 1 2 4 10
711
712
Enter another URL or RETURN to quit: []
713
New set of picks:
714
   ftp://cpan.cict.fr/pub/CPAN/
715
   ftp://cpan.mirrors.easynet.fr/pub/ftp.cpan.org/
716
   ftp://ftp.crihan.fr/mirrors/ftp.cpan.org/
717
   ftp://mir1.ovh.net/ftp.cpan.org
718
719
720
commit: wrote /usr/lib/perl5/5.8.8/CPAN/Config.pm
721
Terminal does not support AddHistory.
722
723
cpan shell - CPAN exploration and modules installation (v1.7602)
724
ReadLine support available (try 'install Bundle: CPAN')
725
726
cpan> quit
727
************************************************** ****************
728
729
Type quit to break cpan
730
731
732
733
3.6 Installation of additional modules from CPAN
734
735
3.6.1 modules installation
736
737
Install Command: cpan NomDuModule to install and validate the default
738
choice for each question.
739
740
List of modules required to koha need to install:
741
Class::Accessor
742
XML::SAX
743
XML::RSS
744
XML::LibXML::SAX
745
MARC::Record
746
MARC::Charset
747
MARC::Charset::Constants
748
MARC::File::XML
749
Net::Z3950::ZOOM
750
Net::LDAP::Filter
751
HTML::Template::Pro
752
Data::ICal
753
DateTime
754
DateTime::Format::ICal
755
GD::Barcode::UPCE
756
Algorithm::CheckDigits::M43_001
757
Biblio::EndnoteStyle
758
Schedule::At
759
Barcode::Code128
760
CGI::Session
761
Class::Factory::Util
762
Date::Manip
763
Lingua::Stem
764
List::MoreUtils
765
PDF::Reuse
766
PDF::Reuse::Barcode
767
PDF::API2
768
PDF::API2::Util
769
Text::CSV
770
Text::CSV_XS
771
XML::Dumper
772
XML::LibXSLT
773
XML::Simple
774
YAML::Syck
775
Unix::Syslog
776
Date::Calc
777
CHI
778
CHI::Driver::Memcached
779
780
781
3.6.2 Installation of modules - Cases difficult
782
783
In some cases, we must force the installation of modules. The two
784
modules (and sometimes others) need to force the installation.
785
Type the command cpan, then:
786
787
force install Mail: Sendmail ======= force install ok For this unit
788
should be Ctrl + C, when he attempted to send an e-mail.
789
force install Net:: LDAP ======= force install ok
790
791
792
793
3.6.3 Installing module access MySQL DBMS
794
795
Installation of the connector DBD::mysql for perl
796
797
We will have to rebuild this module because koha requires the latest version.
798
799
In a window Terminal:
800
cpan
801
cpan> o conf makepl_arg
802
     (search parameters for the CPAN)
803
804
cpan> o conf makepl_arg "- testdb = test - testuser = test - testpass = test"
805
806
cpan> install DBD:: mysql
807
808
cpan> o conf makepl_arg''
809
     (clean to avoid interference with future installations modules).
810
811
cpan> quit
812
813
814
Destruction of the basis of test MySQL
815
816
In a terminal window
817
mysql-u root-p
818
Enter password: kohakoha
819
Database drop test;
820
quit
821
822
823
3.7 Test SAX Parser
824
825
In a Terminal window, go to the installation directory koha.
826
CD /usr/share/koha-3.00.00-alpha/misc
827
launch the script sax_parser_print.pl
828
./sax_parser_print.pl
829
which returns: XML::LibXML::SAX = HASH (0x895a3fc)
830
831
The file /usr/lib/perl5/site_perl/5.8.8/XML/SAX/ParserDetails.ini should be amended to
832
contain the final (save the other lines to comment or delete):
833
[XML::LibXML::SAX::Parser]
834
Http://xml.org/sax/features/namespaces = 1
835
836
837
3.8 Installation of Koha
838
839
Opening a window Terminal and placed in the directory koha
840
CD /usr/share/koha-3.00.00-alpha
841
launch the script Makefile.PL
842
perl Makefile.PL
843
844
Most options are to be validated by default. The data to information are
845
password based koha, format Marc (Marc21 or Unimarc), language indexing
846
Zebra (or en). It should be noted that the three ports will be open:
847
3306, 9998, 9999.
848
849
************************************************** ****************
850
Screenshot
851
By default, Koha can be installed in one of three ways:
852
853
Standard: Install files in conformance with the Filesystem
854
           Hierarchy Standard (FHS). This is the default mode
855
           and should be used when installing a production
856
           Koha system. On Unix systems, root access is
857
           needed to complete a standard installation.
858
859
single: Install files under a single directory. This option
860
           is useful for installing Koha without root access, eg,
861
           on a web host that allows CGI scripts and MySQL databases
862
           but requires the user to keep all files under the user's
863
           HOME directory.
864
865
dev: Create a set of symbolic links and configuration files to
866
           Koha allow to run directly from the source distribution.
867
           This mode is useful for developers who want to run
868
           Koha from a git clone.
869
870
Installation mode (dev, single, standard) [standard]
871
872
Please specify the directory under which most Koha files
873
will be installed.
874
875
Note that if you are planning in installing more than
876
one instance of Koha, you may want to modify the last
877
component of the directory path, which will be used
878
as the package name in the FHS layout.
879
880
Base installation directory [/usr/share/koha]
881
882
Since you are using the 'standard' install
883
mode, you should run 'make install' as root.
884
However, it is recommended that a non-root
885
user (on Unix and Linux platforms) have
886
ownership of Koha's files, including the
887
Zebra indexes if applicable.
888
889
Please specify a user account. This
890
user account does not need to exist
891
right now, but it needs to exist
892
before you run 'make install'. Please
893
note that for security reasons, this
894
user should not be the same as the user
895
account Apache runs under.
896
897
User account [koha]
898
899
Please specify the group that should own
900
Koha's files. As above, this group need
901
not exist right now, but should be created
902
before you run 'make install'.
903
904
Group [koha]
905
906
Please specify which database engine you will use
907
to store data in Koha. The choices are MySQL and
908
PostgreSQL; please note that at the moment
909
PostgreSQL support is highly experimental.
910
911
DBMS to use (Pg, mysql) [mysql]
912
913
Please specify the name or address of your
914
database server. Note that the database
915
does not have to exist at this point, it
916
can be created after running 'make install'
917
and before you try using Koha for the first time.
918
919
Database server [localhost]
920
921
Please specify the port used to connect to the
922
DMBS [3306]
923
924
Please specify the name of the database to be
925
used by Koha [koha]
926
927
Please specify the user that owns the database to be
928
used by Koha [kohaadmin]
929
930
Please specify the password of the user that owns the
931
database to be used by Koha [katikoan] kohakoha
932
933
Koha can use the Zebra search engine for high-performance
934
searching of bibliographic and authority records. If you
935
have installed the Zebra software and would like to use it,
936
please answer 'yes' to the following question. Otherwise,
937
Koha will default to using its internal search engine.
938
939
Please note that if you choose *NOT* to install Zebra,
940
koha-conf.xml will still contain some references to Zebra
941
settings. Those references will be ignored by Koha.
942
943
944
Install the Zebra configuration files? (no, yes) [yes]
945
946
Since you've chosen to use Zebra with Koha,
947
you must specify the primary MARC format of the
948
records to be indexed by Zebra.
949
950
Koha provides Zebra configuration files for MARC 21
951
and UNIMARC.
952
953
MARC format for Zebra indexing (marc21, unimarc) [marc21] unimarc
954
955
Koha supplies Zebra configuration files tuned for
956
searching either English (en) or French (fr) MARC
957
records.
958
959
960
Primary language for Zebra indexing (en, fr) [en] fr
961
962
Please specify Zebra database user [kohauser]
963
964
Please specify the Zebra database password [zebrastripes]
965
966
Since you've chosen to use Zebra, you can enable the SRU/
967
Z39.50 Server if you so choose, but you must specify a
968
few configuration options for it.
969
970
Please note that if you choose *NOT* to configure SRU,
971
koha-conf.xml will still contain some references to SRU
972
settings. Those references will be ignored by Koha.
973
974
975
Install the SRU configuration files? (no, yes) [yes]
976
977
SRU Database host? [localhost]
978
979
SRU port for bibliographic data? [9998]
980
981
SRU port for authority data? [9999]
982
983
984
985
986
Koha will be installed with the following configuration parameters:
987
988
DB_HOST localhost
989
DB_NAME koha
990
DB_PASS koha
991
DB_PORT 3306
992
DB_TYPE mysql
993
DB_USER kohaadmin
994
INSTALL_BASE /usr/share/koha
995
INSTALL_MODE standard
996
INSTALL_SRU yes
997
INSTALL_ZEBRA yes
998
KOHA_GROUP koha
999
KOHA_USER koha
1000
ZEBRA_LANGUAGE fr
1001
ZEBRA_MARC_FORMAT unimarc
1002
ZEBRA_PASS zebrastripes
1003
ZEBRA_SRU_AUTHORITIES_POR9999
1004
ZEBRA_SRU_BIBLIOS_PORT 9998
1005
ZEBRA_SRU_HOST localhost
1006
ZEBRA_USER kohauser
1007
1008
and in the following directories:
1009
1010
DOC_DIR /usr/share/koha/doc
1011
INTRANET_CGI_DIR /usr/share/koha/intranet/cgi-bin
1012
INTRANET_TMPL_DIR /usr/share/koha/intranet/htdocs/intranet-tmpl
1013
INTRANET_WWW_DIR /usr/share/koha/intranet/htdocs
1014
KOHA_CONF_DIR /etc/koha
1015
LOG_DIR /var/log/koha
1016
MAN_DIR /usr/share/koha/man
1017
MISC_DIR /usr/share/koha/misc
1018
OPAC_CGI_DIR /usr/share/koha/opac/cgi-bin
1019
OPAC_TMPL_DIR /usr/share/koha/opac/htdocs/opac-tmpl
1020
OPAC_WWW_DIR /usr/share/koha/opac/htdocs
1021
PERL_MODULE_DIR /usr/share/koha/lib
1022
SCRIPT_DIR /usr/share/koha/bin
1023
ZEBRA_CONF_DIR /etc/koha/zebradb
1024
ZEBRA_DATA_DIR /var/lib/koha/zebradb
1025
ZEBRA_LOCK_DIR /var/lock/koha/zebradb
1026
ZEBRA_RUN_DIR /var/run/koha/zebradb
1027
1028
1029
To change any configuration setting, please run
1030
perl Makefile.PL again. To override one of the target
1031
directories, you can do so on the command line like this:
1032
1033
perl Makefile.PL PERL_MODULE_DIR=/usr/share/perl/5.8
1034
1035
You can also set different default values for parameters
1036
or override directory locations by using environment variables.
1037
1038
For example:
1039
1040
export DB_USER=my_koha
1041
perl Makefile.PL
1042
1043
or
1044
1045
DB_USER=my_koha DOC_DIR=/usr/local/info perl Makefile.PL
1046
1047
Checking if your kit is complete...
1048
Looks good
1049
Writing Makefile for koha
1050
************************************************** ****************
1051
1052
Taper la commande make
1053
1054
Taper la commande make test (ne pas tenir compte des erreurs listées)
1055
1056
Taper la commande make install
1057
1058
1059
1060
4 CONFIGURATION POST INSTALLATION
1061
1062
.1 Saving environment variables
1063
1064
As indicated at the end of the installation (see screen shot), we must add two environment variables:
1065
1066
Entering the two lines below a window in Terminal:
1067
export KOHA_CONF=/etc/koha/koha-conf.xml
1068
export PERL5LIB=/usr/share/koha/lib
1069
1070
Seizures of this event, both variables are recorded on a temporary basis. If these variables are definitely enr
1071
egistrées we must add these two lines in the file. bash_profile or. bashrc users root and koha.
1072
1073
1074
4.2 Creation of the database
1075
The base is not created. It is a bug, we must launch a script to recreate it. In a Terminal window, type:
1076
mysql -user=kohaadmin -password=kohakoha koha </usr/share/koha-3.00.00-alpha/installer/data/mysql/kohastructure.sql;
1077
1078
Explanation:
1079
mysql è launches client mysql
1080
-- user = kohaadmin è behalf of the user base
1081
-- password = kohakoha è password for this user
1082
koha è the name of the database
1083
<È means setting the result of a script (here, the base koha)
1084
/usr/share/koha-3.00.00-alpha/installer/data/mysql/kohastructure.sql è address sql script to execute
1085
Do not forget the sign at the end of the investigation.
1086
1087
To check if the base is well rebuilt: mysql-u-p kohaadmin
1088
Enter password: kohakoha
1089
1090
1091
******************************************************************
1092
Screenshot
1093
Welcome to the MySQL monitor. Commands end with; or \g.
1094
Your MySQL connection id is 51
1095
Server version: 5.0.45 Source distribution
1096
1097
Type 'help,' or '\h' for help. Type '\c' to clear the buffer.
1098
1099
MySQL> use Koha;
1100
Reading table information for completion of table and column names
1101
You can turn off this feature to get a quicker startup with A -
1102
1103
Database changed
1104
MySQL> show tables;
1105
+----------------------------+
1106
| Tables_in_koha |
1107
+----------------------------+
1108
| accountlines |
1109
| accountoffsets |
1110
| action_logs |
1111
| alert |
1112
| aqbasket |
1113
| aqbookfund |
1114
| aqbooksellers |
1115
| aqbudget |
1116
| aqorderbreakdown |
1117
| aqorderdelivery |
1118
| aqorders |
1119
| auth_header |
1120
| auth_subfield_structure |
1121
| auth_tag_structure |
1122
| auth_types |
1123
| authorised_values |
1124
| biblio |
1125
| biblio_framework |
1126
| biblioitems |
1127
| borrowers |
1128
| branchcategories |
1129
| branches |
1130
| branchrelations |
1131
| branchtransfers |
1132
| browser |
1133
| categories |
1134
| cities |
1135
| class_sort_rules |
1136
| class_sources |
1137
| currency |
1138
| deletedbiblio |
1139
| deletedbiblioitems |
1140
| deletedborrowers |
1141
| deleteditems |
1142
| ethnicity |
1143
| import_batches |
1144
| import_biblios |
1145
| import_items |
1146
| import_record_matches |
1147
| import_records |
1148
| issues |
1149
| issuingrules |
1150
| items |
1151
| itemtypes |
1152
| labels |
1153
| labels_conf |
1154
| labels_templates |
1155
| language_descriptions |
1156
| language_rfc4646_to_iso639 |
1157
| language_script_bidi |
1158
| language_script_mapping |
1159
| language_subtag_registry |
1160
| letter |
1161
| marc_matchers |
1162
| marc_subfield_structure |
1163
| marc_tag_structure |
1164
| matchchecks |
1165
| matcher_matchpoints |
1166
| matchpoint_component_norms |
1167
| matchpoint_components |
1168
| matchpoints |
1169
| notifys |
1170
| opac_news |
1171
| overduerules |
1172
| printers |
1173
| repeatable_holidays |
1174
| reports_dictionary |
1175
| reserves |
1176
| reviews |
1177
| roadtype |
1178
| saved_reports |
1179
| saved_sql |
1180
| serial |
1181
| services_throttle |
1182
| sessions |
1183
| special_holidays |
1184
| statistics |
1185
| subscription |
1186
| subscriptionhistory |
1187
| subscriptionroutinglist |
1188
| suggestions |
1189
| systempreferences |
1190
| tags |
1191
| userflags |
1192
| virtualshelfcontents |
1193
| virtualshelves |
1194
| z3950servers |
1195
| zebraqueue |
1196
+----------------------------+
1197
93 rows in set (0.00 sec)
1198
1199
mysql> quit
1200
******************************************************************
1201
1202
4.3 Changing the configuration of the Apache server
1203
1204
Create a link koha in the directory /etc/httpd/conf.d/ pointing to the configuration file of koha for apache.
1205
Open /etc/koha/koha-httpd.conf and paste the contents of this file at the end of /etc/httpd/conf/httpd.conf
1206
1207
Editing httpd.conf located in the directory /etc/httpd/conf, so the Apache web server is reachable on port 8
1208
0 (standard) and also on port 8080.
1209
Find string Listen 80 and add a new line below with the string Listen 8080
1210
Restarting the service httpd. On a Terminal window, type service httpd restart.
1211
1212
Lancer Zebra Server
1213
zebrasrv east /usr/bin
1214
with the name zebrasrv-2.0
1215
go to the directory /usr/bin
1216
cd /usr/bin
1217
koha become user by typing the command su:
1218
su Koha
1219
zebra start the server by the command:
1220
./zebrasrv-2.0-f /etc/koha/koha-conf.xml
1221
1222
Starting the daemon Zebraqueue
1223
zebraqueue_daemon.pl is in /usr/share/koha/bin
1224
go in /usr/share/koha/bin
1225
cd /usr/share/koha/bin
1226
and launch the script zebraqueue_daemon.pl
1227
. /zebraqueue_daemon.pl
1228
1229
1230
4.4 loading data for tests
1231
1232
This step helps to have some input in Koha for testing purposes (table cataloguing default, etc.).
1233
1234
Disable temporarily SElinux
1235
SE-LINUX blocking access to KOHA.
1236
Menu K Hotel è è SElinux
1237
Then turn off Selinux and relaunch the service iptables
1238
1239
Unlocking ports
1240
It must grant access to ports 3306, 9998 and 9999
1241
Menu K Hotel è è Firewall and SElinux
1242
Other ports and click Add button.
1243
When the 3 ports are added, click Apply, then click the button.
1244
1245
Using the Web installer
1246
We must move the fr located in /usr/share/koha/intranet/cgi-bin/data/mysql en-US (installer points to the directory
1247
en-ing and not en).
1248
1249
Connect to Koha: HYPERLINK "http://localhost:8080/" http://localhost:8080 and use the Web installer french (en-US).
1250
1251
-- Validate Step 1 (dependencies);
1252
-- Step 2 (settings of the database on two screens);
1253
-- A Phase 3, click on Install the basic settings (screen 1), select the declination Marc (Unimarc_complet in our
1254
Where Unimarc_lecture_pub; screen 2), select default settings and then click on Import (only settings obligat
1255
oires are checked by default; screen 3);
1256
-- The screen 4 summarizes what has been imported;
1257
-- Finally, the screen 5 indicates the end of the installation; then you just have to click Finish.
1258
1259
Complements
1260
Connect to PhPMyadmin: HYPERLINK "http://localhost/phpmyadmin" http://localhost/phpmyadmin
1261
Connect to interface professional Koha: HYPERLINK "http://localhost:8080/" http://localhost:8080
1262
Connect to online catalogue Koha: HYPERLINK "http://localhost:80/" http://localhost:80
1263
1264
Zebra is in /etc/koha
1265
The files perl Koha professional can be found in /usr/share/koha/intranet/cgi-bin (then a large repertoire by fonctionnal
1266
ities of SIGB)
1267
The files perl Koha public are in /usr/share/koha/koha/cgi-bin
(-)a/INSTALL.opensuse (-1375 lines)
Lines 1-1375 Link Here
1
= Installation Guide for Installing Koha 3.0.0 on openSUSE 11.3 =
2
3
Original version for openSUSE 11.0 created by Ricardo Dias Marques - koha@ricmarques.net
4
Version for openSUSE 11.3 adapted by Freek de Kruijf - freek -at- opensuse -dot- org
5
6
No liability for the contents of this document can be accepted.
7
8
Feedback/bug reports: Koha Developer's List:
9
10
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
11
12
This document last modified: 20 Mar 2012
13
14
== Installation Instructions ==
15
16
This document was prepared in order to help you discover (or test) Koha (Integrated Library System).
17
18
The installation of Linux system described below is a basic, it is not designed for a production server (e.g., security, load balancing ... are not described).
19
20
This document describes the different stages of installing the software Koha 3 on the openSUSE 11.3 Linux distribution in a "new" computer, the author uses a VirtualBox virtual machine, that is, a virtual computer that will have its virtual hard disk contents COMPLETELY ERASED to install openSUSE and Koha!
21
22
In this example, the virtual machine uses a bridged network connection, which mimics a separate computer in the local network, it's assumed that your server gets an IP address by DHCP that later will be changed to 192.168.1.16.
23
24
You'll have to change this to the real IP address that your machine should get (or use DHCP, if that's the case).
25
26
This tutorial assumes a Koha installation that does NOT use Zebra ("Zebra is a high-performance, general-purpose structured text indexing and retrieval engine" - http://www.indexdata.dk/zebra/). Additional steps would be required to set up Zebra for Koha, however it will be installed.
27
28
=== LINUX System Installation ===
29
30
Download openSUSE 11.3 DVD from [http://software.opensuse.org/ here].
31
32
Place the DVD in the drive and restart the machine. In the case of a virtualmachine the iso image is still on the disc and you connect it as a DVD to the virtual machine.
33
34
After the "Welcome" screen, you'll get a First menu, with the following options:
35
36
----
37
Boot from Hard Disk
38
39
Installation
40
41
Repair Installed System
42
43
Rescue System
44
45
Firmware Test
46
47
Memory Test
48
----
49
50
You may want to change the screen size to 1024 x 768 by pressing F3.
51
Choose "Installation" (second command)
52
53
==== "Initializing" screen ====
54
55
(Dialog box appears saying "Probing Mouse")
56
57
==== "Welcome" screen ====
58
59
You'll see two Dropdown Lists: "Language" and "Keyboard Layout"
60
61
This depends of your place and preference, naturally.
62
I live in The Netherlands, and we use the English (US) Keyboard Layout but I prefer an Operating System in English.
63
So I leave the default option selected for "Language"  and "Keyboard Layout" to (English (US)).
64
65
Check the "I Agree to the License Terms" checkbox (under the "License Agreement" textbox).
66
67
Click the "Next" button.
68
69
==== "System Probing" screen ====
70
71
[just watch it...]
72
73
==== "Installation Mode" screen ====
74
75
Leave "New Installation" radio button checked
76
77
I prefer not to have the "Automatic Configuration" so this option is unchecked.
78
It gives you the possibility to specify the name of the system and the network setup.
79
80
Click the "Next" button
81
82
==== "Initializing" screen ====
83
84
[just watch it...]
85
86
==== "Clock and Time Zone" screen ====
87
88
I do this work in Yemen, so I select the following options:
89
90
"Region" listbox: click on "Asia"
91
92
"Time Zone" listbox: click on "Aden"
93
94
I leave the "Hardware Clock Set To UTC" checkbox checked.
95
96
Click the "Next" button
97
98
==== "Desktop Selection" screen ====
99
100
You should see three radio buttons: "GNOME Desktop", "KDE Desktop" and "Other".
101
102
Click on the "Other" radio button.
103
104
Four radio buttons should become visible then:
105
106
"XFCE Desktop"
107
108
"LXDE Desktop"
109
110
"Minimal X Window"
111
112
"Minimal Server Selection (Text Mode)"
113
114
click on this last "Minimal Server Selection (Text Mode)" radio button.
115
116
Click the "Next" button
117
118
==== "Suggested Partitioning" screen ====
119
120
Partitioning choices are really up to you. In this example, I started with a 8 GB virtual disc and I will create a 1000 MB swap partition and the rest is the root "/" partition.
121
122
So, to do this I click on the "Create Partition Setup..." button.
123
124
===== "Preparing Hard Disk: Step 1" screen =====
125
126
I click on the first radio button:
127
"1: 1.IDE 8.0 GB,/dev/sda"
128
129
I click the "Next" button
130
131
===== "Preparing Hard Disk: Step 2" screen =====
132
133
I uncheck the "Propose separate Home Partition" checkbox.
134
135
I click the "Next" button.
136
137
This takes me back to the Suggested Partitioning screen.
138
139
===== "Suggested Partitioning" screen =====
140
141
In my case, I now have this:
142
143
- Create swap volume /dev/sda1 (1004.06 MB)
144
145
- Create root volume /dev/sda2 (7.02 GB) with ext4
146
147
I click the "Next" button.
148
149
==== "Create New User" screen ====
150
151
I use this screen to create a regular user.
152
153
User's full name: Your Full name (e.g: John Smith)
154
155
Username: Your preferred username (e.g.: jsmith)
156
157
Password:
158
159
Confirm Password:
160
161
I uncheck the "Use this password for System Administrator" checkbox.
162
163
I check the "Receive System Mail"
164
165
I uncheck the "Automatic Login" checkbox.
166
167
I click the "Next" button (you may be "nagged" with a dialog box by the YAST2 installer warning that you selected a password that it considers to be too simple. Click "Yes" to keep the password you chose, or "No" to change it).
168
169
==== Password for the System Administrator "root" screen ====
170
171
Enter your password (in the "Password for root User" text box) and repeat it (in the "Confirm Password" text box).
172
173
Click the "Next" button to proceed to the "Installation Settings" screen.
174
175
==== "Installation Settings" screen ====
176
177
Click on the "Software" link
178
179
==== "Software Selection and System Tasks" screen ====
180
181
Scroll down the listbox (that begins with the "Base Technologies" group) until you find the "Server Functions" group.
182
183
In that "Server Functions" group click on the "Web and LAMP Server" checkbox (to check it)
184
185
Click on the "OK" button to return to "Installation Settings"
186
187
==== "Installation Settings" screen ====
188
189
Click on the "Install" button (placed in the same place where usually appear the "Accept" or "Next" button).
190
191
You should see a "Confirm Installation" dialog box. Click on the "Install" button of that dialog box.
192
193
==== "Preparing Your Hard Disk" screen ====
194
195
[just watch it...]
196
197
==== "Deploying Installation Images" screen ====
198
199
[just watch it... ]
200
201
==== "Package Installation" screen ====
202
203
[just watch it... or click on the "Details" tab if you want to see what packages are being installed.]
204
205
==== "Finishing Basic Installation" screen ====
206
207
[just watch it... ]
208
209
After some time you'll see a dialog box warning that the system will reboot in 10 seconds.
210
211
==== After reboot ====
212
213
Leave "Boot from Hard Disk" selected and press ENTER
214
215
You'll have to wait a while (or press ESC to see what the operating system is "doing"). After some moments, you'll be taken to the "Yast2 - installation @ Linux" screen (a text installer).
216
217
On the screen you will see Hostname and Domain Name with a textbox below.
218
The cursor is in the textbox below Hostname.
219
Press the Backspace to delete the name there and insert the name of your system, e.g. koha-server.
220
Pres Tab and Backspace to delete "site" and enter the domain name, e.g. "univ.org".
221
Press Tab go to Change Hostname via DHCP en press Space to remove the "x".
222
Leave the "x" in Assign Hostname to Loopback IP.
223
Press <Alt>+N to activate "Next". Now you enter:
224
225
==== Network Configuration ====
226
227
Press ALT+C to Change Network Settings. Use the Arrow Keys to Highlight "Firewall" and press RETURN.
228
Proceed to Firewall and press RETURN. Go to "Allowed Services" and press RETURN. Press TAB several times to highlight "HTTP Server".
229
Press ALT+A to add HTTP Server to the list. Press ALT+S to choose the next Service to Allow.
230
Press the Down Arrow and a drop down box will appear and press the Down Arrow several times to select Secure Shell Server and press RETURN.
231
Press ALT+A to Add.
232
We also need port 8080 for the management of Koha to be open, so press ALT+D to activate (Advanced...).
233
Press ALT+T to go to TCP Ports and enter 8080 in the textbox.
234
Pressing Alt+O for OK, brings you back to the Firewall Configuration.
235
Pressing Alt+O for OK, brings you back to Network Configuration, but now you see the SSH port is open, the 8080 port is not shown.
236
Press Alt+N for Next, which brings you to: Saving Network Configuration and finally to:
237
238
==== Test Internet Connection ====
239
240
Press RETURN to activate Next and do the test.
241
If all is well you should see "Test Result: Success".
242
Press RETURN to activate Next.
243
Now the meta data of some repositories will be downloaded and the next screen will appear:
244
245
==== Online Update ====
246
247
Here you can choose to do an online update or not.
248
Press RETURN to activate Next and the update will be done.
249
In my case the update even replaced the kernel. Press ALT+A to Accept the update.
250
After that you press RETURN to activate Next.
251
A warning may appear saying that the system will reboot.
252
253
You will see the first screen of booting of the DVD again, but again you choose Boot from Hard Disk, which will also happen when you do not do anything.
254
255
After that you will see the normal system boot screen and you do not need to do anything, but you may press RETURN to speed up the start of booting from the disc.
256
In my case, after booting, the installtion went on and showed a screen of the YaST2 Package Manager showing the Release Notes.
257
Press RETURN to continue.
258
Now a screen asking about Hardware Configuration appeared. Press RETURN to continue.
259
260
Next a screen appears showing Installation Completed.
261
Press RETURN to continue and you will see the startup log messages and at the end the following:
262
263
|--------------------
264
Welcome to openSUSE 11.3 "Teal" - Kernel 2.6.34.7-0.3-desktop (tty1)
265
266
koha-server login:
267
|--------------------
268
269
You may now login with your "root" user.
270
271
==== Changing the Hostname and Domain Name ====
272
273
274
Maybe you want to change the hostname, domain name and switch from DHCP to a Static IP address.
275
Changing the hostname and domain name will not be shown here, because we assume that was done according to your whishes during installation.
276
277
This is how you can do it. You give the command yast (the setup tool) on the command prompt:
278
|--------------------
279
koha-server:~ # yast
280
|--------------------
281
282
Yast should appear.
283
284
On the listbox of the left hand side select "Network Devices" (press TAB to turn focus on that listbox, and press the down arrow key several times to reach it).
285
Then, on the listbox of the right hand side, select "Network Settings" (you'll have again to press TAB to turn focus on that listbox, and press the down arrow key several times to reach it).
286
287
Press the ENTER key.
288
289
==== "Initializing Network Configuration" screen ====
290
291
[just watch it...]
292
293
==== "Network Settings" screen ====
294
295
I want to disable IPv6, so I first go to the "Global Options" section (by pushing the key combination ALT+G to press the "G" letter in Global Options that is highlighted).
296
In the next screen, I push ALT+E to uncheck the "Enable IPv6" checkbox.
297
I'll get a dialog box with a Warning saying that "To apply this change a reboot is needed.".
298
I just press ENTER on that dialog box, but I do NOT reboot (at least not yet).
299
300
Then I press Alt+V to go to the "Overview" (still in "Network Settings").
301
Then I press ALT+I to "Edit" the information for this Network Card.
302
303
==== "Network Card Setup" screen ====
304
305
I check the "Statically assigned IP Address" checkbox, and enter the following info for "IP Address", "Subnet Mask" and "Hostname" (you should use the values defined by your network administrator):
306
307
IP Address: 192.168.1.16
308
Subnet Mask: 255.255.255.0
309
Hostname: koha-server.univ.org
310
311
Then I press ALT+N to click the "Next" button. After a few seconds, I will be taken again to the "Network Settings" screen.
312
313
==== "Network Settings" screen ====
314
315
I press ALT+S to go to the "Hostname/DNS" screen.
316
317
Press ALT+I and the Arrow Key to choose "Only Custom Policy" by pressing Enter, press Tab to choose "Custom Policy Rule" and select "STATIC".
318
Enter the IP Address of the Domain Name Server in the "Name Server 1" text box:
319
320
Name Server 1: 192.168.1.254
321
322
Then I press ALT+U to go to the "Routing" configuration.
323
324
==== "Routing" screen ====
325
326
In the "Default Gateway" text box, I enter the IP Address of my Default Gateway:
327
328
Default Gateway: 192.168.1.254
329
330
Then I press ALT+O for OK to Finish
331
332
==== "Saving Network Configuration" screen ====
333
334
[just watch it...]
335
336
After a few seconds, you should be taken back to the "YaST2 Control Center" screen.
337
Press ALT+Q to Quit YaST2.
338
339
==== Making the ssh-daemon to start at system start ====
340
341
We need a ssh-daemon that does not accept Environment parameters from the remote user.
342
So we have to disable accepting these.
343
For this you use vim to change the config file of sshd.
344
345
|--------------------
346
# cp /etc/ssh/sshd_config /etc/ssh/sshd_config.ORIG
347
# vi /etc/ssh/sshd_config
348
|--------------------
349
350
Find the lines starting with AcceptEnv and insert a # in front of these, There are three lines.
351
Afterwards these lines will look like:
352
|--------------------
353
#AcceptEnv LANG LC_CTYPE LC_NUMERIC LC_TIME LC_COLLATE LC_MONETARY LC_MESSAGES
354
#AcceptEnv LC_PAPER LC_NAME LC_ADDRESS LC_TELEPHONE LC_MEASUREMENT
355
#AcceptEnv LC_IDENTIFICATION LC_ALL
356
|--------------------
357
358
In order to make the ssh-daemon start at system boot, you have to enable this by giving:
359
|--------------------
360
# chkconfig sshd on
361
|--------------------
362
363
You can check the status with the command "chkconfig -l sshd".
364
The output should look like this:
365
|--------------------
366
# sshd                      0:off  1:off  2:off  3:on   4:off  5:on   6:off
367
|--------------------
368
369
Also you need to start the sshd service in order to generate the security keypair for sshd.
370
|--------------------
371
# service sshd start
372
|--------------------
373
374
This time seems to be a good time to reboot your server:
375
|--------------------
376
# reboot
377
|--------------------
378
After rebooting the machine, if you wish, you may go to another machine and connect to your newly created server using a SSH (Secure Shell) client. In Windows, I like to use putty to do ssh sessions to my Linux servers.
379
380
=== Configure Software Repositories ===
381
382
After the system has rebooted, log in as root.
383
384
Later on, you will need to add some software packages from the openSUSE 11 Distribution.
385
Some of those packages are NOT available in the openSUSE 11.3 DVD (libyaz-devel is one of those packages).
386
However we already added these repositories to the system after configuring the network.
387
In case you did not have a network setup at that time, it is now time to setup these repositories, but you can skip this if this has been done already.
388
389
First, run the yast command in the Linux command line (shell):
390
391
|--------------------
392
# yast
393
|--------------------
394
395
Inside yast, select Software -> Software Repositories
396
397
==== "Configured Software Repositories" screen ====
398
399
When on this screen, you already see a table that has:
400
401
* as configured repositories (in the "Name" column)
402
** "Updates for openSUSE 11.3 11.3-1.82"
403
** "openSUSE-11.3 11.3-1.82"
404
** "openSUSE-11.3-Debug"
405
** "openSUSE-11.3-Non-Oss" "openSUSE-11.3-Oss" ...
406
* at least the following repositories have an "x" in the "Enabled" column
407
** "Updates for openSUSE 11.3 11.3-1.82"
408
** "openSUSE-11.3-Oss"
409
* you still have to add the folowing repositiory to this list
410
** "openSUSE BuildService - devel:languages:perl"
411
Press ALT+A to Add Repositories.
412
413
==== "Media type" screen ====
414
415
Select Community Repositories by pressing ALT+I and apply Next (press ALT+X).
416
417
You will see a message that data will be downloaded.
418
After that you will get a list of Repositories and the above mentioned, but not yet available, will be in this list.
419
Select the one you need by using the Arrow Keys and press Space to select (an x will appear in front of the Repository).
420
After that apply OK. You may see some activity and you may get asked to import GnuPG keys, just do so.
421
422
You may see the following screen.
423
424
==== "License Agreement" screen ====
425
426
Check the "Yes, I Agree to the License Agreement" radio button.
427
428
Click on the "Next" button to return to the "Configured Software Repositories" screen.
429
430
==== "Configured Software Repositories" screen ====
431
432
You should see now the "openSUSE 11.3-Oss" listed as an entry.
433
You can Disable "openSUSE-11.3-Source" and its Autorefresh, if present.
434
435
Click on the "OK" button.
436
437
When you get sent back to the "Yast Control Center" click on the "Quit" button (to return to the shell).
438
439
=== Install some useful / necessary programs ===
440
441
By this time, you have to install some of the programs which are regularly used, by using zypper (the command line mode packet manager):
442
443
To install locate, ncftp (command-line ftp client), make and gcc you give the following command:
444
|--------------------
445
# zypper install findutils-locate ncftp make gcc
446
|--------------------
447
Zypper reports that it will install 18 packages; confirm with RETURN.
448
449
== Download Koha ==
450
451
|--------------------
452
# wget http://download.koha-community.org/koha-3.00.00.tar.gz
453
|--------------------
454
You will receive 49,266,888 bytes.
455
456
== Extract Koha ==
457
458
|--------------------
459
# tar -xzvf koha-3.00.00.tar.gz
460
|--------------------
461
462
== Set up Locale for root user ==
463
464
If you run the locale command, you'll probably get this output:
465
|--------------------
466
# locale
467
LANG=POSIX
468
LC_CTYPE=en_US.UTF-8
469
LC_NUMERIC="POSIX"
470
LC_TIME="POSIX"
471
LC_COLLATE="POSIX"
472
LC_MONETARY="POSIX"
473
LC_MESSAGES="POSIX"
474
LC_PAPER="POSIX"
475
LC_NAME="POSIX"
476
LC_ADDRESS="POSIX"
477
LC_TELEPHONE="POSIX"
478
LC_MEASUREMENT="POSIX"
479
LC_IDENTIFICATION="POSIX"
480
LC_ALL=
481
|--------------------
482
483
We want to have en_US.UTF-8 in all LC_* variables. So, we'll do the following:
484
|--------------------
485
# yast
486
|--------------------
487
System -> Language
488
489
The "Languages" screen should appear.
490
491
In the first section (Primary Language Settings):
492
493
Leave "English (US)" selected as the option for Primary Language
494
495
Click on the "Details..." link
496
497
Change the Locale Settings for user root from the default option ("ctype Only") to "Yes"
498
499
Make sure the "Use UTF-8 Encoding" checkbox is checked (it should already be).
500
501
Leave the "Detailed Locale Setting" en_US selected
502
503
Click on the OK button to return to the "Languages" screen
504
505
Click on the "OK" button.
506
507
When you get back to the "Yast2 Control Center" screen, click on the "Quit" button
508
509
== Putty configuration to use Unicode (UTF-8 encoding) ==
510
511
If you use Putty, set up Putty to use UTF-8 encoding.
512
To do this, click on the upper left corner of the PuTTy window, to expand the menu.
513
Scrol down until you find the "Change Settings..." command and click on it.
514
515
This should open the "PuTTy Reconfiguration" screen. Here expand the "Window" category and click on "Translation"
516
517
When you do this, you'll see that the "Received data assumed to be in which character set" dropdown list probably reads:
518
519
"ISO-8859-1:1998 (Latin-1, West Europe)
520
521
change it to: "UTF-8"
522
523
Click on the "Apply" button
524
525
Now, it's a good time to SAVE this PuTTy session.
526
To do this, click again on the upper left corner of the PuTTy window, to expand the menu, and click on the "Change Settings..." command like you did before.
527
528
This should open the "PuTTy Reconfiguration" screen. Go to the right hand side of that screen and type a name in the "Saved Sessions" textbox (e.g: koha).
529
Then click on the "Save" button and, after doing that, click on the "Apply" button.
530
531
IMPORTANT!!! Now it's the time to EXIT the login shell, by typing the exit command:
532
|--------------------
533
# exit
534
|--------------------
535
536
Now you'll reopen PuTTy, but when you do that, open the Saved Session that you have created in order to use the "UTF-8" configuration you have done.
537
538
You may not need to do the above after the change, made earlier, in /etc/ssh/sshd_config. Check it and if so you can modify this wiki page.
539
540
After logging in again with the root user, type the locale command again. Now it should read like the following:
541
542
|--------------------
543
# locale
544
LANG=en_US.UTF-8
545
LC_CTYPE="en_US.UTF-8"
546
LC_NUMERIC="en_US.UTF-8"
547
LC_TIME="en_US.UTF-8"
548
LC_COLLATE="en_US.UTF-8"
549
LC_MONETARY="en_US.UTF-8"
550
LC_MESSAGES="en_US.UTF-8"
551
LC_PAPER="en_US.UTF-8"
552
LC_NAME="en_US.UTF-8"
553
LC_ADDRESS="en_US.UTF-8"
554
LC_TELEPHONE="en_US.UTF-8"
555
LC_MEASUREMENT="en_US.UTF-8"
556
LC_IDENTIFICATION="en_US.UTF-8"
557
LC_ALL=
558
|--------------------
559
560
== Apache configuration (for UTF-8) ==
561
562
Create a file called /etc/apache2/httpd.conf.local with vim (or your preferred text editor):
563
|--------------------
564
myhost:~ # vim /etc/apache2/httpd.conf.local
565
|--------------------
566
Add this line:
567
|--------------------
568
AddDefaultCharset UTF-8
569
|--------------------
570
571
== Configure Apache to start at boot time and start the service ==
572
|--------------------
573
# chkconfig apache2 on
574
575
# service apache2 start
576
Starting httpd2 (prefork)                                            done
577
|--------------------
578
579
Go to a browser and type:
580
581
http://192.168.1.16
582
583
You should see a page that reads:
584
585
"It works!"
586
587
== MySQL configuration ==
588
589
1 - Configure MySQL to start at boot time and start the service:
590
|--------------------
591
# chkconfig mysql on
592
593
# service mysql start
594
|--------------------
595
The system will issue a warning that '--skip-locking' is deprecated, but for now we accept that.
596
597
2 - Change the password for the "root" user of MySQL:
598
|--------------------
599
# /usr/bin/mysqladmin -u root password 'chosenpassword'
600
|--------------------
601
After starting MySQL also it is recommended to give the command:
602
<tt> # /usr/bin/mysqladmin -u root -h koha-server.univ.org password 'chosenpassword'</tt>
603
However this gives an error message. This is left for the more advanced MySQL administrator.
604
605
3 - Check the encoding variables of MySQL
606
607
To check the encoding variables of MySQL, will type the show variables like 'char%'; command in a mysql prompt:
608
|--------------------
609
# mysql -p
610
Enter password:
611
Welcome to the MySQL monitor.  Commands end with ; or \g.
612
Your MySQL connection id is 7
613
Server version: 5.1.46-log SUSE MySQL RPM
614
615
Copyright (c) 2000, 2010, Oracle and/or its affiliates. All rights reserved.
616
This software comes with ABSOLUTELY NO WARRANTY. This is free software,
617
and you are welcome to modify and redistribute it under the GPL v2 license
618
619
Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
620
621
mysql> show variables like 'char%';
622
+--------------------------+----------------------------+
623
| Variable_name            | Value                      |
624
+--------------------------+----------------------------+
625
| character_set_client     | utf8                       |
626
| character_set_connection | utf8                       |
627
| character_set_database   | utf8                       |
628
| character_set_filesystem | binary                     |
629
| character_set_results    | utf8                       |
630
| character_set_server     | utf8                       |
631
| character_set_system     | utf8                       |
632
| character_sets_dir       | /usr/share/mysql/charsets/ |
633
+--------------------------+----------------------------+
634
8 rows in set (0.00 sec)
635
636
mysql> quit
637
Bye
638
|--------------------
639
640
The above looks OK, so we can skip 1 and 2 and continue with 2a, but if not you can follow the following procedure.
641
642
We want to have utf8 in the above character_set_* variables above (and NOT latin1)!
643
644
In order to do this:
645
646
1 - Create a backup of the MySQL configuration file (my.cnf):
647
|--------------------
648
# cd /etc
649
myhost:/etc # cp my.cnf my.cnf.ORIG
650
|--------------------
651
652
2 - Use vim to add these 3 lines in the section [mysqld] of the my.cnf file:
653
|--------------------
654
default-character-set = utf8
655
character-set-server = utf8
656
skip-character-set-client-handshake
657
|--------------------
658
In openSUSE 11.3 and the provided mysql packet only the default-character-set can be set, the other 2 should not be added.
659
660
2a - If you are unfamilar with SQL you should remove the #-character in front of safe-updates in that same section.
661
662
3 - Restart MySQL:
663
|--------------------
664
myhost:/etc # service mysql restart
665
Restarting service MySQL
666
Shutting down service MySQL                                           done
667
Starting service MySQL                                                done
668
|--------------------
669
670
Now, let's type again the show variables like 'char%' mysql command to see if
671
the character_set_variables have changed from latin1 to utf8 (character_set_filesystem
672
will still read "binary" but I think that's OK:
673
|--------------------
674
myhost:/etc # mysql -p
675
Enter password:
676
Welcome to the MySQL monitor.  Commands end with ; or \g.
677
Your MySQL connection id is 1
678
Server version: 5.1.46-log SUSE MySQL RPM
679
680
Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
681
682
mysql> show variables like 'char%';
683
+--------------------------+----------------------------+
684
| Variable_name            | Value                      |
685
+--------------------------+----------------------------+
686
| character_set_client     | utf8                       |
687
| character_set_connection | utf8                       |
688
| character_set_database   | utf8                       |
689
| character_set_filesystem | binary                     |
690
| character_set_results    | utf8                       |
691
| character_set_server     | utf8                       |
692
| character_set_system     | utf8                       |
693
| character_sets_dir       | /usr/share/mysql/charsets/ |
694
+--------------------------+----------------------------+
695
8 rows in set (0.01 sec)
696
697
mysql> quit
698
Bye
699
|--------------------
700
701
== Create the Koha database ==
702
703
=== Create the koha database and user with associated privileges ===
704
|--------------------
705
# mysqladmin -uroot create koha -p
706
|--------------------
707
(you may name the koha database something different from koha)
708
709
=== Grant privileges to a MySQL user to the koha database ===
710
711
Assuming that you want to have a MySQL user called "kohaadmin" to administer a database called "koha" with the password "kohapassword", you'd enter this:
712
|--------------------
713
myhost:~ # mysql -p
714
Enter password:
715
Welcome to the MySQL monitor.  Commands end with ; or \g.
716
Your MySQL connection id is 3
717
Server version: 5.1.46-log SUSE MySQL RPM
718
719
Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
720
721
mysql> grant all on koha.* to 'kohaadmin'@'localhost' identified by 'kohapassword';
722
Query OK, 0 rows affected (0.00 sec)
723
724
mysql> flush privileges;
725
Query OK, 0 rows affected (0.08 sec)
726
727
mysql> quit
728
Bye
729
|--------------------
730
731
== Test your SAX Parser and correct where necessary ==
732
733
  * Install the XML::SAX and XML::LibXML perl Modules:
734
735
|--------------------
736
# zypper install perl-XML-SAX perl-XML-LibXML
737
Loading repository data...
738
Reading installed packages...
739
'perl-XML-SAX' is already installed.
740
There is an update candidate for 'perl-XML-SAX', but it is from different vendor. Use 'zypper install perl-XML-SAX-0.96-13.1.x86_64' to install this candidate.
741
'perl-XML-LibXML' is already installed.
742
There is an update candidate for 'perl-XML-LibXML', but it is from different vendor. Use 'zypper install perl-XML-LibXML-1.70-6.1.x86_64' to install this candidate.
743
Resolving package dependencies...
744
745
Nothing to do.
746
|--------------------
747
748
In the above you see that these two packets have been installed during system installation.
749
You also installed a repository for the language perl.
750
The message about a different vendor is about this repository.
751
You have to use "zypper dup" to install the newer versions from this repository, but this outside this tutorial.
752
753
You must be sure you're using the XML::LibXML SAX parser, not Expat or PurePerl, both of which have outstanding bugs (in 2008) with pre-composed characters. You can test your SAX parser by running:
754
|--------------------
755
# cd /root/koha-3.00.00/
756
757
myhost:~/koha-3.00.00 # misc/sax_parser_print.pl
758
|--------------------
759
760
You will probably see this:
761
|--------------------
762
XML::SAX::PurePerl=HASH(0x8356a4c)
763
|--------------------
764
765
If you're using PurePerl (you probably are) or Expat, you'll need to edit your ParserDetails.ini file to use the LibXML Parser.
766
To find the ParserDetails.ini file, you may use locate.
767
To do this, first update the locate database by running the updatedb command:
768
|--------------------
769
# updatedb
770
|--------------------
771
772
Then find ParserDetails.ini using locate:
773
|--------------------
774
# locate ParserDetails.ini
775
/usr/lib/perl5/vendor_perl/5.12.1/XML/SAX/ParserDetails.ini
776
|--------------------
777
778
OK. So, let's first do a backup of this ini file:
779
|--------------------
780
# cd /usr/lib/perl5/vendor_perl/5.12.1/XML/SAX/
781
782
myhost:/usr/lib/perl5/vendor_perl/5.10.0/XML/SAX # cp ParserDetails.ini ParserDetails.ini.ORIG
783
|--------------------
784
785
Edit this ParserDetails.ini file (with vim or other editor)
786
787
See if the first line contains this:
788
|--------------------
789
[XML::SAX::PurePerl]
790
|--------------------
791
If it does, replace this first line by the following:
792
|--------------------
793
[XML::LibXML::SAX::Parser]
794
|--------------------
795
796
Run the /root/koha-3.00.00/misc/sax_parser_print.pl command again.
797
This time, you should get the following output:
798
|--------------------
799
XML::LibXML::SAX::Parser=HASH(0x8356e0c)
800
|--------------------
801
802
== Install the Zebra package ==
803
804
Zebra is already in the standard repository of openSUSE 11.3, so it seems better to install it.
805
In the next chapter a question will be asked whether it is installed, so you better install it; no harm done.
806
Because you may need the documentation, that will also be installed.
807
Note that the package name is idzebra.
808
809
|--------------------
810
# zypper install idzebra idzebra-doc
811
|--------------------
812
You will notice that a few dependencies need to be resolved, so a few other packages are also installed.
813
814
== Run Koha's perl installer ==
815
|--------------------
816
myhost:/usr/lib/perl5/vendor_perl/5.10.0/XML/SAX # cd /root/koha-3.00.00
817
|--------------------
818
After installation of a number of CPAN/perl packages we will run perl Makefile.PL to run the Koha installer.
819
820
821
=== Using zypper to install CPAN modules ===
822
823
The author of the openSUSE 11.0 version of this page did a trial run with the Makefile.PL module, which showed a lot of unstalled perl modules and other software packages.
824
He used the names of these packages and installed the missing ones.
825
I collected all the missing packets and put them in the list below to install these packages before running Makefile.PL.
826
Doing the way he did provides more inside in the process, however it is tedious and I want to avoid that.
827
You still can go [[Koha_3.0.0_on_openSUSE_11.0#Run_Koha's_perl_installer|there]] and learn from that experience.
828
829
The commands show below need to be given one by one, because zypper will always ask for confirmation. However you can als also put more than one module name after the "zypper install" command.
830
|--------------------
831
# zypper install perl-Algorithm-CheckDigits
832
# zypper install perl-Biblio-EndnoteStyle
833
# zypper install perl-CGI-Session-Serialize-yaml
834
# zypper install perl-CGI-Session
835
# zypper install perl-Class-Accessor
836
# zypper install perl-Class-Factory-Util
837
# zypper install perl-DBD-mysql
838
# zypper install perl-Data-ICal
839
# zypper install perl-Date-Calc
840
# zypper install perl-Date-ICal
841
# zypper install perl-Date-Manip
842
# zypper install perl-DublinCore-Record
843
# zypper install perl-Email-Date
844
# zypper install perl-GD
845
# zypper install perl-GD-Barcode
846
# zypper install perl-HTML-Scrubber
847
# zypper install perl-HTML-Template-Pro
848
# zypper install perl-Lingua-Stem
849
# zypper install perl-MARC-Charset
850
# zypper install perl-MARC-Crosswalk-DublinCore
851
# zypper install perl-MARC-File-XML
852
# zypper install perl-MARC-Record
853
# zypper install perl-MIME-Lite
854
# zypper install perl-Mail-Sendmail
855
# zypper install perl-Net-LDAP
856
# zypper install perl-Net-Z3950-ZOOM
857
# zypper install perl-PDF-API2
858
# zypper install perl-PDF-Reuse
859
# zypper install perl-PDF-Reuse-Barcode
860
# zypper install perl-32bit
861
# zypper install perl-SMS-Send
862
# zypper install perl-Schedule-At
863
# zypper install perl-Text-CSV
864
# zypper install perl-Text-Iconv
865
# zypper install perl-XML-Dumper
866
# zypper install perl-XML-LibXSLT
867
# zypper install perl-XML-RSS
868
# zypper install perl-Text-CSV_XS
869
# zypper install perl-PerlMagick
870
# zypper install perl-Carp-Assert
871
# zypper install gd gd-devel
872
# zypper install xorg-x11-libXpm-devel
873
# zypper install libjpeg-devel
874
# zypper install fontconfig-devel
875
# zypper install libpng-devel
876
# zypper install libyaz-devel
877
|--------------------
878
879
== Running the Makefile.PL module to configure Koha ==
880
881
My installation is a UNIMARC installation, so I'm answering unimarc to the "MARC format for Zebra indexing (marc21, unimarc) [marc21]" question below.
882
If your Library uses the MARC21 format instead of UNIMARC, you should press ENTER to accept the default (which is marc21).
883
884
Because my bibliographic catalog will have mainly records in English and Arabic, I'm answering "en" (English) to the "Primary language for Zebra indexing (en, fr) [en]" question below.
885
886
Although I'm NOT using Zebra, I'm answering "yes" (the default choice) to the "Install the Zebra configuration files? (no, yes) [yes]" so I can set up Zebra later, if I decide to.
887
888
Also note that Zebra has been installed in this case.
889
890
Below is the result of running the "perl Makefile.PL" command (including my answers to the several questions):
891
|--------------------
892
myhost:~/koha-3.00.00 # perl Makefile.PL
893
894
By default, Koha can be installed in one of three ways:
895
896
standard: Install files in conformance with the Filesystem
897
          Hierarchy Standard (FHS).  This is the default mode
898
          and should be used when installing a production
899
          Koha system.  On Unix systems, root access is
900
          needed to complete a standard installation.
901
902
single:   Install files under a single directory.  This option
903
          is useful for installing Koha without root access, e.g.,
904
          on a web host that allows CGI scripts and MySQL databases
905
          but requires the user to keep all files under the user's
906
          HOME directory.
907
908
dev:      Create a set of symbolic links and configuration files to
909
          allow Koha to run directly from the source distribution.
910
          This mode is useful for developers who want to run
911
          Koha from a git clone.
912
913
Installation mode (dev, single, standard) [standard]
914
915
Please specify the directory under which most Koha files
916
will be installed.
917
918
Note that if you are planning in installing more than
919
one instance of Koha, you may want to modify the last
920
component of the directory path, which will be used
921
as the package name in the FHS layout.
922
923
Base installation directory [/usr/share/koha]
924
925
Since you are using the 'standard' install
926
mode, you should run 'make install' as root.
927
However, it is recommended that a non-root
928
user (on Unix and Linux platforms) have
929
ownership of Koha's files, including the
930
Zebra indexes if applicable.
931
932
Please specify a user account.  This
933
user account does not need to exist
934
right now, but it needs to exist
935
before you run 'make install'.  Please
936
note that for security reasons, this
937
user should not be the same as the user
938
account Apache runs under.
939
940
User account [koha]
941
942
Please specify the group that should own
943
Koha's files.  As above, this group need
944
not exist right now, but should be created
945
before you run 'make install'.
946
947
Group [koha]
948
949
Please specify which database engine you will use
950
to store data in Koha.  The choices are MySQL and
951
PostgreSQL; please note that at the moment
952
PostgreSQL support is highly experimental.
953
954
DBMS to use (Pg, mysql) [mysql]
955
956
Please specify the name or address of your
957
database server.  Note that the database
958
does not have to exist at this point, it
959
can be created after running 'make install'
960
and before you try using Koha for the first time.
961
962
Database server [localhost]
963
964
Please specify the port used to connect to the
965
DMBS [3306]
966
967
Please specify the name of the database to be
968
used by Koha [koha]
969
970
Please specify the user that owns the database to be
971
used by Koha [kohaadmin]
972
973
Please specify the password of the user that owns the
974
database to be used by Koha [katikoan] kohapassword
975
976
Koha can use the Zebra search engine for high-performance
977
searching of bibliographic and authority records.  If you
978
have installed the Zebra software and would like to use it,
979
please answer 'yes' to the following question.  Otherwise,
980
Koha will default to using its internal search engine.
981
982
Please note that if you choose *NOT* to install Zebra,
983
koha-conf.xml will still contain some references to Zebra
984
settings.  Those references will be ignored by Koha.
985
986
Install the Zebra configuration files? (no, yes) [yes]
987
988
Unable to find the Zebra programs 'zebrasrv' and 'zebraidx'
989
in your PATH or in some of the usual places.  If you haven't
990
installed Zebra yet, please do so and run Makefile.PL again.
991
992
Since you've chosen to use Zebra with Koha,
993
you must specify the primary MARC format of the
994
records to be indexed by Zebra.
995
996
Koha provides Zebra configuration files for MARC 21
997
and UNIMARC.
998
999
MARC format for Zebra indexing (marc21, unimarc) [marc21] unimarc
1000
1001
Koha supplies Zebra configuration files tuned for
1002
searching either English (en) or French (fr) MARC
1003
records.
1004
1005
Primary language for Zebra indexing (en, fr) [en] fr
1006
1007
Koha can use one of  two different indexing modes
1008
for the MARC authorities records:
1009
1010
grs1 - uses the Zebra GRS-1 filter, available
1011
       for legacy support
1012
dom  - uses the DOM XML filter; offers improved
1013
       functionality.
1014
1015
Authorities indexing mode (dom, grs1) [grs1] dom
1016
1017
Please specify Zebra database user [kohauser]
1018
1019
Please specify the Zebra database password [zebrastripes] zebrapassword
1020
1021
Since you've chosen to use Zebra, you can enable the SRU/
1022
Z39.50 Server if you so choose, but you must specify a
1023
few configuration options for it.
1024
1025
Please note that if you choose *NOT* to configure SRU,
1026
koha-conf.xml will still contain some references to SRU
1027
settings.  Those references will be ignored by Koha.
1028
1029
Install the SRU configuration files? (no, yes) [yes] no
1030
1031
Since you've chosen to use Zebra, you can also choose to
1032
install PazPar2, which is a metasearch tool.  With PazPar2,
1033
Koha can perform on-the-fly merging of bibliographic
1034
records during searching, allowing for FRBRization of
1035
the results list.
1036
1037
Install the PazPar2 configuration files? [no] no
1038
1039
Would you like to run the database-dependent test suite? (no, yes) [no]
1040
1041
Koha will be installed with the following configuration parameters:
1042
1043
AUTH_INDEX_MODE          dom
1044
DB_HOST                  localhost
1045
DB_NAME                  koha
1046
DB_PASS                  kohapassword
1047
DB_PORT                  3306
1048
DB_TYPE                  mysql
1049
DB_USER                  kohaadmin
1050
INSTALL_BASE             /usr/share/koha
1051
INSTALL_MODE             standard
1052
INSTALL_PAZPAR2          no
1053
INSTALL_SRU              no
1054
INSTALL_ZEBRA            yes
1055
KOHA_GROUP               koha
1056
KOHA_INSTALLED_VERSION   3.00.00.096
1057
KOHA_USER                koha
1058
RUN_DATABASE_TESTS       no
1059
ZEBRA_LANGUAGE           fr
1060
ZEBRA_MARC_FORMAT        unimarc
1061
ZEBRA_PASS               zebrapassword
1062
ZEBRA_USER               kohauser
1063
1064
and in the following directories:
1065
1066
DOC_DIR                  /usr/share/koha/doc
1067
INTRANET_CGI_DIR         /usr/share/koha/intranet/cgi-bin
1068
INTRANET_TMPL_DIR        /usr/share/koha/intranet/htdocs/intranet-tmpl
1069
INTRANET_WWW_DIR         /usr/share/koha/intranet/htdocs
1070
KOHA_CONF_DIR            /etc/koha
1071
LOG_DIR                  /var/log/koha
1072
MAN_DIR                  /usr/share/koha/man
1073
MISC_DIR                 /usr/share/koha/misc
1074
OPAC_CGI_DIR             /usr/share/koha/opac/cgi-bin
1075
OPAC_TMPL_DIR            /usr/share/koha/opac/htdocs/opac-tmpl
1076
OPAC_WWW_DIR             /usr/share/koha/opac/htdocs
1077
PAZPAR2_CONF_DIR         /etc/koha/pazpar2
1078
PERL_MODULE_DIR          /usr/share/koha/lib
1079
SCRIPT_DIR               /usr/share/koha/bin
1080
SCRIPT_NONDEV_DIR        /usr/share/koha/bin
1081
ZEBRA_CONF_DIR           /etc/koha/zebradb
1082
ZEBRA_DATA_DIR           /var/lib/koha/zebradb
1083
ZEBRA_LOCK_DIR           /var/lock/koha/zebradb
1084
ZEBRA_RUN_DIR            /var/run/koha/zebradb
1085
1086
To change any configuration setting, please run
1087
perl Makefile.PL again.  To override one of the target
1088
directories, you can do so on the command line like this:
1089
1090
perl Makefile.PL PERL_MODULE_DIR=/usr/share/perl/5.8
1091
1092
You can also set different default values for parameters
1093
or override directory locations by using environment variables.
1094
1095
For example:
1096
1097
export DB_USER=my_koha
1098
perl Makefile.PL
1099
1100
or
1101
1102
DB_USER=my_koha DOC_DIR=/usr/local/info perl Makefile.PL
1103
1104
If installing on a Win32 platform, be sure to use:
1105
'dmake -x MAXLINELENGTH=300000'
1106
1107
Checking if your kit is complete...
1108
Looks good
1109
Writing Makefile for koha
1110
1111
myhost:~/koha-3.00.00 #
1112
|--------------------
1113
1114
== Create the Koha User and Group ==
1115
1116
|--------------------
1117
# useradd koha
1118
1119
# passwd koha
1120
Changing password for koha.
1121
New Password:
1122
Reenter New Password:
1123
Password changed.
1124
1125
# groupadd koha
1126
|--------------------
1127
1128
== Run make test ==
1129
|--------------------
1130
myhost:~/Koha # make test
1131
cp koha-tmpl/opac-tmpl/prog/famfamfam/silk/error_go.png blib/OPAC_TMPL_DIR/prog/famfamfam/silk/error_go.png
1132
cp opac/opac-changelanguage.pl blib/OPAC_CGI_DIR/opac/opac-changelanguage.pl
1133
cp koha-tmpl/intranet-tmpl/prog/img/itemtypeimg/liblime-kids/card.gif blib/INTRANET_TMPL_DIR/prog/img/itemtypeimg/liblime-kids/card.gif
1134
cp koha-tmpl/opac-tmpl/prog/famfamfam/mini/note.gif blib/OPAC_TMPL_DIR/prog/famfamfam/mini/note.gif
1135
1136
[many more lines beginning with "cp" should appear...]
1137
1138
t/Amazon.t .................. ok
1139
t/Barcodes_PrinterConfig.t .. ok
1140
t/Bookfund.t ................ ok
1141
t/Bookseller.t .............. ok
1142
t/Boolean.t ................. ok
1143
t/Branch.t .................. ok
1144
t/Calendar.t ................ ok
1145
t/Charset.t ................. ok
1146
t/Debug.t ................... # BEFORE use:     $debug is not defined
1147
# BEFORE use: $cgi_debug is not defined
1148
t/Debug.t ................... 1/3 #  AFTER use:     $debug is 0
1149
#  AFTER use: $cgi_debug is 0
1150
# Done.
1151
t/Debug.t ................... ok
1152
t/dummy.t ................... ok
1153
t/Input.t ................... ok
1154
t/Koha.t .................... ok
1155
t/Languages.t ............... ok
1156
t/Maintainance.t ............ ok
1157
t/Output.t .................. ok
1158
t/Record.t .................. ok
1159
t/Review.t .................. ok
1160
t/Scrubber.t ................ 1/10 # Note: scrubber test output will have whitespace collapsed for readability
1161
# done.
1162
t/Scrubber.t ................ ok
1163
t/Stats.t ................... ok
1164
All tests successful.
1165
Files=19, Tests=47,  3 wallclock secs ( 0.06 usr  0.08 sys +  2.12 cusr  0.25 csys =  2.51 CPU)
1166
Result: PASS
1167
|--------------------
1168
So here it shows all is OK. I don't expect any problems to appear, otherwise you may need to read the document on installing Koha on openSUSE 11.0.
1169
1170
== Run "make install" ==
1171
1172
Now, we will run make install:
1173
1174
|--------------------
1175
myhost:~/Koha # make install
1176
|--------------------
1177
[Several lines starting with "Manifying" and many lines starting with "Installing" will scroll by...]
1178
|--------------------
1179
Installing /usr/share/koha/man/man3/serials::serial-issues.3pm
1180
Installing /usr/share/koha/man/man3/C4::Context.3pm
1181
Installing /usr/share/koha/man/man3/cataloguing::value_builder::unimarc_field_123f.3pm
1182
Installing /usr/share/koha/man/man3/cataloguing::addbiblio.3pm
1183
Installing /usr/share/koha/man/man3/cataloguing::value_builder::unimarc_field_128c.3pm
1184
Installing /usr/share/koha/man/man3/tools::viewlog.3pm
1185
Installing /usr/share/koha/man/man3/admin::branches.3pm
1186
1187
Koha's files have now been installed.
1188
1189
In order to use Koha's command-line batch jobs,
1190
you should set the following environment variables:
1191
1192
export KOHA_CONF=/etc/koha/koha-conf.xml
1193
export PERL5LIB=/usr/share/koha/lib
1194
1195
For other post-installation tasks, please consult the README.
1196
1197
# cd /etc
1198
myhost:/etc #
1199
|--------------------
1200
1201
== Create /etc/bash.bashrc.local ==
1202
Create a file called bash.bashrc.local in the /etc directory:
1203
|--------------------
1204
myhost:/etc # vim /etc/bash.bashrc.local
1205
|--------------------
1206
Add these 2 lines in the file:
1207
|--------------------
1208
export KOHA_CONF=/etc/koha/koha-conf.xml
1209
export PERL5LIB=/usr/share/koha/lib
1210
|--------------------
1211
1212
Exit the shell and log back in.
1213
|--------------------
1214
myhost:/etc # exit
1215
|--------------------
1216
After logging back in, type the following commands to check if
1217
the KOHA_CONF and PERL5LIB environment variables have been correctly set:
1218
|--------------------
1219
myhost:~ # env | grep KOHA
1220
KOHA_CONF=/etc/koha/koha-conf.xml
1221
1222
myhost:~ # env | grep PERL5LIB
1223
PERL5LIB=/usr/share/koha/lib
1224
|--------------------
1225
1226
== Koha's Web Installer ==
1227
1228
Access Koha's web installer at:
1229
1230
http://192.168.1.16:8080/
1231
1232
Your browser will probably say that:
1233
|--------------------
1234
" The server at 192.168.1.16 is taking too long to respond."
1235
|--------------------
1236
OK... It seems that we have still have to do something.
1237
1238
== Create a symbolic link to /etc/koha/koha-httpd.conf ==
1239
1240
Let's create a symbolic link to the /etc/koha/koha-httpd.conf file in the /etc/apache2/vhosts.d directory
1241
:
1242
|--------------------
1243
myhost:~ # cd /etc/apache2/vhosts.d/
1244
1245
myhost:/etc/apache2/vhosts.d # ln -s /etc/koha/koha-httpd.conf koha-httpd.conf
1246
|--------------------
1247
1248
  * Restart Apache
1249
|--------------------
1250
myhost:/etc/apache2/conf.d # service apache2 restart
1251
Syntax error on line 28 of /etc/apache2/conf.d/koha-httpd.conf:
1252
Invalid command 'RewriteEngine', perhaps misspelled or defined by a module
1253
not included in the server configuration
1254
|--------------------
1255
1256
== Enable the mod_rewrite Apache module ==
1257
1258
OK... It seems that we need to enable the mod_rewrite Apache module:
1259
|--------------------
1260
myhost:/etc/sysconfig # a2enmod rewrite
1261
|--------------------
1262
If the above command seems NOT to work, for some reason, do this - edit /etc/sysconfig/apache2 and add the word "rewrite" (without the quotes) at the end of the APACHE_MODULES line, right before the right quote
1263
|--------------------
1264
myhost:/etc/sysconfig # service apache2 restart
1265
Syntax OK
1266
Shutting down httpd2 (waiting for all children to terminate)         done
1267
Starting httpd2 (prefork)                                            done
1268
|--------------------
1269
1270
== Change koha-httpd.conf ==
1271
1272
If you browsed again to http://192.168.1.16:8080 you would still get no answer. This is because we still have to do some changes to the koha-httpd.conf file. Unless you did not follow this tutorial and port 8080 is not open. Look back in this page to find out how.
1273
1274
First, let's create a backup of this file:
1275
|--------------------
1276
myhost:/etc/apache2/vhosts.d # cp koha-httpd.conf koha-httpd.conf.ORIG
1277
1278
myhost:/etc/koha # vim koha-httpd.conf
1279
|--------------------
1280
1281
At the beginning of the koha-httpd.conf file, under the commented NameVirtualHost line, add the following line:
1282
|--------------------
1283
Listen 8080
1284
|--------------------
1285
In that file, you should find two VirtualHost sections: one for the OPAC area of Koha and the other one for the Intranet.
1286
If the two virtualHost directives - the lines that start with <nowiki><VirtualHost</nowiki> - in that file are set for the IP Address 127.0.0.2, replace them by the correct IP address of your server.
1287
1288
That file will have 2 ServerName directives (one for each of the 2 VirtualHosts).
1289
In those directives, you should have the IP of your server -or- the FQDN of your server (example: ServerName koha-server.univ.org).
1290
1291
Now, restart again Apache:
1292
|--------------------
1293
myhost:/etc/koha # service apache2 restart
1294
Syntax OK
1295
Shutting down httpd2 (waiting for all children to terminate)         done
1296
Starting httpd2 (prefork)                                            done
1297
|--------------------
1298
1299
Try to access the web page:
1300
1301
http://192.168.1.16/
1302
1303
If you get again the "It Works!" web page, you'll probably have to Refresh/Reload the page in your browser (press the F5 key).
1304
1305
After reloading the page, you should get the following error:
1306
|--------------------
1307
Forbidden
1308
1309
You don't have permission to access / on this server.
1310
1311
Additionally, a 403 Forbidden error was encountered while trying to use an
1312
ErrorDocument to handle the request.
1313
Apache/2.2.4 (Linux/SUSE) Server at 192.168.1.16 Port 8080
1314
|--------------------
1315
1316
OK. Let's add then the following directive at the end of the koha-httpd.conf file:
1317
|--------------------
1318
<Directory /usr/share/koha>
1319
  Order allow,deny
1320
  Allow from all
1321
</Directory>
1322
|--------------------
1323
1324
Restart Apache:
1325
|--------------------
1326
myhost:/etc/apache2/vhosts.d # service apache2 restart
1327
Syntax OK
1328
Shutting down httpd2 (waiting for all children to terminate)         done
1329
Starting httpd2 (prefork)                                            done
1330
|--------------------
1331
1332
OK. Load again the following page in your web browser:
1333
1334
http://192.168.1.16
1335
1336
1337
After some seconds you should be redirected to:
1338
1339
http://192.168.0.2/cgi-bin/koha/maintenance.pl
1340
1341
and see a Koha page with the following text:
1342
"System Maintenance... we'll be back soon! If you have any questions, please contact the Site Administrator"
1343
1344
This is actually GOOD NEWS!  :)  It's now time to set up Koha in the Intranet interface.
1345
1346
To do that, browse to:
1347
1348
http://192.168.0.2:8080
1349
1350
You should see a page with the title "Welcome to the Koha Web Installer", and with a "Username" and a "Password" textboxes.
1351
1352
If not you may have forgotten to open the 8080 port.
1353
1354
1355
You may now login with your koha administrator username and password and reply to the several questions you will be asked.
1356
1357
== Add Zebra Indexer ==
1358
1359
Add an entry in Koha user crontab to process scheduled added/updated/deleted records
1360
indexing by Zebra. <script_dir>cronjobs/crontab.example contains examples for these cron jobs (and many more).
1361
1362
NOTE: The cronjobs should be setup under the kohauser (the default is 'koha', but
1363
this is the user you set up in section 'Create the Koha User and Group').
1364
1365
Edit the crontab for the koha user by running
1366
    $ sudo -u <kohauser> crontab -e
1367
1368
For Zebra indexing, you are looking for the example that begins with
1369
1370
    # ZEBRA INDEX UPDATES with -z option, incremental index updates throughout the day
1371
    # for both authorities and bibs
1372
1373
It may be easiest to copy/paste the example into your own crontab and modify as necessary.
1374
1375
You can also configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra
(-)a/INSTALL.ubuntu (-700 lines)
Lines 1-699 Link Here
1
=================================================================
2
Instructions for Installing Koha from Source
3
=================================================================
4
5
BUG REPORTS AND FEEDBACK
6
=================================================================
7
8
This document last modified: 18 September 2013
9
10
Given the nature of documentation to become outdated, or have
11
problems, please either submit feedback or bug reports.
12
13
Bug reports can be posted at http://bugs.koha-community.org
14
15
Feedback can be posted on the Koha Developer's List:
16
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
17
18
19
INTRODUCTION
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, 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
For instructions on how to install Koha on Ubuntu from packages, please
36
consult http://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages
37
38
To help assist with the development and improvement of Koha,
39
continue with these instructions and read more about version
40
control using git! See USEFUL REFERENCE LINKS below.
41
42
These instructions are intended for those who are skilled.
43
They can be used to set up a development system. This install
44
may not be as easy or smooth as you wish. This is to be expected
45
when installing from source.
46
47
48
NOTATION
49
=================================================================
50
51
Commands are indented by 4 spaces, and should be relatively obvious
52
as commands. Commands may have blank lines between them to
53
indicate that you should not just copy and paste the entire block
54
of commands.
55
56
File contents will be surrounded by the plus symbols with a
57
"FILE FULL" or "FILE PARTIAL" and the filename above the plus
58
symbols surrounding file contents.
59
60
Koha is released monthly, so keeping documentation up to date
61
is difficult. The convention is to replace the last number with
62
an x. For example, the current version is part of the 3.14.x
63
series and the former stable version is the 3.12.x series.
64
65
66
INSTALL UBUNTU
67
=================================================================
68
69
These instructions assume that you have already installed Ubuntu
70
from the official site: http://www.ubuntu.com/download/server
71
72
There is no need to install extra packages during the Ubuntu
73
installation. Apache2 and MySQL will be installed in the
74
instructions later.
75
76
Installing a mail transfer agent before installing Koha will
77
prevent the installation of nullmailer. Such an installation
78
and configuration of a mail transfer agent is beyond the
79
scope of this document. Consult your system administrator,
80
network administrator, or IT Department for assistance as needed.
81
82
These instructions assume you created a user account with your
83
login credentials and not one called 'koha'. This is to prevent
84
the system user 'koha' from having more permissions than it should.
85
86
87
ADD A KOHA COMMUNITY REPOSITORY
88
=================================================================
89
90
These instructions still function even though the latest version
91
of Debian is wheezy. If the version has changed again, please
92
confirm these instructions on the mailing list or IRC channel.
93
94
To avoid getting prompted for a password in the middle of a
95
chain of commands type the following:
96
    sudo ls
97
98
IF YOU ARE DOING A STANDARD (tarball) INSTALL use the following
99
command:
100
    echo deb http://debian.koha-community.org/koha squeeze main \
101
        | sudo tee /etc/apt/sources.list.d/koha.list
102
103
IF YOU ARE DOING A DEV (typically git) INSTALL use the following
104
command:
105
    echo deb http://debian.koha-community.org/koha squeeze-dev main \
106
        | sudo tee /etc/apt/sources.list.d/koha.list
107
108
To use the older stable release:
109
echo deb http://debian.koha-community.org/koha oldstable main \
110
| sudo tee /etc/apt/sources.list.d/koha.list
111
Intentionally not indented, as the others are preferred.
112
113
FOR EITHER INSTALLATION:
114
Add the key in gpg.asc to your APT trusted keys to avoid
115
warning messages on installation:
116
    wget -O- http://debian.koha-community.org/koha/gpg.asc \
117
        | sudo apt-key add -
118
119
120
UPDATE UBUNTU
121
=================================================================
122
123
This process, particularly the upgrade step, may take a while.
124
125
    sudo apt-get update
126
127
    sudo apt-get upgrade
128
129
    sudo apt-get clean
130
131
132
DOWNLOAD THE LATEST KOHA RELEASE
133
=================================================================
134
135
There are two ways to grab the source, either by using git
136
or by downloading the .tar.gz file. Git is recommended for a
137
development environment.
138
139
IF YOU ARE DOING A STANDARD INSTALLATION:
140
Downloading Source Via Tarball
141
=================================================================
142
143
    wget http://download.koha-community.org/koha-latest.tar.gz
144
    tar xvf koha-latest.tar.gz
145
    ls
146
147
NOTE: You need to cd into the Koha directory, but since the
148
version changes, you'll know by the ls command what it is.
149
150
IF YOU ARE DOING A DEV INSTALLATION:
151
Downloading Source Via Git
152
=================================================================
153
154
Please see the following wiki page and follow the instructions up
155
to and including "git checkout -b mywork origin".
156
http://wiki.koha-community.org/wiki/Version_Control_Using_Git
157
158
159
INSTALL DEPENDENCIES
160
=================================================================
161
162
Dependencies from Repository
163
=================================================================
164
165
The repository added has koha-deps and koha-perldeps packages
166
which make it very easy. Type the following:
167
    sudo apt-get install koha-deps koha-perldeps make
168
169
Check For Missing Dependencies
170
=================================================================
171
172
Check everything was installed, by running the test script to
173
identifty missing libraries:
174
    ./koha_perl_deps.pl -m -u
175
176
Install any required libraries that are missing. It is a good
177
idea to install optional ones that are easily found as well.
178
179
180
CREATE MYSQL DATABASE AND GRANT PRIVILEGES
181
=================================================================
182
183
Create MySQL Database
184
=================================================================
185
186
If you have difficulty accessing MySQL's root acount, perhaps
187
this Ubuntu page on resetting the root password may help.
188
https://help.ubuntu.com/community/MysqlPasswordReset
189
190
    mysql -u root -p
191
192
    CREATE DATABASE kohadata;
193
194
The Koha database has now been created with the name kohadata.
195
196
Create User and Grant Permissions
197
=================================================================
198
199
Continue entering MySQL commands. SUBSTITUTE A PASSWORD OF YOUR
200
CHOICE FOR THE {PASSWORD}'S IN THE FOLLOWING COMMANDS:
201
202
    CREATE user 'koha'@'localhost' IDENTIFIED by '{PASSWORD}';
203
    GRANT ALL ON kohadata.* TO 'koha'@'localhost' IDENTIFIED BY '{PASSWORD}';
204
    FLUSH PRIVILEGES;
205
    QUIT
206
207
The Koha administrative user has now been created with the name
208
'koha' and the password of your choosing.
209
210
211
CONFIGURE KOHA
212
=================================================================
213
214
User/Group Environment Variables
215
=================================================================
216
217
IF YOU ARE DOING A STANDARD INSTALLATION, then create a
218
separate 'koha' system user:
219
    sudo adduser koha
220
221
There is no need to set the following environment variables,
222
because 'koha' is the default account to use.
223
224
IF YOU ARE DOING A DEV INSTALLATION, then create some
225
environment variables for the process to pick up and use later:
226
    export __KOHA_USER__=$USER
227
    export __KOHA_GROUP__=$USER
228
    echo $USER
229
230
The output of the echo command should match your user id,
231
and since the user id and group id are generally the same for
232
a freshly created account, this will make sure the indexing
233
happens as this account.
234
235
236
Configure Your Koha Install
237
=================================================================
238
239
    perl Makefile.PL
240
241
How you answer the first question will affect where things will
242
end up being placed. It is recommended that choose 'standard' if
243
you are doing a tarball install, and 'dev' if you are doing a
244
git install.
245
246
Answering the resulting questions requires thinking. Here are
247
some hints.
248
249
Recall that the database created is kohadata set in the Create
250
MySQL Database step. The username and password were set up in
251
the Create User and Grant Permissions step.
252
253
Give some thought should be given to the MARC format desired
254
and the method of character normalization (chr or icu), though
255
the defaults will work as MARC21 just fine.
256
257
Use the same username and password for the Zebra questions.
258
259
Don't worry about warnings generated by optional components.
260
261
262
Build And Test Koha
263
=================================================================
264
265
Having configured Koha, build it using the following command:
266
    make
267
268
Once this has successfully run, test Koha using the following
269
command:
270
    make test
271
272
Don't worry about the large number of scary warning scrolling
273
by. All that matters is "PASS" or "FAIL".
274
275
If this fails, it is likely due to a failed dependency. Remember,
276
a source installation is not always smooth. You can determine the
277
missing dependency by scrolling back and looking for something
278
like: Can't locate Cache/Memcached/Fast.pm in @INC
279
Install it, and try to build and test again.
280
281
282
Install Koha
283
=================================================================
284
285
Once the make test has successfully run, install Koha.
286
287
IF YOU ARE DOING A STANDARD INSTALLATION, using the
288
following command (follow any on screen prompts):
289
    sudo make install
290
291
Once this has successfully run, Koha is almost installed. There
292
are only a few more steps left.
293
294
IF YOU ARE DOING A DEV INSTALLATION, using the
295
following command (follow any on screen prompts):
296
    make install
297
298
No sudo is required as you have access to the directories
299
listed above.
300
301
FOR EITHER INSTALLATION:
302
Near the end of this command, the output will have two lines
303
containing KOHA_CONF and PERL5LIB in them.  Take note of the two
304
export commands as you will need them for a later step.
305
306
307
PRE-WEB INSTALL SETUP
308
=================================================================
309
310
Ubuntu MySQL Security Tweak
311
=================================================================
312
313
There is a security risk in Ubuntu's MySQL default setup. Type
314
the following commands:
315
    mysql -u root -p
316
317
    USE mysql;
318
    DELETE FROM user WHERE user='';
319
    FLUSH PRIVILEGES;
320
    QUIT
321
322
The anonymous connections are now removed.
323
324
325
Configure System Wide Environment Variables
326
=================================================================
327
328
Running scripts and cron jobs requires environment variables set.
329
Use the following commands:
330
    sudo nano /etc/environment
331
332
IF YOU ARE DOING A DEV INSTALLATON:
333
FILE PARTIAL (ADD): /etc/environment
334
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
335
KOHA_CONF=/home/{YOUR USER NAME}/koha-dev/etc/koha-conf.xml
336
KOHA_PATH=/home/{YOUR USER NAME}/kohaclone
337
PERL5LIB=/home/{YOUR USER NAME}/kohaclone
338
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
339
NOTE: CHANGE {YOUR USER NAME} TO YOUR ACTUAL USER NAME!
340
341
IF YOU ARE DOING A STANDARD INSTALLATON:
342
FILE PARTIAL (ADD): /etc/environment
343
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
344
KOHA_CONF=/etc/koha/koha-conf.xml
345
KOHA_PATH=/usr/share/koha
346
PERL5LIB=/usr/share/koha/lib
347
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
348
349
    logout
350
351
You need to logout and back in in order to get the environment
352
variables values to be recognized.
353
354
355
CONFIGURE AND START APACHE
356
=================================================================
357
358
Place Koha Site File
359
=================================================================
360
361
IF YOU ARE DOING A DEV INSTALLATION, use the following command:
362
    sudo ln -s ~/koha-dev/etc/koha-httpd.conf \
363
        /etc/apache2/sites-available/koha
364
365
IF YOU ARE DOING A STANDARD INSTALLATION, use the following
366
command:
367
    sudo ln -s /etc/koha/koha-httpd.conf \
368
        /etc/apache2/sites-available/koha
369
370
Tweak Koha Site File
371
=================================================================
372
373
The default file limits connections to those from 127.0.1.1
374
(or 127.0.0.1), which is rather difficult to test/use in a
375
server environment. Edit the file:
376
    sudo nano /etc/apache2/sites-available/koha
377
378
/etc/apache2/sites-available/koha will have a line
379
that should have the IP address changed to a *.
380
FILE PARTIAL (CHANGE): /etc/apache2/sites-available/koha
381
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
382
<VirtualHost *:80>
383
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
384
385
/etc/apache2/sites-available/koha will have another line
386
that should have the IP address changed to a *
387
FILE PARTIAL (CHANGE): /etc/apache2/sites-available/koha
388
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
389
<VirtualHost *:8080>
390
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
391
392
Setup Default Ports
393
=================================================================
394
395
    sudo nano /etc/apache2/ports.conf
396
397
/etc/apache2/ports.conf must have two lines exactly like
398
the following.  Do not add them if they are already there.
399
400
FILE PARTIAL (CONFIRM/ADD/CHANGE): /etc/apache2/ports.conf
401
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
402
Listen 80
403
Listen 8080
404
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
405
406
/etc/apache2/ports.conf does not require NameVirtualHost.
407
Do not add it if it is missing or already there. Just
408
prepend # accordingly.
409
410
FILE PARTIAL (CONFIRM/ADD/CHANGE): /etc/apache2/ports.conf
411
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
412
#NameVirtualHost *:80
413
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
414
415
Disable Default Site
416
=================================================================
417
418
These short instructions assume that the default site is
419
not needed.  Talk with your system administrator, network
420
administrator, or IT Department to CONFIRM THIS BEFORE RUNNING
421
the following command:
422
    sudo a2dissite 000-default
423
424
Enable Modules and Site
425
=================================================================
426
427
Now enable the Apache modules this config needs, enable Koha's
428
virtual host configuration, and restart Apache.
429
    sudo a2enmod rewrite
430
    sudo a2enmod deflate
431
    sudo a2ensite koha
432
    sudo service apache2 restart
433
434
435
SETUP ZEBRA
436
=================================================================
437
438
The Zebra process send responses to search requests sent by Koha
439
or Z39.50/SRU/SRW clients.
440
441
The user you run Zebra as will be the only user with write
442
permission on the Zebra index. For a standard installation, this
443
should be the system user 'koha'. For a dev installation, this
444
should be your system user.
445
446
Start Zebra Server on Boot
447
=================================================================
448
449
IF YOU ARE DOING A STANDARD INSTALLATION, use this command:
450
    sudo ln -s /usr/share/koha/bin/koha-zebra-ctl.sh \
451
        /etc/init.d/koha-zebra-daemon
452
453
IF YOU ARE DOING A DEV INSTALLATION, use this command:
454
    sudo ln -s ~/koha-dev/bin/koha-zebra-ctl.sh \
455
        /etc/init.d/koha-zebra-daemon
456
457
FOR EITHER INSTALLATION:
458
    sudo update-rc.d koha-zebra-daemon defaults
459
    sudo service koha-zebra-daemon start
460
461
Configuring Zebra Indexing
462
=================================================================
463
464
IF YOU ARE DOING A STANDARD INSTALLATION, use this command:
465
    sudo nano /etc/cron.d/koha
466
467
FILE FULL: /etc/cron.d/koha
468
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
469
# The cronjobs -- $KOHA_PATH is defined in /etc/environment, and
470
# gets set when this process runs as a user (koha).
471
*/5 * * * * koha $KOHA_PATH/bin/migration_tools/rebuild_zebra.pl -b -a -z &> /dev/null
472
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
473
474
IF YOU ARE DOING A DEV INSTALLATION, use this command:
475
    crontab -e
476
477
FILE PARTIAL (ADD):
478
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
479
# The cronjobs -- $KOHA_PATH is defined in /etc/environment, and
480
# gets set when this process runs.
481
*/5 * * * *	$KOHA_PATH/misc/migration_tools/rebuild_zebra.pl -b -a -z &> /dev/null
482
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
483
484
485
SETUP ADDITIONAL LANGUAGES
486
=================================================================
487
488
To use multi-lingual sample data, please install languages
489
which may be useful for use in the Koha system.
490
491
Information on this can be found:
492
http://wiki.koha-community.org/wiki/Installation_of_additional_languages_for_OPAC_and_INTRANET_staff_client
493
494
495
WEB INSTALLATION
496
=================================================================
497
498
Now you can visit your staff client website to continue with the
499
Koha web installer. The user name to log in with will be koha.
500
501
The password will be what you set in the 'Create User and
502
Grant Permissions' section above.
503
504
Lynx navigational keys include: tab to go between fields, enter
505
(when not on text fields) to toggle or click, space to change
506
pages (when not on text fields), Q to quit (when not on text
507
fields). Arrows also work.
508
509
    sudo apt-get install lynx
510
511
    lynx http://127.0.1.1:8080/
512
513
514
SET UP YOUR LIBRARY IN KOHA
515
=================================================================
516
517
After the web install, you should be redirected to:
518
http://127.0.1.1:8080
519
Follow these steps:
520
- Login with koha user name and password.
521
- Click on the More dropdown menu.
522
- Select and click Administration.
523
- Click Libraries and groups
524
  under the Basic Parameters heading.
525
- Click New Library and enter your information into the form.
526
- Click Submit.
527
Your library is now set up in Koha.
528
529
Take the time to read the documentation to do other necessary
530
setup tasks such as creating a patron, and importing or entering
531
MARC data. The documentation for Koha can be found at:
532
http://koha-community.org/documentation/
533
534
535
USEFUL REFERENCE LINKS
536
=================================================================
537
538
Documentation:
539
http://koha-community.org/documentation/
540
541
Additional Languages:
542
http://wiki.koha-community.org/wiki/Installation_of_additional_languages_for_OPAC_and_INTRANET_staff_client
543
544
Stage MARC Records for Import:
545
http://manual.koha-community.org/3.14/en/catalogtools.html#stagemarc
546
NOTE: The URL has been similar since Koha version 3.8
547
548
Frequently Asked Questions:
549
http://koha-community.org/documentation/faq
550
551
Bug Reports:
552
http://bugs.koha-community.org/
553
554
Public Z39.50/SRU server:
555
http://wiki.koha-community.org/wiki/Troubleshooting_Koha_as_a_Z39.50_server
556
557
Alternate Indexing Method:
558
http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra
559
560
561
UPGRADING
562
=================================================================
563
564
If you are running in another language other than English,
565
please switch to English before doing the upgrade, the
566
templating system has changed and the templates will need to
567
be regenerated.
568
569
Once you have upgraded, please regenerate your templates in
570
your chosen languages.
571
572
First, ensure the most recent dependencies are installed:
573
    sudo apt-get update
574
    sudo apt-get install koha-deps koha-perldeps
575
576
IF YOU ARE DOING A STANDARD UPGRADE:
577
In order to upgrade, find the path to the koha install-log file:
578
    sudo find /usr/share/koha/ -name 'koha-install-log'
579
580
Change directory into the latest koha source directory, and then:
581
    perl Makefile.PL --prev-install-log /path/to/koha-install-log
582
583
NOTE: Make sure to change the /path/to/koha-install-log to the
584
one that was found.
585
586
    make
587
    make test
588
589
And if that passes:
590
    sudo make upgrade
591
592
IF YOU ARE DOING A DEV UPGRADE:
593
In order to upgrade, find the path to the koha install-log file:
594
    find ~/koha-dev/ -name 'koha-install-log'
595
596
    cd ~/kohaclone
597
    perl Makefile.PL --prev-install-log /path/to/koha-install-log
598
599
NOTE: Make sure to change the /path/to/koha-install-log to the
600
one that was found.
601
602
    make
603
    make test
604
605
And if that passes:
606
    make upgrade
607
608
FOR EITHER UPGRADE TYPE:
609
If you are upgrading from a version of Koha earlier than 3.4.x,
610
Koha 3.4.x or later no longer stores items in biblio records:
611
./misc/maintenance/remove_items_from_biblioitems.pl --run
612
Intentionally not indented, in the hopes that most upgrades are
613
post 3.4.x.
614
615
Regardless of version you are upgrading from, a full reindex is
616
always the best option:
617
IF YOU ARE DOING A STANDARD UPGRADE
618
    sudo su -l koha --command="/usr/bin/perl /usr/share/koha/bin/migration_tools/rebuild_zebra.pl -b -a -r -v"
619
620
IF YOU ARE DOING A DEV UPGRADE
621
    ./misc/migration_tools/rebuild_zebra.pl -b -a -r -v
622
623
624
UNINSTALL INSTRUCTIONS
625
=================================================================
626
627
Stop Services
628
=================================================================
629
    sudo a2dissite koha
630
    sudo rm /etc/apache2/sites-available/koha
631
    sudo service apache2 restart
632
    sudo update-rc.d koha-zebra-daemon remove
633
    sudo rm /etc/init.d/koha-zebra-daemon
634
635
Remove Database
636
=================================================================
637
    mysql -u koha -p
638
639
    drop database kohadata;
640
    quit
641
642
Remove Indexes
643
=================================================================
644
645
IF DOING A STANDARD REMOVAL:
646
    zebraidx -c /etc/koha/zebradb/zebra-biblios.cfg \
647
        -g iso2709 -d biblios init
648
    zebraidx -c /etc/koha/zebradb/zebra-authorities.cfg \
649
        -g iso2709 -d authorities init
650
    sudo rm -rf /etc/koha
651
    sudo rm -rf /usr/share/koha
652
    sudo rm /etc/cron.d/koha
653
654
You may wish to follow up with:
655
    sudo find / -t d -name "koha"
656
to help find any remnants.
657
658
IF DOING A DEV REMOVAL:
659
The following will work, but is very dangerous! Please copy or
660
type this correctly.
661
    zebraidx -c ~/koha-dev/etc/zebradb/zebra-biblios.cfg \
662
        -g iso2709 -d biblios init
663
    zebraidx -c ~/koha-dev/etc/zebradb/zebra-authorities.cfg \
664
        -g iso2709 -d authorities init
665
    rm -rf ~/koha-dev
666
    rm -rf ~/kohaclone
667
NOTE: Don't forget to remove the crontab entries!
668
669
670
LICENSE
671
=================================================================
672
673
This file is part of Koha.
674
675
Major re-write by Mark Tompsett
676
Copyright (C) 2013
677
678
Based on remnants by:
679
Copyright (C) 2007, 2008 LibLime (http://liblime.com)
680
                          Original author: Joshua Ferraro
681
Some parts Copyright (C) 2010 Chris Nighswonger (modified for ubuntu)
682
                          (cnighswonger AT foundations DOT edu)
683
Some parts Copyright (C) 2012 Tomas Cohen Arazi
684
                          (tomascohen AT gmail DOT com)
685
Some parts Copyright (C) 2012 Mark Tompsett
686
                          (mtompset AT hotmail DOT com)
687
688
Koha is free software; you can redistribute it and/or modify it
689
under the terms of the GNU General Public License as published by
690
the Free Software Foundation; either version 3 of the License, or
691
(at your option) any later version.
692
693
Koha is distributed in the hope that it will be useful, but
694
WITHOUT ANY WARRANTY; without even the implied warranty of
695
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
696
GNU General Public License for more details.
697
698
You should have received a copy of the GNU General Public License
699
along with Koha; if not, see <http://www.gnu.org/licenses>.
700
- 

Return to bug 17626