This page last changed on Dec 09, 2010 by alui.

Beware of low-flying worms. You are embarking on stage 3 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.3 for JIRA 4.2.
- Go to the Atlassian download centre.
- Download GreenHopper 5.3 for JIRA 4.2.
- 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).)
- Copy the downloaded Greenhopper JAR file into your {JIRA_HOME}/plugins/installed-plugins directory, where {JIRA_HOME} is the JIRA Home directory that you specified when installing JIRA in Dragons Stage 2. For example:
- On Windows: C:\data\jira-home\plugins\installed-plugins
- On UNIX: /var/jira-home/plugins/installed-plugins
- Start your JIRA server again, and go to your JIRA URL in your browser, e.g. http://www.foobar.com:8080.
- Log in to JIRA with username charlie.
- Set up your GreenHopper license key:
- Click 'Administration' in the top navigation bar.
- Click 'License Details' in the left-hand panel (in the 'GreenHopper' section).
- 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 an evaluation license key.
Make sure you have a GreenHopper 4 license. Existing 3.x licenses will not work.
- 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, or try the Dragon Slayers' Forum.
Victory? Please continue.
Step 2. Add Another JIRA Issue and a Sprint
Now that you have GreenHopper you can choose to add a JIRA issue, edit and move JIRA issues through the workflow stages via the GreenHopper Planning and Task Boards under the Agile tab or via the standard JIRA interface. For this exercise, you will do your updates via GreenHopper.
First you will create a couple of 'sprints', also known as 'milestones'. A sprint is a short period of time, e.g. two weeks, 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, then 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 need to add a new issue (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 of Atlassian – Click the 'Assign to me' icon.
- Click 'Create and Close', to create the issue.
- You will see your planning board again. Click the version number dropdown (next to the dropdowns with 'Planning Board' and 'Version' selected) and select 'Unscheduled', to see all the cards.
- Click the card for your existing 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.
- Now you can 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 leave all other values at their defaults. Click 'Update'.
Screenshot 2 (click to enlarge): The GreenHopper planning board for version 2.0

Problems? Please raise a support ticket for the product you're stuck on, or try the Dragon Slayers' Forum.
Victory? Please continue.
Step 3. Use the 'Scrum' Template for your Project and Add a Story
GreenHopper includes a 'Scrum' project template for projects using the 'Scrum' methodology. This template adds custom fields like ranking fields, story points, etc, to your project. It also allows you to create stories, epics and technical tasks. You will now apply this template to your project and create a story.
- Open the 'Tools' menu on the planning board and click 'Configuration'.
- The project configuration page will appear. Click the 'General' tab.
- Select 'Scrum' from the 'Project Template' dropdown menu (in the 'Project Templates' section).
- Click 'Change template' on the confirmation window. The 'Scrum' project template will be applied.
- 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 be able to wield an extremely big sword.
- Version: 2.0
- Component: Unknown
- Business Value: 10
- Assignee: Charlie of Atlassian – Click the 'Assign to me' icon.
- Story Points: 10
- Click 'Create and Close', to create the story. You will see your planning board again with your story displayed.
Screenshot 3 (click to enlarge): The GreenHopper planning board with story

Problems? Please raise a support ticket for the product you're stuck on, or try the Dragon Slayers' Forum.
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 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, or try the Dragon Slayers' Forum.
Victory? Please continue.
Victory!
Your JIRA dashboard now has 3 gadgets:
- The 'GreenHopper Agile Gadget' 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, or try the Dragon Slayers' Forum.
Victory? Please continue.

|
Grab your Sword and Move to the Next Stage
|
|