JIRA 4.3 : JIRA 4.0 Upgrade Guide
This page last changed on May 20, 2010 by rosie@atlassian.com.
On this page:
Upgrading from JIRA 3.13.x to 4.0Licensing ChangesJIRA 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 instructions below: General Upgrade InstructionsPlease ensure that you follow the instructions in the general JIRA upgrade guide (non-version specific), as well as the JIRA 4.0 specific instructions in the sections below. The general upgrade guide contains important tasks that are essential for getting your upgraded JIRA instance to work correctly (e.g. merging jira-application.properties customisations from the old instance to the upgraded instance). 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: Refer to Setting Properties and Options on Startup for instructions. '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 an XML backup and restore as described in the Upgrading JIRA instructions. 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 charts have not been bundled with JIRA 4.0. If you are using any of the following 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 ProblemPrior to JIRA 4.0, it was possible to create two statuses whose names differed only in case (e.g. 'Resolved' and 'RESOLVED'). If you upgrade to JIRA 4.0, this will lead to ambiguities. Consider this scenario:
Additionally, you will receive ambiguous results if you attempt to perform a search by name on the status in the Advanced Search (e.g. "Status = In Progress (Services)"). 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. Please also note the following: Upgrading from JIRA 2.x Data and earlierIf you are upgrading from JIRA 2.x data (or earlier) to JIRA 4.0, you must upgrade to any JIRA 3.x release first (3.13.5 recommended). You can then follow the JIRA 4.0 Upgrade Guide to upgrade your JIRA instance to 4.0. |
![]() |
Document generated by Confluence on Mar 27, 2011 18:41 |