Debian packages of Koha: current status and plans
For a few weeks now I have been working on and off getting Koha packaged for Debian. Here are my thoughts and plans. To start with, I am targeting Koha 3.2 for Debian squeeze. Neither is released yet, but both will hopefully release in a few weeks or months, respectively. The reason I am targeting those is that when I find things that need fixing, it is probably easier to fix them in a development version than a released version. There were five CPAN modules missing from Debian squeeze that Koha needs. I have made Debian packages from them, and they are currently in Debian unstable. Unless there are problems, they should get into Debian squeeze in a week or two, and hopefully will be part of the actual Debian release. If any further software Koha needs, but is missing from Debian, I'll see about getting that packaged and uploaded as well. CPAN modules are mostly very easy. My near-term goals are as follows: * Get something usable out there soonish. It does not have to be perfect and final, just needs to work. I will make some opnionated choices, to keep things simpler for packaging. For example, Zebra will be required. More flexibility can come later after the basic packages work well and have been tested in various scenarios. * The koha package is meant for someone who wants to set up Koha for themselves. Installing the package will set up a host for one instance of Koha. The package will take care of dependencies, set up the databases, cron jobs, start Zebra, and do everything else to make Koha just work. Actual configuration of Koha will happen via the browser, on the first login to the intranet page, as if Koha had been installed from source. * Those who want to set up a host for multiple Koha instances can install the koha-common package instead. That package does not create any Koha instances , but contains scripts that will create, remove, enable, disable, dump, and restore Koha instances. There can be any number of Koha instances on the same host, and each instance will be independent of each other. * Set up a Debian apt repository at debian.koha-community.org to serve the Koha Debian packages. Koha is a large project and it will take a bit of effort to get it ready for inclusion into Debian, so the new repository will be helpful to those wanting to install Koha on their Debian machines. As a quick example, what I want to achieve is this: if you want to install Koha on your server, do this: apt-get install koha If, on the other hand, you want to host several Koha instances on the same server, do this instead: apt-get install koha-common koha-create --name=kotkahs --description='Kotka High School' \ --domain=kotkahs.example.com --defaults=highschool This will set up a new Koha instance, including databases, etc. It will create a new superlibrarian user, and populate the database with some sample content. The sample content will take care of the initial setup questions that Koha normally asks on the first intranet login. Instead, the instance will be immediately ready to use. In either scenario, it will be possible to enable/disable the Koha instance, for example during system maintenance. koha-disable kotkahs apt-get upgrade koha-enable kotkahs Further, it will be possible to do a dump of an instance, and later restore the instance from the dump, possibly even on a different machine. The dump will contain both the database and all configuration files. koha-disable kotkahs koha-dump kotkahs koha-remove kotkahs scp /var/spool/koha/kotkahs/* newhost.example.com: ssh newhost.example.com koha-restore kotkahs-* koha-enable kotkahs The dumps will be useful as backups as well. I've implemented most of that, although in a quick-and-dirty manner. I'm working on polishing things now, but before I go much further, I thought I'd notify everyone and ask the big questions... Is this something others would find useful? Am I missing something that would be useful to many? I am not currently looking for test users or patches, but I will announce when I have something that I think is reasonably safe for others to try.
Lars Wirzenius wrote:
For a few weeks now I have been working on and off getting Koha packaged for Debian. Here are my thoughts and plans.
This looks fantastic, Lars. Thanks for putting in the hard yards. Things brings Koha (close to) an out of the box install with no fiddling about.
Is this something others would find useful? Am I missing something that would be useful to many?
I would suggest we eventually test this on Debian etch. Prolly minors differences will be encountered, nothing major. One thing we do with our own installs is forgo port 8080 for the Staff client. Instead, we install to virtual hosts, one for OPAC and one for Staff. AFAIK, this only means a change to two files: ports.conf and default-Koha.conf (i.e. the apache config for Koha). Thanks again for the good work. cheers rickw -- _________________________________ Rick Welykochy || Praxis Services Politics is the business of getting power and privilege without possessing merit. -- PJ O'Rourke
Rick Welykochy writes
One thing we do with our own installs is forgo port 8080 for the Staff client. Instead, we install to virtual hosts, one for OPAC and one for Staff.
So do I.
AFAIK, this only means a change to two files: ports.conf and default-Koha.conf (i.e. the apache config for Koha).
ports.conf is part of Apache. Proceeding with one port should make the integration with Apache easier. Cheers, Thomas Krichel http://openlib.org/home/krichel http://authorclaim.org/profile/pkr1 skype: thomaskrichel
On Thu, Apr 29, 2010 at 10:18 PM, Thomas Krichel <krichel@openlib.org>wrote:
Rick Welykochy writes
One thing we do with our own installs is forgo port 8080 for the Staff client. Instead, we install to virtual hosts, one for OPAC and one for Staff.
So do I.
Ditto here. Kind Regards, Chris
On Fri, 2010-04-30 at 12:02 +1000, Rick Welykochy wrote:
I would suggest we eventually test this on Debian etch. Prolly minors differences will be encountered, nothing major.
Debian etch is now really old, and I think no longer supported by Debian, so lenny (the current stable release) would be the natural choice. Lenny should be feasible, but requires that a fairly large number of packages be backported from squeeze, so it's quite a bit more work. I'll do packages for squeeze first, and then we'll see about lenny.
One thing we do with our own installs is forgo port 8080 for the Staff client. Instead, we install to virtual hosts, one for OPAC and one for Staff. AFAIK, this only means a change to two files: ports.conf and default-Koha.conf (i.e. the apache config for Koha).
That's something I'd like to do, too, but it requires two domain names. I'll see about adding support for either solution, since it should be easy enough.
Thanks again for the good work.
You're welcome.
Lars Wirzenius writes
Is this something others would find useful?
I am not sure that the multi-installations are useful to me. But the backup and move to other machine would definitely. The biggest problem I have with koha is performance. I mailed the list about fastCGI some time ago. Moving to a better machine would also improve performance, and your package system would be very handy.
I am not currently looking for test users or patches, but I will announce when I have something that I think is reasonably safe for others to try.
But I already volunteer. This looks like great work Lars. When you come to NYC I will buy you a lot of beer for this. Cheers, Thomas Krichel http://openlib.org/home/krichel http://authorclaim.org/profile/pkr1 skype: thomaskrichel
On 30 April 2010 14:25, Thomas Krichel <krichel@openlib.org> wrote:
Lars Wirzenius writes
Is this something others would find useful?
I am not sure that the multi-installations are useful to me. But the backup and move to other machine would definitely.
The biggest problem I have with koha is performance. I mailed the list about fastCGI some time ago. Moving to a better machine would also improve performance, and your package system would be very handy.
Thomas I spent some time experimenting with fastcgi + nginx, if you want to chat about it sometime. I think its a good avenue to explore I am on irc most days.
I am not currently looking for test users or patches, but I will announce when I have something that I think is reasonably safe for others to try.
But I already volunteer. This looks like great work Lars. When you come to NYC I will buy you a lot of beer for this.
Lars, If you don't want to drink it, you can bring it back to work and I'll help ;) Seriously though, Id like to add my thanks for the work you have done to date. Chris
Dear Lars, Thank you for fantastic work.. On Fri, Apr 30, 2010 at 6:43 AM, Lars Wirzenius <lars@catalyst.net.nz>wrote:
Is this something others would find useful? Am I missing something that would be useful to many?
OH YES very useful !! I have done a couple of Koha install trainings for librarians and many are overwhelmed by the complexity of installing and configuring Koha. It will simply be great to be able to run a simple apt-get and get Koha installed and fully ready to go.
I am not currently looking for test users or patches, but I will announce when I have something that I think is reasonably safe for others to try.
Oww but I would like to test. Including the multiple servers part. Possible? Regards, Koustubha Kale Anant Corporation Contact Details : Address : 103, Armaan Residency, R. W Sawant Road, Nr. Golden Dyes Naka, Thane (w), Maharashtra, India, Pin : 400601. TeleFax : +91-22-21720108, +91-22-21720109 Mobile : +919820715876 Website : http://www.anantcorp.com Blog : http://www.anantcorp.com/blog/?author=2
participants (6)
-
Chris Cormack -
Chris Nighswonger -
Koustubha Kale -
Lars Wirzenius -
Rick Welykochy -
Thomas Krichel