[Pkg-bugzilla-commits] r102 - in trunk/bugzilla-2.18/debian: . examples

Alexis Sukrieh sukria-guest@costa.debian.org
Sun, 12 Jun 2005 12:36:59 +0000


Author: sukria-guest
Date: 2005-06-12 12:36:59 +0000 (Sun, 12 Jun 2005)
New Revision: 102

Added:
   trunk/bugzilla-2.18/debian/examples/
   trunk/bugzilla-2.18/debian/examples/vh-basic.conf
   trunk/bugzilla-2.18/debian/examples/vh-custom-static.conf
Modified:
   trunk/bugzilla-2.18/debian/README.Debian
   trunk/bugzilla-2.18/debian/rules
Log:
ok

Modified: trunk/bugzilla-2.18/debian/README.Debian
===================================================================
--- trunk/bugzilla-2.18/debian/README.Debian	2005-06-12 11:55:32 UTC (rev 101)
+++ trunk/bugzilla-2.18/debian/README.Debian	2005-06-12 12:36:59 UTC (rev 102)
@@ -1,7 +1,8 @@
 README.Debian for bugzilla package
-----------------------------------
+==============================================================================
 
 Global notes
+------------------------------------------------------------------------------
 
   You will need to adjust some parameters to fit your site; see the "Edit
   parameters" document (/cgi-bin/bugzilla/editparams.cgi).
@@ -21,7 +22,8 @@
  -- Rémi Perrot <rperrot@debian.org>,  Sun, 16 Mar 2003 20:28:02 +0100
 
 
-Important change since 2.16.7-1 :
+Bugzilla's MySQL user
+------------------------------------------------------------------------------
 
   The automatic installation mode will generate a "bugzilla" MySQL user 
   with a random password (which is 16 characters long).
@@ -32,3 +34,52 @@
 
  -- Alexis Sukrieh <sukria@sukria.net>, Sat, 08 Jan 2005 12:38:07 +0100
 
+    
+How to set several VirtualHosts with this package
+------------------------------------------------------------------------------
+
+  If you want to provide several virtual hosts of Bugzilla, you can achieve that
+  goal easily thanks to your Apache configuration.
+
+  You will need to enable the Apache mod_env module first:
+    
+    # apache-modconf apache enable mod_env
+
+  Then, you have to prepare a configuration directory for your virtual
+  host. The simpliest way is to copy the one the package created:
+  `/etc/bugzilla'. Name this new configuration directory like that:
+  `/etc/bugzilla-host' where `host' is the name of your virtual host.
+
+  You have now to add a virtual host section in your Apache configuraiton file. 
+  This can be achieved in different ways, depending on the kind of VirtualHost
+  you want.
+
+  This package comes with two virtual host examples, located under
+  `/usr/share/doc/bugzilla/examples/'.
+
+  If you want a vritualhost that uses the same static files as the orginal
+  package, just use the example: `vh-basic.conf'.
+
+  If you'd rather have different static files for the virtual host, you can
+  use the other example: `vh-custom-static.conf'.
+
+  As you can see in those examples, two environment variables are provided for
+  fitting your needs:
+    - X_BUGZILLA_SITE which is the name of the virtual host, it is used to find
+      wich configuration directory to use: `/etc/bugzilla-X_BUGZILLA_SITE'.
+    - X_BUGZILLA_WEBPATH wich is the prefix to prepend to every static files in
+      the templates.
+
+  When you are ok with the apache configuration, you can restart it and
+  test your virtual host.
+
+  Take care to keep sane permissions to your /etc/bugzilla-* directories (should
+  be readable by www-data).
+
+  At this time, you can set a different database for each virtual host,
+  customize templates for another or even share the same database... Everything
+  is possible with few effort.
+
+  Thanks to Yann Dirson for the mod_env idea.
+
+-- Alexis Sukrieh <sukria@sukria.net>, Dun jun 12 14:24:24 CEST 2005

Added: trunk/bugzilla-2.18/debian/examples/vh-basic.conf
===================================================================
--- trunk/bugzilla-2.18/debian/examples/vh-basic.conf	2005-06-12 11:55:32 UTC (rev 101)
+++ trunk/bugzilla-2.18/debian/examples/vh-basic.conf	2005-06-12 12:36:59 UTC (rev 102)
@@ -0,0 +1,6 @@
+<VirtualHost bugzilla.domain.com>
+    ServerAdmin bugzilla@domain.com
+    ServerName bugzilla.domain.com
+
+    SetEnv X_BUGZILLA_SITE "basic"
+</VirtualHost>

Added: trunk/bugzilla-2.18/debian/examples/vh-custom-static.conf
===================================================================
--- trunk/bugzilla-2.18/debian/examples/vh-custom-static.conf	2005-06-12 11:55:32 UTC (rev 101)
+++ trunk/bugzilla-2.18/debian/examples/vh-custom-static.conf	2005-06-12 12:36:59 UTC (rev 102)
@@ -0,0 +1,10 @@
+<VirtualHost bugzilla.domain.com>
+    ServerAdmin bugzilla@domain.com
+    ServerName bugzilla.domain.com
+
+    DocumentRoot /var/www/bugzilla-custom
+    ScriptAlias /cgi-bin/ /var/www/bugzilla-custom/cgi-bin/
+    
+    SetEnv X_BUGZILLA_SITE "custom"
+    SetEnv X_BUGZILLA_WEBPATH "/"
+</VirtualHost>

Modified: trunk/bugzilla-2.18/debian/rules
===================================================================
--- trunk/bugzilla-2.18/debian/rules	2005-06-12 11:55:32 UTC (rev 101)
+++ trunk/bugzilla-2.18/debian/rules	2005-06-12 12:36:59 UTC (rev 102)
@@ -56,6 +56,10 @@
 	install    -m 0755 -o root -g root debian/helper/postinst-db.pl $(CURDIR)/debian/bugzilla/usr/share/bugzilla/debian/postinst-db.pl
 	install    -m 0644 -o root -g root debian/default-files/params $(CURDIR)/debian/bugzilla/usr/share/bugzilla/debian
 	install    -m 0644 -o root -g root debian/patches/101_Config.diff $(CURDIR)/debian/bugzilla/usr/share/bugzilla/debian
+
+	# Installing exemples 
+	install -d -m 0755 -o root -g root $(CURDIR)/debian/bugzilla/usr/share/doc/bugzilla/examples
+	install    -m 0644 -o root -g root debian/examples/*.conf $(CURDIR)/debian/bugzilla/usr/share/doc/bugzilla/examples
 	
 	# remove all the CVS entries in the build dir
 	find ./debian -name CVS -type d -exec rm -rf {} \;