Koha 3 Library Management System - Amit Gupta - E-Book

Koha 3 Library Management System E-Book

Amit Gupta

0,0
34,79 €

-100%
Sammeln Sie Punkte in unserem Gutscheinprogramm und kaufen Sie E-Books und Hörbücher mit bis zu 100% Rabatt.

Mehr erfahren.
Beschreibung

Koha is the first full-featured open source library management system that is widely used for efficiently managing libraries. However, setting up and maintaining Koha is no walk in the park. It is not as straightforward as setting up the other popular LAMP applications.This practical guide provides all the essential information that is needed to make the task of installing and configuring Koha really seem simple and easy. It demonstrates how to set up Koha and its various aspects – installation, configuration, application administration, and data migration. It also covers troubleshooting, software maintenance, software customization, and other advanced topics.The book starts with installing and configuring the LAMP stack and the Koha application to meet your needs. It then goes deeper into setting up various rules and configuring settings for Koha. It also covers data migration of catalog records, software maintenance, and customization of the application. Chapters are also dedicated to providing an insight into advanced topics such as LDAP integration and Internationalization. Filled with numerous code samples and screenshots, this book will tour you through setting up Koha for evaluation or test purposes. It also includes loads of tips for troubleshooting and maintenance activities.

By the end of this book, you will have gained the knowledge to get the most out of your Koha installation.

Das E-Book können Sie in Legimi-Apps oder einer beliebigen App lesen, die das folgende Format unterstützen:

EPUB

Seitenzahl: 226

Veröffentlichungsjahr: 2010

Bewertungen
0,0
0
0
0
0
0
Mehr Informationen
Mehr Informationen
Legimi prüft nicht, ob Rezensionen von Nutzern stammen, die den betreffenden Titel tatsächlich gekauft oder gelesen/gehört haben. Wir entfernen aber gefälschte Rezensionen.



Table of Contents

