How to Upgrade JIRA Client

Upgrade from JIRA Client 3.0 or 3.0.1

Run the downloaded executable file. Select the same installation directory to overwrite the older version.

Run JIRA Client 3.0.2 and wait until it finishes synchronizing JIRA configuration.

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.

Upload all your local changes from the old version of JIRA Client (Connection | Upload Changes),
publish and upload Time Tracker data.

Install JIRA Client 3.0. You'll need to run the downloaded executable file. Select the same
installation directory to overwrite the older version.

Start JIRA Client 3.0. It will now pick up and reinitialize your connections and queries.

Run your top-level queries. The new database does not contain any issues yet, so this step is needed to fill
it.

Some queries based on custom fields will not work in the new version. You can fix them by using Search |
Edit Query.

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+]).

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.