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

(-)a/INSTALL (-8 / +6 lines)
Lines 31-37 Default installation instructions: Link Here
31
  tarball direct from CPAN and install it directly rather than using the cpan command
31
  tarball direct from CPAN and install it directly rather than using the cpan command
32
32
33
2. make
33
2. make
34
3.(optional) make test 
34
3.(optional) make test
35
4. sudo make install
35
4. sudo make install
36
5. sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
36
5. sudo ln -s /etc/koha/koha-httpd.conf /etc/apache2/sites-available/koha
37
  (note that the path to koha-httpd.conf may be different depending on your
37
  (note that the path to koha-httpd.conf may be different depending on your
Lines 63-69 UPGRADE Link Here
63
=======
63
=======
64
If you are running in another language other than english, please
64
If you are running in another language other than english, please
65
switch to english before doing the upgrade, the templating system has
65
switch to english before doing the upgrade, the templating system has
66
changed and the templates will need to be regenerated. 
66
changed and the templates will need to be regenerated.
67
Once you have upgraded, please regenerate your templates in your
67
Once you have upgraded, please regenerate your templates in your
68
chosen languages.
68
chosen languages.
69
69
Lines 89-95 Use the packaged version or install from CPAN Link Here
89
 sudo make upgrade
89
 sudo make upgrade
90
90
91
Koha 3.4.x or later  no longer stores items in biblio records.
91
Koha 3.4.x or later  no longer stores items in biblio records.
92
If you are upgrading from an older version ou will need to do the 
92
If you are upgrading from an older version ou will need to do the
93
following two steps, they can take a long time (several hours) to
93
following two steps, they can take a long time (several hours) to
94
complete for large databases
94
complete for large databases
95
95
Lines 120-133 WHAT NEXT? Link Here
120
    Once the indexing has completed, you will be able to search for records in your
120
    Once the indexing has completed, you will be able to search for records in your
121
    system. NOTE: if you don't run the Fast Index utility, and you have the index
121
    system. NOTE: if you don't run the Fast Index utility, and you have the index
122
    updates scheduled as per 7.3 the indexing process will happen in the background,
122
    updates scheduled as per 7.3 the indexing process will happen in the background,
123
    Once the indexing has completed, you will be able to search for records in your
124
    system. NOTE: if you don't run the Fast Index utility, and you have the index
125
    updates scheduled as per 7.3 the indexing process will happen in the background,
126
    but it will be orders of magnitude slower.
123
    but it will be orders of magnitude slower.
127
124
128
4. Schedule regular index updates
125
4. Schedule regular index updates
129
    run rebuild_zebra.pl -b -a -z as a regular cron job, check misc/cronjobs/crontab.example
126
    run rebuild_zebra.pl -b -a -z as a regular cron job, check the 'misc/cronjobs/crontab.example' file for usage examples
130
    for usage examples
127
128
    You can also configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra
131
129
132
5. To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and
130
5. To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and
133
    change the <listen> options to listen on a TCP port; then restart the zebra daemon.
131
    change the <listen> options to listen on a TCP port; then restart the zebra daemon.
(-)a/INSTALL.debian (-10 / +14 lines)
Lines 8-14 Some parts copyright 2011 MJ Ray and software.coop Link Here
8
Feedback/bug reports: Koha Developer's List:
8
Feedback/bug reports: Koha Developer's List:
9
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
9
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
10
10
11
This document last modified: 2011-06-19
11
This document last modified: 2012-March-20
12
12
13
Installation Instructions
13
Installation Instructions
14
=============================
14
=============================
Lines 127-139 PurePerl, both of which have outstanding bugs with pre-composed characters. Link Here
127
You can test your SAX parser by running:
127
You can test your SAX parser by running:
128
128
129
    $ cd koha
129
    $ cd koha
130
    $ misc/sax_parser_print.pl 
130
    $ misc/sax_parser_print.pl
131
131
132
You should see something like:
132
You should see something like:
133
133
134
    XML::LibXML::SAX::Parser=HASH(0x81fe220)
134
    XML::LibXML::SAX::Parser=HASH(0x81fe220)
135
135
136
If you are configured to use PurePerl or Expat, the script will say you have a problem and 
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.
137
you'll need to edit your ini file to correct it.
138
138
139
The file is typically located at:
139
The file is typically located at:
Lines 198-212 Note: you may still see the usual Apache default site if your VirtualHost Link Here
198
Point your browser to http://<servername>:8080/
198
Point your browser to http://<servername>:8080/
199
199
200
Note: <servername> is (usually) the IP of your server, or localhost (if you are connecting
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 
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
202
      the VirtualHost settings for both the opac and intranet virtual hosts in koha-httpd.conf
203
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 
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 
205
that
206
you can install the sample data for libraries, patrons, and much more.
206
you can install the sample data for libraries, patrons, and much more.
207
207
208
Be aware that removing sample data at a later time (when you may want to take the 
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 
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).
210
install from testing to production, go with minimal sample data (no patrons or bibliographic records).
211
211
212
6. Configure and start Zebra
212
6. Configure and start Zebra
Lines 274-285 Edit the crontab for the koha user by running Link Here
274
    $ sudo -u <kohauser> crontab -e
274
    $ sudo -u <kohauser> crontab -e
275
275
276
For Zebra indexing, you are looking for the example that begins with
276
For Zebra indexing, you are looking for the example that begins with
277
    
277
278
    # ZEBRA INDEX UPDATES with -z option, incremental index updates throughout the day
278
    # ZEBRA INDEX UPDATES with -z option, incremental index updates throughout the day
279
    # for both authorities and bibs
279
    # for both authorities and bibs
280
280
281
It may be easiest to copy/paste the example into your own crontab and modify as necessary.
281
It may be easiest to copy/paste the example into your own crontab and modify as necessary.
282
282
283
You can also configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra
283
284
284
7. What next?
285
7. What next?
285
286
Lines 306-316 Authority data in MARC21 format Link Here
306
    Once the indexing has completed, you will be able to search for records in your system.
307
    Once the indexing has completed, you will be able to search for records in your system.
307
    NOTE: This script should be run as the kohauser (the default is 'koha', this is the user we set up in step 2.3).
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).
308
309
309
7.3 Schedule regular index updates
310
7.3 Schedule regular index updates with cron ,or configure zebra indexing as a background daemon
311
310
    You need to run rebuild_zebra.pl -b -a -z as a regular cron job in orde to pick up new bibs
312
    You need to run rebuild_zebra.pl -b -a -z as a regular cron job in orde to pick up new bibs
311
    and items as you add them. Check misc/cronjobs/crontab.example for usage examples. See 7.0 above.
313
    and items as you add them. Check misc/cronjobs/crontab.example for usage examples. See 7.0 above.
312
    NOTE: This job should be setup under the kohauser (the default is 'koha', this is the user we set up in step 2.3).
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).
313
315
316
    To setup indexing in background see 6.2.2
317
314
7.4 To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and
318
7.4 To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and
315
    change the <listen> options to listen on a TCP port; then restart the zebra daemon.
319
    change the <listen> options to listen on a TCP port; then restart the zebra daemon.
316
320
(-)a/INSTALL.fedora7 (+5 lines)
Lines 1-3 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
1
=============================
6
=============================
2
Installation Guide for Installing Koha on Fedora Core 7
7
Installation Guide for Installing Koha on Fedora Core 7
3
=============================
8
=============================
(-)a/INSTALL.opensuse (-44 / +64 lines)
Lines 5-15 Version for openSUSE 11.3 adapted by Freek de Kruijf - freek -at- opensuse -dot- Link Here
5
5
6
No liability for the contents of this document can be accepted.
6
No liability for the contents of this document can be accepted.
7
7
8
Feedback/bug reports: Koha Developer's List: 
8
Feedback/bug reports: Koha Developer's List:
9
9
10
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
10
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
11
11
12
This document last modified: 15 Oct 2010
12
This document last modified: 20 Mar 2012
13
13
14
== Installation Instructions ==
14
== Installation Instructions ==
15
15
Lines 19-25 The installation of Linux system described below is a basic, it is not designed Link Here
19
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!
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
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. 
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
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).
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
25
Lines 34-40 Place the DVD in the drive and restart the machine. In the case of a virtualmach Link Here
34
After the "Welcome" screen, you'll get a First menu, with the following options:
34
After the "Welcome" screen, you'll get a First menu, with the following options:
35
35
36
----
36
----
37
Boot from Hard Disk 
37
Boot from Hard Disk
38
38
39
Installation
39
Installation
40
40
Lines 42-48 Repair Installed System Link Here
42
42
43
Rescue System
43
Rescue System
44
44
45
Firmware Test 
45
Firmware Test
46
46
47
Memory Test
47
Memory Test
48
----
48
----
Lines 58-65 Choose "Installation" (second command) Link Here
58
58
59
You'll see two Dropdown Lists: "Language" and "Keyboard Layout"
59
You'll see two Dropdown Lists: "Language" and "Keyboard Layout"
60
60
61
This depends of your place and preference, naturally. 
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. 
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)).
63
So I leave the default option selected for "Language"  and "Keyboard Layout" to (English (US)).
64
64
65
Check the "I Agree to the License Terms" checkbox (under the "License Agreement" textbox).
65
Check the "I Agree to the License Terms" checkbox (under the "License Agreement" textbox).
Lines 269-275 koha-server login: Link Here
269
You may now login with your "root" user.
269
You may now login with your "root" user.
270
270
271
==== Changing the Hostname and Domain Name ====
271
==== Changing the Hostname and Domain Name ====
272
 
