New Installations

  1. First, transfer the file to your webserver using whatever method you likebest (ftp, scp, etc). You will need to telnet/ssh into the server machine forthe next steps.

  2. Next, untar/gunzip it to the directory that you want.The usual command is (1 step): tar zxvf <filename.tar.gz> OR (2 steps): gunzip <filename.tar.gz> tar xvf <filename.tar> Winzip, Stuffit, and other programs should also be able to handledecompression of the archive.At this point you may want to rename the directory to something simpler like'mantis'. You will use the mv command to rename a directory (Windows userssubstitute the "ren" command or use explorer). mv <directoryname> mantis

  3. Next we will create the necessary database tables and a basic configurationfile.From your web server, access http://yoursite/mantis/admin/install.phpThis page will walk through the following steps:

    1. check basic parameters for the web server

    2. prompt for the database type and location, and a database user/passwordpair. For installiion, an administrative user/password pair can also beprovided. The operating user requires SELECT, INSERT, UPDATE, and DELETEprivileges. For installation, INDEX, CREATE, ALTER, and DROP privileges arealso required.

    3. create the database and tables. WARNING: A DEFAULT ADMINISTRATOR level account is created. The account name and password are administrator / root. Use this when you first login to Mantis. Immediately go to Manage and create at least one administrator level account. Immediately after that DISABLE or DELETE the administrator account. You can recreate it but you should delete the account to prevent the cookie_string from being used to trick the package. It would be even better to rename the account or delete it permanently. REMEMBER: After setting up the package, REMOVE the default administrator account.

    4. write a basic "config_inc.php file to define the database.

    5. perform some post installation checks on the system.

  4. The next part involves configuring the installation to work with yourspecific setup.Open the file in an editor and add anyother values that are required. There aremany more that you can use to customize your Mantis installation. SeeConfiguration for in depth explanations.The file will overwrite the default values with those necessary for setup.You can load up admin/check.php to see if you set things up correctly. NOTE: check.php sometimes reports the value of register_globalsincorrectly. Create a page with this line in it: <? phpinfo() ?>, save itwith a .php extension and load it up in your web browser. It will, among amultitude of other things, have the correct value of register_globals that youare using.

  5. Mantis now uses only .php files.If your webserver is configured for other extensions (.PHP3, .PHTML) then youwill have to have the administrator add support for .PHP files. This shouldbe a trivial modification.Documentation can be found at: http://www.php.net/manual/en/installation.php

  6. Login to your bugtracker and go to the manage section. Click on theprojects link. You will need to ADD a new project. Then EDIT the new projectand remember to ADD at least one category. Otherwise you won't be able to addany bug reports.That should be it. You're off and running.