JIRA administration 7.3

681 Pages·2017·15.34 MB·English

JIRA administration 7.3
Documentation for JIRA administration 7.3 2
Contents
Administering JIRA applications 7.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
JIRA applications and project types overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Installing JIRA applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
JIRA applications installation requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Installing Java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Supported platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
End of support announcements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Evaluation installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Installing JIRA applications on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Uninstalling JIRA applications from Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Installing JIRA applications on Windows from Zip File . . . . . . . . . . . . . . . . . . . . . . . . 31
Installing JIRA applications on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Uninstalling JIRA applications from Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Installing JIRA applications on Linux from Archive File . . . . . . . . . . . . . . . . . . . . . . . . 39
Unattended installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Installing additional applications and version updates . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Connecting JIRA applications to a database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Connecting JIRA applications to PostgreSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Connecting JIRA applications to MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Connecting JIRA applications to Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Connecting JIRA applications to SQL Server 2012 . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Connecting JIRA applications to SQL Server 2014 . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Tuning database connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Surviving connection closures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Switching databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Installing JIRA Data Center . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Running the setup wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Licensing and application access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
License compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Extending JIRA applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Using AppLinks to link to other applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Administering projects and links across multiple applications . . . . . . . . . . . . . . . . 94
Managing add-ons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Integrating with development tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Synchronize an account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Configure automatic team invitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Linking a Bitbucket or GitHub repository with JIRA . . . . . . . . . . . . . . . . . . . . . . . . 103
Enable Smart Commits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Getting started with Bitbucket and JIRA Cloud . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Integrating with other tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Listeners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Managing webhooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Integrating with collaboration tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Upgrading JIRA applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Upgrading JIRA applications manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Upgrading JIRA applications with a fallback method . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Upgrading JIRA applications using a rapid upgrade method . . . . . . . . . . . . . . . . . . . . 138
Skipping major versions when upgrading JIRA applications . . . . . . . . . . . . . . . . . . . . 148
Rolling back a JIRA application upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Migrating JIRA applications to another server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Migrating from JIRA Cloud to Server applications . . . . . . . . . . . . . . . . . . . . . . . . . 155
Establishing staging server environments for JIRA applications . . . . . . . . . . . . . . . . . 158
Managing zero downtime upgrades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Restricted functions in JIRA Cloud applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Getting started with JIRA Data Center on AWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Created in 2017 by Atlassian. Licensed under a Creative Commons Attribution 2.5 Australia License.
Documentation for JIRA administration 7.3 3
Running JIRA Data Center in AWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Recommendations for running JIRA Software Data Center in AWS . . . . . . . . . . . . . . 174
Layout and design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Configuring the look and feel of your JIRA applications . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Configuring an announcement banner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
Configuring the default dashboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
Using dashboard gadgets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
Adding a gadget to the directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Subscribing to another application's gadgets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
Choosing a default language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Translating JIRA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Configuring the default issue navigator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Creating links in the application navigator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Configuring the user default settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
User management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
Managing users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Create, edit, or remove a user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Assign users to groups, project roles, and applications . . . . . . . . . . . . . . . . . . . . . . . . 199
Monitor a user's activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
Manage password security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
Prevent automatic login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
SAML SSO for JIRA Data Center applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
Enabling public signup and CAPTCHA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
Managing groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
View, create, or delete a group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Modify group membership . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Assign group access to a project role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Manage group access to applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Advanced user management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Allowing connections to JIRA for user management . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Diagrams of possible configurations for user management . . . . . . . . . . . . . . . . . . . . . 215
Managing nested groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
User management limitations and recommendations . . . . . . . . . . . . . . . . . . . . . . . . . 225
Configuring user directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Configuring the internal directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Connecting to an LDAP directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
Configuring an SSL connection to Active Directory . . . . . . . . . . . . . . . . . . . . . . . . 241
Reducing the number of users synchronized from LDAP to JIRA applications . . . 251
Connecting to an internal directory with LDAP authentication . . . . . . . . . . . . . . . . . . . 251
Connecting to Crowd or another JIRA application for user management . . . . . . . . . . 257
Managing multiple directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Migrating users between user directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Synchronizing data from external directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Configuring projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
Defining a project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Editing a project key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
Changing the project key format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Configuring issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Configuring built-in fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
Defining issue type field values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
Defining priority field values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
Defining resolution field values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
Defining status field values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Translating resolutions, priorities, statuses, and issue types . . . . . . . . . . . . . . . . . 287
Issue fields and statuses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
Configuring issue-level security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
Configuring permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
Managing global permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Managing project permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
Customizing JIRA Service Desk permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
Resolving JIRA Service Desk permission errors . . . . . . . . . . . . . . . . . . . . . . . . . . 306
Using Manage Sprints permission for advanced cases . . . . . . . . . . . . . . . . . . . . . 308
Created in 2017 by Atlassian. Licensed under a Creative Commons Attribution 2.5 Australia License.
Documentation for JIRA administration 7.3 4
Managing project roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
Managing project role membership . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
Allowing anonymous access to your project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
Managing components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
Managing versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
Creating release notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
Project screens, schemes and fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
Adding a custom field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
Configuring a custom field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
Specifying field behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
Associating field behavior with issue types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
Configuring renderers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
Defining a screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
Associating a screen with an issue operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
Associating screen and issue operation mappings with an issue type . . . . . . . . . . 340
Creating a notification scheme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
Using the issue collector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
Advanced use of the JIRA issue collector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
Working with workflows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
Managing your workflows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
Configuring workflow schemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
Sharing your workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Advanced workflow configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
Working in text mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
Adding a custom event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
Configuring the initial status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
Configuring workflow triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
Using validators with custom fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
Using XML to create a workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
Workflow properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Configuring JIRA Service Desk approvals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
Importing and exporting data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
Migrating from other issue trackers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
Importing data from CSV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
Commonly asked CSV questions and known issues . . . . . . . . . . . . . . . . . . . . . . . 412
How to import CSV data with PVCS command . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
Importing data from Excel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
Importing data from Bitbucket . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
Importing data from Github . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
Importing Data from Asana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
Importing data from TFS or Visual Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
Importing data from Rally . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
Importing data from VersionOne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
Importing data from YouTrack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
Importing data from Axosoft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
Importing data from Pivotal Tracker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
Importing data from Bugzilla . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
Importing data from FogBugz On Demand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
Importing data from FogBugz for your Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
Importing data from Trac . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
Importing data from Redmine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
Importing data from BaseCamp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
Importing data from JSON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
Importing data from Mantis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
Moving or archiving individual projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
Archiving a project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
Splitting JIRA applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
Exporting issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
Importing issues from JIRA server applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
Configuring JIRA application emails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
Configuring email notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
Configuring JIRA's SMTP mail server to send notifications . . . . . . . . . . . . . . . . . . . . . 466
Created in 2017 by Atlassian. Licensed under a Creative Commons Attribution 2.5 Australia License.
Documentation for JIRA administration 7.3 5
Customizing email content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
Creating issues and comments from email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
Configuring JIRA applications to receive email from a POP or IMAP mail server . . . . 486
JIRA system administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487
System administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
Finding your Server ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
Increasing JIRA application memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
Using the database integrity checker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494
Precompiling JSP pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
Logging and profiling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496
Logging email protocol details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499
Backing up data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
Automating JIRA application backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
Preventing users from accessing JIRA applications during backups . . . . . . . . . . . 505
Restoring data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506
Restoring a project from backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506
Anonymising JIRA application data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
Restoring data from an xml backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
Restoring information from a native backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
Search indexing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519
Re-indexing after major configuration changes . . . . . . . . . . . . . . . . . . . . . . . . . . . 521
Using robots.txt to hide from search engines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522
Licensing your JIRA applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523
Viewing your system information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525
Monitoring database connection usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529
Viewing JIRA application instrumentation statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
Generating a thread dump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
Finding your JIRA application Support Entitlement Number (SEN) . . . . . . . . . . . . . . . 541
Auditing in JIRA applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
Important directories and files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
JIRA application installation directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547
JIRA application home directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548
Setting your JIRA application home directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550
Integrating JIRA applications with a Web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552
Integrating JIRA applications with IIS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552
Integrating JIRA with Apache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
Securing JIRA applications with Apache HTTP Server . . . . . . . . . . . . . . . . . . . . . . . . 578
Using Apache to limit access to the JIRA administration interface . . . . . . . . . . . . 578
Using Fail2Ban to limit login attempts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593
Changing JIRA application TCP ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595
Connecting to SSL services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
Running JIRA applications over SSL or HTTPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601
Configuring security in the external environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614
Data collection policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
JIRA Admin Helper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
Raising support requests as an administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618
Start and Stop JIRA applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620
Configuring global settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623
Configuring time tracking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623
Configuring JIRA application options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 626
Configuring advanced settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629
Configuring the Base URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630
Setting properties and options on startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631
Recognized system properties for JIRA applications . . . . . . . . . . . . . . . . . . . . . . . 638
Advanced JIRA application configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639
Changing the constraints on historical time parameters in gadgets . . . . . . . . . . . . 641
Changing the default order for comments from ascending to descending . . . . . . . 641
Limiting the number of issues returned from a search view such as an RSS feed 641
Configuring file attachments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 643
Configuring issue linking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646
Configuring issue cloning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649
Configuring the whitelist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 650
Created in 2017 by Atlassian. Licensed under a Creative Commons Attribution 2.5 Australia License.
Documentation for JIRA administration 7.3 6
Configuring sub-tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 651
Managing shared filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653
Managing shared dashboards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 655
Enabling logout confirmation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 656
Rich text editing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657
Server optimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658
Configuring secure administrator sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658
Performance testing scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659
JIRA application cookies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667
Preventing security attacks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 668
Using the JIRA application configuration tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670
Running JIRA applications as a Windows service . . . . . . . . . . . . . . . . . . . . . . . . . . . . 674
Getting help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 680
Created in 2017 by Atlassian. Licensed under a Creative Commons Attribution 2.5 Australia License.
Documentation for JIRA administration 7.3 7
Administering JIRA applications 7.3
For JIRA application administrators
The JIRA Application Admin documentation is your one stop shop for administering all of your JIRA
applications, from JIRA Core to JIRA Software and JIRA Service Desk. This space will help you get
acquainted with the tools and techniques for administering your JIRA applications, projects and users.
If you're looking for information specific to a particular JIRA Application, select it below to visit the
documentation.