272
273
273
274
Maybe you want to change the hostname, domain name and switch from DHCP to a Static IP address.
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.
275
Changing the hostname and domain name will not be shown here, because we assume that was done according to your whishes during installation.
Lines 295-301 Press the ENTER key. Link Here
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).
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.
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.".
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). 
298
I just press ENTER on that dialog box, but I do NOT reboot (at least not yet).
299
299
300
Then I press Alt+V to go to the "Overview" (still in "Network Settings").
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.
301
Then I press ALT+I to "Edit" the information for this Network Card.
Lines 350-357 For this you use vim to change the config file of sshd. Link Here
350
Find the lines starting with AcceptEnv and insert a # in front of these, There are three lines.
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:
351
Afterwards these lines will look like:
352
|--------------------
352
|--------------------
353
#AcceptEnv LANG LC_CTYPE LC_NUMERIC LC_TIME LC_COLLATE LC_MONETARY LC_MESSAGES 
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 
354
#AcceptEnv LC_PAPER LC_NAME LC_ADDRESS LC_TELEPHONE LC_MEASUREMENT
355
#AcceptEnv LC_IDENTIFICATION LC_ALL
355
#AcceptEnv LC_IDENTIFICATION LC_ALL
356
|--------------------
356
|--------------------
357
357
Lines 396-413 Inside yast, select Software -> Software Repositories Link Here
396
396
397
==== "Configured Software Repositories" screen ====
397
==== "Configured Software Repositories" screen ====
398
398
399
When on this screen, you already see a table that has: 
399
When on this screen, you already see a table that has:
400
400
401
* as configured repositories (in the "Name" column)
401
* as configured repositories (in the "Name" column)
402
** "Updates for openSUSE 11.3 11.3-1.82"
402
** "Updates for openSUSE 11.3 11.3-1.82"
403
** "openSUSE-11.3 11.3-1.82"
403
** "openSUSE-11.3 11.3-1.82"
404
** "openSUSE-11.3-Debug"
404
** "openSUSE-11.3-Debug"
405
** "openSUSE-11.3-Non-Oss" "openSUSE-11.3-Oss" ... 
405
** "openSUSE-11.3-Non-Oss" "openSUSE-11.3-Oss" ...
406
* at least the following repositories have an "x" in the "Enabled" column
406
* at least the following repositories have an "x" in the "Enabled" column
407
** "Updates for openSUSE 11.3 11.3-1.82"
407
** "Updates for openSUSE 11.3 11.3-1.82"
408
** "openSUSE-11.3-Oss"
408
** "openSUSE-11.3-Oss"
409
* you still have to add the folowing repositiory to this list
409
* you still have to add the folowing repositiory to this list
410
** "openSUSE BuildService - devel:languages:perl" 
410
** "openSUSE BuildService - devel:languages:perl"
411
Press ALT+A to Add Repositories.
411
Press ALT+A to Add Repositories.
412
412
413
==== "Media type" screen ====
413
==== "Media type" screen ====
Lines 486-492 We want to have en_US.UTF-8 in all LC_* variables. So, we'll do the following: Link Here
486
|--------------------
486
|--------------------
487
System -> Language
487
System -> Language
488
488
489
The "Languages" screen should appear. 
489
The "Languages" screen should appear.
490
490
491
In the first section (Primary Language Settings):
491
In the first section (Primary Language Settings):
492
492
Lines 667-674 Shutting down service MySQL done Link Here
667
Starting service MySQL                                                done
667
Starting service MySQL                                                done
668
|--------------------
668
|--------------------
669
669
670
Now, let's type again the show variables like 'char%' mysql command to see if 
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 
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:
672
will still read "binary" but I think that's OK:
673
|--------------------
673
|--------------------
674
myhost:/etc # mysql -p
674
myhost:/etc # mysql -p
Lines 702-712 Bye Link Here
702
702
703
=== Create the koha database and user with associated privileges ===
703
=== Create the koha database and user with associated privileges ===
704
|--------------------
704
|--------------------
705
# mysqladmin -uroot create koha -p 
705
# mysqladmin -uroot create koha -p
706
|--------------------
706
|--------------------
707
(you may name the koha database something different from koha)
707
(you may name the koha database something different from koha)
708
708
709
=== Grant privileges to a MySQL user to the koha database === 
709
=== Grant privileges to a MySQL user to the koha database ===
710
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:
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
|--------------------
712
|--------------------
Lines 754-760 You must be sure you're using the XML::LibXML SAX parser, not Expat or PurePerl, Link Here
754
|--------------------
754
|--------------------
755
# cd /root/koha-3.00.00/
755
# cd /root/koha-3.00.00/
756
756
757
myhost:~/koha-3.00.00 # misc/sax_parser_print.pl 
757
myhost:~/koha-3.00.00 # misc/sax_parser_print.pl
758
|--------------------
758
|--------------------
759
759
760
You will probably see this:
760
You will probably see this:
Lines 762-768 You will probably see this: Link Here
762
XML::SAX::PurePerl=HASH(0x8356a4c)
762
XML::SAX::PurePerl=HASH(0x8356a4c)
763
|--------------------
763
|--------------------
764
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. 
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.
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:
767
To do this, first update the locate database by running the updatedb command:
768
|--------------------
768
|--------------------
Lines 815-821 You will notice that a few dependencies need to be resolved, so a few other pack Link Here
815
|--------------------
815
|--------------------
816
myhost:/usr/lib/perl5/vendor_perl/5.10.0/XML/SAX # cd /root/koha-3.00.00
816
myhost:/usr/lib/perl5/vendor_perl/5.10.0/XML/SAX # cd /root/koha-3.00.00
817
|--------------------
817
|--------------------
818
After installation of a number of CPAN/perl packages we will run perl Makefile.PL to run the Koha installer. 
818
After installation of a number of CPAN/perl packages we will run perl Makefile.PL to run the Koha installer.
819
819
820
820
821
=== Using zypper to install CPAN modules ===
821
=== Using zypper to install CPAN modules ===
Lines 880-886 The commands show below need to be given one by one, because zypper will always Link Here
880
== Running the Makefile.PL module to configure Koha ==
880
== Running the Makefile.PL module to configure Koha ==
881
881
882
My installation is a UNIMARC installation, so I'm answering unimarc to the "MARC format for Zebra indexing (marc21, unimarc) [marc21]" question below.
882
My installation is a UNIMARC installation, so I'm answering unimarc to the "MARC format for Zebra indexing (marc21, unimarc) [marc21]" question below.
883
If your Library uses the MARC21 format instead of UNIMARC, you should press ENTER to accept the default (which is marc21). 
883
If your Library uses the MARC21 format instead of UNIMARC, you should press ENTER to accept the default (which is marc21).
884
884
885
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
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.
886
886
Lines 1136-1167 cp koha-tmpl/opac-tmpl/prog/famfamfam/mini/note.gif blib/OPAC_TMPL_DIR/prog/famf Link Here
1136
1136
1137
[many more lines beginning with "cp" should appear...]
1137
[many more lines beginning with "cp" should appear...]
1138
1138
1139
t/Amazon.t .................. ok   
1139
t/Amazon.t .................. ok
1140
t/Barcodes_PrinterConfig.t .. ok   
1140
t/Barcodes_PrinterConfig.t .. ok
1141
t/Bookfund.t ................ ok   
1141
t/Bookfund.t ................ ok
1142
t/Bookseller.t .............. ok   
1142
t/Bookseller.t .............. ok
1143
t/Boolean.t ................. ok     
1143
t/Boolean.t ................. ok
1144
t/Branch.t .................. ok   
1144
t/Branch.t .................. ok
1145
t/Calendar.t ................ ok   
1145
t/Calendar.t ................ ok
1146
t/Charset.t ................. ok   
1146
t/Charset.t ................. ok
1147
t/Debug.t ................... # BEFORE use:     $debug is not defined
1147
t/Debug.t ................... # BEFORE use:     $debug is not defined
1148
# BEFORE use: $cgi_debug is not defined
1148
# BEFORE use: $cgi_debug is not defined
1149
t/Debug.t ................... 1/3 #  AFTER use:     $debug is 0
1149
t/Debug.t ................... 1/3 #  AFTER use:     $debug is 0
1150
#  AFTER use: $cgi_debug is 0
1150
#  AFTER use: $cgi_debug is 0
1151
# Done.
1151
# Done.
1152
t/Debug.t ................... ok   
1152
t/Debug.t ................... ok
1153
t/dummy.t ................... ok   
1153
t/dummy.t ................... ok
1154
t/Input.t ................... ok   
1154
t/Input.t ................... ok
1155
t/Koha.t .................... ok   
1155
t/Koha.t .................... ok
1156
t/Languages.t ............... ok   
1156
t/Languages.t ............... ok
1157
t/Maintainance.t ............ ok   
1157
t/Maintainance.t ............ ok
1158
t/Output.t .................. ok   
1158
t/Output.t .................. ok
1159
t/Record.t .................. ok   
1159
t/Record.t .................. ok
1160
t/Review.t .................. ok   
1160
t/Review.t .................. ok
1161
t/Scrubber.t ................ 1/10 # Note: scrubber test output will have whitespace collapsed for readability
1161
t/Scrubber.t ................ 1/10 # Note: scrubber test output will have whitespace collapsed for readability
1162
# done.
1162
# done.
1163
t/Scrubber.t ................ ok     
1163
t/Scrubber.t ................ ok
1164
t/Stats.t ................... ok   
1164
t/Stats.t ................... ok
1165
All tests successful.
1165
All tests successful.
1166
Files=19, Tests=47,  3 wallclock secs ( 0.06 usr  0.08 sys +  2.12 cusr  0.25 csys =  2.51 CPU)
1166
Files=19, Tests=47,  3 wallclock secs ( 0.06 usr  0.08 sys +  2.12 cusr  0.25 csys =  2.51 CPU)
1167
Result: PASS
1167
Result: PASS
Lines 1214-1220 Exit the shell and log back in. Link Here
1214
|--------------------
1214
|--------------------
1215
myhost:/etc # exit
1215
myhost:/etc # exit
1216
|--------------------
1216
|--------------------
1217
After logging back in, type the following commands to check if 
1217
After logging back in, type the following commands to check if
1218
the KOHA_CONF and PERL5LIB environment variables have been correctly set:
1218
the KOHA_CONF and PERL5LIB environment variables have been correctly set:
1219
|--------------------
1219
|--------------------
1220
myhost:~ # env | grep KOHA
1220
myhost:~ # env | grep KOHA
Lines 1283-1289 At the beginning of the koha-httpd.conf file, under the commented NameVirtualHos Link Here
1283
|--------------------
1283
|--------------------
1284
Listen 8080
1284
Listen 8080
1285
|--------------------
1285
|--------------------
1286
In that file, you should find two VirtualHost sections: one for the OPAC area of Koha and the other one for the Intranet. 
1286
In that file, you should find two VirtualHost sections: one for the OPAC area of Koha and the other one for the Intranet.
1287
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
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.
1288
1288
1289
That file will have 2 ServerName directives (one for each of the 2 VirtualHosts).
1289
That file will have 2 ServerName directives (one for each of the 2 VirtualHosts).
Lines 1355-1357 If not you may have forgotten to open the 8080 port. Link Here
1355
1355
1356
You may now login with your koha administrator username and password and reply to the several questions you will be asked.
1356
You may now login with your koha administrator username and password and reply to the several questions you will be asked.
1357
1357
1358
== Add Zebra Indexer ==
1359
1360
Add an entry in Koha user crontab to process scheduled added/updated/deleted records
1361
indexing by Zebra. <script_dir>cronjobs/crontab.example contains examples for these cron jobs (and many more).
1362
1363
NOTE: The cronjobs should be setup under the kohauser (the default is 'koha', but
1364
this is the user you set up in section 'Create the Koha User and Group').
1365
1366
Edit the crontab for the koha user by running
1367
    $ sudo -u <kohauser> crontab -e
