JIRA 4.0 : JIRA 4.0 Upgrade Guide
This page last changed on Oct 05, 2009 by alui.
On this page:
Upgrading from JIRA 3.13.x to 4.0JIRA 4.0 introduces some significant licensing changes. Before you begin the upgrade, please go to my.atlassian.com for your upgraded license. Please note, any existing 3.x license files will not work with 4.0.
Once you have upgraded your license, please follow the JIRA general upgrade instructions, plus note the following: Scheduling the UpgradePlease note that upgrading to JIRA 4.0 may take a long time, depending on the size of your instance as well as server and database performance. During the upgrade, several upgrade tasks will need to run to upgrade your data to be ready for JIRA 4.0, such as:
Please schedule sufficient downtime time for the upgrade in your production environment. It is recommended to run an upgrade first in a test environment to see how long the upgrade will take for your data set and hardware configuration. Java VersionIf you are running JIRA under version 6 (1.6) of the Sun JRE, please ensure that you are running a point release JRE 6 (1.6) Update 10 or higher. The reasons for this are:
JIRA HomeJIRA 4.0 has a new directory structure — for details, please see Important Directories and Files. Please ensure that you set the jira.home property as described here. Recommended BrowsersThe following browsers are recommended for use with JIRA 4:
Users May Encounter 'Advanced Search'If any of your users have saved invalid filters, the new 'Advanced Search' screen may appear when they try to display them. 'mail.mime.decodeparameters' System PropertyThe following system property must be set in order for the JIRA mail handler to work correctly with emails from RFC 2231-compliant mail clients: mail.mime.decodeparameters=true System properties are set in different ways depending on your application server. 'Resolution Date' System FieldJIRA 4.0 introduces a new system field, the Resolution Date. This field provides the date when an issue last entered into a 'Resolved' workflow state. When upgrading to JIRA 4.0, an upgrade task will run, calculating the Resolution Date for every resolved issue in your system. If you have a large number of issues, this may take a long time. The speed at which this upgrade task runs can be improved by ensuring that your database statistics are up to date for your changegroup and changeitem tables (to ensure the database will select the most effective query plan). For example, on Postgres this can be done by executing the following commands: jiratest=# ANALYZE changegroup; ANALYZE jiratest=# ANALYZE changeitem; ANALYZE JIRA's RPC interface now provides two new methods to retrieve an issue's Resolution Date:
The RemoteIssue class was left unchanged, to ensure backwards compatibility of RPC clients. Database Schema ChangesIf you are using an Oracle or MySQL database, please note that two column data types have been changed. Therefore, the easiest way to upgrade to JIRA 4.0 is to perform anXML backup and restoreas described in theUpgrading JIRAinstructions. If in the past, instead of performing an XML backup and restore, you have been upgrading by "pointing" the new version of JIRA at an old database, this is still possible. However, the procedure is more complicated. You will need to use SQL scripts to perform database schema changes. For details (and the scripts), please see JIRA 4.0 Database Schema Changes for MySQL and Oracle . Charting PluginJIRA 4.0 now bundles most of the charts previously provided by the JIRA charting plugin. If you currently have the JIRA charting plugin installed (v1.4.1 or previous) in WEB-INF/lib, please remove it as otherwise JIRA will fail to start. The following three charts have not been bundled with JIRA 4.0. If you are using any of the following three charts, you will need to upgrade to version 1.5 of the JIRA charting plugin:
JIRA ToolkitIf you are using the JIRA Toolkit, you will need to upgrade it to the latest version. You will also need to install it in your JIRA home directory, rather than your atlassian-jira/WEB-INF/lib/ directory as it now runs in an OSGi container. Read Managing JIRA's Plugins for more information. GreenHopper PluginGreenHopper for JIRA 4.0 is now available for use with JIRA 4.0. You can download it on the GreenHopper Plugin for JIRA Downloads page. Please follow the GreenHopper Installation and Upgrade Guide for instructions on how to upgrade GreenHopper. Please note, you need to upgrade your GreenHopper license before you can use GreenHopper with JIRA 4.0. Any existing GreenHopper license files will not work with JIRA 4.0. You can obtain a license from http://my.atlassian.com. Issue 'Status' Field ProblemIf you have defined two issue statuses with the same name, JIRA's search will not recognise any issues assigned these statuses as distinct issues. For example, consider this scenario:
To resolve this issue, we recommend that you ensure that each issue status is distinct by renaming the duplicate statuses appropriately. You may also need to update any issue filters that you have set up. Plugin NotesJIRA 4.0 introduces several changes that may break existing plugins. There are now two different types of plugins. Each type of plugin needs to be installed into a different directory to work. Read Managing JIRA's Plugins for more information. If you are using a plugin that is not shipped with JIRA, the plugin may need to be updated to work with JIRA 4.0. If the plugin was written by you, please read through Updating JIRA Plugins for JIRA 4.0 and see if any of it is relevant to your plugin. If you are using a plugin written by a third party, please check with the plugin's author to see if the plugin has been tested with JIRA 4.0. MemoryRunning JIRA v4.0 may require more RAM than running v3.x. Upgrading from JIRA 3.12 and earlierIn addition to the points listed above, please read the Upgrade Guide for every version you are skipping during the upgrade. The complete list of Upgrade Guides is available here. |
![]() |
Document generated by Confluence on Oct 06, 2009 00:26 |