Installing Koha on windows/mac/linux Created by Josh Hertel Last Updated 5/23/12 Welcome!

This guide will show you how to install Koha Integrated Library System (http://kohacommunity.org/) on an existing windows/mac/linux system. Although the newest version of Koha is created for a linux operating system, it is possible to run Koha on windows/mac using virtualization software. Using a virtualization software you can create a virtual environment in which to run the Koha server. This guide outlines two options to install. The first option is to use a pre-made image of the Koha server. The second option is to install from scratch. Keep in mind that with either option you will need a computer that is capable of running the virtualization software. As long as the host machine is only a few years old there should be no problem running the Koha system.

Instructions for installing using a pre-made image. Instructions for installing from scratch.

Instructions for Installing Using a Pre-made Image If you just want to get a system up and running quickly, this is the easiest way to do it. You will need to download the virtualization program, download the server image, and then import the image. Once you start up the virtual machine you will have a running library server. 1. Install Virtual Box on your machince https://www.virtualbox.org/ 2. Download library server image. 3. Import the image into virtual box. 4. Start the virtual machine. 5. Open a web browser Staff Login: 127.0.0.1:8081 Guest Login: 127.0.0.1:8080 The base image that I created can be found here: https://www.dropbox.com/s/fxmx2deup2t0rrd/LibraryServer.ova Default settings are: Default library: Main Library User accounts (both have the same privileges): username: admin username: staff password: admin password: staff

I recommended that you change the password on these accounts once you begin to use the system. To do this, go to patrons, then search for the parton, and click on change password.

Instructions for Installing from Scratch Overview 1. Install Virtual Box 2. Create a virtual linux machine 3. Download Debian iso image 4. Install debian on virtual machine 5. add the koha-community repository 6. Install koha-common 7. Install mysql-server 8. Configure appache 9. Configure the host os to route to the virtual machine 10. Configure Koha

Detailed Steps 1. Install a virtual box on your machine. https://www.virtualbox.org/ 2. Once virtual box is installed, create a new linux virtual machine. Use the default settings. 3. Download debian squeeze iso image http://www.debian.org/releases/stable/ 4. Load the debian squeeze image in the cd/dvd drive of the virtual machine. 5. Boot the virtual machine and install debian squeeze by following the instructions. Note: I chose not to install the graphical interface. 6. Reboot the system (you can leave the debian squeeze image in the cd/rom for the next part but you will need to remove it eventually) 7. Login to the new system and become root (you can do this by using the su command) 8. Add the koha-community repository by adding this line to a /etc/apt/sources.list using a text editor (I used nano) deb http://debian.koha-community.org/koha squeeze main 9. Add the key for the repository wget -O- http://debian.koha-community.org/koha/gpg.asc | apt-key add 10. Update and install koha (at some point you will be prompted to load the debian squeeze iso image into the cd/dvd drive, do this via virtualbox settings->storage) apt-get update apt-get install koha-common

11. install mysql server apt-get install mysql-server 12. a2enmod rewrite 13. Configure apache Edit /etc/apache2/ports.conf and add Listen 8080 Listen 8081 14. /etc/init.d/apache2 restart 15. Create Library Instance, I have called the library mathlibrary below koha-create --create-db mathlibrary 16. Retrieve the admin username and password (youll need this later) This information is in /etc/koha/site/mathlibrary/koha-conf.xml Scroll to the bottom of the file and look for <config> <db_scheme>mysql</db_scheme> <user>[system generated]</user> <pass>[Some password generate by the system]</pass> 17. Edit /etc/apache2/sites-enabled/mathlibrary and change ports under OPAC and Intranet # OPAC <VirtualHost *:8080> # Intranet <VirtualHost *:8081> 18. Configure host os to route to the virtual machine. Now we need to route port to ports o the virtual machine. This can be done using the virtualbox. a. Shutdown the virtual machine. b. Go to Settings -> Network then click on the Advanced arrow and the button Port Forward c. Add two forwards I called mine GuestLogin and StaffLogin. Note that you only need to specify the port (leave the IP boxes blank)

GuestLogin StaffLogin

8080 8081

8080 8081

19. Configure Koha. Youll need the login/password from step 13. a. Start up the virtual machine (you may need to eject the iso image or change the boot order so that the live cd doesnt launch). b. Login to the admin page on the virtual machine 127.0.0.1:8081 c. Options I checked during setup auth_val.sql marc21_default_matching_rules.sql marc21_fastadd_framework.sql marc21_holdings_coded_values.sql marc21_simple_bib_frameworks.sql parameters.sql patron_categories.sql sample_z3950_servers.sql

20. Login to the new system Staff Login: 127.0.0.1:8081 Guest Login: 127.0.0.1:8080 21. Create new library Koha Administration -> Basic Parameters -> Libraries, branches, and groups On my system, I changed the MARC record structure and made 942c non-mandatory Kohaadmin -> MARC Bibliographic Framework-> MARC Structure. Then search for the tag field and edit the preferences.

22. Add an admin user and set permissions http://manual.koha-community.org/3.6/en/patronpermissions.html