Bugzilla Bug 123030

Hi,
  I searched around for Gentoo specific Docs about how is one supposed to
install bugzilla software. The webapp-config app has a small doc but does not
show how to list files presented through apache2 at http://localhost/bugzilla.
I found there are some hardlinks made by the webapp-config but I couldn't find
from where to where.

Problems with the installation:

1. The localconfig file is missing in both /var/www/localhost/htdocs/bugzilla/
and  /usr/share/webapps/bugzilla/2.20/htdocs/.

2. Nothing in the postinstall docs says where to look for such configuration
Gentoo specific issues. I copied the file to both places myself, still have no
clue what are those dirs.

3. The ExecCGI bit set in .htaccess is ignored by the apache2 webserver. That's
because AllowOverride None is set in
/etc/apache2/vhosts.d/00_default_vhost.conf for /var/www/localhost/htdocs/.
Probably webapp-config should handle this automatically or bugzilla (and
phpmyadmin and other CGIs handled through webapp-config) should have been
installed under /var/www/localhost/cgi-bin. I would prefer the latter and also
the apache2 configuration is already preset like this.

4. bugzilla-2.20.ebuild file should not force downgrade to DBD-mysql-2.9007 but
allow for 3.0002 (without any patches, at least not _p3 through _p4):

    !postgres? ( >=dev-db/mysql-3.23.41 <dev-perl/DBD-mysql-3.0002_p3 )

DBD-mysql-3.0002 is the last which works for me with bugzilla (there's a bug
filed in Gentoo Bugzilla about that for DBD-mysql).

(In reply to comment #0)
>   I searched around for Gentoo specific Docs about how is one supposed to
> install bugzilla software. The webapp-config app has a small doc but does not
> show how to list files presented through apache2 at http://localhost/bugzilla.
> I found there are some hardlinks made by the webapp-config but I couldn't find
> from where to where.

Please read man 5 webapp-config, man 8 webapp-config, man webapp.eclass

> Problems with the installation:
> 
> 1. The localconfig file is missing in both /var/www/localhost/htdocs/bugzilla/
> and  /usr/share/webapps/bugzilla/2.20/htdocs/.

The ebuild clearly instructs the user to read
http://www.bugzilla.org/docs/2.20/html/installation.html . localconfig is
created at install time by running checksetup.pl

> 2. Nothing in the postinstall docs says where to look for such configuration
> Gentoo specific issues. I copied the file to both places myself, still have no
> clue what are those dirs.

Read the above manpages.

> 3. The ExecCGI bit set in .htaccess is ignored by the apache2 webserver. That's
> because AllowOverride None is set in
> /etc/apache2/vhosts.d/00_default_vhost.conf for /var/www/localhost/htdocs/.
> Probably webapp-config should handle this automatically 

No, I'd rather leave this up to the server administrator.

> or bugzilla (and
> phpmyadmin and other CGIs handled through webapp-config) should have been
> installed under /var/www/localhost/cgi-bin. I would prefer the latter and also
> the apache2 configuration is already preset like this.

I see your point about cgi-bin vs htdocs. At the moment, the recommended
solution is to edit the AllowOverride directive as you mentioned above.

> 4. bugzilla-2.20.ebuild file should not force downgrade to DBD-mysql-2.9007 but
> allow for 3.0002 (without any patches, at least not _p3 through _p4):
> 
>     !postgres? ( >=dev-db/mysql-3.23.41 <dev-perl/DBD-mysql-3.0002_p3 )
> 
> DBD-mysql-3.0002 is the last which works for me with bugzilla (there's a bug
> filed in Gentoo Bugzilla about that for DBD-mysql).

Good point, fixed in CVS.

Created an attachment (id=79999) [details]
51_bugzilla.conf

Why isn't there /etc/apache2/modules.d/51_bugzilla.conf installed by default?
Actually, I think what would make more sense is to install bugzilla under
cgi-bin and set for the user rewriting rule and redirect /bugzilla to
/cgi-bin/bugzilla.

If you do not aggree please add two more lines into the postinstall text
mentioning the AlllowOverride thing and whether the localconfig should be
hardlinked by the user from htdocs and htdocs-secure and maybe form sowhere
else. Sorry, but I find this unclear. And two lines can save the user reading
all the manpages, which still do not describe the actual case.

(In reply to comment #3)
> If you do not aggree please add two more lines into the postinstall text
> mentioning the AlllowOverride thing and whether the localconfig should be
> hardlinked by the user from htdocs and htdocs-secure and maybe form sowhere
> else. Sorry, but I find this unclear. And two lines can save the user reading
> all the manpages, which still do not describe the actual case.

Added instructions to run ${MY_INSTALLDIR}/checksetup.pl (will be expanded to
point to the correct location in /var/www) and to modify the AllowOverride
directive.