Getting started How to Users and groups
Installing JIRA Applications Define a project Managing users
Licensing and application access Configure issues Managing application access
Customize your JIRA Apps
Integrations User documentation Support and reference
info
Integrate development tools JIRA Software
Integrate collaboration tools JIRA Service Desk Release notes
Integrate using other tools JIRA Core Knowledge base

Created in 2017 by Atlassian. Licensed under a Creative Commons Attribution 2.5 Australia License.
Documentation for JIRA administration 7.3 8
JIRA applications and project types overview
The JIRA family of applications are built to deliver a tailored experience to their user. JIRA Core is the default
application of JIRA, and will always be present in a JIRA instance. You may also choose to include other
applications in your instance, such as JIRA Software or JIRA Service Desk. A user may require access to one,
all, or any combination of these applications.
Note that as JIRA Core is the default application, if you have a license for JIRA Software or JIRA Service Desk,
your users automatically have access to JIRA Core without requiring an additional license. For example, a JIRA
Software user can view development information on an agile board, and can also view business projects.
Application features and project types
Each application delivers a tailored experience for its users, and has an associated project type, which in turn,
offers application-specific features. Below is a list of the project types, and their associated application-specific
features.
Application Project type Application-specific feature set
JIRA Core Available to all licensed users of JIRA
Business projects
JIRA Software Integration with development tools
Agile boards
Release hub for software version release
Software projects
Created in 2017 by Atlassian. Licensed under a Creative Commons Attribution 2.5 Australia License.
Documentation for JIRA administration 7.3 9
JIRA Service Service Level Agreements (SLAs)
Desk A customizable web portal for customers
Permission schemes allowing customer
access
Service Desk projects
Application features and users
All users that can log in to a JIRA instance will be able to see all the projects in that instance (pending
permissions), but they will only be able to see the application-specific features when they have application
access. For example, a Software project is able to display information from linked development applications,
such as Bitbucket and FishEye on a Software project, and you can create agile boards, but this information is
only viewable by a JIRA Software user. A JIRA Core user would be able to see the Software project, but would
not be able to see the application-specific features, like agile boards or development information. Likewise,
a JIRA Software user would not be able to see any JIRA Service Desk application-specific features on a Service
Desk project — only a basic view of the project and its issues.
Only a JIRA administrator can create a project for an installed application. They do not need
application access to create the project, but they do need application access if they'd like to view
or use the project.
Anonymous users will have access equivalent to JIRA Core users. In other words, they can view
issues and work in any type of project, but they won't see application-specific features, e.g. agile
boards, which are JIRA Software-specific features. To know how to allow anonymous users
access to projects, see Allowing anonymous access to your instance.

