Jira Cloud から Server アプリケーションに移行する
このページでは、Jira Cloud から Jira Server へのデータの移行について説明します。Jira Server から Jira Cloud に移行する場合は、移行リソースをチェックしてください。
Jira Cloud は通常、Jira Server よりも先に進んだバージョンを利用しており、したがっていくつかの機能を Jira Server で利用できない可能性があります。
サイト全体ではなくプロジェクトを移動する場合は、「バックアップからプロジェクトをリストアする」を参照してください。
制限事項
Jira Cloud アプリケーションは定期的に更新されており、常に最新の機能を備え、機能改善が適用されています。このため、Jira アプリケーションの最新のダウンロード版よりも新しいバージョン上で実行されています。Jira Cloud アプリケーションから Jira Server アプリケーションに移行する場合は、次の制限事項にご注意ください。
機能の不足
Jira Cloud には多くの場合、Jira Server の最新バージョンで未リリースの機能が含まれています。
パスワードのリセット
Jira Cloud のユーザーは、新しい Jira Server インスタンスにログインする前にパスワードをリセットする必要があります。
Jira アプリケーションのライセンス
Atlassian Cloud ライセンスは、Jira Server アプリケーションからインストールされたインスタンスでは使用できません。https://my.atlassian.com にアクセスして、Jira Server アプリケーションの新しいライセンスを生成する必要があります。
You can reuse your licenses for plugins in your instance installed from Jira Server applications. The licenses for Atlassian plugins and Gliffy for Jira applications can be viewed on https://my.atlassian.com. For all other third-party plugins, contact the third-party vendor for a license.
ユーザーのアバター
Due to recent changes that took place in Cloud, User avatars now reside in id.atlassian.com. They are not included in the Cloud backup and, therefore, cannot be migrated to JIRA Server.
その他のクラウド アプリケーションの移行
このページの手順は、Jira アプリケーションにのみ適用されます。その他のクラウド アプリケーションを移行する (例: Confluence Cloud を Confluence Server からインストールしたインスタンスへ移行する) 場合は、「データのバックアップとエクスポート」を参照してください。
注: Jira Cloud アプリケーションとその他のアプリケーション (例: Confluence Cloud) を独自のサーバーでホスティングしているインスタンスに移行する場合は、クラウド ネイティブな統合機能が失われます。アプリケーション間でアプリケーション リンクを構築することによって、これらの機能を再度有効にできます。手順については「他のアプリケーションにリンクする」をご参照ください。お困りの場合は、サポートまでお問い合わせください。
Jira Cloud と Jira Server の違いの詳細
Jira Server への移行
1. バックアップ
Jira Cloud のアプリケーション データのバックアップを作成します。
管理者として Jira Cloud にログインします。
XML バックアップを作成します。詳細は、「Cloud から Server への課題のエクスポート」を参照してください。エクスポートの過程で、クラウド アプリケーションやプラグインのライセンスが XML から削除されます。これにより、Jira Cloud サイトではライセンスを引き続き利用できますが、Server インスタンスではライセンスを利用できなくなる点にご注意ください。
2.最新バージョンのインストーラーのダウンロード
お使いのオペレーティング システムのインストーラーをダウンロードします – Jira Core、Jira Software、または Jira Service Desk。
3. Jira Server のインストール
Jira アプリケーションをインストールします。詳細は、「Jira アプリケーションのインストール」を参照してください。
インストールの際、既存のデータがあるかどうか尋ねられます。次の手順で説明するように、このときに XML バックアップをインポートできます。
4. Jira Cloud から Jira Server にデータをインポート
To ensure that your data is migrated correctly, you need to set your server’s timezone or the Java Virtual Machine (JVM) timezone to Coordinated Universal Time (UTC). Learn how to set the timezone for the Java Environment
In step 2 of the setup wizard (Application Properties), you'll be asked whether you have existing data. Click Import your existing data, and follow instructions to import your XML backup.
インポートの際に、以前の Jira バージョンからデータをインポートする旨の警告が表示されます。この警告を無視してインポートを続行できます。
バックアップが 2 GB 以上の場合、添付ファイルを別途インポートしてください
大規模なバックアップの場合は、添付ファイルを個別にインポートすることをお勧めします。この操作を行うには、次の手順に従います。
バックアップ ファイルを展開します。
Linux で unzip ユーティリティを使用している場合は、バックアップ ファイルを抽出する前に、UNZIP_DISABLE_ZIPBOMB_DETECTION=TRUE環境変数を設定して、大きなアーカイブを展開しようとする際にエラーが発生するのを防止します。代替手段として (または Windows を使用している場合)、7-zip ユーティリティを使用します。activeobjects.xmlおよびentities.xmlファイルのみを圧縮します。上記のように、セットアップ ウィザードで圧縮ファイルをインポートします。
attachmentsディレクトリのコンテンツを、Jira Server の<home-directory>/data/attachmentsディレクトリにコピーします。
移行後
5. 管理者パスワードの変更
次の認証情報を使用して、新規の Jira アプリケーションにログインします。
ユーザー名:
sysadminパスワード:
sysadmin
ログイン後、直ちにパスワードを変更します。
6. Cloud にあるアプリを確認します。
Jira Cloud アプリケーションで使用中のアプリは、Jira アプリケーション インストールにインストールする必要があります。たとえば、Gliffy、Tempo などです。
> [アプリの管理] の順に選択します。7. Jira Server にアプリをインストールします。
上記のステップに記載された各アプリを Jira アプリケーションにインストールします。必ず、アプリの最新バージョンをインストールしてください。アトラシアンは、アプリの古いバージョンのインストールによってダウングレードされたデータについてはサポートを提供していません。
アプリのインストール方法の詳細については、アプリの管理を参照してください。アプリ ライセンス キーを手動で追加する必要があります。
8.Jira アプリのクラウド互換性をインストールするか、スクリプトを実行します。
Cloud から Server への移行後、ユーザー メンションがユーザー名ではなく AccountID として表示される場合があります。これは、既知の GDPR 関連問題です。これを修正するには、Cloud compatibility for Jira アプリを使用するか、データベースで更新スクリプトを実行できます。
このアプリを使用すれば手早く解決できますが、UI 側の問題を解決し、Jira Cloud からの accountId を wiki マークアップ フィールドのよりユーザー フレンドリーなテキストに置き換えるだけなので、あくまで一時的な措置です。しかし、自分の環境でスクリプトをテストする時間がなく、手早く解決したい場合は、これも選択肢になり得ます。このアプリは、Jira Server 8.0 以降に対応しています。
Jira Server インスタンスで、[Jira 管理] > [アプリの管理] > [新しいアプリの検索] に移動します。
Jira に対する Cloud の互換性を検索します。
アプリをインストールします。
問題を永久的に解決するには、データベースで更新スクリプトを実行します。まず、テスト環境でスクリプトを実行し、DB バックアップを作成してください。
PostgreSQL
SELECT ('UPDATE jiraaction SET actionbody = replace(actionbody, ''accountid:' || cu.external_id || ''', ''' || cu.lower_user_name || ''') WHERE actionbody LIKE ''%[~accountid:' || cu.external_id || ']%'';') as "Queries to fix" FROM cwd_user cu WHERE cu.external_id IS NOT NULL; MySQL
SELECT (CONCAT('UPDATE jiraaction SET actionbody = replace(actionbody, ''accountid:' , ifnull(cu.external_id, '') , ''', ''' , ifnull(cu.lower_user_name, '') , ''') WHERE actionbody LIKE ''%[~accountid:' , ifnull(cu.external_id, '') , ']%'';')) as "Queries to fix" FROM cwd_user cu WHERE cu.external_id IS NOT NULL; MS SQL:
SELECT (((((('UPDATE jiraschema.jiraaction SET actionbody = CAST(REPLACE(CAST(actionbody as NVarchar(MAX)), ''accountid:' + cast(cu.external_id as varchar(max))) + ''', ''') + cast(cu.lower_user_name as varchar(max))) + ''') AS NText) WHERE actionbody LIKE ''%[[]~accountid:') + cast(cu.external_id as varchar(max))) + ']%'';') [Queries to fix] FROM jiraschema.cwd_user cu WHERE cu.external_id IS NOT NULL; 9. ユーザーのパスワードをリセット
Jira Cloud から Jira Server への移行が完了した後で、ユーザーのパスワードをリセットする必要があります。これは、以下のいずれかの方法で実行できます。
[パスワードを忘れた場合] を選択してパスワードをリセットする必要があることを全ユーザーに通知します。すべての Jira ユーザーにメールを送信する方法をご確認ください。
システム管理者としてログインし、全員のパスワードをリセットする。
これで、Jira Cloud サイトを Jira Server インスタンスに移行できました。
既知の問題
Jira Cloud から Jira Server への移行中または移行後に、いくつかの既知の問題が発生する可能性があります。これらは主に 2 つの製品のソース コードの違いが原因です。
問題の詳細については、次の表を参照してください。
| 課題 | ソリューション |
|---|---|
After migrating data from Jira Cloud to Jira Data Center, the time is displayed incorrectly. Users may notice that the timestamps for issue creation, comments, and other activities do not match the expected local time. | This issue occurs when the data from Jira Cloud was imported in other time zone than Coordinated Universal Time (UTC). To avoid this, before you import data in step 4, you need to do one of the following:
For instructions, refer to Set the timezone for the Java Environment. |
Jira Server は Jira Cloud からデータをインポートするように設定されていますが、データをインポートするかどうかを確認するプロンプトは表示されません。 | Jira Server データベースにすでに何らかのデータが含まれている場合、Jira の起動時にバックアップからデータをインポートするように求められないことがあります。Jira のユーザー インターフェイスが表示されるだけです。 データベースの復元に進むことができます。データベースを復元すると、その中のデータが上書きされます。そのため、データを上書きしても他の問題が発生しないと確信できる場合にのみ、この手順を実行してください。 |
Jira Cloud から移行した後、Jira Server は同じサーバー インスタンスのバックアップからプロジェクトをインポートできないことがあります。この場合、「エラーの数が多すぎるためインポートが中止されました」という通知が表示されます。 | これは、このナレッジ ベース記事に記載されている既知の問題です。この記事では、問題が発生する可能性のあるシナリオと解決方法が説明されています。 |
| Jira Cloud から Server に移行した後、ユーザーはどの Jira アプリケーション (Jira Core、Jira Software、Jira Service Management) に対しても新しいライセンスを生成できなくなります。 | これは、チケット JRASERVER-66787 で追跡されている既知の問題です。 遠慮なくチケットにコメントをご記入ください。アトラシアンがユース ケースを深く理解し、この問題がカスタマーの業務にどのような影響を与えているかを把握できます。 |