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) を独自のサーバでホスティングしているインスタンスに移行する場合、クラウド ネイティブの連携機能は失われます。これらの機能は、アプリケーション間でアプリケーション リンクを構築することにより、再度有効にできます。手順については、「AppLinks を使用してその他のアプリケーションにリンクする」を参照してください。お困りの場合は、サポートまでお問い合わせください。
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 にデータをインポート
セットアップ ウィザードのステップ 2 (アプリケーション プロパティ)で、既存のデータの有無が確認されます。既存データをインポートをクリックし、指示に従って XML のバックアップをインポートします。
インポートの際に、以前の 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 関連問題です。これを修正するには、Jira アプリの Cloud 互換性を使用するか、データベースで更新スクリプトを実行できます。
このアプリを使用すれば手早く解決できますが、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; 9. ユーザーのパスワードをリセット
Jira Cloud から Jira Server への移行が完了した後で、ユーザーのパスワードをリセットする必要があります。これは、以下のいずれかの方法で実行できます。
[パスワードを忘れた場合] をクリックしてパスワードをリセットする必要があることを、全ユーザーに通知する。すべての Jira ユーザーへメールを送信する方法についてご確認ください。
- システム管理者としてログインし、全員のパスワードをリセットする。
これで、Jira Cloud サイトを Jira Server インスタンスに移行できました。