Migration-Tool

Migration-Tool is a web tool for migrating Jira data to ONES system. Migration-Tool will read the backup package directory and the attachment directory of Jira Server, which are located in Jira Local Home. It will not modify and delete jira server data.

• Jira Local Home (default): /var/atlassian/application-data/jira
• Backup package directory: Jira Local Home/export
• Attachment directory: Jira Local Home/data/attachments

---

Version Relationship

Tools Version	ONES Version	Remark
v6.x.x	[3.14.0, ~)	recommended

---

Mapping xlsx

The following forms show how Jira data will be migrated to ONES (such as Jira project, user, issue, etc.)

Chinese version: Jira数据迁移清单.xlsx

English version: Jira migration mapping form.xlsx

Japanese version: Jira データ移行リスト.xlsx

---

Quick Start

Step 1: Log into jira server by ssh

Step 2: Download the zip file to jira server

Step 3: Unzip file and run start.sh

ssh jira@jira-server-ip

unzip migration-tool-*-*.zip && cd migration-tool-*-* && ./scripts/start.sh

Parameters that need to be entered when starting the migration tool

• Please input Migration Tool http port (default: 5001)
• Please input Jira Local Home (default: /var/atlassian/application-data/jira)[https://confluence.atlassian.com/adminjiraserver/jira-application-home-directory-938847746.html]
• Please input Jira Attachment Path (default: /var/atlassian/application-data/jira/data/attachments)
• Please input cache path, at least 20G (default: /data/nas/importer/cache-5001)

Then visit Jira migration tool by website: http://jira-server-ip:port