This page last changed on Oct 05, 2009 by smaddox.

You are embarking on stage 6 of the Atlassian Dragon Quest. Be prepared to ride on the dragon's back, for he is swift and strong and will take you where you need to go.
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. Add a JIRA Server to FishEye and Enable Remote API
In this step you will define a JIRA server in the FishEye administration interface, configure FishEye to trust JIRA and enable FishEye's remote API.
- Go to your FishEye URL in your web browser, e.g. http://localhost:8060/.
- Click 'Administration' at the bottom of the FishEye screen, to go to the FishEye Admin screens.
- Enter your FishEye administration password. This is the password you chose when setting up FishEye in Dragons stage 5.
- Click 'JIRA Servers' in the left-hand panel.
- The 'View JIRA Servers' screen will appear. Click 'Add a JIRA Server'.
- The 'Add JIRA Server' screen will appear. Enter the following information:
- Name: Dragons JIRA.
- URL – Enter the base URL of your JIRA server, e.g. http://coopers:8080 or http://www.foobar.com:8080.
- Username: charlie.
- Password – Enter Charlie's password in Crowd.
- Include in Activity Streams – Select this checkbox.
- Authenticate as Trusted Application – Select this checkbox.
- Click 'Test' to ensure that your details are correct.
- Click 'Save'.
- Click 'Trusted Applications' in the left-hand panel.
- The 'Trusted Applications List' will appear. Click 'Add a Trusted Application'.
- The 'Trusted Application' screen will appear. Enter the following information:
- Leave the other fields at their default values and click 'Get Id'.
- FishEye will add the trusted application ID into the 'Id' field. Click 'Save'.
- Click 'Server Settings' in the left-hand panel.
- 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'.
Step 2. 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 Plugin' screen will appear. Click 'Setup FishEye'.
- The 'FishEye' screen will appear. Enter the following information:
- Leave all the other fields at their default values and click 'Update'.
- The 'Associate FishEye Repositories with JIRA Projects' screen will appear. Enter project key 'DRA' next to the 'Dragons' repository under 'Mapped Project Keys'.
- Click 'Update'.
- Click 'Trusted Applications' in the left-hand panel (in the 'System' section).
- The 'View Trusted Applications' screen will appear, with a section called 'Request New Trusted Application Details'. Copy the base URL for your FishEye site (e.g. http://coopers:8060 or http://fisheye.foobar.com:8060) and paste it into the 'Base URL' field.
- Click 'Send Request'.
- The 'Add New Trusted Application' screen will appear. Enter the following information:
- Application Name: FishEye – The default will be the URL you entered on the previous screen. You can safely change it to a more meaningful name.
- IP Address Matches: 127.0.0.1 – Add this address to a new line in the box.
- Leave the other fields at their default values.
- Click 'Add'.
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 1 (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.
Screenshot 2 (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. Try clicking the changeset number ('1') or the repository name ('Dragons') on the 'Source' tab in JIRA.
You can also click through from FishEye to JIRA, by clicking the issue key. Try it by clicking 'DRA-1' in your FishEye view.
Full details are in the FishEye plugin documentation.
Problems? Please go immediately to the Dragon Slayers' Forum.
Victory? Please continue.
Step 3. Add a FishEye Gadget to JIRA
Now you will add the 'FishEye Charts' 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 'FishEye' 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 Charts' 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 Charts' gadget:
- Enter 'Dragons' in the 'Repository' field.
- Click the dropdown arrow next to 'Refresh Interval' and select 'Every 15 Minutes'.
- Click 'Save'.
- Re-arrange your dashboard by dragging the 'Projects' gadget to the right and dropping it under the 'Assigned to Me' gadget. Drag the 'Agile' gadget to the bottom right too.
- 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 go immediately to the Dragon Slayers' Forum.
Victory? Please continue.
Victory!
Your JIRA dashboard now has 4 gadgets:
- The 'FishEye Charts' gadget
- The 'Assigned to Me' gadget
- The 'Projects' gadget
- The GreenHopper 'Agile' gadget
Screenshot 3 (click to enlarge): JIRA dashboard with 4 gadgets
Problems? Please go immediately to the Dragon Slayers' Forum.
Victory? Please continue.

|
Grab a Bigger Sword and Move to the Next Stage
|
|