This page last changed on Jun 22, 2011 by smaddox.

You are embarking on stage 5 of the Atlassian Dragon Quest, a place filled with flame and serpents and dragons.
In this stage you will configure JIRA and FishEye, so that you will be able to see code commits in JIRA and see JIRA issues in FishEye.
Time estimate: This stage will take approximately 15 minutes.
On this page:
Step 1. Configure your JIRA Settings in FishEye/Crucible
During the FishEye setup wizard, you connected JIRA to FishEye/Crucible. Now you will update that application link and enable subtasks for Crucible. This is required for creating JIRA issues from Crucible reviews. You will also enable the remote API in FishEye.
- Go to your FishEye URL in your web browser, e.g. http://localhost:8060/fisheye.
- Click the downward-pointing arrow next to your username ('charlie') then click 'Administration' in the dropdown menu.
- Click 'Application Links' in the left-hand panel.
- The 'Configure Application Links' screen will appear, showing a connection to your JIRA server. Click 'JIRA Settings' next to the JIRA application link.
- The 'Update JIRA Server' screen will appear. Enter the following information:
- Select the 'Include in Activity Streams' checkbox.
- Click the 'Test' button in the 'Subtask Settings' section. The options 'Subtask Settings' section will change, allowing you to complete the following fields.
- Select the 'Subtask Type': Technical task.
- Enter the 'Subtask Resolution Action ID': 2.
- Leave the 'Subtask Resolution' at its default value: Cannot Reproduce.
- Select 'Allow Unassigned': Yes.
- Click 'Save'.
- Click the 'Server' link in the left-hand menu under 'Global Settings'.
- The 'Server Settings' screen will appear. Click 'Edit Settings'.
- The 'Edit Web Settings' screen will appear. Select the 'On' radio button next to 'Allow remote API calls'.
- Click 'Update'.
Screenshot 1 (click to enlarge): Application link to JIRA in FishEye