1368
1369
For Zebra indexing, you are looking for the example that begins with
1370
1371
    # ZEBRA INDEX UPDATES with -z option, incremental index updates throughout the day
1372
    # for both authorities and bibs
1373
1374
It may be easiest to copy/paste the example into your own crontab and modify as necessary.
1375
1376
You can also configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra
1377
(-)a/INSTALL.ubuntu (-5 / +9 lines)
Lines 11-17 Modified for Ubuntu by: Chris Nighswonger (cnighswonger AT foundations DOT edu) Link Here
11
Feedback/bug reports: Koha Developer's List:
11
Feedback/bug reports: Koha Developer's List:
12
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
12
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
13
13
14
This document last modified: 19 May 2010
14
This document last modified: 20 March 2010
15
15
16
Installation Instructions
16
Installation Instructions
17
=============================
17
=============================
Lines 281-287 To add a user do: Link Here
281
281
282
Option 1: run the Zebra processes from the command line:
282
Option 1: run the Zebra processes from the command line:
283
283
284
1.1 Zebra Search Server
284
5.1.1 Zebra Search Server
285
285
286
This process send responses to search requests sent by Koha or
286
This process send responses to search requests sent by Koha or
287
Z39.50/SRU/SRW clients.
287
Z39.50/SRU/SRW clients.
Lines 294-300 Note: the user you run Zebra as will be the only user with write permission Link Here
294
      on the Zebra index; in development mode, you may wish to use your
