WineHQ Application Database
#------------------------------------------------------------------------#
Authors:
    Jeremy Newman <jnewman@codeweavers.com>
    Charles Leop <charles@codeweavers.com>
    
Contributors:
    Paul van Schayck <polleke@gmail.com>
    Chris Morgan <cmorgan@alum.wpi.edu>
    Tony Lambregts <tony_lambregts@telusplanet.net>
    Jonathan Ernst <Jonathan@ErnstFamily.ch>

To install locally for testing/hacking:
#------------------------------------------------------------------------#

# Symlink from /var/www to the appdb directory

# Copy include/config.php.sample to include/config.php

# Edit include/config.php as you see fit, the default name of the database 
  used in the table creation step below is "apidb", you'll have to modify 
  these files if you change this in config.php

# cd tables, run ./create_tables to create the database tables

# Try to open up localhost/appdb, if you get a directory listing
  Edit your /etc/apache/httpd.conf "DirectoryIndex" to include index.php 
  so apache will open index.php after not finding index.html/index.htm etc

# Also ensure these options in /etc/apache/php.ini:
   register_globals 0
   short_open_tag 0
   register_long_arrays 0
   magic_quotes_gpc 0
 Or ensure your appdb directory has AllowOverride' set to 'All' inside 
 httpd.conf to let .htaccess set these settings.
 
# An AppDB admin user has been automatically created while running 
  the create_tables script
  email: admin@localhost
  password: testing
  You should change the password as soon as possible!

#------------------------------------------------------------------------#
You can either set up a real bugzilla database or a fake one 
#
# cd tables, run ./create_bugzilla_tables to create the fake bugzilla tables
#------------------------------------------------------------------------#
# or installing a real bugzilla database (hope this helps)
#
# download buzilla  (password for cvs is cvs)

cd /var/www/html
export CVSROOT=:pserver:cvs@cvs.winehq.org:/home/wine
cvs login
cvs -z 0 checkout bugzilla

# change directory to bugzilla and change the group ownership to apache.

cd bugzilla
chgrp -R apache .
chmod -R g+rX .


# change to su and run ./checksetup.pl and fix up what it finds wrong.
# this may take several runs 

su
./checksetup.pl

# in the /etc/httpd/conf/hppt.conf file find "AddHandler cgi-script .cgi" and add the following.

<Directory "/var/www/html/bugzilla">
Options ExecCGI
AllowOverride Limit
Order allow,deny
Allow from all
</Directory>

# edit local config as necessary to allow access.