Remerciez-le!

Remerciez @Admin pour avoir partagé cet document gratuitement, de la manière la plus simple, en partageant sur les réseaux sociaux.

MantisBT 1.3 Admin Guide Mantis Issue Tracker Administration Guide BOOK PUBLISH

MantisBT 1.3 Admin Guide Mantis Issue Tracker Administration Guide BOOK PUBLISHING TOOL Gianluca Sforna Admin Guide MantisBT 1.3 Admin Guide Mantis Issue Tracker Administration Guide Edition 1.0 Author Gianluca Sforna giallu@gmail.com Copyright © 2013 MantisBT team. This material may only be distributed subject to the terms and conditions set forth in the GNU Free Documentation License (GFDL), V1.2 or later (the latest version is presently available at http://www.gnu.org/licenses/fdl.txt). A short overview and summary of the book's subject and purpose, traditionally no more than one paragraph long. Note: the abstract will appear in the front matter of your book and will also be placed in the description field of the book's RPM spec file. iii 1. About MantisBT 1 1.1. What is MantisBT? ....................................................................................................... 1 1.2. Who should read this manual? ..................................................................................... 1 1.3. License ........................................................................................................................ 1 1.4. How to get it? .............................................................................................................. 1 1.5. About the Name ........................................................................................................... 1 1.6. History ......................................................................................................................... 2 1.7. Support ........................................................................................................................ 2 1.8. MantisBT News ............................................................................................................ 2 1.9. Versioning .................................................................................................................... 3 2. Installation 5 2.1. Overview ..................................................................................................................... 5 2.2. System Requirements .................................................................................................. 5 2.2.1. Server Hardware Requirements .......................................................................... 5 2.2.2. Server Software Requirements ........................................................................... 5 2.2.3. Client Requirements .......................................................................................... 7 2.3. Pre-installation / upgrade tasks ..................................................................................... 7 2.4. New Installation ............................................................................................................ 8 2.5. Upgrading .................................................................................................................... 9 2.6. Configure your installation ........................................................................................... 10 2.7. Post-installation and upgrade tasks ............................................................................. 10 2.8. Post-installation tasks ................................................................................................. 11 2.9. Post-upgrade tasks ..................................................................................................... 11 2.10. Backups ................................................................................................................... 12 2.10.1. MySQL Backups ............................................................................................ 12 2.11. Uninstall ................................................................................................................... 12 3. User Management 15 3.1. Creating User Accounts .............................................................................................. 15 3.2. Enabling/Disabling User Accounts ............................................................................... 15 3.3. Deleting User Accounts .............................................................................................. 16 3.4. User Signup ............................................................................................................... 16 3.5. Forgot Password and Reset Password ........................................................................ 16 3.6. Changing Password ................................................................................................... 17 3.7. Pruning User Accounts ............................................................................................... 17 3.8. Authorization and Access Levels ................................................................................. 17 3.9. Auto Creation of Accounts on Login ............................................................................ 18 3.10. User Preferences ..................................................................................................... 18 3.11. User Profiles ............................................................................................................ 19 4. Issue Lifecycle and Workflow 21 4.1. Issue Creation ............................................................................................................ 21 4.2. Issue Statuses ........................................................................................................... 21 4.3. Workflow .................................................................................................................... 22 4.3.1. Workflow Transitions ........................................................................................ 22 4.3.2. Workflow Thresholds ........................................................................................ 23 5. Configuration 27 5.1. Database ................................................................................................................... 27 5.2. Path ........................................................................................................................... 27 5.3. Webserver ................................................................................................................. 28 5.4. Configuration Settings ................................................................................................. 29 Admin Guide iv 5.5. Security and Cryptography .......................................................................................... 29 5.6. Signup and Lost Password ......................................................................................... 30 5.7. Email ......................................................................................................................... 30 5.8. Version ...................................................................................................................... 33 5.9. Language ................................................................................................................... 34 5.10. Display ..................................................................................................................... 34 5.11. Time ......................................................................................................................... 37 5.12. Date ......................................................................................................................... 37 5.13. Time Zone ............................................................................................................... 38 5.14. News ....................................................................................................................... 38 5.15. Default Preferences .................................................................................................. 38 5.16. Summary ................................................................................................................. 41 5.17. Bugnote ................................................................................................................... 42 5.18. File Upload .............................................................................................................. 42 5.19. HTML ....................................................................................................................... 44 5.20. Authentication ........................................................................................................... 45 5.20.1. Global authentication parameters .................................................................... 45 5.20.2. LDAP authentication method parameters ......................................................... 45 5.21. Status Settings ......................................................................................................... 47 5.22. Filters ....................................................................................................................... 49 5.23. Misc ......................................................................................................................... 49 5.24. Cookies .................................................................................................................... 52 5.25. Database Tables ....................................................................................................... 52 5.26. Speed Optimisation .................................................................................................. 53 5.27. Reminders ................................................................................................................ 53 5.28. Bug History .............................................................................................................. 54 5.29. Sponsorship ............................................................................................................. 54 5.30. Custom Fields .......................................................................................................... 55 5.31. My View Settings ...................................................................................................... 55 5.32. Relationship Graphs ................................................................................................. 55 5.33. Sub-Projects ............................................................................................................. 56 5.34. Field Visibility ........................................................................................................... 56 5.35. System Logging and Debugging ................................................................................ 58 5.36. Time Tracking .......................................................................................................... 61 5.37. SOAP API ................................................................................................................ 62 5.37.1. Disabling the SOAP API ................................................................................. 62 5.38. MantisTouch ............................................................................................................. 62 6. Page descriptions 65 6.1. Login page ................................................................................................................. 65 6.2. Main page .................................................................................................................. 65 6.3. View Issues page ....................................................................................................... 65 6.4. Issue View page ........................................................................................................ 66 6.5. Issue Change Status page .......................................................................................... 66 6.6. Issue Edit page .......................................................................................................... 67 6.7. My Account Page ....................................................................................................... 67 6.7.1. Preferences ..................................................................................................... 67 6.7.2. Profiles ............................................................................................................ 67 6.8. System Management Pages ....................................................................................... 67 6.8.1. Manage Users ................................................................................................. 68 6.8.2. Manage Projects Page ..................................................................................... 68 6.8.3. Manage Custom Fields .................................................................................... 68 v 6.8.4. Manage Global Profiles .................................................................................... 70 6.8.5. Manage Configuration ...................................................................................... 70 6.9. Monitor Issue ............................................................................................................. 74 6.10. Reopen Issue ........................................................................................................... 74 6.11. Delete Issue ............................................................................................................. 74 6.12. Close Issue .............................................................................................................. 74 6.13. Assign to Me ............................................................................................................ 74 6.14. Resolve Issue .......................................................................................................... 74 6.15. News Syndication ..................................................................................................... 74 7. Customizing MantisBT 77 7.1. Strings / Translations .................................................................................................. 77 7.2. Custom Fields ............................................................................................................ 78 7.2.1. Overview ......................................................................................................... 78 7.2.2. Custom Field Definition .................................................................................... 78 7.2.3. Adding/Editing Custom Fields ........................................................................... 80 7.2.4. Linking/Unlinking/Ordering Existing Custom Fields in Projects ............................. 80 7.2.5. Localizing Custom Field Names ....................................................................... 81 7.2.6. Dynamic default values .................................................................................... 81 7.2.7. Dynamic values for Enumeration Custom Fields ................................................ 82 7.3. Enumerations ............................................................................................................. 83 7.4. Email Notifications ...................................................................................................... 85 7.5. Customizing Status Values .......................................................................................... 87 7.6. Custom Functions ...................................................................................................... 89 7.6.1. Default Custom Functions ................................................................................ 89 7.6.2. Example Custom Function Override .................................................................. 91 8. Authentication 93 8.1. Standard Authentication .............................................................................................. 93 8.2. LDAP and Microsoft Active Directory ........................................................................... 93 8.3. Basic Authentication ................................................................................................... 93 8.4. HTTP Authentication ................................................................................................... 94 8.5. Deprecated authentication methods ............................................................................. 94 9. Troubleshooting 95 9.1. Application Errors ....................................................................................................... 95 9.1.1. Error 1502 - Category not found ....................................................................... 95 9.1.2. Error 2800 - Invalid form security token ............................................................. 96 10. Project Management 99 10.1. Change Log ............................................................................................................. 99 10.2. Roadmap ............................................................................................................... 101 10.3. Time Tracking ......................................................................................................... 104 10.4. Graphs ................................................................................................................... 104 10.5. Summary Page ....................................................................................................... 104 11. Contributing to MantisBT 107 11.1. Talent and Time ...................................................................................................... 107 11.2. Recommend MantisBT to Others ............................................................................. 107 11.3. Blog about MantisBT ............................................................................................... 107 11.4. Integrate with MantisBT ........................................................................................... 107 11.5. Registered in MantisBT Users Directory ................................................................... 107 11.6. Donate Money ........................................................................................................ 107 11.7. Sponsor MantisBT .................................................................................................. 108 Admin Guide vi A. Revision History 109 Index 111 Chapter 1. 1 About MantisBT 1.1. What is MantisBT? MantisBT is a web based bug tracking system that was first made available to the public in November 2000. Over time it has matured and gained a lot of popularity, and now it has become one of the most popular open source bug/issue tracking systems. MantisBT is developed in PHP, with support to multiple database backends including MySQL, MS SQL, PostgreSQL and DB2. MantisBT, as a PHP script, can run on any operating system that is supported by PHP and has support for one of the DBMSes that are supported. MantisBT is known to run fine on Windows, Linux, OS/2, Mac OS X, System i and a variety of Unix operating systems. 1.2. Who should read this manual? This manual is targeted for the person responsible for evaluating, installing and maintaing MantisBT in a company. Typically we refer to this person as the MantisBT administrator. 1.3. License MantisBT is released under the terms of GNU General Public License (GPL)1. MantisBT is free to use and modify. It is free to redistribute as long as you abide by the distribution terms of the GPL2. 1.4. How to get it? MantisBT is available in several Linux distributions including: Debian, Ubuntu, Fedora, Gentoo, Frugalware and others. Hence, if you are running Linux, start by checking if your distribution has a package for MantisBT. If not, or if the package is not up-to-date with the latest MantisBT version, then you may want to download it directly from here3. For Windows, Mac OS X and other operating systems, use the link provided above to download MantisBT. The download is compressed in tar.gz or zip format. Both formats can be unpacked using tools like 7-Zip4 (in case of Windows). Note that at any point in time there are typically two "latest" MantisBT releases that are available for download. The latest production release (stable), and the latest development release which can be an alpha or a release candidate. It is not recommended to use development releases in production specially if it is still in the alpha stage unless the administrator is familiar with PHP and is able to troubleshoot and fix any issues that may arise. 1.5. About the Name When initially seeking to name this project Ken ran into a problem every programmer encounters. What is a good name? It has to be descriptive, unique, and not too verbose. Additionally having multiple meanings would be a nice touch. Quickly ruled out were php*Something* names which, incidentally, although popular, do not seem to be condoned by the PHP Group developers. Drawing 1 http://www.gnu.org/copyleft/gpl.html 2 http://www.gnu.org/copyleft/gpl.html 3 http://www.mantisbt.org/download.php 4 http://www.7-zip.org/ Chapter 1. About MantisBT 2 inspiration from Open Source projects like Apache, Mozilla, Gnome, and so forth resulted in two eventual choices: Dragonfly and Mantis. Dragonfly was already the name of a webmail package. So the name became Mantis. Praying Mantis are insects that feed primarily on other insects and bugs. They are extremely desirable in agriculture as they devour insects that feed on crops. They are also extremely elegant looking creatures. So, we have a name that is fairly distinctive and descriptive in multiple ways. The BT suffix stands for "Bug Tracker" and distinguishes this project from general usage of the word Mantis. However, over time the project was typically referred to as Mantis. 1.6. History Kenzaburo Ito and a friend originally created a bug tracker as an internal tool for their pet project. A search for good, free packages came up with nothing suitable so uploads/s3/ admin-guide 2 .pdf