Koha 3 Library Management System
Credits
About the Authors
About the Reviewers
Preface
What this book covers
What you need for this book
Who this book is for
Conventions
Reader feedback
Customer support
Errata
Piracy
Questions
1. Installing the Software Stack
An orientation to Koha's installation
Koha's architecture
What do we need to install?
Installation tools
Package manager
Make utility
CPAN shell
Git
Choosing between Linux Perl packages and CPAN modules
Choosing a Linux distribution
Getting help—Koha's community resources
Preparing for installation
Server prerequisites
Downloading Koha and switching to a branch
Cloning Koha
Checking out a branch
Preparing a list of installation packages
System packages
Perl modules
Debian/Ubuntu package lists
Setting up repositories or sources
Configuring the CPAN shell
Installing Koha's software stack
Installing packages using the package manager
Installing packages from the Linux prompt
Installing packages using shell scripts
Installing packages using dselect
Installing Perl modules using CPAN
Troubleshooting CPAN installations
Setting up Koha's MySQL database
Configuring Koha's installation: Makefile.PL
Completing Koha's installation
Summary
2. Configuring the Apache2 Web Server
Understanding Apache2 configuration
About Apache2
Apache2 virtual hosts
Name-based or IP-based virtual hosts
Apache2's configuration folder
Koha's default Apache2 file
Koha's virtual hosts
Virtual host configuration
Preparing for Apache2 configuration
Configuration plan
Two host names
Hostname with two ports
IP address with two ports
Two IP addresses
Standalone machine
Configuration prerequisites
Configuring Apache2 web server
Creating a symbolic link to koha-httpd.conf
Enabling Apache2's Rewrite module
Configuring the listener
Editing the OPAC virtual host
Editing the staff client virtual host
Enabling Koha's virtual hosts
Restarting Apache2
Troubleshooting configuration problems
Rewrite module not enabled
Incorrect or missing Directory directive
Unable to connect to MySQL
Listener not setup
Summary
3. Installing Koha's Zebra Search Engine
About Zebra
Koha's Zebra related components
Zebrasrv—the Zebra query and retrieval server
Rebuild_zebra.pl—the Zebra index maintenance program
Installing Zebra
Installing Zebra packages
Installing Koha with Zebra
Testing Zebra
Testing zebrasrv
The zebrasrv command
Invoking zebrasrv with Koha's configuration file
zebrasrv daemon
Zebrasrv daemon on Debian or Ubuntu
zebrasrv daemon on openSuSE
Rebuilding Zebra
Creating or recreating indexes
Using Koha without Zebra
Summary
4. Koha's Web Installer, Crontab, and Other Server Configurations
Executing Koha's web installer
Understanding the web installer's functions
Understanding how to execute the web installer
Understanding optional data available for import
Settings for MARC frameworks
Other data
Executing the web installer
Launching Koha
Configuring the crontab
Editing the crontab
Setting up environment variables
Generating advance notices
Generating overdue notices
Sending e-mail messages
Calculating fines
Rebuilding Zebra indexes
More crontab examples
Ensuring Koha starts automatically on server reboot
Auto-starting Apache2
Auto-starting MySQL
Auto-starting Zebra server
Configuring the correct SAX parser
Setting up environment variables for the Linux shell
Setting up KOHA_CONF environment variable
Setting up PERL5LIB environment variable
Setting up persistent environment variables
Summary
5. Configuring the Cataloging Module
A first look at Koha's cataloging configuration tools
MARC frameworks
Authority Control
Authorized values
Preparing a configuration plan
Identifying Authority Control rules
Identifying frequently cataloged types of material
Identifying MARC field sets for each type of material
Identifying mandatory fields
Identifying Authority Control rules
Identifying fields to control using authorized values
Implementing our configuration plan
Configuring authorities system preferences
Configuring Authority Types
Configuring authorized values categories
Editing authorized values
Special authorized values
Library
Item Type
Configuring MARC frameworks
Editing MARC framework list
Creating a new framework
Editing fields and subfields
Editing labels of fields or subfields
Making a field or subfield mandatory
Advanced constraints
Hidden fields and subfields
Bringing fields or subfields under Authorized Value or Authority Control
Summary
6. Configuring the Circulation Module
Patron categories
Identifying patron categories
Creating patron categories
Item types
Identifying Item types
Creating Item types
Circulation and fine rules
Identifying circulation and fine rules
Creating circulation and fine rules
Configuring the calendar and calculation of due date and fines
Calendar and fine calculation
Calculation of due dates in Koha
Preparing to configure the calendar and fines and due date calculations
Editing the calendar
Editing system preferences
Due and overdue notices
Preparing to configure due and overdue notices
Editing notices
Editing notice triggers
Configuring holds
Preparing to configure holds
Editing holds preferences
Summary
7. Configuring Other System Preferences
Understanding Koha's system preferences
Koha's global system preferences module
Using system preferences
Online documentation
Configuring transactional modules
Configuring patrons preferences
Configuring acquisitions preferences
Configuring serials preferences
Configuring OPAC preferences
Configuring static content
Configuring tools for patrons
Configuring patron access control
Configuring enhanced content
Configuring styling and appearance
Configuring OPAC styling and appearance
Configuring staff client styling and appearance
Configuring general preferences
Configuring messaging preferences
Configuring security preferences
Configuring search preferences
Summary
8. Test Driving Your Koha Installation
Patrons—create, search, and view patron record
Creating a new patron
Searching for a patron
Cataloging—create, search, and view bibliographic and item record
Creating a bibliographic record
Creating an item record
Searching for the record
Circulation—check-out, check-in, and view circulation history
Checking out
Checking in
Viewing circulation history
Acquisitions—create an order, receive shipment, and view budget utilization
Creating budgets
Creating a vendor
Creating orders
Receiving shipments
Viewing budget utilization
Serials—creating a subscription and receiving the first issue
Creating a subscription
Searching for the subscription
Receiving an issue
Reports—creating a guided report and executing it
Building a report
Using a saved report
OPAC—running a catalog search
Summary
9. Migrating Catalog Data
An orientation to migrating catalog data
Understanding MARC files
Koha Holdings in tag 952
Holdings in legacy systems
Import tools
MARCEdit
bulkmarckimport.pl
Koha's GUI import tool
Choosing an import tool
Migration process
Preparing to migrate catalog data
Mapping Koha's holdings subfields to subfields in source MARC file
Planning setup of administrative fields in Koha
Migrating catalog data
Setting up values in Koha's administrative fields
Setting up branch codes
Setting up Item types
Setting up collection codes
Setting up shelving locations
Editing the source MARC file using MARCEdit
Swapping subfields
Adding a new subfield
Merging subfields
Importing the MARC file
Using the bulkmarcimport.pl program
Importing catalog records using the GUI tools
Staging MARC records for import
Managing records
Undo Import
Summary
10. Troubleshooting
Where to get help—community resources
Koha's mailing lists
Koha's IRC chat
Koha's bug tracker
Koha's Git repository
Common problems
Apache2 web server is down
MySQL database server is down
Zebra search not returning any results
Zebra index rebuild not working
Parser problems
Overdues e-mail not working
Reviewing notice triggers
Troubleshooting e-mail problems
Troubleshooting problems with generation of notices
Fines not working
Software bugs
Command line programs—environment variables not exported
Problems with Internet Explorer
Summary
11. Updating Software
Orientation to updating software
Understanding Koha's software versions
Branches
Heads
Tags
Choosing a version to update to
Understanding components of software updates
An overview of the installation process
Updating the software
Downloading updates using git pull command
Switching to a new software version
Installing the new software version
Running the Makefile.PL program
Installing Perl modules
Completing Koha installation
Configuring Apache2
Upgrading the database
Zebra—rebuilding indexes and restarting the server
Rebuilding Zebra indexes
Restarting zebrasrv
Summary
12. Customizing Koha Software
An orientation to customizing Koha software
Skills needed
Understanding Koha's application folder
Top level folders
Template files
Relationships between different types of files
Understanding Koha's database
Browsing Koha's database
An overview of important Koha tables
Cataloguing
Circulation
Patrons
Administration
Serials
Acquisitions
Koha's database structure
Using Git to manage software changes
Understanding the software customization process
Customizing Koha software—an example
Creating a development branch
Making CSS changes
Creating a new JavaScript file
Loading the Transliteration JavaScript file
Creating a system preference
Adding the transliteration tool to the display template
Editing the Perl scripts to enable the system preference
Committing changes
Create a patch using Git
Sending the patch to Koha's release manager
Summary
13. Advanced Topics
Creating and using matching rules for use during catalog imports
Understanding matching rules
Determining search indexes
More information and examples
Using LDAP with Koha
Configuring LDAP
Microsoft Active Directory
Setting permissions
Multiple OPAC interfaces
Installing new languages
Install Locale::PO module
Creating language templates for the OPAC
Creating language templates for the staff client
System preferences
Testing the new language
Setting up a public Z39.50 server
Configuring the listen directive
Configuring the server directive
Configuring the serverinfo directive
Restarting the Zebra server
Summary
Index

