This article refers to Koha 1.9.x and Koha 2.0.x. For Koha 3.0.x this functionality is built into the installer.

General Notes

The first step is to get a copy of the koha tree from CVS; there are directions for how to do this on the CVS section of Koha's SourceForge project page. I will call this directory <cvs>. For example, mine is currently at /home/mike/cvs/koha , Thus, if there is a script at say /home/mike/cvs/koha/script.pl, I will refer to it as <cvs>/script.pl .

You also need an installed copy of 1.9.x (I am pretty sure this process will also work for anything up through the 2.0 series, but I am not positive that there will be no major changes in the filesystem layout). I will call this directory <inst>. For example, mine is installed at /usr/local/koha. In this document, I will refer files(/directories) such as /usr/local/koha/intranet as <inst>/intranet.

In order to run these commands, you may need to run as root. Also, <cvs> and its contents need to be readable by the user under which apache runs.

Please note that I am not totally positive that doing things this way will not introduce any new problems. I run this on my system and have not found anything wrong, but I make no guarantees. If you see anything wrong or know how to improve this document, feel free to either change it yourself or send me an e-mail at mwhansenAThmc.edu. Thanks.

Symlinking within <inst>/intranet

  • First, we need to replace all of the major intranet scripts that reside in <inst>/intranet/cgi-bin with the ones from the CVS tree. To do so, we make a symlink from <cvs> to <inst>/intranet/cgi-bin . To accomplish this, you would use the following commands
    • rm -rf <inst>/intranet/cgi-bin
    • ln -s <cvs> <inst>/intranet/cgi-bin
  • Next, we need to get the Koha installation to use the current CVS templates. The templates should be installed at <inst>/intranet/htdocs/intranet-tmpl. We will want to symlink <cvs>/koha-tmpl/intranet-tmpl to this. The commands are as follows
    • rm -rf <inst>/intranet/htdocs/intranet-tmpl
    • ln -s <cvs>/koha-tmpl/intranet-tmpl <inst>/intranet/htdocs/intranet-tmpl
  • We now need to set up the modules by symlinking <cvs>/C4 to <inst>/intranet/modules/C4. The commands are as follows
    • rm -rf <inst>/intranet/modules/C4
    • ln -s <cvs>/C4 <inst>/intranet/modules/C4

Symlinking within <inst>/opac

  • First, we need to replace the scripts under <inst>/opac/cgi-bin with the ones under <cvs>/opac. To do so, run the following commands
    • rm -rf <inst>/opac/cgi-bin
    • ln -s <cvs>/opac <inst>/opac/cgi-bin
  • Next, we need to update the templates under <inst>/opac/htdocs/opac-tmpl with the ones under <cvs>/koha-tmpl/opac-tmpl. The commands are as follows
    • rm -rf <inst>/opac/htdocs/opac-tmpl
    • ln -s <cvs>/koha-tmpl/opac-tmpl <inst>/opac/htdocs/opac-tmpl

Allowing symlinks in webserver Webserver

  • You might need to set your webserver to follow symlinks, like I (vlankhaar) had to. To accomplish this, you need to add the following to your httpd.conf, if you're running Apache:

Final words

Barring any major problems, you should have successfully updated your install of Koha to use the most current versions of the scripts/modules/templates available via CVS. Good luck with testing!

 
cvssymlinkinstallation.txt · Last modified: 2008/12/30 10:03 by sbrinker
 
Except where otherwise noted, content on this wiki is licensed under the following license:CC Attribution-Noncommercial-Share Alike 3.0 Unported
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki