Jira Migration

Jira Migration

Before You Start

1. Contact ONES to obtain the appropriate Linux AMD64 package and confirm compatibility with your environment.
2. Confirm the version, infrastructure, and network requirements.
3. Prepare a full Jira data backup as described in the Migration Tool Guide.
4. Review API, backup package, and database migration methods.

Start the Tool

unzip migration-tool-*-*.zip
cd migration-tool-*-*
sudo chmod 755 -R scripts/ bin/
cd scripts
sudo ./start.sh

During startup, choose jira, select the HTTP port, and specify a cache path with at least 20 GB of free space. The default Jira port is 5001.

Run the Migration

1. Open the migration tool in a browser.
2. Click Migrate Now and log in to ONES.
3. Create a migration task and select the backup file.
4. Load and parse the Jira data.
5. Select the target team and projects.
6. Map issue types, fields, email suffixes, and users.
7. Review the configuration and start the migration.
8. Complete the post-migration steps.

For Jira Cloud migrations, contact ONES before starting.