Koha 3 Library Management System

Koha 3 Library Management System

Copyright © 2010 Packt Publishing

All rights reserved. No part of this book may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, without the prior written permission of the publisher, except in the case of brief quotations embedded in critical articles or reviews.

Every effort has been made in the preparation of this book to ensure the accuracy of the information presented. However, the information contained in this book is sold without warranty, either express or implied. Neither the authors, nor Packt Publishing, and its dealers and distributors will be held liable for any damages caused or alleged to be caused directly or indirectly by this book.

Packt Publishing has endeavored to provide trademark information about all of the companies and products mentioned in this book by the appropriate use of capitals. However, Packt Publishing cannot guarantee the accuracy of this information.

First published: November 2010

Production Reference: 1091110

Published by Packt Publishing Ltd.

32 Lincoln Road

Olton

Birmingham, B27 6PA, UK.

ISBN 978-1-849510-82-0

www.packtpub.com

Cover Image by John M. Quick (<[email protected]>)

Credits

Authors

Savitra Sirohi

Amit Gupta

Reviewers

Kyle M Hall

Vimal Kumar V

Acquisition Editor

Steven Wilding

Development Editor

Wilson D'souza

Technical Editor

Kavita Iyer

Indexer

Hemangini Bari

Editorial Team Leader

Akshara Aware

Project Team Leader

Priya Mukherji

Project Coordinator

Srimoyee Ghoshal

Proofreaders

Aaron Nash

Clyde Jenkins

Graphics

Nilesh Mohite

Production Coordinator

Adline Swetha Jesuthas

Cover Work

Adline Swetha Jesuthas

About the Authors

