Version: | 1.8 |
---|
This notes detail the MySQL backend for the Roundup issue tracker.
To use MySQL as the backend for storing roundup data, you also need to install:
Note
The InnoDB implementation has a bug that Roundup tickles. SeeRoundup tests expect an empty MySQL database. Two alternate ways to provide this:
If you have root permissions on the MySQL server, you can create the necessary database entries using the follwing SQL sequence. Use mysql on the command line to enter:
CREATE DATABASE rounduptest; USE rounduptest; GRANT ALL PRIVILEGES ON rounduptest.* TO rounduptest@localhost IDENTIFIED BY 'rounduptest'; FLUSH PRIVILEGES;
If your administrator has provided you with database connection info, you can modify MYSQL_* constants in the file test/test_db.py with the correct values.
The MySQL database should not contain any tables. Tests will not drop the database with existing data.
To initialise and use the MySQL database backend, roundup's configuration file (config.py in the tracker's home directory) should have the following entries:
MYSQL_DBHOST = 'localhost' MYSQL_DBUSER = 'rounduptest' MYSQL_DBPASSWORD = 'rounduptest' MYSQL_DBNAME = 'rounduptest' MYSQL_DATABASE = ( MYSQL_DBHOST, MYSQL_DBUSER, MYSQL_DBPASSWORD, MYSQL_DBNAME )
Fill in the first four entries with values for your local MySQL installation before running "roundup-admin initialise". Use the commands in the Running the MySQL tests to set up a database if you have privilege, or ask your local administrator if not.
If things ever get to the point where that test database is totally hosed, just:
$ su - # /etc/init.d/mysql stop # rm -rf /var/lib/mysql/rounduptest # /etc/init.d/mysql start
and all will be better (note that on some systems, mysql is spelt mysqld).