= Fedora specific installation notes =

== Database ==

Mantis requires a database to function; use the following steps to
configure mantis to work with MySQL:

1. install MySQL packages
    yum install mysql-server php-mysql

2. start MySQL server 
    service mysqld start

WARNING: the default MySQL configuration has a "root" account with no password.
         Please have a look to the MySQL documentation to add a proper password
         and/or a separate account for mantis usage.


== Configuration files ==

The mantis configuration file is /etc/mantis/config_inc.php.

Be sure to check the file /usr/share/mantis/config_defaults_inc.php for the 
full list of available configuration options.


== First time operations ==

1. allow yourelf to access the admin directory
    Please note that the provided configuration file for Apache 
    (/etc/httpd/conf.d/mantis.conf) by default prevents access to the mantis
    administration area. 
    Find the section:
        <Directory /usr/share/mantis/admin>

    and change the "None" in:
        Allow from None
    
    to the machine IP you will be connecting from. For instance:
        Allow from 127.0.0.1

    allows localhost access to the admin area
    
    then restart apache with:
      service httpd restart

2. point your browser to:
      https://localhost/mantis/admin/install.php
   to create an empty DB.

BIG FAT WARNING: when you are done with the installation, be sure to revert the 
         modifications you've done in step 1.
         Otherwise you will leave the administration area unprotected with
         critical system information and database update capabilities open to 
         any unauthorized person.

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. REMEMBER: After setting up the package, REMOVE the
         default administrator account.

== Upgrades ==

After a version upgrade that involves changes to the DB schema, you will need
to run again the installer steps as outlined above. The installer is able to
recognize which modifications are needed and apply them to the DB.

Albeit the upgrade routine is usually well tested and safe, please 
consider doing a complete backup of the database before attempting the
procedure.


== SELinux ==

The default SELinux configuration prevents the httpd process (hence mantis)
from sending emails. This is easily fixed with:

    setsebool -P httpd_can_sendmail=1