Scheduled maintenance 2023.06.01. 07:30 CET
|Importing Data from Mantis to codebeamer #12862/HEAD / v150|
Importing Data from Mantis to CodeBeamer
The Mantis Importer tool has been developed for importing bug data from existing Mantis 0.14+ Bugtracking databases into a CodeBeamer 4.2+ installation.
This tool is a stand-alone Java application which uses the CodeBeamer Web Service API to remotely connect to a CodeBeamer server. You can run the tool using a 1.4 or newer Java Runtime Environment.
Migrated Mantis Data
The following Mantis objects are migrated:
Only Mantis user profiles and preferences cannot be migrated, because CodeBeamer has a different concept.
Mapping Mantis Codes to CodeBeamer Choices
The Mantis data to be migrated is extracted directly from a Mantis database.
Unfortunately, not all required information is stored in the Mantis database.
The following available values and display text are missing:
These Mantis code to CodeBeamer choice (name plus optional code) mappings have to be provided separately in a properties file (default: mantis-choice.properties).
Restrictions on Mapping
Mantis access_level can only be mapped to the default CodeBeamer project roles:
The Mantis bug priority must be mapped to one of the predefined CodeBeamer priorities:
The Mantis bug status can be mapped to a predefined CodeBeamer status
In CodeBeamer, the estimated time to achive (ETA) is measured in explicit hours, not in a category as in Mantis. Therefore Mantis eta values must be mapped to hours.
Finding the Importer
The Mantis importer is bundled together with the Bugzilla importer in a codebeamer_importers_<release>.zip archive, that you can find in the directory
of your codebeamer installation.
To install, simply unpack the ZIP archive and then go to the mantis subdirectory.
Running the Importer
Specify the connection to the source Mantis database in the mantis-jdbc.properties file before running the import script. Set the values for the database driver, url, username and password.
Please note, that the Mantis importer distribution only includes a MySQL database driver. Drivers for other databases have to be provided by the customers themselves.
You will also have to review/set your choice field mappings in the default mantis-choice.properties file. You can also create your own custom version of this mapping file.
The source Mantis database instance and the target CodeBeamer server instance must be up and running and reachable from the host where the import script is executed.
To start the import, issue the following command:
mantis-import <service-URL> <username> <password> [choice-mapping-file]
Where <service-URL> is the URL of the target CodeBeamer server (e.g. http://www.mycompany.com/cb/remote-api), and <username> and <password> are the name and password of the CodeBeamer user who executes the import.
The 4th parameter is optional. It is the name of a custom choice mapping file to use. If not specified, mantis_choice.properties is used.
mantis-import http://localhost:8080/cb/remote-api bond 007
The import script displays status messages about the import progress on the console, and also writes a MantisImporter.log file.
This log file is helpful when you need to know the mapping of the old Mantis bug IDs to the new CodeBeamer bug IDs.
codebeamer Knowledge Base
Services by Intland Software