Bug 12748 - Fixes duplicate serials with an "expected" status bug
[koha.git] / INSTALL.opensuse
blob7784d6ed3dfb3046b999e9338a4b9e5ceff6142c
1 = Installation Guide for Installing Koha 3.0.0 on openSUSE 11.3 =
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
6 No liability for the contents of this document can be accepted.
8 Feedback/bug reports: Koha Developer's List:
10 http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
12 This document last modified: 20 Mar 2012
14 == Installation Instructions ==
16 This document was prepared in order to help you discover (or test) Koha (Integrated Library System).
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).
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!
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.
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).
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.
28 === LINUX System Installation ===
30 Download openSUSE 11.3 DVD from [http://software.opensuse.org/ here].
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.
34 After the "Welcome" screen, you'll get a First menu, with the following options:
36 ----
37 Boot from Hard Disk
39 Installation
41 Repair Installed System
43 Rescue System
45 Firmware Test
47 Memory Test
48 ----
50 You may want to change the screen size to 1024 x 768 by pressing F3.
51 Choose "Installation" (second command)
53 ==== "Initializing" screen ====
55 (Dialog box appears saying "Probing Mouse")
57 ==== "Welcome" screen ====
59 You'll see two Dropdown Lists: "Language" and "Keyboard Layout"
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)).
65 Check the "I Agree to the License Terms" checkbox (under the "License Agreement" textbox).
67 Click the "Next" button.
69 ==== "System Probing" screen ====
71 [just watch it...]
73 ==== "Installation Mode" screen ====
75 Leave "New Installation" radio button checked
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.
80 Click the "Next" button
82 ==== "Initializing" screen ====
84 [just watch it...]
86 ==== "Clock and Time Zone" screen ====
88 I do this work in Yemen, so I select the following options:
90 "Region" listbox: click on "Asia"
92 "Time Zone" listbox: click on "Aden"
94 I leave the "Hardware Clock Set To UTC" checkbox checked.
96 Click the "Next" button
98 ==== "Desktop Selection" screen ====
100 You should see three radio buttons: "GNOME Desktop", "KDE Desktop" and "Other".
102 Click on the "Other" radio button.
104 Four radio buttons should become visible then:
106 "XFCE Desktop"
108 "LXDE Desktop"
110 "Minimal X Window"
112 "Minimal Server Selection (Text Mode)"
114 click on this last "Minimal Server Selection (Text Mode)" radio button.
116 Click the "Next" button
118 ==== "Suggested Partitioning" screen ====
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.
122 So, to do this I click on the "Create Partition Setup..." button.
124 ===== "Preparing Hard Disk: Step 1" screen =====
126 I click on the first radio button:
127 "1: 1.IDE 8.0 GB,/dev/sda"
129 I click the "Next" button
131 ===== "Preparing Hard Disk: Step 2" screen =====
133 I uncheck the "Propose separate Home Partition" checkbox.
135 I click the "Next" button.
137 This takes me back to the Suggested Partitioning screen.
139 ===== "Suggested Partitioning" screen =====
141 In my case, I now have this:
143 - Create swap volume /dev/sda1 (1004.06 MB)
145 - Create root volume /dev/sda2 (7.02 GB) with ext4
147 I click the "Next" button.
149 ==== "Create New User" screen ====
151 I use this screen to create a regular user.
153 User's full name: Your Full name (e.g: John Smith)
155 Username: Your preferred username (e.g.: jsmith)
157 Password:
159 Confirm Password:
161 I uncheck the "Use this password for System Administrator" checkbox.
163 I check the "Receive System Mail"
165 I uncheck the "Automatic Login" checkbox.
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).
169 ==== Password for the System Administrator "root" screen ====
171 Enter your password (in the "Password for root User" text box) and repeat it (in the "Confirm Password" text box).
173 Click the "Next" button to proceed to the "Installation Settings" screen.
175 ==== "Installation Settings" screen ====
177 Click on the "Software" link
179 ==== "Software Selection and System Tasks" screen ====
181 Scroll down the listbox (that begins with the "Base Technologies" group) until you find the "Server Functions" group.
183 In that "Server Functions" group click on the "Web and LAMP Server" checkbox (to check it)
185 Click on the "OK" button to return to "Installation Settings"
187 ==== "Installation Settings" screen ====
189 Click on the "Install" button (placed in the same place where usually appear the "Accept" or "Next" button).
191 You should see a "Confirm Installation" dialog box. Click on the "Install" button of that dialog box.
193 ==== "Preparing Your Hard Disk" screen ====
195 [just watch it...]
197 ==== "Deploying Installation Images" screen ====
199 [just watch it... ]
201 ==== "Package Installation" screen ====
203 [just watch it... or click on the "Details" tab if you want to see what packages are being installed.]
205 ==== "Finishing Basic Installation" screen ====
207 [just watch it... ]
209 After some time you'll see a dialog box warning that the system will reboot in 10 seconds.
211 ==== After reboot ====
213 Leave "Boot from Hard Disk" selected and press ENTER
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).
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:
225 ==== Network Configuration ====
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:
238 ==== Test Internet Connection ====
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:
245 ==== Online Update ====
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.
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.
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.
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:
263 |--------------------
264 Welcome to openSUSE 11.3 "Teal" - Kernel 2.6.34.7-0.3-desktop (tty1)
266 koha-server login:
267 |--------------------
269 You may now login with your "root" user.
271 ==== Changing the Hostname and Domain Name ====
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.
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 |--------------------
282 Yast should appear.
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).
287 Press the ENTER key.
289 ==== "Initializing Network Configuration" screen ====
291 [just watch it...]
293 ==== "Network Settings" screen ====
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).
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.
303 ==== "Network Card Setup" screen ====
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):
307 IP Address: 192.168.1.16
308 Subnet Mask: 255.255.255.0
309 Hostname: koha-server.univ.org
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.
313 ==== "Network Settings" screen ====
315 I press ALT+S to go to the "Hostname/DNS" screen.
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:
320 Name Server 1: 192.168.1.254
322 Then I press ALT+U to go to the "Routing" configuration.
324 ==== "Routing" screen ====
326 In the "Default Gateway" text box, I enter the IP Address of my Default Gateway:
328 Default Gateway: 192.168.1.254
330 Then I press ALT+O for OK to Finish
332 ==== "Saving Network Configuration" screen ====
334 [just watch it...]
336 After a few seconds, you should be taken back to the "YaST2 Control Center" screen.
337 Press ALT+Q to Quit YaST2.
339 ==== Making the ssh-daemon to start at system start ====
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.
345 |--------------------
346 # cp /etc/ssh/sshd_config /etc/ssh/sshd_config.ORIG
347 # vi /etc/ssh/sshd_config
348 |--------------------
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 |--------------------
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 |--------------------
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 |--------------------
369 Also you need to start the sshd service in order to generate the security keypair for sshd.
370 |--------------------
371 # service sshd start
372 |--------------------
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.
380 === Configure Software Repositories ===
382 After the system has rebooted, log in as root.
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.
389 First, run the yast command in the Linux command line (shell):
391 |--------------------
392 # yast
393 |--------------------
395 Inside yast, select Software -> Software Repositories
397 ==== "Configured Software Repositories" screen ====
399 When on this screen, you already see a table that has:
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.
413 ==== "Media type" screen ====
415 Select Community Repositories by pressing ALT+I and apply Next (press ALT+X).
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.
422 You may see the following screen.
424 ==== "License Agreement" screen ====
426 Check the "Yes, I Agree to the License Agreement" radio button.
428 Click on the "Next" button to return to the "Configured Software Repositories" screen.
430 ==== "Configured Software Repositories" screen ====
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.
435 Click on the "OK" button.
437 When you get sent back to the "Yast Control Center" click on the "Quit" button (to return to the shell).
439 === Install some useful / necessary programs ===
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):
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.
449 == Download Koha ==
451 |--------------------
452 # wget http://download.koha-community.org/koha-3.00.00.tar.gz
453 |--------------------
454 You will receive 49,266,888 bytes.
456 == Extract Koha ==
458 |--------------------
459 # tar -xzvf koha-3.00.00.tar.gz
460 |--------------------
462 == Set up Locale for root user ==
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 |--------------------
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
489 The "Languages" screen should appear.
491 In the first section (Primary Language Settings):
493 Leave "English (US)" selected as the option for Primary Language
495 Click on the "Details..." link
497 Change the Locale Settings for user root from the default option ("ctype Only") to "Yes"
499 Make sure the "Use UTF-8 Encoding" checkbox is checked (it should already be).
501 Leave the "Detailed Locale Setting" en_US selected
503 Click on the OK button to return to the "Languages" screen
505 Click on the "OK" button.
507 When you get back to the "Yast2 Control Center" screen, click on the "Quit" button
509 == Putty configuration to use Unicode (UTF-8 encoding) ==
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.
515 This should open the "PuTTy Reconfiguration" screen. Here expand the "Window" category and click on "Translation"
517 When you do this, you'll see that the "Received data assumed to be in which character set" dropdown list probably reads:
519 "ISO-8859-1:1998 (Latin-1, West Europe)
521 change it to: "UTF-8"
523 Click on the "Apply" button
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.
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.
531 IMPORTANT!!! Now it's the time to EXIT the login shell, by typing the exit command:
532 |--------------------
533 # exit
534 |--------------------
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.
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.
540 After logging in again with the root user, type the locale command again. Now it should read like the following:
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 |--------------------
560 == Apache configuration (for UTF-8) ==
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 |--------------------
571 == Configure Apache to start at boot time and start the service ==
572 |--------------------
573 # chkconfig apache2 on
575 # service apache2 start
576 Starting httpd2 (prefork)                                            done
577 |--------------------
579 Go to a browser and type:
581 http://192.168.1.16
583 You should see a page that reads:
585 "It works!"
587 == MySQL configuration ==
589 1 - Configure MySQL to start at boot time and start the service:
590 |--------------------
591 # chkconfig mysql on
593 # service mysql start
594 |--------------------
595 The system will issue a warning that '--skip-locking' is deprecated, but for now we accept that.
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.
605 3 - Check the encoding variables of MySQL
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
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
619 Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
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)
636 mysql> quit
638 |--------------------
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.
642 We want to have utf8 in the above character_set_* variables above (and NOT latin1)!
644 In order to do this:
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 |--------------------
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.
660 2a - If you are unfamilar with SQL you should remove the #-character in front of safe-updates in that same section.
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 |--------------------
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
680 Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
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)
697 mysql> quit
699 |--------------------
701 == Create the Koha database ==
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)
709 === Grant privileges to a MySQL user to the koha database ===
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
719 Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
721 mysql> grant all on koha.* to 'kohaadmin'@'localhost' identified by 'kohapassword';
722 Query OK, 0 rows affected (0.00 sec)
724 mysql> flush privileges;
725 Query OK, 0 rows affected (0.08 sec)
727 mysql> quit
729 |--------------------
731 == Test your SAX Parser and correct where necessary ==
733   * Install the XML::SAX and XML::LibXML perl Modules:
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...
745 Nothing to do.
746 |--------------------
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.
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/
757 myhost:~/koha-3.00.00 # misc/sax_parser_print.pl
758 |--------------------
760 You will probably see this:
761 |--------------------
762 XML::SAX::PurePerl=HASH(0x8356a4c)
763 |--------------------
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 |--------------------
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 |--------------------
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/
782 myhost:/usr/lib/perl5/vendor_perl/5.10.0/XML/SAX # cp ParserDetails.ini ParserDetails.ini.ORIG
783 |--------------------
785 Edit this ParserDetails.ini file (with vim or other editor)
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 |--------------------
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 |--------------------
802 == Install the Zebra package ==
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.
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.
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.
821 === Using zypper to install CPAN modules ===
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.
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 |--------------------
879 == Running the Makefile.PL module to configure Koha ==
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).
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.
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.
888 Also note that Zebra has been installed in this case.
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
894 By default, Koha can be installed in one of three ways:
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.
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.
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.
913 Installation mode (dev, single, standard) [standard]
915 Please specify the directory under which most Koha files
916 will be installed.
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.
923 Base installation directory [/usr/share/koha]
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.
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.
940 User account [koha]
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'.
947 Group [koha]
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.
954 DBMS to use (Pg, mysql) [mysql]
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.
962 Database server [localhost]
964 Please specify the port used to connect to the
965 DMBS [3306]
967 Please specify the name of the database to be
968 used by Koha [koha]
970 Please specify the user that owns the database to be
971 used by Koha [kohaadmin]
973 Please specify the password of the user that owns the
974 database to be used by Koha [katikoan] kohapassword
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.
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.
986 Install the Zebra configuration files? (no, yes) [yes]
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.
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.
996 Koha provides Zebra configuration files for MARC 21
997 and UNIMARC.
999 MARC format for Zebra indexing (marc21, unimarc) [marc21] unimarc
1001 Koha supplies Zebra configuration files tuned for
1002 searching either English (en) or French (fr) MARC
1003 records.
1005 Primary language for Zebra indexing (en, fr) [en] fr
1007 Koha can use one of  two different indexing modes
1008 for the MARC authorities records:
1010 grs1 - uses the Zebra GRS-1 filter, available
1011        for legacy support
1012 dom  - uses the DOM XML filter; offers improved
1013        functionality.
1015 Authorities indexing mode (dom, grs1) [grs1] dom
1017 Please specify Zebra database user [kohauser]
1019 Please specify the Zebra database password [zebrastripes] zebrapassword
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.
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.
1029 Install the SRU configuration files? (no, yes) [yes] no
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.
1037 Install the PazPar2 configuration files? [no] no
1039 Would you like to run the database-dependent test suite? (no, yes) [no]
1041 Koha will be installed with the following configuration parameters:
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
1064 and in the following directories:
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
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:
1090 perl Makefile.PL PERL_MODULE_DIR=/usr/share/perl/5.8
1092 You can also set different default values for parameters
1093 or override directory locations by using environment variables.
1095 For example:
1097 export DB_USER=my_koha
1098 perl Makefile.PL
1102 DB_USER=my_koha DOC_DIR=/usr/local/info perl Makefile.PL
1104 If installing on a Win32 platform, be sure to use:
1105 'dmake -x MAXLINELENGTH=300000'
1107 Checking if your kit is complete...
1108 Looks good
1109 Writing Makefile for koha
1111 myhost:~/koha-3.00.00 #
1112 |--------------------
1114 == Create the Koha User and Group ==
1116 |--------------------
1117 # useradd koha
1119 # passwd koha
1120 Changing password for koha.
1121 New Password:
1122 Reenter New Password:
1123 Password changed.
1125 # groupadd koha
1126 |--------------------
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
1136 [many more lines beginning with "cp" should appear...]
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.
1170 == Run "make install" ==
1172 Now, we will run make install:
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
1187 Koha's files have now been installed.
1189 In order to use Koha's command-line batch jobs,
1190 you should set the following environment variables:
1192 export KOHA_CONF=/etc/koha/koha-conf.xml
1193 export PERL5LIB=/usr/share/koha/lib
1195 For other post-installation tasks, please consult the README.
1197 # cd /etc
1198 myhost:/etc #
1199 |--------------------
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 |--------------------
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
1222 myhost:~ # env | grep PERL5LIB
1223 PERL5LIB=/usr/share/koha/lib
1224 |--------------------
1226 == Koha's Web Installer ==
1228 Access Koha's web installer at:
1230 http://192.168.1.16:8080/
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.
1238 == Create a symbolic link to /etc/koha/koha-httpd.conf ==
1240 Let's create a symbolic link to the /etc/koha/koha-httpd.conf file in the /etc/apache2/vhosts.d directory
1242 |--------------------
1243 myhost:~ # cd /etc/apache2/vhosts.d/
1245 myhost:/etc/apache2/vhosts.d # ln -s /etc/koha/koha-httpd.conf koha-httpd.conf
1246 |--------------------
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 |--------------------
1256 == Enable the mod_rewrite Apache module ==
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 |--------------------
1270 == Change koha-httpd.conf ==
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.
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
1278 myhost:/etc/koha # vim koha-httpd.conf
1279 |--------------------
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.
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).
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 |--------------------
1299 Try to access the web page:
1301 http://192.168.1.16/
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).
1305 After reloading the page, you should get the following error:
1306 |--------------------
1307 Forbidden
1309 You don't have permission to access / on this server.
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 |--------------------
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 |--------------------
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 |--------------------
1332 OK. Load again the following page in your web browser:
1334 http://192.168.1.16
1337 After some seconds you should be redirected to:
1339 http://192.168.0.2/cgi-bin/koha/maintenance.pl
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"
1344 This is actually GOOD NEWS!  :)  It's now time to set up Koha in the Intranet interface.
1346 To do that, browse to:
1348 http://192.168.0.2:8080
1350 You should see a page with the title "Welcome to the Koha Web Installer", and with a "Username" and a "Password" textboxes.
1352 If not you may have forgotten to open the 8080 port.
1355 You may now login with your koha administrator username and password and reply to the several questions you will be asked.
1357 == Add Zebra Indexer ==
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).
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').
1365 Edit the crontab for the koha user by running
1366     $ sudo -u <kohauser> crontab -e
1368 For Zebra indexing, you are looking for the example that begins with
1370     # ZEBRA INDEX UPDATES with -z option, incremental index updates throughout the day
1371     # for both authorities and bibs
1373 It may be easiest to copy/paste the example into your own crontab and modify as necessary.
1375 You can also configure zebra-indexing as an background daemon, see http://wiki.koha-community.org/wiki/Background_indexing_with_Zebra