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 |
|