Documentation for GreenHopper 4.2.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

Before you begin

Icon

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

  • The instructions on this page are for JIRA 4.0 and later.
  • You must be a JIRA administrator to carry out the instructions on this page.
    (info) Please note, GreenHopper does not add or alter JIRA tables or columns, i.e. adding or removing GreenHopper from your installed plugins will not cause any collateral damage to your JIRA data.
  • 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 7 or later. If you cannot upgrade, you may want to consider installing Google Chrome Frame instead.

On this page:

Installing GreenHopper

 

Installing the GreenHopper Plugin

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

  1. Download GreenHopper. If you have a .zip simply rename your file as a .jar — Internet Explorer is playing tricks on you.
  2. Shut down JIRA.
  3. Replace or copy the jar into the {JIRA_HOME}/plugins/installed-plugins directory.
    (info) The default {JIRA_HOME} location is C:\Program Files\Atlassian\Application Data\JIRA, if you are using Windows. Read more about the JIRA Home directory.
  4. Remove any jira-greenhopper-plugin-*.jar from your {JIRA_INSTALL}/atlassian-jira/WEB-INF/lib directory.
    (info) The {JIRA_INSTALL} location will be something like C:\Program Files\Atlassian\JIRA 4.0.0, if you are using Windows. Read more about the JIRA Installation directory.
  5. Restart JIRA.

Entering your GreenHopper License

New license required for GreenHopper 4.0

Icon
If you have an existing license for GreenHopper 3.8.x or earlier, you will need to upgrade it before you can use GreenHopper 4.0. Any existing 3.x license files will not work with 4.0. Before upgrading to GreenHopper 4.0, please upgrade your license as follows:
  1. Go to my.atlassian.com.
  2. Generate a GreenHopper license for 4.0.
  3. Once you have upgraded your license, please follow the instructions for entering your GreenHopper license into JIRA.

GreenHopper license must match JIRA license

Icon
Please note, if you are using a commercial (i.e. not an evaluation) license for GreenHopper, it must match your JIRA license. For example, if you have a JIRA 25 User Commercial license you must have a GreenHopper 25 User Commercial license. GreenHopper evaluation licenses do not need to match JIRA licenses.
  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Bring up the administration page by clicking the 'Administration' menu on the top bar and selecting the 'JIRA Administration' option.
  3. Click the 'GreenHopper Licence' link under the 'System' section of the administration menu. This will display the 'GreenHopper License' screen (see screenshot below)
  4. Enter your license details and click 'Add'.
    Screenshot: Example GreenHopper Licence page

Configuring GreenHopper

To configure GreenHopper, read the GreenHopper 101 Guide.

Which languages are supported?

Icon

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

Upgrading GreenHopper

 

Upgrading GreenHopper is no different to upgrading any other JIRA plugin.

  1. Download the new version of the jar file from the GreenHopper Download Center (If you have a .zip simply rename your file as a .jar — Internet Explorer is playing tricks on you)
  2. Shut down your Web server.
  3. Remove the old version of the jar from your {JIRA_HOME}/plugins/installed-plugins directory.
  4. Copy the new version of the jar into your {JIRA_HOME}/plugins/installed-plugins directory.
  5. Restart JIRA.

Uninstalling GreenHopper

 

If you want to uninstall GreenHopper, simply remove the jar from the {JIRA_HOME}/plugins/installed-plugins directory and restart JIRA. However, before you remove remove the jar, ensure that you have disabled the GreenHopper night service as described below.

To disable the GreenHopper night service,

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Bring up the administration page by clicking the 'Administration' menu on the top bar and selecting the 'JIRA Administration' option.
  3. Click the 'GreenHopper' link under the 'Global Settings' section in the left menu. The 'GreenHopper Configuration' page will display.
  4. Navigate down the page to the 'GreenHopper Listeners and Services' section.
  5. Uncheck the 'GreenHopper night service' checkbox to disable the GreenHopper night service.

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.