README

   1 WineHQ Application Database
   2 #------------------------------------------------------------------------#
   3 Authors:
   4     Jeremy Newman <jnewman@codeweavers.com>
   5     Charles Leop <charles@codeweavers.com>
   6
   7 Contributors:
   8     Paul van Schayck <polleke@gmail.com>
   9     Chris Morgan <cmorgan@alum.wpi.edu>
  10     Tony Lambregts <tony_lambregts@telusplanet.net>
  11     Jonathan Ernst <Jonathan@ErnstFamily.ch>
  12
  13 To install locally for testing/hacking:
  14 #------------------------------------------------------------------------#
  15
  16 # Symlink from /var/www to the appdb directory
  17
  18 # Copy include/config.php.sample to include/config.php
  19
  20 # Edit include/config.php as you see fit, the default name of the database
  21   used in the table creation step below is "apidb", you'll have to modify
  22   these files if you change this in config.php
  23
  24   # NOTE: You must update the APPDB_ROOT entry to be YOUR url to the application database
  25           If this the APPDB_ROOT isn't correct your urls will point to the wrong pages.
  26
  27   # NOTE: if you've changed the name of the database by changing the define of
  28     'APPS_DB' in include/config.php you'll have to modify the 'create database' and 'use'
  29     entries in pretty much every file in the /tables/ directory. The recommendation is to
  30     leave the default value of APPS_DB to keep things simple
  31
  32 # 'cd tables', run './create_tables' to create the database tables
  33
  34 # Look in include/config.php at the 'APPS_DBUSER' and 'APPS_DBPASS' defines.
  35   Ensure that this user and password exist in your mysql users list and that this user
  36   has been granted 'SELECT', 'INSERT', 'UPDATE' and 'DELETE' privileges on the database
  37   defined by the value of 'APPS_DB' in include/config.php
  38
  39 # Try to open up localhost/appdb, if you get a directory listing
  40   Edit your /etc/apache/httpd.conf "DirectoryIndex" to include index.php
  41   so apache will open index.php after not finding index.html/index.htm etc
  42
  43 # Also ensure these options in /etc/apache/php.ini:
  44    register_globals 0
  45    short_open_tag 0
  46    register_long_arrays 0
  47    magic_quotes_gpc 0
  48  Or ensure your appdb directory has AllowOverride' set to 'All' inside
  49  httpd.conf to let .htaccess set these settings.
  50
  51 # An AppDB admin user has been automatically created while running
  52   the create_tables script
  53   email: admin@localhost
  54   password: testing
  55   You should change the password as soon as possible!
  56
  57 #------------------------------------------------------------------------#
  58 You can either set up a real bugzilla database or a fake one
  59 #
  60 # cd tables, run ./create_bugzilla_tables to create the fake bugzilla tables
  61 #------------------------------------------------------------------------#
  62 # or installing a real bugzilla database (hope this helps)
  63 #
  64 # download buzilla  (password for cvs is cvs)
  65
  66 cd /var/www/html
  67 export CVSROOT=:pserver:cvs@cvs.winehq.org:/home/wine
  68 cvs login
  69 cvs -z 0 checkout bugzilla
  70
  71 # change directory to bugzilla and change the group ownership to apache.
  72
  73 cd bugzilla
  74 chgrp -R apache .
  75 chmod -R g+rX .
  76
  77
  78 # change to su and run ./checksetup.pl and fix up what it finds wrong.
  79 # this may take several runs
  80
  81 su
  82 ./checksetup.pl
  83
  84 # in the /etc/httpd/conf/hppt.conf file find "AddHandler cgi-script .cgi" and add the following.
  85
  86 <Directory "/var/www/html/bugzilla">
  87 Options ExecCGI
  88 AllowOverride Limit
  89 Order allow,deny
  90 Allow from all
  91 </Directory>
  92
  93 # edit local config as necessary to allow access.