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


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 4.0 for JIRA 4.0.x.

  1. Go to the Atlassian download centre.
  2. Download GreenHopper 4.0 for JIRA 4.0.x.
  3. 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).)
  4. 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
  5. Start your JIRA server again, and go to your JIRA URL in your browser, e.g. http://www.foobar.com:8080.
  6. Log in to JIRA with username charlie.
  7. Set up your GreenHopper license key:
    • Click 'Administration' in the top navigation bar.
    • Click 'GreenHopper Licence' in the left-hand panel (in the 'System' section).
    • The 'GreenHopper License Information' screen will appear. Paste your Greenhopper license key into the 'GreenHopper Licence' 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'.
  8. 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 go immediately to 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 JIRA issue and do other updates via GreenHopper or via the standard JIRA interface. Now that you have GreenHopper you can choose to add, edit and move JIRA issues through the workflow stages via the 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, and add your existing issue to the same sprint.

  1. Click 'Manage' on the planning board.
  2. The 'Manage Versions' screen will appear. Add a sprint with the following information:
    • Version Name: 2.0.S1
    • Description: Version 2.0 Sprint 1
  3. Add another sprint with the following information:
    • Version Name: 2.0.S2
    • Description: Version 2.0 Sprint 2
  4. Click 'Agile' in the top navigation bar to go back to your planning board.
  5. 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 'Edit Master' icon next to 'Master' in the box for sprint '2.0.S1'.
  6. A dropdown list will appear. Select '2.0'.
  7. 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'.
  8. Edit the 'Master' for sprint '2.0.S1' in the same way.
  9. 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.
  10. Click 'Create and Close', to create the issue. You will see your planning board again.
  11. 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'.
  12. Drag DRA-2 to sprint '2.0.S1' as well.
  13. Your planning board will now be empty. Select version '2.0.S1' in the version dropdown list at the top of your planning board. You should now see your two cards, i.e. issues 'DRA-1' and 'DRA-2'.
  14. Click the version number '2.0' at the top of the version 2.0 box on the right. Notice the following points:
    • The number in the version 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 click the down arrows at top right of each version box, to minimise the box.
  15. Now you can mark one of your issues as complete:
    • Click the down arrow next to 'Agile' 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. Click 'Close Issue' and leave all other values at their defaults.
  16. Go back to your planning board to see the changes reflected there too.

Screenshot 2 (click to enlarge): The GreenHopper planning board for version 2.0

Problems? Please go immediately to the Dragon Slayers' Forum.
Victory?      Please continue.

Step 3. Add the GreenHopper Gadget to your JIRA Dashboard

Now you will add the GreenHopper 'Agile' gadget to your Dragon Development Dashboard.

  1. Click 'Dashboards' at top left of your JIRA screen.
  2. Your 'Dragon Development Dashboard' will appear. Click 'Add Gadget'.
  3. 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.
  4. The list of gadgets will change, to show only the gadgets that match your search term. Find the '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.
  5. Click 'Finished' to go back to your dashboard.
  6. Configure the 'Agile' gadget:
    • Select 'Dragons' in the 'Projects' dropdown list.
    • Leave the default value for 'Display chart values'.
    • Click the dropdown arrow next to 'Refresh Interval' and select 'Every 15 Minutes'.
    • Click 'Save'.
    • Click the version dropdown arrow 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.)
  7. Choose a different colour for your 'Agile' 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 go immediately to the Dragon Slayers' Forum.
Victory?      Please continue.

Victory!

Your JIRA dashboard now has 3 gadgets:

  • The GreenHopper 'Agile' gadget
  • the 'Assigned to Me' gadget
  • The 'Projects' gadget

Screenshot 3 (click to enlarge): JIRA dashboard with 3 gadgets



Problems? Please go immediately to the Dragon Slayers' Forum.
Victory?      Please continue.

Grab your Sword and Move to the Next Stage

Document generated by Confluence on Oct 06, 2009 00:43