294
      on the Zebra index; in development mode, you may wish to use your
295
      system user.
295
      system user.
296
296
297
1.2 Zebra Indexer
297
5.1.2 Zebra Indexer
298
298
299
Added/updated/deleted records in Koha MySQL database must be indexed
299
Added/updated/deleted records in Koha MySQL database must be indexed
300
into Zebra. A specific script must be launched each time a bibliographic
300
into Zebra. A specific script must be launched each time a bibliographic
Lines 308-314 Option 2: run the Zebra process as a daemon, and add to startup process: Link Here
308
Note that references to $SCRIPT_DIR refer to the directory where
308
Note that references to $SCRIPT_DIR refer to the directory where
309
Koha's command-line scripts are installed, e.g., /usr/share/koha/bin.
309
Koha's command-line scripts are installed, e.g., /usr/share/koha/bin.
310
310
311
1.1 Zebra Search Server
311
5.2.1 Zebra Search Server
312
312
313
    $ sudo ln -s ${SCRIPT_DIR}/koha-zebra-ctl.sh  /etc/init.d/koha-zebra-daemon
313
    $ sudo ln -s ${SCRIPT_DIR}/koha-zebra-ctl.sh  /etc/init.d/koha-zebra-daemon
314
    (Note: ${SCRIPT_DIR} is /usr/share/koha/bin/ by default in a standard install)
