Upgrade from JIRA Client 3.0 or 3.0.1

1. Back up your workspace.
2. Run the downloaded executable file. Select the same installation directory to overwrite the older version.
3. Run JIRA Client 3.0.2 and wait until it finishes synchronizing JIRA configuration.
4. If you have custom fields that were not supported properly in 3.0 or 3.0.1, you'll need to run Search  | Reload Query From Server in order to see values for these fields and to search by these fields.

Upgrade from JIRA Client 2.x or 1.x

Note: in JIRA Client 3.0 we have changed the way issues are stored locally. That means that there are some things to migrate from the old place where the issues were stored. Please read carefully to ensure that your information is not lost.

1. Upload all your local changes from the old version of JIRA Client (Connection | Upload Changes), publish and upload Time Tracker data.
2. Back up your workspace.
3. Install JIRA Client 3.0. You'll need to run the downloaded executable file. Select the same installation directory to overwrite the older version.
4. Start JIRA Client 3.0. It will now pick up and reinitialize your connections and queries.
5. Run your top-level queries. The new database does not contain any issues yet, so this step is needed to fill it.
6. Some queries based on custom fields will not work in the new version. You can fix them by using Search | Edit Query.
7. Similarly, some custom field columns will be missing in issue table. You can add them back by clicking the button to the right of the table header or by pressing Ctrl+] (Cmd+]).
8. If you use local tags, they will need to be migrated from the old database. JIRA Client will automatically do it for you on the first run (the only time it will need the old database.) During this operation it will create a file named tags.txt in your workspace. If you see that tags are not imported, run Tools | Tag Importer for that file to get your tags.

You can use JIRA Client in a free 30-day trial mode or with any license obtained from ALM Works with an active maintenance subscription. JIRA Client Lite may be used freely with any JIRA server running on a Starter license, or with a JIRA server that hosts a sponsored open-source project.