Atlassian Integration Guide : Dragons Stage 6 - Get JIRA and FishEye Talking This page last changed on Dec 13, 2010 by alui. 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 'Application Links' in the left-hand panel. The 'Configure Application Links' screen will appear. Click 'Add Application Link'. The 'Link to another server – Step 1' dialogue will appear. Enter the following information: Server URL – Enter the base URL of your JIRA server, e.g. `http://coopers:8080` or `http://www.foobar.com:8080`. Click 'Next'. The 'Link to another server – Step 2' dialogue will appear. Enter the following information: Application Name: `Dragons JIRA`. Application Name: `JIRA`. Click 'Create'. The 'Configure Application Links' page will display the new application link to your JIRA server. Now you will configure authentication for the application link. Click 'Configure' next to your new application link. The 'Configure Dragons JIRA' screen will appear. Click 'Incoming Authentication' in the left-hand menu. The outgoing authentication page will appear with the 'Trusted Applications' tab active. Click 'Configure' then 'Apply' to enable trusted applications for incoming authentication. Do the same for incoming authentication. Click 'Close' when done. Click 'JIRA Settings' next to your 'Dragons JIRA' application link The 'Update JIRA Server' screen will appear. Select the 'Include in Activity Streams' checkbox and click 'Save'. Now you will set up an entity link from your FishEye repository to your JIRA project, to 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 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 click 'Application Links' from the menu that appears. The 'Dragons Application Links' screen will appear. Click 'Add Link' then click 'Dragons JIRA (JIRA)' from the dropdown menu. The 'Enter link details' screen will appear. Enter the following details: Key: `DRA` Alias: `Dragons` Click 'Create'. 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'. ## 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` Enable Crucible Integration: `Yes` Review Search Method: `Both` 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 under 'System'. 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. URL Paths to Allow: Add these paths to the existing paths, one per line: `/plugins/servlet/applinks/whoami` `/secure/CreateSubTaskIssueDetails.jspa` `/browse` 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 JIRA documentation. Problems? Please raise a support ticket for the product you're stuck on, or try 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 raise a support ticket for the product you're stuck on, or try 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 raise a support ticket for the product you're stuck on, or try the Dragon Slayers' Forum. Victory? Please continue.
| ##### Grab a Bigger Sword and Move to the Next Stage Tweet? Tweet. Go to Dragons Stage 7 - Get JIRA and Crucible Talking.
## 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) JIRAIssueSourceTab.png (image/png) JIRAProjectSourceTab.png (image/png) JIRADashboardStage6.png (image/png)

Document generated by Confluence on Feb 27, 2011 17:37