[Sommaire] [Imprimer]

   1  -------------------------------------------------------------------------------
   2  Mantis - a php based bugtracking system
   3  Copyright (C) 2000-2002  Kenzaburo Ito - kenito@300baud.org
   4  Copyright (C) 2002-2004  Mantis Team   - mantisbt-dev@lists.sourceforge.net
   5  -------------------------------------------------------------------------------
   6  
   7  INSTALLATION
   8  
   9  The following details the basic steps for installation on any system.  The
  10  instructions may seem unix-centric but should work fine on Windows systems.
  11  
  12  Barring complications, it should take you about 10-20 minutes to install,
  13  configure, and be using Mantis.
  14  
  15  These instructions are also available at:
  16  http://manual.mantisbugtracker.com/manual.installation.php
  17  
  18  # --- Requirements ----------
  19  
  20  * MySQL 3.23.2 and higher
  21  * PHP 4.0.6 and higher
  22  * a webserver
  23  
  24  # --- Summary ---------------
  25  
  26  1. Tranfer files
  27  2. Uncompress files
  28  3. Generate database tables
  29  4. Edit configuration file
  30  5. PHP File extensions
  31  6. Login
  32  
  33  ******************************************************************************
  34  
  35  This installation process has changed with release 1.0.0.
  36  
  37  1. First, transfer the file to your webserver using whatever method you like
  38  best (ftp, scp, etc).  You will need to telnet/ssh into the server machine for
  39  the next steps.
  40  
  41  2. Next, untar/gunzip it to the directory that you want.
  42  The usual command is (1 step):
  43  
  44      tar zxvf <filename.tar.gz>
  45  
  46  OR  (2 steps):
  47  
  48      gunzip <filename.tar.gz>
  49      tar xvf <filename.tar>
  50  
  51  Winzip, Stuffit, and other programs should also be able to handle
  52  decompression of the archive.
  53  
  54  At this point you may want to rename the directory to something simpler like
  55  'mantis'.  You will use the mv command to rename a directory (Windows users
  56  substitute the "ren" command or use explorer).
  57  
  58  mv <directoryname> mantis
  59  
  60  If you are upgrading see the UPGRADING document.
  61  
  62  3. Next we will create the necessary database tables and a basic configuration
  63  file.
  64  
  65  From your web server, access http://yoursite/mantis/admin/install.php
  66  
  67  This page will walk through the following steps:
  68  a) check basic parameters for the web server
  69  b) prompt for the database type and location, and a database user/password 
  70  pair. For installiion, an administrative user/password pair can also be 
  71  provided. The operating user requires DELETE, SELECT, INSERT, and UPDATE
  72  privileges. For installation, INDEX, CREATE, ALTER, and DROP privileges are
  73  also required.
  74  c) create the database and tables.
  75  
  76  * WARNING: A DEFAULT ADMINISTRATOR level account is created.  The account name
  77  and password are administrator / root.  Use this when you first login to
  78  Mantis. Immediately go to Manage and create at least one administrator level
  79  account.  Immediately after that DISABLE or DELETE the administrator account.  
  80  You can recreate it but you should delete the account to prevent the 
  81  cookie_string from being used to trick the package.  It would be even better 
  82  to rename the account or delete it permanently.  REMEMBER: After setting up 
  83  the package, REMOVE the default administrator account.
  84  
  85  d) write a basic "config_inc.php file to define the database.
  86  e) perform some post installation checks on the system.
  87  
  88  4. The next part involves configuring the installation to work with your
  89  specific setup.
  90  
  91  Open the file in an editor and add anyother values that are required. There are 
  92  many more that you can use to customize your Mantis installation.  See the 
  93  doc/CUSTOMIZATION file for in depth explanations.
  94  
  95  The file will overwrite the default values with those necessary for setup.
  96  
  97  You can load up admin/check.php to see if you set things up correctly.
  98  
  99  *** NOTE: check.php sometimes reports the value of register_globals
 100  incorrectly.  Create a page with this line in it: <? phpinfo() ?>, save it
 101  with a .php extension and load it up in your web browser.  It will, among a
 102  multitude of other things, have the correct value of register_globals that you
 103  are using.
 104  
 105  5. Mantis now uses only .php files.
 106  
 107  If your webserver is configured for other extensions (.PHP3, .PHTML) then you
 108  will have to have the administrator add support for .PHP files.  This should
 109  be a trivial modification.
 110  
 111  Documentation can be found at: http://www.php.net/manual/en/installation.php
 112  
 113  6.  Login to your bugtracker and go to the manage section.  Click on the
 114  projects link.  You will need to ADD a new project.  Then EDIT the new project
 115  and remember to ADD at least one category.  Otherwise you won't be able to add
 116  any bug reports.
 117  
 118  That should be it.  You're off and running.  For some help on custom editing
 119  of the site please read the CUSTOMIZATION file.
 120  
 121  -------------------------------------------------------------------------------
 122  ### Upgrading ###
 123  -------------------------------------------------------------------------------
 124  
 125  See the file: UPGRADING 
 126  
 127  -------------------------------------------------------------------------------
 128  ### Troubleshooting ###
 129  -------------------------------------------------------------------------------
 130  
 131  See TROUBLESHOOTING
 132  
 133  -------------------------------------------------------------------------------
 134  ### Useful links ###
 135  -------------------------------------------------------------------------------
 136  
 137  http://www.php.net/        -  excellent documentation.
 138  http://www.phpwizard.net/  -  an excellent web front end to mysql.
 139  http://www.phpbuilder.net/ -  good help forums.
 140  http://www.mysql.com/      -  good documentation.
 141  http://www.apache.org/     -  you should be able to find what you need.