314
    (Note: ${SCRIPT_DIR} is /usr/share/koha/bin/ by default in a standard install)
Lines 317-323 Koha's command-line scripts are installed, e.g., /usr/share/koha/bin. Link Here
317
317
318
    $ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start
318
    $ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start
319
319
320
1.2 Zebra Indexer
320
5.2.2 Zebra Indexer
321
321
322
Add an entry in Koha user crontab to scheduled added/updated/deleted records
322
Add an entry in Koha user crontab to scheduled added/updated/deleted records
323
indexing by Zebra with this command:
323
indexing by Zebra with this command:
Lines 327-332 indexing by Zebra with this command: Link Here
327
See check misc/cronjobs/crontab.example for usage examples.
327
See check misc/cronjobs/crontab.example for usage examples.
328
NOTE: This job should be setup under the kohauser (the default is 'koha').
328
NOTE: This job should be setup under the kohauser (the default is 'koha').
329
329
330
You can also configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra
331
330
6. Run the Web Installer, populate the database, initial configuration of settings
332
6. Run the Web Installer, populate the database, initial configuration of settings
331
333
332
    Point your browser to http://<servername>:8080/
334
    Point your browser to http://<servername>:8080/
Lines 360-365 NOTE: This job should be setup under the kohauser (the default is 'koha'). Link Here
360
    You need to run rebuild_zebra.pl -b -a -z as a regular cron job in orde to pick up new bibs
