Install Koha on Ubuntu — Part 6: Going Live

Koha Logo

Warn­ing: this tuto­r­ial was devel­oped in 2008, and is for ver­sions of Koha and Ubuntu that are now con­sid­ered quite old. If you want to install the cur­rent ver­sion of Koha on Ubuntu, please visit Koha on Ubuntu at the Koha Com­mu­nity wiki.

This is part 6 of 6 in a tuto­r­ial series on installing Koha 3.0 on Ubuntu 8.10.

So far we’ve installed and con­fig­ured Linux, laid the ground­work for Koha, installed and con­fig­ured Koha, and played around with it a little.

If you’re con­sid­er­ing the next step—using Koha for actual library hold­ings and actual patrons—this final arti­cle is for you.

If you plan to put Koha into pro­duc­tion for real-world Library use there are many other things you need to con­sider. The final arti­cle in the series, Going Live, dis­cusses this further.

Who this arti­cle is for.
  • Peo­ple who want to try Koha.
  • Peo­ple who aren’t nec­es­sar­ily Linux experts, but…
  • Who are very com­fort­able with com­put­ers and not afraid of using a command-line inter­face.
What to expect.

Show­time!

If you’re con­sid­er­ing host­ing your own live, pro­duc­tion Koha imple­men­ta­tion, it’s impor­tant that you under­stand what you’re get­ting into.

Before you take Koha into pro­duc­tion with live data it’s crit­i­cal that you seek sound advice from one or more com­pe­tent web/Linux sys­tem administrators.

I am def­i­nitely not a com­pe­tent sys­tem admin­is­tra­tor, so this sec­tion is sim­ply a col­lec­tion of my (informed, I hope) opin­ions. Please take it as such.

What You’ll Need

Koha is free. Com­pe­tent appli­ca­tion– and sys­tem admin­is­tra­tion and sup­port is not.

I’m not qual­i­fied to admin­is­ter a pro­duc­tion web server, but through years of devel­op­ing and deploy­ing web-based appli­ca­tions for sen­si­tive infor­ma­tion I’ve worked with a num­ber of peo­ple who are. Here’s what I know.

To pro­ceed with a pro­duc­tion Koha imple­men­ta­tion you’ll either need your own IT staff with the required exper­tise, or you’ll need to con­tract with some­one who has it. That might be gen­eral IT con­sult­ing firm or an orga­ni­za­tion that spe­cial­izes in Koha imple­men­ta­tions. The Koha Library Soft­ware Com­mu­nity pro­vides a page list­ing orga­ni­za­tions that install and/or sup­port Koha.

In any case you must have:

  • A server and net­work con­nec­tiv­ity that can sup­port your expected peak lev­els of use.
  • Some means of ensur­ing that the appli­ca­tion remains avail­able (for exam­ple, a failover server in case the pro­duc­tion server goes down), or else a thought­ful deci­sion not to have such mea­sures in place and an accep­tance that peri­odic down­time is possible.
  • One or more peo­ple with the time and exper­tise to set up and security-harden your pro­duc­tion server and your network.
  • One or more peo­ple with the time and exper­tise to mon­i­tor it reg­u­larly, ensur­ing it is func­tion­ing prop­erly and its secu­rity hasn’t been breached—people com­mit­ted to remain­ing cur­rent on best prac­tices for secu­rity and sys­tem administration.
  • One or more peo­ple with the time and exper­tise to respond quickly when there are appli­ca­tion, server, or net­work prob­lems, or when the system’s secu­rity is compromised.
  • Fund­ing, both up-front and ongo­ing, to sup­port all of the above.

There are more things of course, but your com­pe­tent appli­ca­tion– and system-administrators can work with you on the details.

Exter­nal Hosting

One way to address some of these issues is to locate Koha with an inde­pen­dent web host (one sup­port­ing shell access and vir­tual pri­vate servers). There are hun­dreds of web hosts to choose from.

