Installation
Last Modified: February 26, 2006 09:02AM
|
|
(This installation process has changed with release 1.0.0.)
|
Description
Following are a new Mantis installation:
- Download Mantis
- Go through Mantis Configuration and set the database options + whatever options where you need to override the default values.
- Test your configuration through the admin folder
- Create a new administrator account and remove the standard user 'administrator'
Following are the steps to upgrade a Mantis installation:
See Upgrading.
The following details the basic steps for installation on any system. The
instructions may seem unix-centric but should work fine on Windows systems.
Barring complications, it should take you about 10-20 minutes to install,
configure, and be using Mantis.
Summary
- Tranfer files
- Uncompress files
- Generate database tables
- Edit configuration file, if needed
- PHP File extensions
- Login
- Add projects and users
Details for older versions of Mantis are here.
Details for New Installations of v1.0.0a2 or later
- First, transfer the file to your webserver using whatever method you like
best (ftp, scp, etc). You will need to telnet/ssh into the server machine for
the next steps.
- 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 handle
decompression 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 users
substitute the "ren" command or use explorer).
mv <directoryname> mantis
- Next we will create the necessary database tables and a basic configuration
file.
From your web server, access http://yoursite/mantis/admin/install.php
This page will walk through the following steps:
- check basic parameters for the web server
- prompt for the database type and location, and a database user/password
pair. For installiion, an administrative user/password pair can also be
provided. The operating user requires SELECT, INSERT, UPDATE, and DELETE
privileges. For installation, INDEX, CREATE, ALTER, and DROP privileges are
also required.
- 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.
- write a basic "config_inc.php file to define the database.
- perform some post installation checks on the system.
- The next part involves configuring the installation to work with your
specific setup.
Open the file in an editor and add anyother values that are required. There are
many more that you can use to customize your Mantis installation. See
Configuration 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_globals
incorrectly. Create a page with this line in it: <? phpinfo() ?>, save it
with a .php extension and load it up in your web browser. It will, among a
multitude of other things, have the correct value of register_globals that you
are using.
- Mantis now uses only .php files.
If your webserver is configured for other extensions (.PHP3, .PHTML) then you
will have to have the administrator add support for .PHP files. This should
be a trivial modification.
Documentation can be found at: http://www.php.net/manual/en/installation.php
- Login to your bugtracker and go to the manage section. Click on the
projects link. You will need to ADD a new project. Then EDIT the new project
and remember to ADD at least one category. Otherwise you won't be able to add
any bug reports.
That should be it. You're off and running.
Details for New Installations of v1.0.0a1 or earlier
- First, transfer the file to your webserver using whatever method you like
best (ftp, scp, etc). You will need to telnet/ssh into the server machine for
the next steps.
- 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 handle
decompression 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 users
substitute the "ren" command or use explorer).
mv <directoryname> mantis
- Next we will create the necessary database tables. Make sure you have
created the database ahead of time. You should know your mysql username and
password as well.
Go into the sql directory and run the following command:
mysql -u<username> -p<password> <databasename> < db_generate.sql
You could also cut and paste the sql statements from db_generate.sql into a
package like phpMyAdmin or into your terminal window.
e.g. if your username is bob, password is mypass, database name is bugtracker:
mysql -ubob -pmypass bugtracker < db_generate.sql
You may require an additional host parameter if your SQL server is on another
machine. e.g. if your server is sqlserver
mysql -h sqlserver -ubob -pmypass bugtracker < db_generate.sql
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 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.
- The next part involves configuring the installation to work with your
specific setup.
In the installation directory, locate config_inc.php.sample and copy it to
config_inc.php.
Open the file in an editor and edit the values to match your settings. The
sample file contains only essential settings. There are many more that
you can use to customize your Mantis installation. See the customization.html
file 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_globals
incorrectly. Create a page with this line in it: <? phpinfo() ?>, save it
with a .php extension and load it up in your web browser. It will, among a
multitude of other things, have the correct value of register_globals that you
are using.
- Mantis now uses only .php files.
If your webserver is configured for other extensions (.PHP3, .PHTML) then you
will have to have the administrator add support for .PHP files. This should
be a trivial modification.
Documentation can be found at: http://www.php.net/manual/en/installation.php
- Login to your bugtracker and go to the manage section. Click on the
projects link. You will need to ADD a new project. Then EDIT the new project
and remember to ADD at least one category. Otherwise you won't be able to add
any bug reports.
That should be it. You're off and running. For some help on custom editing
of the site please read the CUSTOMIZATION file.
Contents- Requirements
- Backups
- Upgrading
- CVS Integration
- Uninstall
|
User Contributed Notes
Installation |
|
| There are no user contributed notes for this page. |
| Last updated: Sun, 14 Mar 2010 - 4:22:07 |
|
|
