Mantis Bug Tracker Administration Guide
Mantis Bug Tracker Administration Guide
Copyright © 2010 The MantisBT Team
Reference manual for the Mantis Bug Tracker.
Build Date: 23 April 2010
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Table of Contents
1. About MantisBT .........................................................................................................................1
What is MantisBT?.................................................................................................................1
Who should read this manual?............................................................................................1
License .....................................................................................................................................1
Minimum Requirements.......................................................................................................1
How to get it? .........................................................................................................................1
About the Name.....................................................................................................................2
History.....................................................................................................................................2
Support....................................................................................................................................2
MantisBT News......................................................................................................................3
Versioning ...............................................................................................................................3
2. Installation...................................................................................................................................5
Summary.................................................................................................................................5
New Installations ...................................................................................................................5
Requirements..........................................................................................................................6
Backups ...................................................................................................................................6
Uninstall ..................................................................................................................................7
3. User Management ......................................................................................................................8
Creating User Accounts ........................................................................................................8
Enabling/Disabling User Accounts ....................................................................................8
Deleting User Accounts ........................................................................................................9
User Signup ............................................................................................................................9
Forgot Password and Reset Password................................................................................9
Changing Password...............................................................................................................9
Pruning User Accounts.......................................................................................................10
Authorization and Access Levels ......................................................................................10
Auto Creation of Accounts on Login ................................................................................11
User Preferences...................................................................................................................11
User Profiles..........................................................................................................................12
4. Issue Lifecycle and Workflow ................................................................................................13
Issue Creation.......................................................................................................................13
Issue Statuses........................................................................................................................13
Workflow...............................................................................................................................14
Workflow Transitions.................................................................................................14
Workflow Thresholds ................................................................................................14
5. Configuration ............................................................................................................................17
Database ................................................................................................................................17
Path ........................................................................................................................................17
Webserver..............................................................................................................................18
Configuration Settings ........................................................................................................18
Signup and Lost Password.................................................................................................18
Email......................................................................................................................................19
Version ...................................................................................................................................22
Language...............................................................................................................................22
Display...................................................................................................................................22
Time .......................................................................................................................................25
Date........................................................................................................................................25
News ......................................................................................................................................26
Default Preferences..............................................................................................................26
Summary...............................................................................................................................28
Bugnote .................................................................................................................................29
File Upload............................................................................................................................29
HTML ....................................................................................................................................31
Authentication......................................................................................................................31
Status Settings ......................................................................................................................33
Filters .....................................................................................................................................35
iii
Misc........................................................................................................................................35
Cookies ..................................................................................................................................37
Database Tables....................................................................................................................38
Speed Optimisation .............................................................................................................38
Reminders .............................................................................................................................39
Bug History...........................................................................................................................39
Sponsorship ..........................................................................................................................40
Source Control Integration .................................................................................................40
Custom Fields.......................................................................................................................41
My View Settings .................................................................................................................41
Relationship Graphs............................................................................................................41
Sub-Projects...........................................................................................................................42
Field Visibility ......................................................................................................................43
System Logging....................................................................................................................44
6. Page descriptions......................................................................................................................45
Login page ............................................................................................................................45
Main page .............................................................................................................................45
View Issues page ..................................................................................................................45
Issue View page....................................................................................................................46
Issue Change Status page ...................................................................................................46
Issue Edit page .....................................................................................................................47
My Account Page.................................................................................................................47
Preferences ..................................................................................................................47
Profiles .........................................................................................................................47
System Management Pages................................................................................................47
Manage Users .............................................................................................................47
Manage Projects Page ................................................................................................48
Manage Custom Fields..............................................................................................48
Manage Global Profiles .............................................................................................50
Manage Configuration ..............................................................................................50
Monitor Issue........................................................................................................................53
Reopen Issue.........................................................................................................................54
Delete Issue...........................................................................................................................54
Close Issue ............................................................................................................................54
Assign to Me.........................................................................................................................54
Resolve Issue ........................................................................................................................54
News Syndication ................................................................................................................54
7. Customizing MantisBT ...........................................................................................................55
Custom Fields.......................................................................................................................55
Overview .....................................................................................................................55
Custom Field Definition............................................................................................55
Adding/Editing Custom Fields...............................................................................56
Linking/Unlinking/Ordering Existing Custom Fields in Projects ....................57
Localizing Custom Field Names..............................................................................57
Dynamic default values.............................................................................................58
Dynamic values for Enumeration Custom Fields .................................................58
Enumerations .......................................................................................................................60
Email Notifications ..............................................................................................................61
Customizing Status Values.................................................................................................62
Custom Functions................................................................................................................63
Defined Functions ......................................................................................................64
Example Custom Function .......................................................................................64
8. Authentication ..........................................................................................................................66
Standard Authentication.....................................................................................................66
HTTP_AUTH........................................................................................................................66
BASIC_AUTH ......................................................................................................................66
LDAP .....................................................................................................................................66
Microsoft Active Directory .................................................................................................67
iv
9. Project Management ................................................................................................................68
Change Log...........................................................................................................................68
Roadmap ...............................................................................................................................69
Time Tracking .......................................................................................................................71
Graphs ...................................................................................................................................72
Summary Page .....................................................................................................................72
10. Contributing to MantisBT ....................................................................................................73
Talent and Time....................................................................................................................73
Recommend MantisBT to Others ......................................................................................73
Blog about MantisBT...........................................................................................................73
Integrate with MantisBT .....................................................................................................73
Registered in MantisBT Users Directory ..........................................................................73
Donate Money ......................................................................................................................73
Sponsor MantisBT................................................................................................................73
Colophon........................................................................................................................................75
v