362
    You need to run rebuild_zebra.pl -b -a -z as a regular cron job in orde to pick up new bibs
361
    and items as you add them. Check misc/cronjobs/crontab.example for usage examples. See 7.0 above.
363
    and items as you add them. Check misc/cronjobs/crontab.example for usage examples. See 7.0 above.
362
    NOTE: This job should be setup under the kohauser (the default is 'koha').
364
    NOTE: This job should be setup under the kohauser (the default is 'koha').
365
    
366
    You can also indexing in background, see 5.2.2 above
363
367
364
7.4 To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and
368
7.4 To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and
365
    change the <listen> options to listen on a TCP port; then restart the zebra daemon.
369
    change the <listen> options to listen on a TCP port; then restart the zebra daemon.
(-)a/INSTALL.ubuntu.lucid (-6 / +9 lines)
Lines 11-17 Modified for Ubuntu by: Chris Nighswonger (cnighswonger AT foundations DOT edu) Link Here
11
Feedback/bug reports: Koha Developer's List:
11
Feedback/bug reports: Koha Developer's List:
12
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
12
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
13
13
14
This document last modified: 11 Sep 2010
14
This document last modified: 20 Marchp 2012
15
15
16
Installation Instructions
16
Installation Instructions
17
=============================
17
=============================
Lines 217-223 To add a user do: Link Here
217
217
218
Option 1: run the Zebra processes from the command line:
218
Option 1: run the Zebra processes from the command line:
219
219
220
1.1 Zebra Search Server
220
5.1.1 Zebra Search Server
221
221
222
This process send responses to search requests sent by Koha or
222
This process send responses to search requests sent by Koha or
223
Z39.50/SRU/SRW clients.
223
Z39.50/SRU/SRW clients.
Lines 230-236 Note: the user you run Zebra as will be the only user with write permission Link Here
230
      on the Zebra index; in development mode, you may wish to use your