Step 2. Link your FishEye and JIRA Projects and Subscribe JIRA to FishEye's Gadgets
In this step you will link your FishEye 'Dragons' repository to your JIRA 'Dragons' project via a project link. This will enable the hyperlink on JIRA issue keys in FishEye and the summary popup window that appears when you move your cursor over a JIRA issue key. You will also make your FishEye gadgets available for use in JIRA.
- Go to your FishEye URL in your web browser, e.g. http://localhost:8060/fisheye.
- Click the downward-pointing arrow next to your username ('charlie') then click 'Administration' in the dropdown menu.
- Click the 'Repositories' link in the left-hand menu under 'Repository Settings'.
- The 'Repositories' screen will appear. Click the cog icon next to your 'Dragons' repository and select 'Application Links' from the dropdown menu.
- Click 'Add Link' and select your JIRA server from the dropdown menu.
- Click 'Create'. Your FishEye repository is now linked to your JIRA project.
- Now you will make your FishEye gadgets available in JIRA, so that users will be able to add any FishEye gadget to their JIRA dashboard. Go to your JIRA browser window and click 'Dashboards' in JIRA's top navigation bar.
- Click 'Add Gadget'.
- The 'Gadget Directory' popup window will appear. Click 'Gadget Subscriptions'.
- The 'Gadget Subscriptions' popup window will appear. Click 'Add Subscription'.
- The 'Add Subscriptions' popup window will appear. Copy the base URL for your FishEye site (e.g. http://coopers:8060/fisheye or http://www.foobar.com:8060/fisheye) and paste it into the text box on the screen.
- Click 'Add Subscription'.
- Click 'Finished'.
The FishEye gadgets are now available in your JIRA gadget directory. You have not yet added them to your JIRA dashboard. We will do that in a later step.
Step 3. Configure the FishEye Plugin in JIRA
The FishEye plugin for JIRA is bundled as part of the JIRA package, so there is no need to install it. Now you will configure the plugin for your installation and configure JIRA to trust FishEye.
- Go to your JIRA URL in your browser, e.g. http://www.foobar.com:8080.
- Click 'Administration' in the top navigation bar.
- The JIRA Administration console will open. Click 'FishEye Configuration' in the left-hand panel (in the 'Global Settings' section).
- The JIRA FishEye configuration screen will appear. Click 'Edit Primary Configuration' at the bottom of the screen.
- Enter the following information:
- Enable Crucible Integration: Yes
- Review Search Method: Both
- Leave all the other fields at their default values and click 'Update'.
- Click 'Application Links Configuration' at the bottom of the screen.
- Click 'Trusted Applications' in the 'Outgoing Authentication' column for your FishEye/Crucible link. If prompted, log in to FishEye as charlie.
- Click 'Modify' and enter the following information:
- 'IP Patterns': Enter the IP addresses of your FishEye/Crucible site, separated by commas. For example: 127.0.0.1, 172.20.5.95.
- Click 'Apply'.
- Click 'Incoming Authentication' in the left-hand menu.
- Click 'Modify' and enter the following information:
- 'IP Patterns': Enter the IP addresses of your JIRA site, one per line. For example: 127.0.0.1, 172.20.5.95.
- 'URL Patterns': Enter the following paths, one per line:
- Click 'Apply' and then 'Close'.
Try It Out!
- There is now a 'Source' tab on your JIRA issues. Open your 'DRA-1' issue and click the new 'Source' tab. The tab shows the changesets related to the issue, i.e. changesets where the JIRA issue key was included in the commit message.
Screenshot 2 (click to enlarge): Source tab on a JIRA issue

- There is now also a 'Source' tab on your JIRA project. Open your 'Dragons' project to see the new tab. (Click the dropdown arrow next to 'Projects' in the top navigation bar, then click the 'Dragons (DRA)' project.) The 'Source' tab shows the most recent changesets related to any issue in the project, provided the changes were committed in the last 30 days.
We committed our changes to the 'Dragons' repository more than 30 days ago, so you will not see any commits on the JIRA project tab. The screenshot below shows you what they would look like.
Screenshot 3 (click to enlarge): Source tab on a JIRA project

- You can click through from JIRA to view a changeset or other repository views in FishEye. To try it, go to the 'Source' tab on your 'DRA-1' issue and click the changeset number or the repository name ('Dragons').
- In FishEye, you can see a popup summary of issue information for an issue key. Try it by moving your cursor over 'DRA-1' in your FishEye view. You can also click through from FishEye to JIRA by clicking the issue key.
Full details are in the JIRA documentation.
Problems? Please raise a support ticket for the product you're stuck on, see answers from the community, or search the forum of past dragon slayers.
Victory? Please continue.
Step 4. Add a FishEye Gadget to JIRA
Now you will add the 'FishEye Recent Changesets' gadget to your Dragon Development Dashboard.
- Click 'Dashboards' at top left of your JIRA screen.
- Your 'Dragon Development Dashboard' will appear. Click 'Add Gadget'.
- The 'Gadget Directory' will appear, showing a list of the available gadgets for your JIRA dashboard. Enter 'recent' into the search box at top right of the Gadget directory screen.
- The list of gadgets will change, to show only the gadgets that match your search term. Find the 'FishEye Recent Changesets' gadget and click 'Add it Now'. The gadget will be highlighted for a short time and the button's wording will change to 'Adding', while JIRA adds the gadget to the dashboard.
- Click 'Finished' to go back to your dashboard.
- Configure the 'FishEye Recent Changesets' gadget:
- Enter 'Dragons' in the 'Repository' field.
- Leave all the other fields at their default values and click 'Save'.
- Choose a different colour for your 'FishEye Recent Changesets' gadget:
- Move your cursor pointer over the gadget and click the downward-pointing arrow at top right of the gadget frame.
- Select the orange square in the row of colours.
Problems? Please raise a support ticket for the product you're stuck on, see answers from the community, or search the forum of past dragon slayers.
Victory? Please continue.
Victory!
Your JIRA dashboard now has 5 gadgets:
- The 'FishEye Recent Changesets' gadget
- The Confluence 'Activity Stream' gadget
- The 'Assigned to Me' gadget
- The 'Projects' gadget
- The GreenHopper 'Agile' gadget
Screenshot 3 (click to enlarge): JIRA dashboard with 5 gadgets
Problems? Please raise a support ticket for the product you're stuck on, see answers from the community, or search the forum of past dragon slayers.
Victory? Please continue.

|
Don your Armour and Move to the Next Stage
|
|