GreenHopper Installation and Upgrade Guide

Before you begin

Please note the following information before you install/upgrade/remove GreenHopper:

• You must be a JIRA administrator to carry out the instructions on this page.
• Please check the Supported Platforms to ensure your version of JIRA supports the intended GreenHopper version.
• Check for any known issues in the GHKB.
• Please allocate an extra 256M of RAM to JIRA, just for GreenHopper — ie. please allocate a minimum of 512M to JIRA, instead of 256M. For details on how to do this, please see: Increasing JIRA Memory.
• Internet Explorer 6 is not supported. If you are currently using Internet Explorer 6, 7 or 8, we strongly recommend that you upgrade to Internet Explorer 9. If you cannot upgrade, you may want to consider installing Google Chrome Frame instead.

Please note: GreenHopper does alter JIRA database tables to support project templates. Further, GreenHopper will add additional tables to the JIRA database. Enabling or disabling GreenHopper within your installed plugins will not cause any damage to your JIRA data.

Activating the GreenHopper Plugin

GreenHopper comes pre-installed with JIRA 4.4, so you simply need to activate it.

To activate the GreenHopper plugin,

1. Log in as a user with the 'JIRA Administrators' global permission.
2. Click the 'Dashboard' link on the top bar to open your JIRA Dashboard.
3. In the 'Admin' gadget, click the link 'Start a free trial of GreenHopper':
   If this link doesn't appear, then GreenHopper has already been activated.
   Screenshot 1: the 'Admin' Gadget on the JIRA Dashboard
   
4. 'Step 1' of the 'GreenHopper setup process' will be displayed:
   Screenshot 2: the GreenHopper setup process
   
5. Click on the 'generate an evaluation key link (or the 'you can retrieve it' link) below the 'License Key' field.
   Your new license key will be generated (or retrieved) via https://my.atlassian.com and will be automatically pasted into the 'License Key' box on the 'GreenHopper setup process' screen.
6. Click the 'Finish' button to return to the JIRA Dashboard.
7. Click the 'Agile' tab to go to GreenHopper.

If you need to change your GreenHopper license details at any time in the future, please refer to Specifying your License Details.

Configuring GreenHopper

To configure GreenHopper, read the GreenHopper 101 Guide.

Before you begin, please read the Release Notes and Upgrade Notes for the version to which you are upgrading.

To upgrade GreenHopper:

1. Click the 'Administration' link on the top bar to open the JIRA administration console.
2. Select 'System > Plugins' to open the 'Universal Plugin Manager'. The 'Universal Plugin Manager' will be displayed, showing the plugins installed on your JIRA instance.
3. Click the 'Upgrade' tab. The plugin upgrades page will display.
4. Click the 'Upgrade Now' button next to the GreenHopper plugin to update it to the plugin version displayed.

To disable GreenHopper:

1. Log in as a user with the 'JIRA Administrators' global permission.
2. Click the 'Administration' link on the top bar to open the JIRA administration console.
3. Select 'System > Plugins' to open the 'Universal Plugin Manager'. The 'Universal Plugin Manager' will be displayed, showing the plugins installed on your JIRA instance.
4. Click the 'Manage Existing' tab. The plugins currently installed in JIRA will be displayed.
5. Click the GreenHopper plugin. The details for the GreenHopper plugin will display.
6. Click the 'Disable' button.

You may wish to check out the Atlassian Answers for GreenHopper for advice from other users. If you need further assistance from us to resolve a problem, please log an issue on our support system.