[Koha-patches] [PATCH] Debian installation instructions minor editing

[Joe Atzberger]

> >> +    $ sudo a2dissite default
> >>
> >
> > This change is extremely hazardous.  It will lead some unsuspecting
> > new users to take their main web site (usually in /var/www) offline.
> > This step is unnecessary if the koha host is configured correctly to
> > take priority when needed, as described in the Apache HTTPD manual.
> >
>
> As far as I understand it, this installation procedure is not intended
> for installing Koha on an existing machine with an already running web
> site.



> This is a new installation: debian is downloaded (1.1), installed
> and a new Apache and MySql server are also installed. In this situation,
> the Debian 'default' site configuration is not users 'main web site' but
> Debian-Apache default site. This default site blocks  'koha' site.
> Without this modification, people taking a look to Koha will have to
> understand that to get Koha running they have to disable Debian default
> site in the Debian way. That's the reason why I indicate how to do it.
> Maybe a comment could clarify what's this line is doing.


The installation instructions are not limited to "fresh" installations.
Even in that case, Koha should not require disabling parts of the system
that are not relevant to its operation.

As indicated, if the koha host is correctly configured the default site is
not a problem.  If you have not assigned a unique DNS name (or port) for
your koha VirtualHost, the default apache site would respond.  The problem
with disabling the default site as a "workaround" is that it relies on
requests falling to your koha instance by default, not because you are
configured to receive them specifically.  That means:

   1. You can't enable default apache again.
   2. It's not just the default site: Koha still might not work, if other
   sites are enabled ahead of it.  Or it might break if you enable them later.
   3. You can't install any other koha instances in the same way without
   problems!

In short, I agree that disabling other apache sites (including default) is
not advisable.

--Joe Atzberger
-------------- next part --------------
An HTML attachment was scrubbed...
URL: </pipermail/koha-patches/attachments/20080423/63df4a3b/attachment-0002.html>