Documentation for GreenHopper 5.6.x . Documentation for other versions of JIRA Agile is available too.
GreenHopper is now called JIRA Agile. Learn more.

Skip to end of metadata
Go to start of metadata

On this page:

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 GreenHopper Knowledge Base.
  • 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 from GreenHopper 4.0 onwards. If you are currently using Internet Explorer 6, we strongly recommend that you upgrade to Internet Explorer 8 or later. If you cannot upgrade, you may want to consider installing Google Chrome Frame instead.

(info) Please note: GreenHopper does alter JIRA database tables to support project templates. However, GreenHopper will not add additional tables to the JIRA database, and adding or removing GreenHopper from your installed plugins will not cause any collateral damage to your JIRA data.

Installing GreenHopper

Installing the GreenHopper Plugin

Installing GreenHopper is no different to installing any other JIRA plugin:

  1. Click the 'Administration' link on the top bar to open the JIRA administration console.
  2. Click the 'Plugins' link under the 'System' section in the left menu to open the 'Universal Plugin Manager'. The 'Universal Plugin Manager' will be displayed, showing the plugins installed on your JIRA instance.
  3. Click the 'Install' tab in the UPM. The 'Find new plugin' page will display, showing the featured plugins available for JIRA.
  4. Type 'GreenHopper' in the 'Search the Plugin Exchange' box and click the 'Search' button.
  5. The GreenHopper plugin will appear in the 'Featured Plugins' section on the 'Install' tab. Click the 'Install' button. A confirmation message and the plugin details will display, if it is installed successfully.
  6. Restart JIRA.

Entering your GreenHopper License

For details on entering your GreenHopper License details, please refer to Specifying your License Details.

Configuring GreenHopper

To configure GreenHopper, read the GreenHopper 101 Guide.

Which languages are supported?

Icon

For now, English, French, German, Japanese, Dutch and Spanish are supported. Almost all character sets (like Cyrillic, Greek...) are supported in the inputs. More languages will be supported in future releases. For more details please see Atlassian Translations

Upgrading GreenHopper

To upgrade GreenHopper:

  1. Click the 'Administration' link on the top bar to open the JIRA administration console.
  2. Click the 'Plugins' link under the 'System' section in the left menu 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 in the UPM. 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.
  5. Restart JIRA.

Uninstalling GreenHopper

To uninstall GreenHopper:

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Remove the GreenHopper Ranking type custom field via Administration > Issue Fields > Custom Fields (see the JIRA Custom Fields documentation for details).
  3. Disable the GreenHopper Night Service via Administration > GreenHopper > General Configuration (see the JIRA Services documentation for details).
  4. Remove the GreenHopper plugin: (see the Managing Add-ons for further details)
    1. Click the 'Administration' link on the top bar to open the JIRA administration console.
    2. Click the 'Plugins' link under the 'System' section in the left menu to open the 'Universal Plugin Manager'. The 'Universal Plugin Manager' will be displayed, showing the plugins installed on your JIRA instance.
    3. Click the 'Manage Existing' tab. The plugins currently installed in JIRA will be displayed.
    4. Click the GreenHopper plugin. The details for the GreenHopper plugin will display.
    5. Click the 'Uninstall' button. The information summary will display an 'Uninstalling' message and the plugin will be uninstalled from JIRA.
  5. Restart JIRA.

Getting Help

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.