[Koha] Installation Questions

[Roger Buck]

I am currently trying a first-time install of Koha (from latest CVS) on
RedHat 6.2

As I proceed, I am trying to clarify and document problems that I
encounter so although the stuff below is written in the style of
statements, it is in fact questionable <grin>

The starting point for this is the koha INSTALL document.

I intend to expand on that and so, for that purpose, I have created a
Koha installation wiki at:

  http://www.saas.nsw.edu.au/wiki/

It is also available for anyone to add/edit/modify via public Internet.

The wiki content may eventually be a suitable update for the koha
INSTALL file.

The document is available now, but in order for me to proceed, can
anyone please help clarify /correct the following:

Koha is designed to be installed as two separate services - each having
a unique web address and folder structure (two virtual web hosts). The
folder structures for both servers are designed to operate separately
and independently; The only reason for this is to simplify security
setup?

The "/cgi-bin/opac/*" scripts (placed in the opac cgi-bin folder) are a
sub-set of the "/cgi-bin/koha/" scripts.

To clarify this further:

  * The "/cgi-bin/opac/" cgi-bin folder contains _only_ those scripts in
the root directory of the "scripts/" directory (found in the koha
distribution).

  * The "koha" cgi-bin folder contains all files and folders found
inside the distribution "scripts/" folder _except_ the "telnet" folder
and non web stuff (see below). This means that the following sub folders
and their contents...

 /scripts/acqui/*.pl
 /scripts/maint/*.pl
 /scripts/circ/*.pl
 /scripts/misc/*.pl
 /scripts/sec/*.pl

...should be copied to the root of /cgi-bin/koha/ (do not copy contents
of telnet, tkperl, translator and updater directories to cgi-bin - see
install manual for details).

NOTE: Is there some way this could be implied?

What about acqui.simple in CVS - does this mean either use /acqui/*.pl
_or_ /acqui.simple/*.pl ?


Both virtual hosts access a single database which may be on the same
server or on a remote server. The two separate web servers are referred
to as "koha" and "opac". The term "intranet" in the koha doc refers to
the "koha" web site.

NOTE: For consistency why not re-name the respective html distro folders
koha-html and opac-html ?

Catalogue maintenance and acquisitions links in /catalogue/index.html
are broken (..."acquisitions/" link is relative instead of absolute...
which (wrongly) requires that "acquisition" folder is a sub-folder of
catalogue)? Also, I assume the "catmaintain.pl" should be located inside
the "catalogue/" subdir - not the root of cgi-bin/koha/ ? Anyhow, I
think the index.html links need to be tidied up ;^)

I'm sure there is other stuff but I want to get feedback on above before
going too far on a wild goose chase <grin>

I'm happy to find, fix and diff anything obvious if that would help.

In the meantime. I'll continue to provide more feedback/questions here.

R.