# Mantis Plugin This plugin integrates [Mantis Bug Tracker](http://www.mantisbt.org/) to Jenkins. Mantis is a free popular web-based bugtracking system written in PHP scripting language. This plugin decorates Hudson "Changes" HTML to create links to your Mantis issues, and update issues with private / public notes. As an example, if you committed a change with the following log message (which is configurable see Project Configuration): fix issue #410 Mantis keys in changelogs are now hyperlinked to the corresponding Mantis issue pages (complete with tooltips), ![](docs/images/changelog.png) and Mantis issues are also updated with note as following. ![](docs/images/mantis_note.png) This plugin only supports **Mantis 1.1.0 and above**. ## Configuration ### System Configuration First, you need to go to system config screen to tell Jenkins where's your Mantis. - URL - the root URL of your Mantis installation, eg. - Version - version of your Mantis installation. 1.1.X or 1.2.X(1.2.0a3 and later, this is experimental) - User Name, Password - user name and password of your Mantis installation to update relevant Mantis issues. ![](docs/images/mantis_system_config.png) ### Project Configuration In the top section, select the url of your Mantis installation. ![](docs/images/job_config_select_site.png) - %ID% is placeholder which means Mantis issue id. - Project and Category is mandatory for "File a ticket when build is broken or unstable". #### Update Mantis issue In the Post-build Actions section, choose "Updated relevant Mantis issues" (option). ![](docs/images/job_config_update_issues.png) This plugin updates Mantis issues if build is stable or unstable. #### File a ticket if build is broken or unstable In the Post-build Actions section, choose "File a ticket to Mantis" (option). ![](docs/images/job_config_add_issue.png) To Update Mantis issues, Mantis user must have at least "DEVELOPER". ## Trouble Shooting If you have ran into trouble, 1. Select New Log Recorder in System log screen. ![](docs/images/trouble_new_logrecorder.png) 2. Configure Log Recorder. Logger is "hudson.plugins.mantis", log level is "finest". and save. ![](docs/images/trouble_configure_logger.png) 3. Update Mantis issue... 4. See System log. Check SOAP request and response. ## [Use BASIC\_AUTH](https://wiki.jenkins.io/display/JENKINS/Use+BASIC_AUTH) (Workaround) ## Tips - "Array to string conversion" while try to connect to mantis([JENKINS-27077](https://issues.jenkins-ci.org/browse/JENKINS-27077)). ## Change Log ##### Version 0.26 (Feb 16, 2015) - Mantis password written in plain text in build.xml([JENKINS-26831](https://issues.jenkins-ci.org/browse/JENKINS-26831)). ##### Version 0.25 (May 31, 2013) - View state for newly created Mantis ([JENKINS-18038](https://issues.jenkins-ci.org/browse/JENKINS-18038)). ##### Version 0.24 (Apr, 30, 2012) - Do not update mantis entry for all downstream jobs ([JENKINS-11839](https://issues.jenkins-ci.org/browse/JENKINS-11839)). ##### Version 0.23 (Apr, 1, 2012) - NullPointerException when Category have value : not selected ([JENKINS-13215](https://issues.jenkins-ci.org/browse/JENKINS-13215)). ##### Version 0.22 (Mar, 12, 2012) - NullPointerException when parsing changeset of Matrix project ([JENKINS-12849](https://issues.jenkins-ci.org/browse/JENKINS-12849)). - Mantis Plugin causes Configuration Loading Overlay to not disappear ([JENKINS-13023](https://issues.jenkins-ci.org/browse/JENKINS-13023)). - added "veiyfy" button under advanced button to check credentials. - Updated wsdl. ##### Version 0.21 (Jan, 1, 2012) - enable to select a subproject for filing a ticket. ##### Version 0.20 (Oct, 5, 2011) (unstable) - File a ticket if build is broken or unstable ##### Version 0.12 (Oct 9, 2011) - updated wsdl to support Mantisbt 1.28 ##### Version 0.11 (Apr 29, 2011) - Mantis-Plugin fails again to add a note.([JENKINS-9554](https://issues.jenkins-ci.org/browse/JENKINS-9554), [JENKINS-9552](https://issues.jenkins-ci.org/browse/JENKINS-9552)) - Jenkins 1.399 or later required. - MalformedURLException if malformed url. ([JENKINS-9440](https://issues.jenkins-ci.org/browse/JENKINS-9440)) ##### Version 0.10.1 (May 2, 2010) - Fix 'update relevant mantis issue' is not saved'. ([JENKINS-6363](https://issues.jenkins-ci.org/browse/JENKINS-6363)) ##### Version 0.10 (April 4, 2010) - Support Mantis 1.2.0 ([JENKINS-6114](https://issues.jenkins-ci.org/browse/JENKINS-6114)). ##### Version 0.9 (Mar 3, 2010) - Update code for more recent Hudson. ##### Version 0.8.3 (Jul 26, 2009) - Allow empty pattern in form validation. ##### Version 0.8.2 - check if user has Job.CONFIGURE, not ADMINISTER when configuring project ([JENKINS-4077](https://issues.jenkins-ci.org/browse/JENKINS-4077)). - fixed NPE in M2 project ([JENKINS-4049](https://issues.jenkins-ci.org/browse/JENKINS-4049)). - replaced deprecated classes and methods. ##### Version 0.8.1 - Support subversion plugin. - Saved regexp pattern per build, which enables link in old history even if configuration is changed. ##### Version 0.8.0 - Regexp pattern support. ##### Version 0.7.1 - Support Mercurial changelog, which requires Mercurial Plugin 1.15. - Support Git changelog, which requires Git Plugin 0.5. - Fixed a bit. ##### Version 0.7 - Record changelog in Mantis note. ##### Version 0.6.1 - Don't change build status if failing to add note. ([JENKINS-3005](https://issues.jenkins-ci.org/browse/JENKINS-3005)). - check permission. ##### Version 0.6 - Hudson 1.281 and later required. - Supported Mantis 1.2.0a3 and later (experimental) ([JENKINS-2877](https://issues.jenkins-ci.org/browse/JENKINS-2877)). - Logged SOAP Request and Response. - Improved error diagnostics. ##### Version 0.5.2 - Use default issue id pattern if project configuration has not saved after upgrading ([JENKINS-2307](https://issues.jenkins-ci.org/browse/JENKINS-2307)). ##### Version 0.5.1 - Improved performance of hyperlink to mantis. ##### Version 0.5 - Configurable Mantis issue IDs patterns ([JENKINS-2117](https://issues.jenkins-ci.org/browse/JENKINS-2117)). - Hyperlink to mantis even if checkbox is not checked ([JENKINS-2117](https://issues.jenkins-ci.org/browse/JENKINS-2117)). ##### Version 0.4.3 - Fixed UnknownFormatConversionException ([JENKINS-2116](https://issues.jenkins-ci.org/browse/JENKINS-2116)). - Improved Japanese translation. ##### Version 0.4.2 - Added more logging for debugging. - The username and password of Mantis installation is now optional. ##### Version 0.4.1 - Fix [JENKINS-2039](https://issues.jenkins-ci.org/browse/JENKINS-2039) (Mantis plugin breaks Job Save). ##### Version 0.4 - Update mantis issue if build status is unstable. - Support unsigned server certs. ##### Version 0.3.1 - Fix JavaScript error ##### Version 0.3 - Support HTTP Basic Authentication(Not Mantis's BASIC\_AUTH) - Fix small bug ##### Version 0.2 - Remove mantisconnect-client-api.jar. ##### Version 0.1 - First version