Atlassian Integration Guide : Dragons Stage 6 - Get JIRA and FishEye Talking This page last changed on Apr 07, 2010 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 Step 2. Configure the FishEye Plugin in JIRA Step 3. Add a FishEye Gadget to JIRA Victory! ## 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 the username (i.e. 'Charlie of Atlassian') then 'Administration' from the dropdown menu, to go to the FishEye Admin screens. 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`. Display Base 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'. Now you 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. Click 'Edit default JIRA Server mappings'. The 'Default Mappings for JIRA Projects' screen will appear. Click 'add all' then click 'Save'. Next you will reassure FishEye that it can trust your JIRA server. 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: URL – Enter the base URL of your JIRA server, e.g. `http://coopers:8080` or `http://www.foobar.com:8080`. 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: FishEye URL – Enter the URL of your FishEye server, e.g. `http://coopers:8060` or `http://fisheye.foobar.com:8060`. Wiki Rendering: `ON` 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, 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 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. To try it, go to the 'Source' tab on your 'DRA-1' issue and click the changeset number ('1') 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 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'. Choose a different colour for your 'FishEye Charts' 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 5 gadgets: The 'FishEye Charts' 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 go immediately to the Dragon Slayers' Forum. Victory? Please continue.
| ##### Grab a Bigger Sword and Move to the Next Stage Tweet? Tweet. Go to Dragons Stage 7 - Install Bamboo.
Attachments: JIRAIssueSourceTab.png (image/png) JIRAProjectSourceTab.png (image/png) JIRADashboard4Gadgets.png (image/png) JIRADashboard4Gadgets.png (image/png) JIRAIssueSourceTab.png (image/png) JIRAProjectSourceTab.png (image/png) JIRADashboard4Gadgets.png (image/png) JIRAProjectSourceTab.png (image/png) JIRAIssueSourceTab.png (image/png) JIRADashboardStage6.png (image/png) JIRADashboardStage6.png (image/png) JIRAIssueSourceTab.png (image/png) JIRAProjectSourceTab.png (image/png)

Document generated by Confluence on Apr 07, 2010 22:35