A list of the applications, their default user groups, and their project's application-specific features is listed below:
JIRA Core JIRA Software JIRA Service Desk
jira-core-user jira-software-user jira-servicedesk-agent
Business Project View
Projects level
Issue level Create
View
Comment
Transition
JIRA View
Gadgets
Software Project View
Projects level
Issue level Create
Created in 2017 by Atlassian. Licensed under a Creative Commons Attribution 2.5 Australia License.
Documentation for JIRA administration 7.3 10
View
Comment
Transition
View
development
information
View release
information
Board Create
level
View
JIRA View
Software
gadgets
Service Desk Project View
Projects level
Issue level Create
View
Comment
Transition
SLA level Create
View
Queue Create
level
View
JIRA View
Service
Desk
gadgets
Installing JIRA applications
Use these installation pages if you need to install a JIRA application, or add an additional JIRA application to
your existing JIRA installation. If you are upgrading please refer to the Upgrade Guide. It's important to review
the supported platforms and JIRA applications installation requirements pages for more information on what
you'll need to run a JIRA application.
Installing a JIRA application
Follow the instructions for your operating system:
Installing JIRA applications on Windows
Installing JIRA applications on Linux
Installing an additional JIRA application
Once you have installed your initial JIRA application, it's possible to install additional applications directly through
the Versions and licenses page.
Created in 2017 by Atlassian. Licensed under a Creative Commons Attribution 2.5 Australia License.