Admin Guide Reference for Administrators MantisBT Development Team <[email protected]> Admin Guide: Reference for Administrators by MantisBT Development Team Abstract This book is targeted at MantisBT administrators, and documents the installation, upgrade, configuration, customization and administration tasks required to operate the software. Copyright © 2016 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). Table of Contents 1. About MantisBT ............................................................................................................. 1 What is MantisBT? ..................................................................................................... 1 Who should read this manual? ...................................................................................... 1 License ..................................................................................................................... 1 How to get it? ............................................................................................................ 1 About the Name ......................................................................................................... 1 History ...................................................................................................................... 2 Support ..................................................................................................................... 2 MantisBT News .......................................................................................................... 3 Versioning ................................................................................................................. 3 2. Installation ..................................................................................................................... 4 Overview ................................................................................................................... 4 System Requirements .................................................................................................. 4 Server Hardware Requirements ............................................................................. 4 Server Software Requirements .............................................................................. 4 Client Requirements ............................................................................................ 7 Pre-installation / upgrade tasks ...................................................................................... 7 New Installation ......................................................................................................... 8 Upgrading .................................................................................................................. 8 Configure your installation ......................................................................................... 10 Post-installation and upgrade tasks ............................................................................... 11 Post-installation tasks ................................................................................................. 11 Post-upgrade tasks ..................................................................................................... 11 Backups ................................................................................................................... 12 MySQL Backups ............................................................................................... 12 Uninstall .................................................................................................................. 13 3. User Management .......................................................................................................... 14 Creating User Accounts ............................................................................................. 14 Enabling/Disabling User Accounts ............................................................................... 14 Deleting User Accounts ............................................................................................. 15 User Signup ............................................................................................................. 15 Forgot Password and Reset Password ........................................................................... 15 Impersonating a user .................................................................................................. 16 Changing Password ................................................................................................... 16 Pruning User Accounts .............................................................................................. 16 Authorization and Access Levels ................................................................................. 16 Auto Creation of Accounts on Login ............................................................................ 17 User Preferences ....................................................................................................... 17 User Profiles ............................................................................................................ 18 4. Issue Lifecycle and Workflow ......................................................................................... 19 Issue Creation ........................................................................................................... 19 Issue Statuses ........................................................................................................... 19 Workflow ................................................................................................................ 20 Workflow Transitions ........................................................................................ 20 Workflow Thresholds ........................................................................................ 21 5. Configuration ................................................................................................................ 23 Introduction .............................................................................................................. 23 Database .................................................................................................................. 23 Path ........................................................................................................................ 24 Webserver ................................................................................................................ 25 Configuration Settings ................................................................................................ 26 iii Admin Guide Security and Cryptography ......................................................................................... 26 Signup and Lost Password .......................................................................................... 27 Email ...................................................................................................................... 28 DKIM signature ................................................................................................ 32 S/MIME signature ............................................................................................. 33 Version .................................................................................................................... 34 Language ................................................................................................................. 34 Display .................................................................................................................... 35 Time ....................................................................................................................... 37 Date ........................................................................................................................ 38 Time Zone ............................................................................................................... 38 News ....................................................................................................................... 39 Default Preferences ................................................................................................... 39 Summary ................................................................................................................. 41 Bugnote ................................................................................................................... 43 File Upload .............................................................................................................. 43 HTML ..................................................................................................................... 44 Authentication .......................................................................................................... 46 Global authentication parameters ......................................................................... 46 LDAP authentication method parameters ............................................................... 46 Status Settings .......................................................................................................... 49 Filters .....................................................................................................................