230
      on the Zebra index; in development mode, you may wish to use your
231
      system user.
231
      system user.
232
232
233
1.2 Zebra Indexer
233
5.1.2 Zebra Indexer
234
234
235
Added/updated/deleted records in Koha MySQL database must be indexed
235
Added/updated/deleted records in Koha MySQL database must be indexed
236
into Zebra. A specific script must be launched each time a bibliographic
236
into Zebra. A specific script must be launched each time a bibliographic
Lines 244-250 Option 2: run the Zebra process as a daemon, and add to startup process: Link Here
244
Note that references to $SCRIPT_DIR refer to the directory where
244
Note that references to $SCRIPT_DIR refer to the directory where
245
Koha's command-line scripts are installed, e.g., /usr/share/koha/bin.
245
Koha's command-line scripts are installed, e.g., /usr/share/koha/bin.
246
246
247
1.1 Zebra Search Server
247
5.2.1 Zebra Search Server
248
248
249
    $ sudo ln -s ${SCRIPT_DIR}/koha-zebra-ctl.sh  /etc/init.d/koha-zebra-daemon
249
    $ sudo ln -s ${SCRIPT_DIR}/koha-zebra-ctl.sh  /etc/init.d/koha-zebra-daemon
250
    (Note: ${SCRIPT_DIR} is /usr/share/koha/bin/ by default in a standard install)
