= 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