Tuesday, July 26, 2011

UPGRADING ATLASSIAN JIRA


This post describes the standard, recommended procedure for upgrading to JIRA 4.3.x from JIRA version 4.0.0 or later.
Atlassian's own web site describe the standards to upgrade Jira. The link given below shows how to upgrade Jira.
Link: http://confluence.atlassian.com/display/JIRA043/Upgrading+JIRA
Upgrading operation consists of a few basic steps. The steps are;
1. Backing Up
  • Back up your database:
    • Backup your external database and verify that your backup was created correctly.

  • Back up your JIRA Home directory:
    • In the WEB-INF/classes directory of your Jira installation directory, there is a jira-application.properties file, in the file, the location of home directory is available.

  • Back up your attachments directory if located outside your JIRA Home directory:
    • If your attachments directory is located outside of Jira home directory, it should be backed up.

  • Back up your JIRA Installation directory:
    • It is the directory that the Jira application files and libraries were extracted when Jira was installed.
2. Performing the Upgrade
  • Install the new version of JIRA:

    • Download Jira to install with the version that you want. And install Jira. Be aware of that install the new Jira version to a new location. Do not overwrite your existing Jira installation.

  • Migrate your existing JIRA configurations over to your new JIRA installation:
    • For each file that you have modified in your existing Jira installation, you need manually edit each equivalent in your new Jira version installation and re-apply your modification.

  • Connect your new JIRA to your existing database:
    • You should configure your new Jira version installation to connect your existing data base. Manually you can edit server.xml (in your new Jira version installation directory) to connect database. Also you can use Jira Configuration tool to configure your new Jira installation to connect your existing database.

  • Point your new JIRA to your existing JIRA Home directory:
    • Edit jira-application.properties (in new Jira installation directory) file. Find jira-home property and update the property to the path of your existing Jira home directory that you backed up in the steps above.
  • Start your new version of JIRA:

    • Shut down old Jira installation.

    • Start up new version of Jira.

    • Visit Jira in your web browser, log in by using user name and password from your old Jira installation. Without seeing the setup wizard, you should be able to log in.
To see detailed information for each step, visit the atlassian page that given on the top of the first page.
I hope to be useful.