Features Library System
David Maska, 123RF Easy library administration with Koha Book Keeper
Information technology plays a key role in modern library In this article, I describe Koha and, more environments. We check out Koha, an open source specifically, the configuration of Koha 3.02 on a 64-bit openSUSE [2] server. integrated system that can help manage a library’s daily Initial Configuration operations. By Evelthon Prodromou Installing Koha on your server is quite easy. The first thing you should do is in- ibrary catalogs were originally by both patrons and staff through an in- stall the required packages: Apache web based on a card system that was tuitive web interface. server [3], some Perl modules, and the tedious and time-consuming to The setup is a pilot system for second- MySQL [4] database. Start by opening a Lupdate. Fortunately, this task is ary schools in Cyprus. Three lyceums console and issuing: now done by modern electronic systems are currently participating in this effort, for easy central administration of li- and the Library of the University of Cy- yast ‑i apache2 apache2‑mod‑perlU brary catalogs. Recently, I had the plea- prus is helping with setup, fine-tuning, mysql‑community‑server make gcc sure of installing one such system, and hosting the project. Koha. Koha [1] is an open source inte- For the initial test bed, I imported the After installing these packages, you need grated library system initially developed library’s catalog from another system to to tune the system locale, Apache, and by Katipo Communications Ltd. in New Koha. The next step was to import the MySQL. Your system’s locale must be Zealand. Cyprus Union Catalog to Koha (planned UTF-8. To see whether this is the case, The Koha system includes modules for for the near future). The union catalog circulation, cataloging, acquisitions, seri- includes bibliographic data from 38 dif- Listing 1: System Locale als, reserves, patron (user) management, ferent libraries across the island, with locale and more. Koha uses the well-known more than half a million records, which LANG=en_US.UTF‑8 MySQL database and is easily accessible will give a major boost to the project. LC_CTYPE="en_US.UTF‑8" For example, a school library will no LC_NUMERIC="en_US.UTF‑8" Author longer need to catalog its books be- LC_TIME="en_US.UTF‑8" cause most of them will be in the union LC_COLLATE="en_US.UTF‑8" Evelthon Prodromou is catalog. LC_MONETARY="en_US.UTF‑8" an electrical and com- LC_MESSAGES="en_US.UTF‑8" puter engineer. He is cur- Additionally, the solution will benefit LC_PAPER="en_US.UTF‑8" rently working as IT Offi- everyone participating in the school LC_NAME="en_US.UTF‑8" cer at the Library of the union catalog. One installation serves an LC_ADDRESS="en_US.UTF‑8" University of Cyprus. His interests in- arbitrary number of libraries through LC_TELEPHONE="en_US.UTF‑8" clude server virtualization, ranking algo- web-based access, with no locally in- LC_MEASUREMENT="en_US.UTF‑8" rithms, e-learning, and human-computer stalled clients. This system will require LC_IDENTIFICATION="en_US.UTF‑8" interaction. You can view his personal fewer support hours and will be easier to LC_ALL= website at http://www. prodromou. eu . maintain and update.
56 August 2011 Issue 129 linux-magazine.com | Linuxpromagazine.com
056-062_Koha.indd 56 7/1/11 1:27:57 PM Features Library System
go to a shell console and type locale. enable or disable The output should look like Listing 1. If Apache modules Listing 2: MySQL Variable Set Values your system is not already in UTF-8, you and other param- 01 mysql> show variables like 'char%'; can follow the procedure in the “Setting eters of the web 02 +‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑+‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑+ Locale to UTF-8” box. server. 03 | Variable_name | Value | To download Koha, issue 04 +‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑+‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑+ MySQL 05 | character_set_client | utf8 | 06 | character_set_connection | utf8 | wget http://download.koha‑community.U Config 07 | character_set_database | utf8 | org/koha‑version.tar.gz If you get this far, MySQL is already 08 | character_set_filesystem | binary | and extract it with tar, installed. So, you 09 | character_set_results | utf8 | need to make sure 10 | character_set_server | utf8 | 11 | character_set_system | utf8 | tar xvfz koha‑version.tar.gz it starts on boot, turns on, and 12 | character_sets_dir | /usr/share/mysql/charsets/ | 13 +‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑+‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑+ which goes into folder koha‑version. takes care of secu- 14 8 rows in set (0.00 sec) rity: Apache Configuration The next step is to set Apache encoding. chkconfig mysql on Koha ships with a shell utility that you To set default encoding to UTF-8, create rcmysql start can use for this: a local configuration file and add the /usr/bin/mysql_secure_installation AddDefaultCharset directive: koha_root_folder/misc/sax_parser_print.pl The last command tightens security and vi /etc/apache2/httpd.conf.local allows you to remove the test databases In my case, Koha’s SAX parser checker and the anonymous user account created returned the contents of Listing 4. Add the following to the file: by default. This step is strongly recom- As it says in line 5, it looks bad, but mended for production servers. Apart fixing this error is easy: You just need to AddDefaultCharset UTF‑8 from setting a root password, the rest of locate a file called ParserDetails.ini as the questions are better left to their de- follows: and save. Next, enter: fault values by simply pressing Enter. Now make sure the MySQL encoding find / ‑iname ParserDetails.ini a2enmod perl5 is set to UTF-8. To change it, go to a chkconfig apache2 on MySQL prompt with mysql ‑p, answer You will get a reply like: rcapache2 restart the challenge by entering the root pass- word, then check the encoding settings /usr/lib/perl5/vendor_perl/5.12.1/XML/U The preceding commands enable Perl as in Listing 2 with show. In this case, all SAX/ParserDetails.ini scripting, restart Apache, and make sure settings are in UTF-8, so no changes are it starts on boot. necessary. The next step is to edit ParserDetails. The last step for MySQL is to grant ini and change [XML::SAX::PurePerl] to Configuring Apache privileges to the Koha user for the Koha [XML::LibXML::SAX::Parser] and save. To I set up the system on openSUSE, which database. You can do this through the verify, rerun sax_parser_print.pl. You uses the YaST configuration tool. The MySQL command interface. On success- should get a Looks good message (List- basic steps for other distros are similar, ful creation of the database, you need to ing 5). but the details will differ. On openSUSE create a MySQL user and grant that user systems, use YaST to install the yast2- the necessary privileges for Koha’s data- Installing Perl Modules http package, which offers a GUI tool for base. In the case described in this article, When you are finished with the XML easy HTTP server management. After in- the MySQL user is called kohaadmin parser, you need to install a few Perl stalling this package, reload YaST and go (Listing 3). modules. To discover which, execute to Network Services | http server. Make perl Makefile.PL. sure the HTTP server is allowed through SAX Parser At this point, I had hoped I would be the firewall. From this tool, you can also Koha is primarily built on Perl, so you greeted by some sort of installation mes- need to make sure the perl-XML-SAX sage, but I was not. Instead, I got a com- Setting Locale to UTF-8 and perl-XML-LibXML packages are in- plaint from the installer saying Can’t lo- stalled. If not, you can install them from cate ZOOM.pm in @INC (@INC con- 1. Load YaST. a shell prompt: tains:. 2. Go to System | Languages. Further investigation in Makefile.PL 3. Click on Details. A new window ap- pears. Make sure Locale settings for yast ‑i perl‑XML‑SAX perl‑XML‑LibXML showed that I was missing the perl-Net- User root is set to yes and the Use Z3950-ZOOM package. This package is UTF-8 Encoding checkbox is checked. Next, you need to check which XML not located in the standard openSUSE re- 4. Accept your changes. parser your system is using. Fortunately, positories (those added when the system
linux-magazine.com | Linuxpromagazine.com Issue 129 August 2011 57
056-062_Koha.indd 57 7/1/11 1:28:00 PM Features Library System sc11.supercomputing.org Conference firsts: storage and analysis across a Listing 3: MySQL User Creation and Setup Listing 4: Parser Checker • a full day of technical diverse range of science and mysql ‑u root ‑p 01 Koha wants something like: sessions on Friday, engineering disciplines. Enter password: 02 XML::LibXML::SAX::Parser=HASH( November 18, the last day 0x81fe220) Welcome to the MySQL monitor. Commands end with ; or \g. 03 You have: • the most Technical Your MySQL connection id is 53 04 XML::SAX::PurePerl=HASH(0x9a2bd0) Program submissions ever SC11 will continue to recog- Server version: 5.1.53‑log SUSE MySQL RPM Seattle, WA 05 Looks bad, check INSTALL.* • a State of the Practice track nize exceptional individual documentation. Connecting communities Copyright (c) 2000, 2010, Oracle and/or its affiliates. All rights reserved. through HPC • a Scientific Visualization accomplishments through This software comes with ABSOLUTELY NO WARRANTY. This is free software, and you Showcase the awards and fellowship are welcome to modify and redistribute it under the GPL v2 license Listing 5: Verifying Parser November 12-18, 2011 • the largest number of programs. The Communities 01 misc/sax_parser_print.pl exhibitors ever—nearly 300 Program offers opportunities Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. 02 Koha wants something like: Seattle, WA for people new to SC to 03 XML::LibXML::SAX::Parser=HASH( Washington State mysql> create database `koha` default character set utf8 collate utf8_unicode_ci; 0x81fe220) engage through the Education Query OK, 1 row affected (0.00 sec) 04 You have: Convention Center SC11 Thrust: Program, Broader Engage- 05 XML::LibXML::SAX::Parser=HASH( ment, International Ambas- 0x9a0240) Data Intensive Science— mysql> grant all on koha.* to 'kohaadmin'@'localhost' identified by sadors, Student Volunteers, 'kohapassword'; 06 Looks good. SC11, the premier international the conference thrust— Query OK, 0 rows affected (0.00 sec) conference on high performance focusing on the challenges Student Cluster Challenge, computing, networking, storage and opportunities for address- and the annual Student passwd password, groupadd groupname. For mysql> flush privileges; Job Fair. convenience, you can set the username and analysis, will convene ing the exponential growth Query OK, 0 rows affected (0.00 sec) to be the same as the group name. November 12-18, 2011 in Seattle, and demands in the genera- To start the installation, execute Make‑ Washington. This year’s conference Join the SC11 conversation mysql> quit tion and analysis of data. file.PL. The installation script outputs a on Facebook, Twitter and Bye will place an emphasis on bringing lot of lines. Each parameter is explained together communities to facilitate Technical Program LinkedIn and look for by the installation script, so this proce- podcasts, videos and blogs. is installed). The easiest thing to do is All of these modules must be installed dure should take only a few minutes. information exchange, discussions Focus: search for the package [5], perl_net- when you configure Koha with all op- After configuring the parameter op- and new collaborations for Sustained Performance— We look forward to your Z3050. Follow the procedure in the “1- tions enabled. The left column shows tions, the installation script generates a research and education related achieving real, measurable Click Service Installation” box to install. the names of the Perl modules required; list of parameters and their settings, as participation! to innovating high performance productivity within an elapsed This adds devel:languages:perl [6] to the right column lists the Perl modules well as instructions on how to alter computing applications and your list of repositories. as they are named in openSUSE’s Perl re- them. Next, issue make, make test, and time using cutting-edge sc11.supercomputing.org advancing scientific discovery The list of Perl modules needed is dis- pository. Not all the required modules make install. If you entered the correct advances in high performance Sponsors: played after you run the installer. A list exist in the Perl repository. Those with setup options, you’ll get a shell prompt and scholarship. computing, networking, of unmet prerequisites is provided by the no equivalent must be installed through saying the Koha files were installed. To installer after you answer a number of CPAN [7]. use Koha’s command-line batch jobs, set questions. To save you trouble, I created Two other packages need to be in- the following environment variables: a list for you (Table 1). stalled on your system: perl-Cache-Mem- chached and memcached. To install export KOHA_CONF=/etc/koha/koha‑conf.xml 1-Click Service Install through CPAN, issue the cpan command export PERL5LIB=/usr/share/koha/lib 1. Click on 1-Click install. in a shell console. If this is the first time you have run the command, you will be For other post-installation tasks, please 2. You are asked to open a YaST meta- package with the appropriate handler. taken through an autoconfiguration pro- consult the README. cess. Once done, you should get a CPAN As instructed by the post-installation 3. You are shown a repository to be prompt: notes, you need to set the environment added to your system; click Next. variables. To do this, simply create /etc/ 4. You see the software component to in- Enter 'h' for help. bash.bashrc.local and add: stall (e.g., perl-Net-Z3950); click Next. cpan[1]> 5. You are shown the changes that will export KOHA_CONF=/etc/koha/koha‑conf.xml be made to your system; click Next. From here, you can install modules with export PERL5LIB=/usr/share/koha/lib 6. You are shown a final, pop-up warn- install module_name – for example, in‑ ing stating that changes will be made . Now, to set the variables, log out and log to your system; click Yes. stall Authen::CAS::Client back in to the shell. 7. If you are not logged in as root, a re- quest to enter the root password is Installing Koha made to install the package. The first thing you need to do is create a Configuring Apache SC11 returns to Seattle, a city noted as a conference favorite by attendees. Why? user and a group for Koha. Make sure Because this is a web application, you’ll 8. Import an untrusted GnuPG key. • Hotels are within walking distance of the convention center you set Koha’s password. The com- need to create a virtual host. On open- 9. The installation finishes. • The downtown area is vibrant—even after dark mands you need are useradd username, SUSE, virtual host files are set in the • Experiences abound—Pike Place Market, Pioneer Square, Puget Sound, Space Needle, and much more. 58 August 2011 Issue 129 linux-magazine.com | Linuxpromagazine.com
056-062_Koha.indd 58 7/1/11 1:28:02 PM Untitled-2 2 6/13/11 4:24:41 PM sc11.supercomputing.org Conference firsts: storage and analysis across a • a full day of technical diverse range of science and sessions on Friday, engineering disciplines. November 18, the last day • the most Technical Seattle, WA Program submissions ever SC11 will continue to recog- Connecting communities • a State of the Practice track nize exceptional individual through HPC • a Scientific Visualization accomplishments through Showcase the awards and fellowship November 12-18, 2011 • the largest number of programs. The Communities Seattle, WA exhibitors ever—nearly 300 Program offers opportunities for people new to SC to Washington State engage through the Education Convention Center SC11 Thrust: Program, Broader Engage- Data Intensive Science— ment, International Ambas- SC11, the premier international the conference thrust— sadors, Student Volunteers, conference on high performance focusing on the challenges Student Cluster Challenge, computing, networking, storage and opportunities for address- and the annual Student and analysis, will convene ing the exponential growth Job Fair. November 12-18, 2011 in Seattle, and demands in the genera- Washington. This year’s conference tion and analysis of data. Join the SC11 conversation will place an emphasis on bringing on Facebook, Twitter and together communities to facilitate Technical Program LinkedIn and look for information exchange, discussions Focus: podcasts, videos and blogs. and new collaborations for Sustained Performance— We look forward to your research and education related achieving real, measurable participation! to innovating high performance productivity within an elapsed computing applications and time using cutting-edge sc11.supercomputing.org advancing scientific discovery advances in high performance Sponsors: and scholarship. computing, networking,
SC11 returns to Seattle, a city noted as a conference favorite by attendees. Why? • Hotels are within walking distance of the convention center • The downtown area is vibrant—even after dark • Experiences abound—Pike Place Market, Pioneer Square, Puget Sound, Space Needle, and much more.
056-062_Koha.inddUntitled-2 2 59 6/13/117/1/11 1:28:02 4:24:41 PM PM Features Library System
Table 1: Perl Modules Perl Package openSUSE 11.3 Package Perl Package openSUSE 11.3 Package Algorithm::CheckDigits perl-Algorithm-CheckDigits MIME::Lite perl-MIME-Lite Authen::CAS::Client Mail::Sendmail perl-Mail-Sendmail Biblio::EndnoteStyle perl-Biblio-EndnoteStyle Memoize::Memcached Business::ISBN perl-Business-ISBN Net::LDAP CGI::Session perl-CGI-Session Net::Z3950::ZOOM perl-Net-Z3950 CGI::Session::Serialize::yaml perl-CGI-Session-Serialize-yaml Net::LDAP::Filter Class::Accessor perl-Class-Accessor Net::Server perl-Net-Server Class::Factory::Util perl-Class-Factory-Util Number::Format perl-Number-Format DBD::SQLite2 perl-DBD-SQLite PDF::API2 perl-PDF-API2 DBD:µysql perl-DBD-mysql PDF::API2::Page Data::ICal perl-Data-ICal PDF::API2::Simple Date::Calc perl-Data-Calc inc::Module::Install perl-Module-Install Date::ICal perl-Date-ICal PDF::API2::Util Date::Manip perl-Date-Manip PDF::Reuse perl-PDF-Reuse DateTime perl-DateTime PDF::Reuse::Barcode perl-PDF-Reuse-Barcode Email::Date perl-Email-Date PDF::Table GD perl-GD POE perl-POE GD::Barcode::UPCE perl-GD-Barcode SMS::Send perl-SMS-Send Graphics::Magick perl-GraphicsMagick Schedule::At perl-Schedule-At HTML::Scrubber perl-HTML-Scrubber Text::CSV perl-Text-CSV HTML::Template::Pro perl-HTML-Template-Pro Text::CSV::Encoded HTTP::OAI Text::CSV_XS perl-Text-CSV_XS JSON perl-JSON Text::Iconv perl-Text-Iconv Lingua::Stem perl-Lingua-Stem UNIVERSAL:require perl-UNIVERSAL-require Lingua::Stem::Snowball perl-Lingua-Stem-Snowball XML::Dumper perl-XML-Dumper List::MoreUtils perl-List-MoreUtils XML::LibXSLT perl-XML-LibXSLT Locale::Currency::Format XML::RSS perl-XML-RSS Locale::PO perl-Locale-PO XML::SAX::Writer perl-XML-SAX-Writer MARC::Charset perl-Marc-Charset YAML Perl-YAML MARC::Crosswalk::DublinCore perl-MARC-Crosswalk-DublinCore YAML::Syck perl-YAML-Syck MARC::File::XML perl-MARC-File-XML HTML::Template::Pro perl-HTML-Template-Pro MARC::Record perl-MARC-Record DublinCore::Record perl-DublinCore-Record
/etc/apache2/vhost.d folder. Any file Furthermore, you need to enable the re‑
Listing 6: Installing a New Language 01 ./tmpl_procd /usr/share/koha/misc/translator 02 ./tmpl_process3.pl install ‑i /usr/share/koha/opac/htdocs/opac‑tmpl/prog/en/ ‑o /usr/share/koha/opac/htdocs/opac‑tmpl/prog/ el‑GR ‑s /home/koha/koha‑3.02.00/misc/translator/po/el‑GR‑i‑opac‑t‑prog‑v‑3002000.po ‑r 03 ./tmpl_process3.pl install ‑i /usr/share/koha/intranet/htdocs/intranet‑tmpl/prog/en/ ‑o /usr/share/koha/intranet/htdocs/ intranet‑tmpl/prog/el‑GR ‑s /home/koha/koha‑3.02.00/misc/translator/po/el‑GR‑i‑staff‑t‑prog‑v‑3002000.po 04 Charset in/out: UTF‑8 at ./tmpl_process3.pl line 267. 05 Copying /usr/share/koha/intranet/htdocs/intranet‑tmpl/prog/en/columns.def... 06 The install seems to be successful.
60 August 2011 Issue 129 linux-magazine.com | Linuxpromagazine.com
056-062_Koha.indd 60 7/1/11 1:28:02 PM Features Library System
Listing 7: Output of Zebra’s Rebuild Command text indexing and retrieval engine [8]. Without it, searching for anything will /usr/share/koha/bin/migration_tools/rebuild_zebra.pl ‑r ‑v ‑a ‑b be slow and frustrating. If you are just testing, however, you’ll be fine without Zebra configuration information it. To install Zebra, simply type: ======Zebra biblio directory = /var/lib/koha/zebradb/biblios yast ‑i idzebra idzebra‑doc Zebra authorities directory = /var/lib/koha/zebradb/authorities Koha directory = /usr/share/koha/intranet/cgi‑bin Once Zebra is installed, you can issue BIBLIONUMBER in : 001$@ the rebuild command: BIBLIOITEMNUMBER in : 090$a ======/usr/share/koha/bin/migration_tools/U exporting authority rebuild_zebra.pl ‑r ‑v ‑a ‑b ======
======In my case, Zebra did not work out of REINDEXING zebra the box. I had to do some tweaking. The ======command to rebuild returned with own- 15:24:24‑21/12 zebraidx(5218) [log] zebra_start 2.0.43 ership issues, as shown in Listing 7. abd433d1a315576cf1f4a53f2c70365f9a76477f To fix this, I gave proper ownership to 15:24:24‑21/12 zebraidx(5218) [log] config /etc/koha/zebradb/zebra‑biblios.cfg the zebradb folder, as follows: 15:24:24‑21/12 zebraidx(5218) [warn] zebra_lock_create fail fname=/var/lock/koha/ zebradb/biblios/norm..LCK [Permission denied] chown ‑R [koha_user]:[koha_group] U
/var/lock/koha/zebradb koha web interface locked in mainte- If you get the message The install nance mode. seems to be successful, you can proceed Then, I issued the command to rebuild When I first visited my web installer to step two, which is to activate the new again, and it ran without any com- interface, I received a warning that the language. If not, you might not have cre- plaints. However, it still seemed like no perl-Date-ICal package was not installed, ated a necessary folder, or you might filter modules were loaded. The problem even though it was installed through have mistyped YaST. To resolve this, I removed it from one of the paths in YaST and then installed it through CPAN. the commands. To continue, log Installing Additional in to the intranet Languages interface as an ad- As with any multilingual application, ministrator. The your setup might need to support lan- first interface an guages besides English. To translate the administrator sees graphical user interface to another lan- is the Welcome guage, you must complete a two-step screen shown in process. The first step is to locate the .po Figure 2. files of the desired language and install From there, go them. The second step is to activate the to Home | Admin- newly installed language from Koha’s istration | System Figure 2: The intranet as seen by an administrator. web administration interface. I’ll show Preferences | OPAC how to add the Greek language; the pro- | I18N/L10N. On cedure is the same for any other sup- that page, you will ported language. be given the op- To create the hierarchy for Greek tion to enable the (el‑GR), you need to create two folders: newly installed /usr/share/koha/opac/htdocs/opac‑tmpl/ language, as prog/el‑GR and /usr/share/koha/intra‑ shown in Figure 3. net/htdocs/intranet‑tmpl/prog/el‑GR. The first folder involves the OPAC (On- Installing line Public Access Catalog) interface, Zebra and the second involves the Intranet in- If you are building terface. Assuming you extracted Koha in a production its user home folder, you can execute the server, you will commands shown in Listing 6 to install probably want to the Greek translation. install the Zebra Figure 3: Activating additional languages in Koha.
linux-magazine.com | Linuxpromagazine.com Issue 129 August 2011 61
056-062_Koha.indd 61 7/1/11 1:28:04 PM Features Library System
lay with the path of the 64-bit libraries. in to tailor the in- To locate the correct path, enter the fol- formation to their lowing find command: needs. Addition- ally, users can find / ‑iname mod‑alvis.so store search re- /usr/lib64/idzebra‑2.0/modules/U sults as lists, add mod‑alvis.so tags, submit pur- chase suggestions, Figure 5: Searching for patrons. Once I had the correct path, I edited the and more. De- zebra‑biblios.cfg configuration file and tailed manuals [9] replaced: explain all sorts of operations. modulePath: /usr/lib/idzebra‑2.0/modules Adding with Patrons In library environ- modulePath: /usr/lib64/idzebra‑2.0/U ments, users are modules called patrons. And, adding a pa- Finally, you can initialize Zebra with: tron in Koha is just a matter of a /usr/bin/zebrasrv U few clicks. To do ‑f /etc/koha/koha‑conf.xml & this, go to Patrons | New. Clicking on Make sure this command is added to New opens a form, Figure 6: Setting privileges. /etc/init.d/after.local so that Zebra is where you add a initialized each time your server boots. patron’s details. Note the OPAC Login ful consideration should be taken before Finally, if you are taking the system and Password fields toward the end of assigning rights to users. live on the Internet, you should enable the form. Every user requires an OPAC SSL support on your installation. I will account to log in to Koha. When you are Conclusion not go into many details on that, be- done, simply click Save. Koha helps you automate a library’s pro- cause SSL support on Apache is pretty If you do nothing else, the credentials duction cycle through a web-based user straightforward. you created for this user are only used to interface and is relatively easy to set up. For Koha, you need to edit the configu- log him in as a regular patron (library Learning to operate Koha can take a ration file and add SSL as a new virtual user). If you need to create some sort of while because it is a complete library host directive on port 443. You can also other user, you need to edit the user’s system. Here, I focused on installing and add SSL encryption on port 8080 for in- access rights. To do so, go to Home | Pa- setting up Koha from an administrator’s tranet logins (don’t forget to enable trons and choose the patron’s account. point of view. After that, it’s up to librar- Apache’s SSL module). You can locate the account by searching ians to add content, patrons, and operate on a partial name or with a patron card the software accordingly. nnn Using Koha number. Alternatively, you can browse The Online Public Access Catalog patrons by last name. Info (OPAC) interface is what a user sees Suppose, for example, you have a pa- [1] Koha: http://koha-community.org/ when visiting your Koha website. The tron called Account Tester. Searching for [2] openSUSE Linux: interface will be similar to that shown in test returns a list of users (in this case, http://www. opensuse. org Figure 4. Users can search for materials just one demo user), as seen in the [3] Apache web server: in the library’s catalog, and they can log Search Results screen in Figure 5. http://www. apache. org The name of the [4] MySQL: http://www. mysql. com patron will be a [5] openSUSE download: link. Clicking on http://software. opensuse. org that link takes you [6] openSUSE Perl repository: to the patron’s http://download.opensuse.org/ page. Choose repositories/devel:/ languages:/ perl/ More | Set permis- openSUSE_11.3 sions to go to the [7] CPAN: http://www. cpan. org permissions page. [8] Zebra: The permission http://www. indexdata. com/ zebra Figure 4: The Online Public Access Catalog (OPAC) as seen by an options are shown [9] Koha documentation: http://koha- anonymous user. in Figure 6. Care- community.org/ documentation/
62 August 2011 Issue 129 linux-magazine.com | Linuxpromagazine.com
056-062_Koha.indd 62 7/1/11 1:28:05 PM