250
    (Note: ${SCRIPT_DIR} is /usr/share/koha/bin/ by default in a standard install)
Lines 253-259 Koha's command-line scripts are installed, e.g., /usr/share/koha/bin. Link Here
253
253
254
    $ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start
254
    $ sudo ${SCRIPT_DIR}/koha-zebra-ctl.sh start
255
255
256
1.2 Zebra Indexer
256
5.2.2 Zebra Indexer
257
257
258
Add an entry in Koha user crontab to scheduled added/updated/deleted records
258
Add an entry in Koha user crontab to scheduled added/updated/deleted records
259
indexing by Zebra with this command:
259
indexing by Zebra with this command:
Lines 263-268 indexing by Zebra with this command: Link Here
263
See check misc/cronjobs/crontab.example for usage examples.
263
See check misc/cronjobs/crontab.example for usage examples.
264
NOTE: This job should be setup under the kohauser (the default is 'koha').
264
NOTE: This job should be setup under the kohauser (the default is 'koha').
265
265
266
You can also configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra
267
266
6. Run the Web Installer, populate the database, initial configuration of settings
268
6. Run the Web Installer, populate the database, initial configuration of settings
267
269
268
    Point your browser to http://<servername>:8080/
270
    Point your browser to http://<servername>:8080/
Lines 297-302 NOTE: This job should be setup under the kohauser (the default is 'koha'). Link Here
297
    and items as you add them. Check misc/cronjobs/crontab.example for usage examples. See 7.0 above.
299
    and items as you add them. Check misc/cronjobs/crontab.example for usage examples. See 7.0 above.
298
    NOTE: This job should be setup under the kohauser (the default is 'koha').
300
    NOTE: This job should be setup under the kohauser (the default is 'koha').
299
301
302
    You can also indexing in background, see 5.2.2 above
303
300
7.4 To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and
304
7.4 To enable public Z39.50/SRU servers, you'll need to edit your koha-conf.xml and
301
    change the <listen> options to listen on a TCP port; then restart the zebra daemon.
305
    change the <listen> options to listen on a TCP port; then restart the zebra daemon.
302
306
303
- 

Return to bug 7759