Mantis Bug Tracker

From DreamHost
Jump to: navigation, search

Mantis Bug Tracker is a free, web-based bug tracking system written in PHP.

Installation

Thanks to the largely web-based installer, installing and configuring Mantis is fairly simple once you get the files properly extracted. This example will use the development version 1.2.0a2, but similar steps will work for the older/official 1.1 release if you change the file names appropriately.

  • Note that Mantis 1.2+ requires PHP 5, so you may need to configure your domain in the Dreamhost panel to use PHP 5.x under Domains, Manage Domains, find your target domain, click edit, choose PHP version 5.x and click the button at the bottom to save the settings. Wait for a few minutes for the change to kick in.
  • Configure a MySQL database in the Dreamhost panel by going to Goodies, Manage MySQL, Create a new MySQL database. Enter a domain, password, username, database name, etc. and save to create the database. Mantis will ask for the datatabase details in a moment, so make a note of them.
  • Get the latest Mantis tar.gz download from http://www.mantisbt.org/download.php and use FTP to transfer the file to your Dreamhost account, or issue a command similar to this to download the file after logging in via SSH to your account (the exact download URL can be obtained by following the links on the mantis download page):
    wget http://internap.dl.sourceforge.net/sourceforge/mantisbt/mantis-1.2.0a2.tar.gz
  • Make sure the downloaded archive file is in the root directory for your domain ("mv mantis* domain.com" and then "cd domain.com" to change to that directory)
  • Extract the mantis source code tar/gz file using a command like this:
    tar xvfz mantis-1.2.0a2.tar.gz
  • Rename the extracted mantis-1.2.0a2 directory to something simpler like just "mantis" since it will also be the directory name web surfers will use to access Mantis via a URL (http://www.domain.com/mantis/):
    mv mantis-1.2.0a2 mantis
  • Open the URL to connect to your domain with the suffix of the directory you choose (http://www.domain.com/mantis/), and Mantis will ask for the MySQL server/domain, user, password, database name, etc that you input when creating the database in the panel. Note that the database server will never be the default of "localhost". You can leave the admin user/password blank, since Mantis will use the database user you already entered. Click the install button there and Mantis configures itself and connects to and configures your database. Mantis should inform you that every thing went "Good", but may warn you about leaving the Admin fields blank.
  • Log in to the Mantis administration panel with the username "administrator" and the password "root". Be sure to IMMEDIATELY change the administrator password to something else by going to My Account, Password!
  • Back in SSH, you should delete the admin folder (for security reasons) from the Mantis installation, now that it is all configured:
    cd mantis
    rm -rf admin
  • Now you can log out of SSH and use your web browser to configure Mantis by adding projects, users, etc.

External link