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

Beware of fiends and dragons on the gargoyled eaves. You are embarking on stage 2 of the Atlassian Dragon Quest.
In this stage, you will install GreenHopper into JIRA, for agile project management.
Time estimate: This stage will take approximately 30 minutes.
On this page:
Step 1. Install GreenHopper Plugin into JIRA
Requirements: GreenHopper 5.6.4 for JIRA 4.3.4.
In this step you will install the GreenHopper plugin into JIRA.
- Go to your JIRA URL in your browser, e.g. http://www.foobar.com:8080.
- Click 'Plugins' in the 'System' section of the 'Administration' menu.
- The plugin management page will appear. Click the 'Install' tab.
- Enter greenhopper into the search box and click 'Search'.
- The GreenHopper plugin will appear in the list of plugins. Click the 'GreenHopper' plugin name.
- The plugin details will appear. Click 'Install Now'.
- When the plugin has been successfully installed, shut down your JIRA server. (Press Ctrl+C in your JIRA server command window or run {JIRA_INSTALL}\bin\shutdown.bat on Windows, or {JIRA_INSTALL}/bin/shutdown.sh on UNIX.)
- Start your JIRA server again, and log in to JIRA as charlie.
- Set up your GreenHopper license key:
- Click 'License Details' in the 'GreenHopper' section of the 'Administration' menu.
- The 'GreenHopper License Information' screen will appear. Paste your GreenHopper license key into the 'GreenHopper License' textbox. If you do not already have a GreenHopper license, follow the prompts on the 'GreenHopper License' screen to get a 'GreenHopper for JIRA 4: Evaluation' license key.
- Click 'Add'.
- Click 'Agile' in the top navigation bar.
You will see the Dragons planning board, supplied by GreenHopper in JIRA.
(If you do not see the planning board, click the down arrow next to 'Agile' and select 'Planning Board'.)
Screenshot 1 (click to enlarge): The GreenHopper planning board in JIRA

There's more about getting started with GreenHopper in the GreenHopper 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 2. Add Another JIRA Issue and a Sprint
Now that you have GreenHopper you can choose to update your issues via the GreenHopper tabs or via the standard JIRA interface. For this exercise you will do your updates via GreenHopper.
First you will create two 'sprints', also known as 'milestones'. A sprint is a short period of time, two weeks for example, in which your developers focus on a particular set of tasks. Then you will create a new issue and include it in one of the sprints. Finally you will add your existing issue to the same sprint.
- Click the 'Add' button above the version cards, near the top right of the planning board.
- The 'Add Version' screen will appear. Add a sprint with the following information:
- Version Name: 2.0.S1
- Description: Version 2.0 Sprint 1
- Leave the default values for the other fields.
- Click 'Create and Close'.
- Follow the above steps to add another sprint with the following information:
- Version Name: 2.0.S2
- Description: Version 2.0 Sprint 2
- Your two new sprints will appear as boxes on the right of the planning board, underneath the '2.0' box. Now you need to include the two sprints into the existing version 2.0. Click the sprint box for sprint '2.0.S1'.
- Within the sprint box click the gear icon (top right) and select 'Toggle visibility', or double click the sprint title bar, to expand the box.
- The 'Parent' is currently set to 'none'. Click 'Parent'.
- A dropdown list will appear. Select '2.0'.
- The '2.0.S1' sprint will become part of version 2.0 – the gap between the boxes will disappear and a small downward and rightward-pointing arrow will appear next to the heading '2.0.S1'.
- Edit the 'Parent' for sprint '2.0.S2' in the same way.
- You now have two sprints within version 2.0. Next you will add a new issue, also known as a card. Click 'New Card' on the planning board. Enter the following values:
- Card type: Bug
- Priority: Blocker
- Summary: Exploding flame extinguishers
- Version: Unscheduled
- Component: Unknown
- Original estimate: 2d
- Assignee: charlie
- Click 'Create and Close', to create the issue.
- You will see your planning board again. It currently shows no cards. Click the version number dropdown near the top left of the screen (currently showing '2.0.s2') and select 'Unscheduled' to see all the cards.
- Click the card for issue DRA-1, drag the card to the right and drop it onto the box for sprint '2.0.S1'.
- Drag DRA-2 to sprint '2.0.S1' as well.
- Your planning board will now be empty, because it is currently showing cards for version 'Unscheduled'. Click the version number '2.0.S1' at the top of the version 2.0.S1 box on the right. You should now see your two cards 'DRA-1' and 'DRA-2'.
- Click the version number '2.0' at the top of the version 2.0 box on the right. Notice the following points:
- The value in the version number dropdown box at the top of the planning board also changes to '2.0'.
- Your two issue cards are included in version 2.0 as well as in sprint 2.0.S1.
- You can double click the title bar of each version box, to minimise or expand the box.
- Mark one of your issues as complete:
- Click the down arrow next to 'Planning Board' and select 'Task Board'.
- Your task board will appear, with your two issue cards in the 'To Do' column on the left. Click the card for 'DRA-1', drag it to the right and drop it in the 'Done' column.
- The 'Transitioning Issue' screen will appear. Select 'Close Issue' and click 'Update'.
- The 'Close Issue' screen will appear. Click 'Close Issue'.
Screenshot 2 (click to enlarge): The GreenHopper task board for version 2.0

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 3. Use the Scrum Template for your Project and Add a Story
GreenHopper includes a project template for projects using the Scrum methodology. The template adds custom fields, such as ranking fields and story points, to your project. It also allows you to create stories, epics and technical tasks. In this step you will apply the Scrum template to your project and create a story.
- Go back to your planning board, click the 'Tools' menu and select 'Configuration'.
- The project configuration page will appear. Click the 'General' tab.
- Select 'Scrum' from the 'Project Template' dropdown menu.
- Click 'Change template' on the confirmation window.
- Next you will create a new story. Go back to your planning board and click 'New Card'. Enter the following values:
- Card type: Story
- Priority: Major
- Summary: As a dragon slayer I would like to wield an extremely big sword.
- Version: 2.0
- Component: Unknown
- Business Value: 10
- Assignee: charlie
- Story Points: 10
- Click 'Create and Close'. You will see your planning board again. If your new story does not appear on the board, click the version number '2.0' at the top of the version 2.0 box on the right so that the board shows all cards for version 2.0.
Screenshot 3 (click to enlarge): The GreenHopper planning board with story

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 the GreenHopper Gadget to your JIRA Dashboard
Now you will add the GreenHopper 'Agile' 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 'agile' 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 'GreenHopper Agile 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 'GreenHopper Agile Gadget':
- Start typing 'Dragons' in the 'Project or Saved Filter' box and select 'Dragons (DRA)' from the dropdown list that appears.
- Leave the default value for 'Display chart values' and 'Display chart legend'.
- Click the dropdown arrow next to 'Refresh Interval' and select 'Every 15 Minutes'.
- Click 'Save'.
- Click the version dropdown arrow next to 'Unscheduled' and select '2.0'.
- The gadget will display the 'Hours' burndown chart. Click the 'Issues' tab to see the issues burndown chart.
(The burndown charts will become more interesting when you have more issues in your project.)
- Choose a different colour for your 'GreenHopper Agile Gadget' gadget:
- Move your cursor pointer over the gadget and click the downward-pointing arrow at top right of the gadget frame.
- Select the green 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 3 gadgets:
- The GreenHopper 'Agile Gadget'
- The 'Assigned to Me' gadget
- The 'Projects' gadget
Screenshot 4 (click to enlarge): JIRA dashboard with 3 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 Chain Mail and Move to the Next Stage
|
|