Deploying JIRA in the Enterprise - Part 1: Test environments

Deploying JIRA in the Enterprise – Part 1: the different environments

This article is the first of a series of three about managing JIRA instances inside the enterprise. This is based on resources from the Atlassian Documentation (here) as well as our knowledge as Atlassian Experts.


Setting up JIRA test environments

When we administer one or more JIRA instances, it is essential to have at least one testing environment set up (for each instance!). In most companies, we make a distinction between these different types of servers:

  • Production: the server currently installed for all users.
  • Staging: a server with an identical architecture to the production one, it allows you to test change procedures before applying them on the production server. It can also be useful to execute performance testing (for capacity planning or before a JIRA upgrade).
  • QA (Quality Assurance): this server allows anyone to test changes such as core code modification, plug-in installation, execution of a script, etc.
  • Development: server on which are tested all the specific developments made by developers (if there is any). Developers can also have a local instance on their computers.

Once these environments are set up, you need to establish a release strategy for new features or enhancements. These changes can be of different types:

  • Modification of an existing workflow: you need to define on which server the modification will need to be tested before releasing it in production. You also need to decide who is going to be in charge of this modification: the JIRA Administrator or the requester of the change (to whom you would have given temporary administration permissions).
  • Adding a new plug-in : who has the ability to install a new plug-in and on which server should they do it? Who is able to validate the release (and sometimes the purchase) of a plug-in? Etc.
  • Plug-in development: How often the new features of this plug-in released? How are these communicated to end-users?  What kind of documentation is expected? Where is the source code located? Who is doing peer reviews? What CVS tool is used?
  • JIRA upgrade: On which server is the upgrade tested? Who is able to validate the upgrade procedure? What are the communication steps for end-users?
  • Etc.

Ideally, you would need to answer all these questions before even having deployed JIRA. But don’t worry, it is never too late to establish you own release strategy.

Finally, you need to decide (and communicate about) how often you will update your environments. The more up to date your data is, the more relevant your tests will be to your production environment; but you should also keep the data long enough to allow long-term testing (e.g. impact of a plug-in growing data).

Update your JIRA test environments

To update a test server with the latest data from production, you need to follow these steps:

  1. Back up the <jira-home> folder from your production server and replace the one on your test server.
  2. Back up JIRA installation folder and replace the one on your test server.
  3. Back up your production database and import it in a newly created database.
  4. Edit <jira-home>/dbconfig.xml file to use your new database.
  5. Edit the <jira-install>/WEB-INF/classes/ file if the <jira-home> folder is located in a different place on your test server.
  6. Start your test server.
  7. Deactivate all your email servers (ingoing and outgoing).
  8. Edit the base URL of your JIRA instance.
  9. Edit the JIRA Look and Feel. Generally, we edit the color of the header to distinguish the different environments. You can also use the announcement banner for this purpose.
  10. Reconfigure Application Links if needed.

Test servers are there to secure your production environment, so do not underestimate this when deploying JIRA.

The next article of this series will concern the sizing of a JIRA instance: how can you evaluate the expected volume a year from now before having even installed the product?

Cutted Triangle

Subscribe to the Valiantys Newsletter

Registered request ! Subscribing... This is not an email An error occured

In accordance with our privacy policy, we are committed to respecting your personal data.

Contact us

Our Atlassian certified consultants will be happy to answer you.

Join us

We're building the next dream team - Are you in?

Follow us

We use cookies for the operation of our website. This is to improve its use, to personalize your experience, and to compile visitor statistics. By continuing to use this site, you consent to this policy. You can manage the settings and choose whether or not to accept certain cookies whilst browsing. For more information, see our privacy policy. Our privacy policy

Privacy settings

In order to facilitate your navigation and to provide you with the best possible service, we use cookies to improve the site to the needs of our visitors, particularly according to the number of visitors. For more information, please read our privacy policy. Our privacy policy


Google reCAPTCHA is a system designed to distinguish humans from computers, so that bots are unable to maliciously fill out forms on behalf of a human being.


Used to send data to Google Analytics about the visitor's device and behavior. Tracks the visitor across devices and marketing channels. Used by the social sharing platform AddThis to store the user's usage history of the AddThis sharing widget. Registers a unique ID that is used to generate statistical data on how the visitor uses the website.


Targeting Cookies: Targeting cookies may be set through our site by our advertising partners. They may be used by those companies to build a profile of your interests and show you relevant advertising on other sites. They are based on uniquely identifying your browser and internet device. You can turn off the use of cookies for targeted advertising here. When the button is green, targeted cookies are on. When the button is red, targeting cookies have been turned off.

Social Media Cookies: These cookies are set by a range of social media services that we have added to the site to enable you to share our content with your friends and networks. They are capable of tracking your browser across other sites and building up a profile of your interests. This may impact the content and messages you see on other websites you visit. If you do not allow these cookies you may not be able to use or see these sharing tools.