This is far from a panacea. While this will relieve you of many secu­rity and sys­tem admin­is­tra­tion issues, you’re also putting both your trust and your patron infor­ma­tion in the hands of a third party com­pany. Not all web hosts deserve this trust. Of the ones that do, not all will remain that way.

This Blaz­ing Moon arti­cle gives some advice on research­ing and choos­ing a web host.

Appli­ca­tion Trou­bleshoot­ing: An Example

This thread from a Koha news­group is a good exam­ple of some mod­er­ately hairy diag­nos­tic work in response to an issue with the optional Zebra search engine. I include it here to illus­trate a point: embark on a Koha imple­men­ta­tion only if some­one in your orga­ni­za­tion or some­one you con­tract with is will­ing and able to tackle trou­bleshoot­ing of this sort when needed.

And on a hap­pier note…

Koha is a won­der­ful and Free Open Source soft­ware pack­age devel­oped by a com­mu­nity of peo­ple who are try­ing to make the world a bet­ter place and who believe high-quality soft­ware should be freely available.

Though I’ve out­lined a some­what impos­ing list of logis­ti­cal con­sid­er­a­tions above, there are many suc­cess­ful pro­duc­tion Koha imple­men­ta­tions in the world, there will be many more, and there are plenty of good peo­ple out there who can help you to have one if it’s the direc­tion you choose.

If all has gone well you’ve just installed a test bed where you can bet­ter under­stand how Koha would work for your orga­ni­za­tion. I believe you’ll not only find the soft­ware to be of high qual­ity, but the online com­mu­nity to be help­ful and supportive.

Best of luck with your inves­ti­ga­tion and the choices you have ahead.

There are 15 responses to this post.

By deepti on November 25, 2010 at 5:05 am

hii my name is deepti. i have con­fig­ure server of koha for my com­pay but it shoe me fol­low­ing error.

Koha error

The fol­low­ing fatal error has occurred:

Can’t locate ZOOM.pm in @INC (@INC con­tains: /usr/share/koha/lib /usr/lib/perl5/5.10.0/i586-linux-thread-multi /usr/lib/perl5/5.10.0 /usr/lib/perl5/site_perl/5.10.0/i586-linux-thread-multi /usr/lib/perl5/site_perl/5.10.0 /usr/lib/perl5/vendor_perl/5.10.0/i586-linux-thread-multi /usr/lib/perl5/vendor_perl/5.10.0 /usr/lib/perl5/vendor_perl .) at /usr/share/koha/lib/C4/Context.pm line 84.
BEGIN failed–compilation aborted at /usr/share/koha/lib/C4/Context.pm line 84.
Com­pi­la­tion failed in require at /usr/share/koha/lib/C4/Output.pm line 30.
BEGIN failed–compilation aborted at /usr/share/koha/lib/C4/Output.pm line 30.
Com­pi­la­tion failed in require at /usr/share/koha/intranet/cgi-bin/mainpage.pl line 23.
BEGIN failed–compilation aborted at /usr/share/koha/intranet/cgi-bin/mainpage.pl line 23.

Please help me..

 

By Andy on November 29, 2010 at 8:51 am

Deepti,

Sorry to hear about the prob­lem you encoun­tered. Another per­son reported the same prob­lem today, which makes me won­der whether it’s caused by a recent change to one of the Koha modules.

Unfor­tu­nately I don’t have a Koha test com­puter where I can inves­ti­gate this prob­lem right now. But I have two suggestions.

