Jira Cloud から Data Center アプリに移行する
このページでは、Jira Cloud から Jira Data Center へのデータの移行について説明します。Jira Data Center から Jira Cloud に移行する場合は、移行リソースをチェックしてください。
Jira Cloud は通常、Jira Data Center よりもバージョンが先行しているため、Jira Data Center に移行後は一部の機能を利用できなくなる可能性があります。
サイト全体ではなくプロジェクトを移動する場合は、「バックアップからプロジェクトをリストアする」を参照してください。
制限事項
Jira Cloud アプリは定期的に更新されており、常に最新の機能を備え、機能改善が適用されています。つまり、Jira アプリケーションの最新のダウンロード版よりもバージョンが新しいということです。Jira Cloud アプリから Jira Data Center アプリに移行する場合は、次の制限事項にご注意ください。
機能の不足
Jira Cloud には多くの場合、Jira Data Center の最新バージョンで未リリースの機能が含まれています。
パスワードのリセット
Jira Cloud のユーザーは、新しい Jira Data Center インスタンスにログインする前にパスワードをリセットする必要があります。
Jira アプリケーションのライセンス
Atlassian Cloud ライセンスは、Jira Data Center アプリからインストールしたインスタンスでは使用できません。https://my.atlassian.com にアクセスして、Jira Data Center アプリの新しいライセンスを生成する必要があります。
Jira Data Center アプリからインストールしたインスタンスで、プラグイン用のライセンスを再利用できます。アトラシアン プラグインと Jira アプリケーション用 Gliffy のライセンスは、https://my.atlassian.com で表示できます。その他のサードパーティ製プラグインのライセンスについては、そのベンダーに問い合わせていただく必要があります。
ユーザーのアバター
Cloud での最近の変更を受け、ユーザー アバターは id.atlassian.com に含まれるようになりました。これらは Cloud のバックアップには含まれず、そのため、Jira Data Center に移行することもできません。
その他のクラウド アプリケーションの移行
このページの手順は、Jira アプリケーションにのみ適用されます。その他の Cloud アプリを移行する (例: Confluence Cloud を Confluence Data Center からインストールしたインスタンスへ移行する) 場合は、「データのバックアップとエクスポート」を参照してください。
注: Jira Cloud アプリケーションとその他のアプリケーション (例: Confluence Cloud) を独自のサーバーでホスティングしているインスタンスに移行する場合は、クラウド ネイティブな統合機能が失われます。アプリケーション間でアプリケーション リンクを構築することによって、これらの機能を再度有効にできます。手順については「他のアプリケーションにリンクする」をご参照ください。お困りの場合は、サポートまでお問い合わせください。
Jira Cloud と Jira Data Center の違いの詳細
Jira Data Center への移行
1. バックアップ
Jira Cloud のアプリケーション データのバックアップを作成します。
管理者として Jira Cloud にログインします。
XML バックアップを作成します。詳細は、「Cloud から Data Center への課題のエクスポート」を参照してください。エクスポートの過程で、クラウド アプリやプラグインのライセンスが XML から削除されます。これにより、Jira Cloud サイトではライセンスを引き続き利用できますが、Data Center インスタンスではライセンスを利用できなくなる点にご注意ください。
2.最新バージョンのインストーラーのダウンロード
お使いのオペレーティング システムのインストーラー (Jira Software、Jira Service Desk) をダウンロードします。
3. Jira Data Center のインストール
Jira アプリケーションをインストールします。詳細は、「Jira アプリケーションのインストール」を参照してください。
インストールの際、既存のデータがあるかどうか尋ねられます。次の手順で説明するように、このときに XML バックアップをインポートできます。
4. Jira Cloud から Jira Data Center にデータをインポート
セットアップ ウィザードのステップ 2 (アプリケーション プロパティ)で、既存のデータの有無が確認されます。既存データをインポートをクリックし、指示に従って XML のバックアップをインポートします。
インポートの際に、以前の Jira バージョンからデータをインポートする旨の警告が表示されます。この警告を無視してインポートを続行できます。
バックアップが 2 GB 以上の場合、添付ファイルを別途インポートしてください
大規模なバックアップの場合は、添付ファイルを個別にインポートすることをお勧めします。この操作を行うには、次の手順に従います。
バックアップ ファイルを展開します。
Linux で unzip ユーティリティを使用している場合は、バックアップ ファイルを抽出する前に、UNZIP_DISABLE_ZIPBOMB_DETECTION=TRUE環境変数を設定して、大きなアーカイブを展開しようとする際にエラーが発生するのを防止します。代替手段として (または Windows を使用している場合)、7-zip ユーティリティを使用します。activeobjects.xmlおよびentities.xmlファイルのみを圧縮します。上記のように、セットアップ ウィザードで圧縮ファイルをインポートします。
attachmentsディレクトリの内容を、Jira Data Center の<home-directory>/data/attachmentsディレクトリにコピーします。
移行後
5. 管理者パスワードの変更
次の認証情報を使用して、新規の Jira アプリケーションにログインします。
ユーザー名:
sysadminパスワード:
sysadmin
ログイン後、直ちにパスワードを変更します。
6. Cloud にあるアプリを確認します。
Jira Cloud アプリケーションで使用中のアプリは、Jira アプリケーション インストールにインストールする必要があります。たとえば、Gliffy、Tempo などです。
> [アプリの管理] の順に選択します。7. Jira Data Center へのアプリのインストール
上記のステップに記載された各アプリを Jira アプリケーションにインストールします。必ず、アプリの最新バージョンをインストールしてください。アトラシアンは、アプリの古いバージョンのインストールによってダウングレードされたデータについてはサポートを提供していません。
アプリのインストール方法の詳細については、アプリの管理を参照してください。アプリ ライセンス キーを手動で追加する必要があります。
8.Jira アプリのクラウド互換性をインストールするか、スクリプトを実行します。
Cloud から Data Center への移行後、ユーザー メンションがユーザー名ではなく AccountID として表示される場合があります。これは、既知の GDPR 関連問題です。これを修正するには、Cloud compatibility for Jira アプリを使用するか、データベースで更新スクリプトを実行できます。
このアプリを使用すれば手早く解決できますが、UI 側の問題を解決し、Jira Cloud からの accountId を wiki マークアップ フィールドのよりユーザー フレンドリーなテキストに置き換えるだけなので、あくまで一時的な措置です。しかし、自分の環境でスクリプトをテストする時間がなく、手早く解決したい場合は、これも選択肢になり得ます。このアプリは、Jira Data Center 8.0 以降に対応しています。
Jira Data Center インスタンスで、[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 Data Center への移行が完了した後で、ユーザーのパスワードをリセットする必要があります。これは、以下のいずれかの方法で実行できます。
[パスワードを忘れた場合] を選択してパスワードをリセットする必要があることを全ユーザーに通知します。すべての Jira ユーザーにメールを送信する方法をご確認ください。
システム管理者としてログインし、全員のパスワードをリセットする。
これで、Jira Cloud サイトを Jira Data Center インスタンスに移行できました。
既知の問題
Jira Cloud から Jira Data Center への移行中または移行後に、いくつかの既知の問題が発生する可能性があります。これらは主に 2 つの製品のソース コードの違いが原因です。
問題の詳細については、次の表を参照してください。
| 課題 | ソリューション |
|---|---|
Jira Data Center は Jira Cloud からデータをインポートするように設定されていますが、データをインポートするかどうかを確認するプロンプトは表示されません。 | Jira Data Center データベースにすでに何らかのデータが含まれている場合、Jira の起動時にバックアップからデータをインポートするように求められないことがあります。Jira のユーザー インターフェイスが表示されるだけです。 データベースの復元に進むことができます。データベースを復元すると、その中のデータが上書きされます。そのため、データを上書きしても他の問題が発生しないと確信できる場合にのみ、この手順を実行してください。 |
Jira Cloud から移行した後、Jira Data Center は同じサーバー インスタンスのバックアップからプロジェクトをインポートできないことがあります。この場合、「エラーの数が多すぎるためインポートが中止されました」という通知が表示されます。 | これは、このナレッジ ベース記事に記載されている既知の問題です。この記事では、問題が発生する可能性のあるシナリオと解決方法が説明されています。 |
| Jira Cloud から Data Center に移行した後、ユーザーはどの Jira アプリケーション (Jira Core、Jira Software、Jira Service Management) に対しても新しいライセンスを生成できなくなります。 | これは、チケット JRASERVER-66787 で追跡されている既知の問題です。 遠慮なくチケットにコメントをご記入ください。アトラシアンがユース ケースを深く理解し、この問題がカスタマーの業務にどのような影響を与えているかを把握できます。 |