JIRA Overview and Setup

Zephyr comes with a 2-way integration to an external JIRA defect system via remote integration and connector. Currently, JIRA versions 4.0.x to 4.4.x and JIRA 5.x and 6.x are supported, either Downloaded or Cloud. While all the issues and administration of that defect tracking system continue to remain in JIRA, Zephyr reads and writes issues and pulls up metrics from that JIRA installation via APIs. There is no synchronization needed.


With this 2-way integration, a user will be able to do the following:


There are 2 steps to this process:

1. Connecting your Zephyr to JIRA: this allows you to map projects between Zephyr and JIRA, let Zephyr users login, view, file, update and search JIRA issues from with Zephyr's UI.

2. Install the Zephyr Connector in JIRA: this allows Zephyr to fetch metrics data from JIRA

Connecting your Zephyr to JIRA

In the Administration application, navigate to the Defect Tracking tab and enter the following information:





When this option is chosen, the following JIRA URL is needed:




where <your_jira_server> includes the name/IP address and the port of the JIRA server. Please do not enter the URL that is used to access JIRA directly from your browser.


(E.g. if you currently access your JIRA server with the following URL - http://jiraserver:81 - then you should enter - http://jiraserver:81/rpc/soap/jirasoapservice-v2 as the URL)


Also, a valid JIRA admin-level username/password that has access to all the projects being tracked is needed to fetch data for defect metrics. Each user in the Zephyr system will need their own JIRA username/password to File and Search for defects in their own Desktops.




Installing the Zephyr Connector

Read this section for detailed instructions.


Note: If you are using Atlassian Cloud, the Zephyr Connector plugin comes pre-installed.