Jira管理员手册（v8.8英文完整版）_jira8手册

Jira

需积分: 49 394 浏览量更新于2023-05-28 评论 1 收藏 32.99MB PDF 举报

身份认证购VIP最低享 7 折!

领优惠券(最高得80元）

资源详情

资源评论

资源推荐

Administering Jira applications 8.8

2
Contents
 Administering Jira Server 8.8 applications  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
 Jira applications and project types overview  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
 Getting started as an administrator  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11
 Setting up your instance  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
 Creating a project  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  14
 Adding new users  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
 Managing permissions  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  16
 Installing Jira applications  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  18
 Jira applications installation requirements  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
 Installing Java  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
 Supported platforms  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  24
 End of support announcements  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  28
 Evaluation installation  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  37
 Installing Jira applications on Windows  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  40
 Uninstalling Jira applications from Windows  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  44
 Installing Jira applications on Windows from Zip File  . . . . . . . . . . . . . . . . . . . . . . . . . .  45
 Installing Jira applications on Linux  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  51
 Uninstalling Jira applications from Linux  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  55
 Installing Jira applications on Linux from Archive File  . . . . . . . . . . . . . . . . . . . . . . . . . .  56
 Unattended installation  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  63
 Installing additional applications and version updates  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  65
 Troubleshooting installation  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  67
 Connecting Jira applications to a database  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  68
 Connecting Jira applications to Azure SQL  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  69
 Connecting Jira applications to PostgreSQL  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  72
 Connecting Jira applications to MySQL 5.6  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  76
 Connecting Jira applications to MySQL 5.7  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  81
 Connecting Jira applications to Oracle  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  87
 Connecting Jira applications to SQL Server 2014  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  91
 Connecting Jira applications to SQL Server 2016  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  95
 Connecting Jira applications to SQL Server 2017  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  99
 Tuning database connections  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  103
 Surviving connection closures  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  109
 Switching databases  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  111
 Encrypting database password  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  113
 Basic encryption  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  114
 Advanced encryption  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  116
 Creating your own Cipher  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  120
 Connecting Jira Data Center to Amazon Aurora  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  123
 Installing Jira Data Center  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  126
 Moving to Jira Data Center  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  130
 Running the setup wizard  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  132
 Licensing and application access  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  136
 License compatibility  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  138
 Extending Jira applications  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  140
 Integrating with development tools  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  142
 Getting started with Bitbucket and Jira Cloud  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  148
 Enable Smart Commits  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  156
 Synchronize an account  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  158
 Configure automatic team invitations  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  160
 Linking a Bitbucket or GitHub repository with Jira  . . . . . . . . . . . . . . . . . . . . . . . . .  162
 Integrating with other tools  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  168
 Listeners  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  170
 Managing webhooks  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  172
 Services  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  173
 Using AppLinks to link to other applications  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  175
 Administering projects and links across multiple applications  . . . . . . . . . . . . . . . .  178
 Integrating with collaboration tools  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  183
2

3
 Managing apps  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  187
 Upgrading Jira applications  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  188
 Reasons to upgrade  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  190
 Upgrade checklist  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  194
 Upgrade matrix  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  201
 Upgrade methods  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  216
 Creating a test environment for Jira  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  219
 Preparing for the upgrade  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  222
 Upgrading Jira (installer)  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  225
 Upgrading Jira (manual)  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  231
 Upgrading Jira Data Center (installer)  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  236
 Upgrading Jira Data Center (manual)  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  243
 Upgrading Jira Data Center with zero downtime  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  249
 Zero downtime upgrade checklist  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  252
 Upgrade task troubleshooting  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  253
 Zero downtime upgrade FAQs  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  254
 Upgrading Jira with a fallback method  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  257
 Rolling back a Jira application upgrade  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  260
 Migrating Jira applications to another server  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  261
 Migrating from Jira Cloud to Server applications  . . . . . . . . . . . . . . . . . . . . . . . . . .  265
 Getting started with Jira Data Center on AWS  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  268
 Administering Jira Data Center on AWS  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  273
 Upgrading Jira Data Center on AWS  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  275
 Getting started with Jira Data Center on Azure  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  278
 Administering Jira Software Data Center on Azure  . . . . . . . . . . . . . . . . . . . . . . . . . . .  283
 Federating Jira - managing multiple instances  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  286
 Layout and design  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  293
 Configuring the look and feel of your Jira applications  . . . . . . . . . . . . . . . . . . . . . . . . . . .  294
 Configuring an announcement banner  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  296
 Configuring the default dashboard  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  297
 Using dashboard gadgets  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  298
 Adding a gadget to the directory  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  301
 Subscribing to another application's gadgets  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  304
 Choosing a default language  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  306
 Translating Jira  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  308
 Configuring the default issue navigator  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  309
 Creating links in the application navigator  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  311
 Configuring the user default settings  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  312
 User management  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  313
 Managing users  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  314
 Create, edit, or remove a user  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  315
 Assign users to groups, project roles, and applications  . . . . . . . . . . . . . . . . . . . . . . . .  320
 Monitor a user's activity  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  322
 Manage password security  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  323
 Prevent automatic login  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  325
 SAML SSO for Jira Data Center applications  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  327
 Anonymizing users  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  330
 Retrying anonymization  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  335
 Enabling public signup and CAPTCHA  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  337
 Managing groups  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  339
 View, create, or delete a group  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  340
 Modify group membership  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  341
 Assign group access to a project role  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  342
 Manage group access to applications  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  343
 Advanced user management  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  345
 Allowing connections to Jira for user management  . . . . . . . . . . . . . . . . . . . . . . . . . . .  346
 Diagrams of possible configurations for user management  . . . . . . . . . . . . . . . . . . . . .  349
 Managing nested groups  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  356
 User management limitations and recommendations  . . . . . . . . . . . . . . . . . . . . . . . . .  359
 Configuring user directories  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  363
 Configuring the internal directory  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  366
 Connecting to an LDAP directory  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  368
 Configuring an SSL connection to Active Directory  . . . . . . . . . . . . . . . . . . . . . . . .  377
 Reducing the number of users synchronized from LDAP to JIRA applications  . . .  388
3

4
 Connecting to an internal directory with LDAP authentication  . . . . . . . . . . . . . . . . . . .  390
 Connecting to Crowd or another Jira application for user management  . . . . . . . . . . .  396
 Managing multiple directories  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  404
 Migrating users between user directories  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  406
 Synchronizing data from external directories  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  409
 Configuring projects  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  411
 Defining a project  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  412
 Editing a project key  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  417
 Changing the project key format  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  419
 Configuring issues  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  421
 Configuring built-in fields  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  424
 Defining issue type field values  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  425
 Defining priority field values  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  430
 Defining resolution field values  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  435
 Defining status field values  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  436
 Translating resolutions, priorities, statuses, and issue types  . . . . . . . . . . . . . . . . .  437
 Issue fields and statuses  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  438
 Configuring issue-level security  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  442
 Configuring permissions  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  445
 Managing global permissions  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  448
 Managing project permissions  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  452
 Customizing Jira Service Desk permissions  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  459
 Resolving Jira Service Desk permission errors  . . . . . . . . . . . . . . . . . . . . . . . . . . .  461
 Using Manage Sprints permission for advanced cases  . . . . . . . . . . . . . . . . . . . . .  464
 Sprint permissions and defined processes  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  466
 Managing project roles  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  470
 Managing project role membership  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  473
 Allowing anonymous access to your project  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  474
 Managing components  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  475
 Archiving a component  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  478
 Managing versions  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  480
 Creating release notes  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  483
 Project screens, schemes and fields  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  484
 Adding a custom field  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  486
 Configuring a custom field  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  488
 Specifying field behavior  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  493
 Associating field behavior with issue types  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  497
 Configuring renderers  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  500
 Defining a screen  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  506
 Associating a screen with an issue operation  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  509
 Associating screen and issue operation mappings with an issue type  . . . . . . . . . .  512
 Creating a notification scheme  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  515
 Optimizing custom fields  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  519
 Custom fields with global contexts  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  520
 Using the issue collector  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  522
 Advanced use of the Jira issue collector  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  526
 Working with workflows  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  536
 Managing your workflows  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  540
 Configuring workflow schemes  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  543
 Sharing your workflow  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  546
 Advanced workflow configuration  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  549
 Working in text mode  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  557
 Adding a custom event  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  560
 Configuring the initial status  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  563
 Configuring workflow triggers  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  564
 Using validators with custom fields  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  575
 Using XML to create a workflow  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  576
 Workflow properties  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  577
 Configuring Jira Service Desk approvals  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  579
 Archiving a project  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  582
 Archiving an issue  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  584
 Importing and exporting data  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  590
 Migrating from other issue trackers  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  591
 Importing data from CSV  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  592
4

5
 Commonly asked CSV questions and known issues  . . . . . . . . . . . . . . . . . . . . . . .  600
 How to import CSV data with PVCS command  . . . . . . . . . . . . . . . . . . . . . . . . . . .  601
 Importing data from Excel  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  602
 Importing data from Bitbucket  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  603
 Importing data from Github  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  604
 Importing Data from Asana  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  605
 Importing data from TFS or Visual Studio  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  606
 Importing data from Rally  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  607
 Importing data from VersionOne  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  608
 Importing data from YouTrack  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  609
 Importing data from Axosoft  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  610
 Importing data from Pivotal Tracker  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  611
 Importing data from Bugzilla  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  612
 Importing data from FogBugz On Demand  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  613
 Importing data from FogBugz for your Server  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  614
 Importing data from Trac  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  615
 Importing data from Redmine  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  616
 Importing data from BaseCamp  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  617
 Importing data from JSON  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  618
 Importing data from Mantis  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  626
 Moving or archiving individual projects  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  627
 Splitting Jira applications  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  628
 Exporting issues from Cloud to Server  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  629
 Exporting issues from Server to Cloud  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  631
 Migrating data with 3rd party apps  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  632
 Migrating data with Adaptavist  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  633
 Promoting configuration changes from staging to production  . . . . . . . . . . . . . . . .  634
 Migrating projects to another Jira instance  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  645
 Merging Jira instances  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  659
 Migrating data with Botron  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  661
 Promoting Jira configuration from development to production  . . . . . . . . . . . . . . . .  662
 Migrating Jira projects  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  672
 Consolidating multiple Jira instances  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  681
 Configuring Jira application emails  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  682
 Configuring email notifications  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  683
 Configuring an SMTP mail server to send notifications  . . . . . . . . . . . . . . . . . . . . . . . .  688
 Customizing email content  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  693
 Customizing email content (batched notifications)  . . . . . . . . . . . . . . . . . . . . . . . . .  694
 Customizing email content (separate notifications)  . . . . . . . . . . . . . . . . . . . . . . . .  697
 Adding custom fields to emails  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  699
 Adding custom fields to emails (batched notifications)  . . . . . . . . . . . . . . . . . . . . . .  700
 Creating issues and comments from email  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  706
 Configuring Jira applications to receive email from a POP or IMAP mail server  . . . . .  721
 Jira system administration  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  723
 System administration  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  724
 Finding your Server ID  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  725
 Increasing Jira application memory  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  726
 Using the database integrity checker  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  733
 Precompiling JSP pages  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  735
 Logging and profiling  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  736
 Logging email protocol details  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  739
 Log format  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  741
 Backing up data  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  743
 Automating Jira application backups  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  745
 Preventing users from accessing Jira applications during backups  . . . . . . . . . . . .  747
 Restoring data  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  748
 Restoring a project from backup  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  749
 Anonymising Jira application data  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  758
 Restoring data from an xml backup  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  760
 Restoring information from a native backup  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  762
 Search indexing  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  763
 Re-indexing after major configuration changes  . . . . . . . . . . . . . . . . . . . . . . . . . . .  766
 Using robots.txt to hide from search engines  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  767
 Control anonymous user access  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  768
5