One is to review the com­ments peo­ple posted on the first page of the tuto­r­ial (http://www.blazingmoon.org/news/2008/12/installing-koha-3-on-ubuntu-810-a-tutorial/). A cou­ple of them men­tion prob­lems with the Zoom mod­ule and pos­si­ble solutions.

The sec­ond sug­ges­tion is to sign­ up for the Koha Mail­ing List (http://lists.katipo.co.nz/mailman/listinfo/koha) and post­ your ques­tion there if you haven’t already.

If you do find a solu­tion, please post it here so I can update the tuto­r­ial and pre­vent the prob­lem for oth­ers. And if I’m able to line up a Koha test com­puter I’ll do the same.

By DEEPTI on December 2, 2010 at 9:47 am

thanx’s for reply i got the solu­a­tion of this prob­lemwe­have to install Net::Zoom packge in cpan

By deepti on December 3, 2010 at 6:15 am

hii
can u tell me that can we use moo­dle with koha nad how??please reply me i m waiting

By THILSHATH on December 6, 2010 at 9:41 am

is there any­way that we can inte­grate koha with moodle?

 

By Andy on December 6, 2010 at 9:51 am

I wish I could help, but I’m not at all famil­iar with Moodle.

By THILSHATH on December 6, 2010 at 1:54 pm

Andy,
can you please tell me how do i add books jour­nals etc… to my koha server????

Thanks in advance

 

By Andy on December 6, 2010 at 9:03 pm

Thilshath,

Part 5 of the tuto­r­ial (http://www.blazingmoon.org/news/2008/12/install-koha-on-ubuntu-part-5-testing/) includes exam­ples of adding and check­ing out materials.

For infor­ma­tion beyond that, you could check out the Koha doc­u­men­ta­tion site (http://koha.org/documentation) or the Koha Com­mu­nity doc­u­men­ta­tion site (http://koha-community.org/documentation/).

By Abdullah-Al-Modabber on December 9, 2010 at 6:53 am

Hi
I have installed koha 3 on ubuntu 9.04 using you nice tuto­r­ial. It it run­ning fine but if I try to add a marc record import­ing through z39.50, and when I try to save fill­ing with bar­code etc he fol­low­ing error mes­sage shown. I am no good with linux com­mand. Could you please help me to solve this problem!

Koha error

The fol­low­ing fatal error has occurred:

Can’t call method “append_fields” on an unde­fined value at /usr/local/share/perl/5.10.0/MARC/File/SAX.pm line 92.

Apache Server ver­sion: Apache/2.2.11 (Ubuntu) Server built: Aug 16 2010 17:45:31
Koha 3.00.00.107
Koha DB 3.0000107
MySQL mysql Ver 14.12 Dis­trib 5.0.75, for debian-linux-gnu (i486) using read­line 5.2
OS Linux modabber-desktop 2.6.28–19-generic #66-Ubuntu SMP Sat Oct 16 17:39:04 UTC 2010 i686 GNU/Linux
Perl 5.010000

 

By Andy on December 9, 2010 at 9:37 am

Abdullah-Al-Modabber — I’m sorry, but I don’t think I can help you with this prob­lem. I don’t cur­rently have a Koha sys­tem where I can inves­ti­gate the prob­lem. You might try a Google search using part of that error mes­sage, or you could try email­ing the Koha Mail­ing List (http://lists.katipo.co.nz/mailman/listinfo/koha). Best of luck.

By deepti on December 15, 2010 at 5:43 am

hii
can u tell me how we can export data into koha.
one server data into koha server

By Tejas on February 15, 2011 at 3:59 am

I am get­ting the fol­low­ing Koha Error:

Koha error

The fol­low­ing fatal error has occurred:

This ver­sion of XML::LibXSLT requires XML::LibXML 1.67 (ABI 1), which is incom­pat­i­ble with cur­rently installed XML::LibXML 1.70 (ABI 2). Please upgrade XML::LibXSLT, XML::LibXML, or both! at /usr/local/lib/perl/5.10.0/XML/LibXML.pm line 49.
BEGIN failed–compilation aborted at /usr/lib/perl5/XML/LibXSLT.pm line 7.
Com­pi­la­tion failed in require at /usr/share/koha/lib/C4/XSLT.pm line 27.
BEGIN failed–compilation aborted at /usr/share/koha/lib/C4/XSLT.pm line 27.
Com­pi­la­tion failed in require at /usr/share/koha/lib/C4/Search.pm line 27.
BEGIN failed–compilation aborted at /usr/share/koha/lib/C4/Search.pm line 27.
Com­pi­la­tion failed in require at /usr/share/koha/lib/C4/Heading.pm line 25.
BEGIN failed–compilation aborted at /usr/share/koha/lib/C4/Heading.pm line 25.
Com­pi­la­tion failed in require at /usr/share/koha/lib/C4/Biblio.pm line 114.
BEGIN failed–compilation aborted at /usr/share/koha/lib/C4/Biblio.pm line 114.
Com­pi­la­tion failed in require at /usr/share/koha/lib/C4/Reserves.pm line 28.
BEGIN failed–compilation aborted at /usr/share/koha/lib/C4/Reserves.pm line 28.
Com­pi­la­tion failed in require at /usr/share/koha/lib/C4/Circulation.pm line 25.
BEGIN failed–compilation aborted at /usr/share/koha/lib/C4/Circulation.pm line 25.
Com­pi­la­tion failed in require at /usr/share/koha/lib/C4/Overdues.pm line 24.
BEGIN failed–compilation aborted at /usr/share/koha/lib/C4/Overdues.pm line 24.
Com­pi­la­tion failed in require at /usr/share/koha/lib/C4/Members.pm line 27.
BEGIN failed–compilation aborted at /usr/share/koha/lib/C4/Members.pm line 27.
Com­pi­la­tion failed in require at /usr/share/koha/lib/C4/Auth.pm line 31.
BEGIN failed–compilation aborted at /usr/share/koha/lib/C4/Auth.pm line 31.
Com­pi­la­tion failed in require at /usr/share/koha/intranet/cgi-bin/mainpage.pl line 24.
BEGIN failed–compilation aborted at /usr/share/koha/intranet/cgi-bin/mainpage.pl line 24.

 

By Andy on February 15, 2011 at 8:56 am

Unfor­tu­nately I don’t remem­ber see­ing the prob­lem you men­tion in the times I installed Koha, and I don’t cur­rently have a Koha com­puter where I can inves­ti­gate this prob­lem. The tuto­r­ial is now a cou­ple of years old, and the libraries sup­port­ing Koha are con­stantly being changed and upgraded, so some­times peo­ple work around prob­lems by installing newer ver­sions of libraries. The text of the error mes­sage often gives infor­ma­tion about which libraries need to be upgraded.

Your error mes­sage sug­gests that your library XML::LibXSLT is expect­ing an older ver­sion of XML::LibXML (1.67), instead of the newer XML::LibXML that’s installed (1.70). Installing a newer ver­sion of XML::LibXSLT, using steps sim­i­lar to those ear­lier in the tuto­r­ial, might help: it’s more likely to be com­pat­i­ble with your newer XML::LibXML.

If that doesn’t work, and if you haven’t already done this, you might con­sider post­ing your ques­tion to the Koha mail­ing list. The tech­ni­cal peo­ple who are most active in the Koha com­mu­nity reg­u­larly fol­low that list and sug­gest solu­tions to prob­lems. You can sign up for the Koha mail­ing list here: http://lists.katipo.co.nz/mailman/listinfo/koha

By Nigussie Abate on August 1, 2011 at 2:14 am

Dear Sir!
I am work­ing at uni­ver­sity library and want use koha soft­ware appli­ca­tion in my Infor­ma­tion System.But I get some prob­lem to make it in my info.centre.Do I cre­ate koha data­base by myself or is already cre­ated?
Can I Install MySQL & Perl 5.8.8 on the ubuntu ter­mi­nal by using their site or must be on CD?

By Install Koha on Ubuntu — Part 3: Koha Prerequisites » Blazing Moon on July 30, 2012 at 4:09 pm

[…] Library use there are many other things you need to con­sider. The final arti­cle in the series, Going Live, dis­cusses this fur­ther. Who this article […]

You aren't currently logged in. You can use the fields below to post a comment without logging in or registering, or you can log in or register now.




By submitting a comment here you grant Blazing Moon a perpetual license to reproduce your words and name/web site in attribution. Inappropriate comments will be removed at admin's discretion.

Blazing Moon RSS Feed