Please log in to subscribe to updates for this article
Last updated at Mon Mar 04 19:21, by zegenie
Table of contents
Error: date(): It is not safe to rely on the system's timezone settings. You are *required* to use the date.timezone setting or the date_default_timezone_set() function.
Error: preg_match() function.preg-match: Compilation failed: unrecognized character after (?< at offset
Installing or upgrading The Bug Genie ⇑ top
Fresh install ⇑ top
System requirements ⇑ topTo be installed, The Bug Genie requires the following:
- A web server, with URL rewriting capabilities
- PHP version 5.3.0 or later. PHP version 5.2.x is not supported.
- A supported database (MySQL >= 5.0 or PostgreSQL >= 8.2 ) and php modules for this database
- For statistics, the php-gd library needs to be installed
Installing ⇑ topAfter unpacking the archive into a folder, access the thebuggenie/index.php file, and the installation wizard should start automatically. This will also guide you through and explain setting up the rewrite rules.
Upgrading ⇑ top
Version 3.1 -> 3.1.x ⇑ topTo upgrade from 3.1 to the latest 3.1.x version, download the archive from the main download site. Extract the files into your current installation, overwriting existing files where prompted. When this is done, clear the contents of the B2DB cache folder (don't delete the folder, just its contents):
Version 3.0.1 -> 3.1 or 3.1.x ⇑ topTo upgrade from 3.0.1 to 3.1 / 3.1.x, download the archive from the main download site. Extract the files into your current installation, overwriting existing files where prompted. When this is done, clear the contents of the B2DB cache folder (don't delete the folder, just its contents):
core/cache/B2DBThe upgrade helper needs write access to the following two files:
./installed #This file will be altered with version information ./upgrade #This file will be deletedThe last file doesn't exist. Create it to enable upgrading, and then open up the your bug tracker with the following url, which will launch the upgrade helper:
<trackername>/upgradeWhen the upgrade helper is completed, your installation will be upgraded to version 3.1
Version 3.0 -> 3.0.1 ⇑ topTo upgrade from 3.0 to 3.0.1, download the archive from the main download site. Extract the files into your current installation, overwriting existing files where prompted. When this is done, clear the contents of the B2DB cache folder (don't delete the folder, just its contents):
Upgrading from ANY pre-release / beta / RC version -> ANY other version ⇑ topWe do not support upgrading from pre-release, beta or RC versions. Please perform a clean install of the latest stable release, or perform an upgrade from an earlier stable release if available.
Troubleshooting ⇑ top
Required database permissions for installing and using The Bug Genie? ⇑ topThe Bug Genie does not require any special database permission for normal usage, except the following:
SELECT, UPDATE, INSERT, DELETEDuring installation, however, tables are created, and as such the database user used during installation also requires the following permissions:
CREATE, ALTER, INDEXIf you want to change the database user used in normal operations, after the installation has been completed, you can do so by updating the username located in the following file:
What files should I back up when upgrading or reinstalling The Bug Genie? ⇑ topA general overview of the folder structure of The Bug Genie is available in the development section in the wiki. Worth noting is that The Bug Genie stores configuration and installation information in the following files (from project root):
This file contains version information and timestamp from when the installation took place. The file is required for The Bug Genie to run, as it is being pinged everytime The Bug Genie is initialized. The file usually contains something like this:
3.0, installed 29.04.2011 21:45After upgrade, it will contain something like this:
3.1, upgraded 30.04.2011 20:11 3.0, installed 29.04.2011 21:45/core/b2db_bootstrap.inc.php
This file contains the database connection details. Contents usually looks like this:
In addition, the apache .htaccess file is located inside the public directory:
/** * B2DB sql parameters * * @author Daniel Andre Eikeland <email@example.com> * @version 2.0 * @license http://www.opensource.org/licenses/mozilla1.1.php Mozilla Public License 1.1 (MPL 1.1) * @package B2DB * @subpackage core */ self::setUname('db_user'); self::setPasswd('password'); self::setTablePrefix('tbg3_'); self::setDSN('mysql:host=localhost;dbname=thebuggenie_db');
thebuggenie/.htaccessFor a minor performance increase you can copy this configuration to your virtual host configuration if you're using apache.
Installing The Bug Genie on IIS6 ⇑ topThe Bug Genie requires url rewriting to function. You will be able to install it without, but you will not be able to use The Bug Genie without an url rewriting module properly configured for The Bug Genie. There is a free rewrite module available from microsoft's codeplex: http://iirf.codeplex.com/ and there is also one available from a company called helicontech: http://www.helicontech.com/isapi_rewrite/
Tips and tricks about installing The Bug Genie on IIS6 can be found in this forum thread:
Error: date(): It is not safe to rely on the system's timezone settings. You are *required* to use the date.timezone setting or the date_default_timezone_set() function. ⇑ topThe Bug Genie requires php to be correctly configured - this includes configuring the default timezone. As The Bug Genie supports multiple timezones including server / user difference, this is a requirement for The Bug Genie to function properly. Please see the php documentation for how to set this up properly: http://www.php.net/manual/en/datetime.configuration.php#ini.date.timezone
Error: preg_match() function.preg-match: Compilation failed: unrecognized character after (?< at offset ⇑ topThe Bug Genie requires pcre libraries version 8 or later. This message usually occurs if the pcre libraries on your system is older than the required version. (On many CentOS and RedHat systems, the installed libraries are version 6.x) You can find your installed pcre library version by looking at the pcre section of your
To fix this error you need to upgrade your system pcre libraries to a new version, at least version 8.
Note: as of 3.1, a check is performed during installation to make sure your pcre libraries are up to date. Installation will not be possible with pcre libraries < version 8.
What is the default username and password? ⇑ topThe Bug Genie sets up one administrator and one (automatic) guest user. The Administrator user has the following username/password:
- Username: administrator
- Password: admin
Where can I download the latest version? ⇑ topThe latest stable version is always available from http://www.thebuggenie.com/get.
For details on accessing our developer version via the git repositories, see the Developer's Guide getting started guide.