[[PageOutline(2-5,Contents,pullout)]]

= Mantis to Trac conversion script

== Description

This script allows you to import a ticket repository from Mantis to Trac.

Currently, the following data is imported from Mantis:
  * bugs
  * bug comments
  * bug activity (field changes)
  * attachments (as long as they're stored in the database)

Attachments are imported ONLY if they're stored in the database. There is no provision for migrating filesystem-based attachments. If you use the script, please read the NOTES section (at the top of the file) and make sure you adjust the config parameters for your environment.

== Bugs/Feature Requests

If you have any issues, please create a 
[https://github.com/Aeon/mantis2trac/issues new ticket] on github.

Historical bugs and feature requests for MantisImportScript are 
[report:9?COMPONENT=MantisImportScript here].

== Download

Download the zipped source from [https://github.com/Aeon/mantis2trac/zipball/master github].

== Source

You can browse the source and check out MantisImportScript from [https://github.com/Aeon/mantis2trac here] using git or subversion.

== Example

mantis2trac.py has similar parameters as the bugzilla2trac.py script:

mantis2trac - Imports a bug database from Mantis into Trac.

Usage: mantis2trac.py [options] 

Available Options:
{{{
  --db [MySQL dbname]                - Mantis database
  --tracenv /path/to/trac/env        - Full path to Trac db environment
  -h | --host [MySQL hostname]       - Mantis DNS host name
  -u | --user [MySQL username]       - Effective Mantis database user
  -p | --passwd [MySQL password]     - Mantis database user password
  -c | --clean                       - Remove current Trac tickets before importing
  --products [Product1,"Product 2"]  - List of products to import from mantis
  --help | help                      - This help info
}}}

== Author/Contributors

'''Author:''' Paul Baranowski [[BR]]
'''Contributors:''' [http://pessoal.org/ João Prado Maia], [http://github.com/Aeon codeFiend], John Lichovník