GreenHopper Installation and Upgrade Guide

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.
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 7 or later. If you cannot upgrade, you may want to consider installing Google Chrome Frame instead.

Please note: GreenHopper does alter JIRA 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:

Unable to render {include} The included page could not be found.

Entering your GreenHopper License

New license required for GreenHopper 4.0

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:

Go to my.atlassian.com.
Generate a GreenHopper license for 4.0.
Once you have upgraded your license, please follow the instructions for entering your GreenHopper license into JIRA.

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?

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.

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)
Shut down your Web server.
Remove the old version of the jar from your {JIRA_HOME}/plugins/installed-plugins directory.
Copy the new version of the jar into your {JIRA_HOME}/plugins/installed-plugins directory.
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,

Log in as a user with the 'JIRA Administrators' global permission.
Bring up the administration page by clicking the 'Administration' menu on the top bar.
Click the 'General Configuration' link under the 'GreenHopper' section in the left menu. GreenHopper's global settings page will be displayed.
Navigate down the page to the 'GreenHopper Listeners and Services' section.
Clear the 'GreenHopper night service' check box to disable the GreenHopper night service.

Getting Help

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

Child pages