[FishEye Knowledge Base]
JIRA is Atlassian's issue-tracking and project-management application. You can connect FishEye to JIRA for one or both of the following:
Configuring those two aspects are separate processes, and are described on this page. Note that you can link FishEye with one or more instances of JIRA. If you're linking FishEye to an Atlassian Cloud JIRA instance, please see Linking to server applications from your cloud instance.
Your user tiers don't need to match between JIRA and FishEye/Crucible in order to integrate them. JIRA users that are not FishEye users will see the same view as FishEye users within JIRA, but will not be able to log in to FishEye to view the source/reviews.
You should check that the instances of JIRA that you wish to link to FishEye are configured to accept remote API calls; in each JIRA instance, go to Administration > System > General Configuration and turn on Accept remote API calls (under 'Options'). A restart is not required. See JIRA options for more details.
When you are installing FishEye, the setup wizard allows you to configure the JIRA connection automatically. This is a quick way of setting up integration with JIRA for user management. See Configuring JIRA integration in the Setup Wizard.
If you did not set up JIRA integration during FishEye setup at install time, you can still configure that from the FishEye administration area as described below.
See JIRA Integration in FishEye for an overview of the benefits you get when FishEye and JIRA are integrated.
Integrating FishEye with JIRA relies on configuring an application link between the FishEye and JIRA servers. See Linking to another application for guidance on doing that.
See also Enabling Smart Commits.
This option requires JIRA 4.3 and later.
If you want to manage your FishEye users using JIRA, you need to configure a connection in JIRA and then set up the user directory in FishEye. Both steps are described below.
2.1. To configure a new connection for user management in JIRA:
192.168.10.1/16. For more information, see the introduction to CIDR notation on Wikipedia and RFC 4632.
2.2. To set up the JIRA user directory in FishEye:
Make the following settings:
|Authenticate against||Select a JIRA instance|
|Application name and password||Enter the values that you defined for your application in the settings on JIRA.|
The web address of your JIRA server. Examples:
|Auto-add||Select Create a FishEye user on successful login so that your JIRA users will be automatically added as a FishEye user when they first log in.|
|Periodically synchronise users with JIRA||Select Yes to ensure that JIRA will synchronize all changes in the user information on a regular basis. Change the value for Synchronise Period if required.|
|When Synchronisation Happens||Select an option depending on whether you want to allow changes to user attributes from within FishEye.|
|Single Sign On||Select Disabled. SSO is not available when using JIRA for user management and if enabled will make the integration fail.|
We do not recommend the use of project links with FishEye 2.9 and later, if you have JIRA 5.0 or later as well as the latest version of the JIRA FishEye Plugin. This is because application links now provide all of the functionality previously available with project links. However, project links are retained for the following reasons:
config.xml in your FishEye/Crucible data directory.
context attribute to the