Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 123030 - www-apps/bugzilla-2.20: doc issues and ExecCGI unset on the top-level directory
Summary: www-apps/bugzilla-2.20: doc issues and ExecCGI unset on the top-level directory
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Current packages (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Gentoo Web Application Packages Maintainers
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-02-16 05:54 UTC by Martin Mokrejš
Modified: 2006-02-17 08:13 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments
51_bugzilla.conf (a,411 bytes, text/plain)
2006-02-17 02:11 UTC, Martin Mokrejš
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Martin Mokrejš 2006-02-16 05:54:01 UTC
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).
Comment 1 Renat Lumpau (RETIRED) gentoo-dev 2006-02-16 11:53:58 UTC
(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.
Comment 2 Martin Mokrejš 2006-02-17 02:11:10 UTC
Created attachment 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.
Comment 3 Martin Mokrejš 2006-02-17 02:16:39 UTC
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.
Comment 4 Renat Lumpau (RETIRED) gentoo-dev 2006-02-17 08:13:20 UTC
(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.