Savitra Sirohi heads Nucsoft OSS Labs (http://www.osslabs.biz) – a Koha services provider. As part of his work, Savitra has lead several Koha implementations and conducts regular Koha workshops in India. Savitra is an Engineer and has an MBA from the Indian Institute of Management.

We would like to thank Kyle Hall, Vimal Kumar, and Nicole Engard and other members of the Koha community who took the time to review the chapter drafts. Their perspective and expertise helped improve this book immeasurably.

Many thanks are due to Wilson, Kavita, Srimoyee, Steven, and others at Packt for their expertise and hard work and also their patience with these first time authors.

Amit Gupta is the lead Koha specialist at Nucsoft OSS Labs (http://www.osslabs.biz), a Koha services provider. Amit has played a key role in several Koha implementations, including the one at Delhi Public Library, one of India's biggest Koha projects. Amit has a BSc and a Master's in Computer Applications.

About the Reviewers

Kyle M Hall is an IT specialist for the Meadville Public Library and the Crawford County Federated Library System of Pennsylvania is a Free Open Source Software advocate and software developer. His contributions to Koha include bugfixes and new features, as well as the Koha Off-line Circulation system. In addition to his work with Koha, he is also the author of a FOSS Kiosk Management System, Libk (http://libki.org), a cross-platform system for controlling access to computers via logins and time limits.

Vimal Kumar is a library professional with genuine interest in Linux and open source software. He is an active member of Koha community. He has a Master's degree in Library and Information Science from University of Kerala. He has done an evaluative study of open source library management system conducted in 2005 for the completion of MLISc degree project. During the past few years he has been active as a resource person for Koha training programs. He has been working with Mahatma Gandhi University Library and has also presented many papers in national and international conferences.

Preface

Much of what we have written in this book is based on our experiences teaching Koha installation and maintenance of technology and library staff.

We hope this book will help you to quickly install and set up a working Koha installation, complete with catalog data migrated from your current library system. The first nine chapters of this book are devoted to these topics. In the rest of the book we cover topics such as troubleshooting, installing software updates, and customizing Koha, which will be of interest to you when you start to use Koha in earnest.

You will need some Linux expertise. Most Koha users use Debian. However you should feel free to try the installation on your preferred distribution. In the examples in this book, we have demonstrated Debian and openSuSE commands; we think these two are representative of most commonly used Linux distributions.

During the installation process, we would encourage you to seek help from the Koha community via the Koha mailing lists.

What this book covers

Chapter 1, Installing the Software Stack

In the first chapter our goal will be to install Koha's software stack—the Koha application itself, MySQL database server, Apache2 web server, and the various system and Perl packages Koha uses.

Chapter 2, Configuring the Apache2 Web Server

Next, we will configure Koha's web server—Apache2. Apache2 serves Koha pages to users when they access the OPAC or the staff client.

Chapter 3, Installing Koha's Zebra Search Engine

In the third chapter we will focus on Zebra—Koha's powerful catalog search engine. We will learn how to install and test Zebra.

Chapter 4, Koha's Web Installer, Crontab, and Other Server Configurations

In the fourth chapter, we will learn about executing Koha's web installer, setting up Koha's Crontab, and configuring Koha services to start automatically when the machine reboots. At the end of this chapter, we will be able to launch Koha.

Chapter 5, Configuring the Cataloging Module

This chapter is the first of three application configuration chapters. In this chapter, we will learn how to configure Koha's Cataloging module, which is used to maintain information about items in the library.

Chapter 6, Configuring the Circulation Module

In this chapter, we will learn how to configure Koha's circulation module. This module is used to loan library items to the patrons. Our goal here will be to map the library's circulation policies to rules and preferences in Koha.

Chapter 7, Configuring Other System Preferences

In this chapter, we will learn how to configure system preferences related to the rest of Koha's modules—Patrons, Acquisitions and Serials, and Online Public Access Catalog (OPAC). We will also study preferences related to styling and appearance, messaging, security, and search.

Chapter 8, Test Driving Your Koha Installation

By now we will be in a position to take our Koha installation for a test drive. We will look to complete a transaction cycle in each of the primary Koha modules—Patrons, Cataloging, Circulation, Acquisitions and Serials. We will also test the reports module and catalog search on the OPAC.

Chapter 9, Migrating Catalog Data

Migrating catalog data from the legacy system is a prerequisite to using Koha for most libraries. In this chapter we will learn how to convert MARC files from legacy systems into Koha compatible files. We will learn about Koha's MARC record import tools.

Chapter 10, Troubleshooting

In this chapter, we will learn about ways to troubleshoot Koha problems, we will learn about the community tools and resources and take a closer look at ten specific problems.

Chapter 11, Updating Software

It is good practice to keep your Koha software updated to benefit from new features and bug fixes, but also to avoid migration problems if your version falls too far behind. In this chapter we learn how to download and install software updates.

Chapter 12, Customizing Koha Software

Most serious Koha users will want to customize the software to suit their needs, perhaps to modify the styling or appearance or to tweak a certain page to show additional information. If you have the skills you can even take on more serious work such as adding new features. In this chapter, we learn how to customize Koha code.

Chapter 13, Advanced Topics

In this final chapter, we will learn about setting up some less widely used but nevertheless important features of Koha—custom record matching rules, LDAP authentication, custom OPACs for each library, internationalization, and setting up Koha as a Z39.50 source.

What you need for this book

You will need:

A computer or a serverA Linux DVD; we cover Debian & openSuSE in this book, but other distributions should be fine tooHigh speed Internet connection to download software

Who this book is for

This book is aimed at Linux System Administrators who need to install and maintain Koha. If you are a system administrator who wants to set up an open source integrated library system, then this book is for you. It will also be useful for system administrators who require help with specific aspects of implementing Koha.

Conventions

In this book, you will find a number of styles of text that distinguish between different kinds of information. Here are some examples of these styles, and an explanation of their meaning.

Code words in text are shown as follows: "We use the ln command to create the symbolic link."

Any command-line input or output is written as follows:

koha@li190-245:/$ sudo ln –s /home/koha/koha-dev/etc/koha-httpd.conf /etc/apache2/sites-available/koha-httpd.conf

New terms and important words are shown in bold. Words that you see on the screen, in menus or dialog boxes for example, appear in the text like this: "To edit these preferences, navigate to Administration|Global system preferences.".

Note

Warnings or important notes appear in a box like this.

Tip

Tips and tricks appear like this.

Reader feedback

Feedback from our readers is always welcome. Let us know what you think about this book—what you liked or may have disliked. Reader feedback is important for us to develop titles that you really get the most out of.

To send us general feedback, simply send an e-mail to <[email protected]>, and mention the book title via the subject of your message.

If there is a book that you need and would like to see us publish, please send us a note in the SUGGEST A TITLE form on www.packtpub.com or e-mail <[email protected]>.

If there is a topic that you have expertise in and you are interested in either writing or contributing to a book, see our author guide on www.packtpub.com/authors.

Customer support

Now that you are the proud owner of a Packt book, we have a number of things to help you to get the most from your purchase.

Errata

Although we have taken every care to ensure the accuracy of our content, mistakes do happen. If you find a mistake in one of our books—maybe a mistake in the text or the code—we would be grateful if you would report this to us. By doing so, you can save other readers from frustration and help us improve subsequent versions of this book. If you find any errata, please report them by visiting http://www.packtpub.com/support, selecting your book, clicking on the erratasubmissionform link, and entering the details of your errata. Once your errata are verified, your submission will be accepted and the errata will be uploaded on our website, or added to any list of existing errata, under the Errata section of that title. Any existing errata can be viewed by selecting your title from http://www.packtpub.com/support.

Piracy

Piracy of copyright material on the Internet is an ongoing problem across all media. At Packt, we take the protection of our copyright and licenses very seriously. If you come across any illegal copies of our works, in any form, on the Internet, please provide us with the location address or website name immediately so that we can pursue a remedy.

Please contact us at <[email protected]> with a link to the suspected pirated material.

We appreciate your help in protecting our authors, and our ability to bring you valuable content.

Questions

You can contact us at <[email protected]> if you are having a problem with any aspect of the book, and we will do our best to address it.

Chapter 1. Installing the Software Stack

In this chapter, our goal will be to install Koha's software stack—the Koha application itself and the various system and Perl packages it uses. Installing the stack in itself is not enough to be able to use Koha, but is an important first step.

This task can be quite challenging, especially for novice Linux users. You will need to get familiar with using the Linux terminal and multiple installation tools. Expect problems with Perl modules, as troubleshooting these can be especially difficult.

We cover the chapter in three stages—first an orientation, next preparatory steps, and finally a demonstration of the installation. Throughout this book we will use two Linux distributions—Debian and openSuSE; the two combined are representative of most other distributions.

An orientation to Koha's installation

In this section we'll learn about:

What components we will need to installWhat installation tools to use and whenThe implications of choosing one Linux distribution over anotherWhere to get help when you run into installation problems

Koha's architecture

First, let us take a quick look at Koha's architecture. Koha runs on the Linux, Apache2, MySQL, Perl (LAMP) platform:

Linux: The operating systemApache2: The web serverMySQL: The database serverPerl: Koha is written in the Perl programming language

What do we need to install?

We will install various packages related to:

The Koha architecture above—Linux, Apache, MySQL, and PerlThe Koha application itselfBuild and compiler programs that help with the installationVarious Perl and non Perl packages that Koha uses, along with their own prerequisites

Installation tools

Let us take a look at the various tools we will use to install Koha's software stack. These tools are:

Package manager: To install Linux packagesMake utility: To install Perl modulesCPAN shell: To install Perl modules that are not available as Linux packagesGit: To download the Koha application

Package manager

A package manager makes installation easy by automatically installing prerequisites, tracking versions and updates, and verifying checksums. Your choice of the package manager will usually depend on the Linux distribution you use. Here are some popular package managers:

APT: On Debian or UbuntuYaST: On openSuSEYUM: On CentOS

Make utility

Perl programs such as Koha or the various Perl modules it uses can be installed using a series of commands:

perl Makefile.PL: This command checks for prerequisites and creates a configuration file needed by makemake: This compiles the software and creates executablesmaketest: It runs test cases to ensure proper installation, flags errors, and warnings in case of problemsmakeInstall: This installs the executable files into proper directories in the server

CPAN shell

CPAN (Comprehensive Perl Archive Network)—is an archive of Perl modules.

The CPAN shell is a tool that automates the download and installation of Perl modules from the archive including the execution of the perl Makefile.PL, make, maketest, and make install commands given above.

Learn more about CPAN here: http://www.cpan.org/.

Git

Git is Koha's version control system. Git simplifies and automates the download of software from Koha's online repository. We use Git not only during installation, but also while installing software updates. If you wish to make software changes of your own, Git will help merge those changes with new versions of Koha.

Learn more about Git here: http://git-scm.com/.

Choosing between Linux Perl packages and CPAN modules

CPAN is the largest archive of Perl modules. Perl modules are always available on CPAN. Many, but not all of Koha's Perl prerequisites are available as packages in a distribution's sources.

The recommended approach in such a scenario is to use Linux packages where available. If you don't find packages for a certain module, then use CPAN to install it.

The Linux package manager can manage all prerequisites of a module. CPAN only knows about Perl prerequisites, and cannot install any non-Perl prerequisites. For this reason, you will likely have smoother installations with the package manager in comparison to CPAN.

Choosing a Linux distribution

It appears that Debian is the most popular when it comes to Koha. Some of the installation tasks are simpler in this distribution. Also you might get better community support from a large pool of Debian Koha users.

However, if you are skilled on another distribution, it might make sense to use that. Installation on Ubuntu is very similar to that on Debian. There are many Koha users on Fedora, CentOS, or openSuSE. Installation documents, live CDs, and other sorts of help are becoming available for these distributions as well.

In any case, once you are past the installation stage, it does not really matter distribution you are on.

Getting help—Koha's community resources

If you face trouble with the installation, Koha's community resources can be of excellent help:

Mailing lists: Koha's mailing lists are very active and you are likely to get timely help. Join the mailing lists via this page: http://koha-community.org/support/koha-mailing-lists/.Mailing lists archives: Many of the discussions are indexed by search engines. If you run into trouble, it is likely someone else had a similar problem before you, so just search for solutions using your favourite search engine.IRC chat: Many of Koha's developers are available on this live chat forum. Join here: http://koha-community.org/support/.Wiki: Koha's wiki might have useful material - http://wiki.koha-community.org/.Installation documents: Up-to-date installation documents are available in Koha's application folder.

Preparing for installation

In this section we prepare for the installation—setting up a server, preparing a list of packages for installation and configuring installation tools.

Server prerequisites

Before we start the installation, we will need a server setup as follows:

Prerequisites

Description

Server

2 GB RAM, 40 GB hard disk should be good for most libraries.

Internet connection

High speed Internet connection to download software.

Linux

Your preferred distribution installed on the server.

Firewall ports opened

Git port 9418

FTP port 21

HTTP port 80

Access

Access to the server via SSH, or directly.

User

A Linux user with sudo privileges, in this book we use user—koha.

Locale

Your locale setup on the server.

Downloading Koha and switching to a branch

One of the first things we do is to download Koha and switch to a version (or a branch) that we want to use. This helps us draw up, as explained in sections below, our package installation list.

Cloning Koha

To download the Koha application, we need Git. Let us install Git:

koha@li190-245:~$ sudo apt-get install git

Now we are ready to download Koha, let us change to a folder where we want to install Koha. The user koha must own this folder:

koha@li190-245:~ # cd /home/koha

To clone the application from Koha's git server we use the gitclone command:

koha@li190-245:~$ git clone git:://git.koha-community.org/koha.git kohaclone

Checking out a branch