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.
その他のクラウド アプリケーションの移行
The instructions on this page only apply to Jira applications. If you're migrating other Cloud applications (e.g. Confluence Cloud to an instance installed from Confluence Server), see this page: Backing up and exporting data.
注: Jira Cloud アプリとその他のアプリ (例: Confluence Cloud) を独自のサーバーでホストしているインスタンスに移行する場合は、クラウド ネイティブな統合機能が失われます。アプリ間でアプリケーション リンクを構成することによって、これらの機能を再度有効にできます。手順については、「他のアプリにリンクする」を参照してください。お困りの場合は、サポートまでお問い合わせください。
Jira Cloud と Jira Server の違いの詳細
Jira Server への移行
1. バックアップ
Jira Cloud のアプリケーション データのバックアップを作成します。
管理者として Jira Cloud にログインします。
XML バックアップを作成します。詳細は、「Cloud から Server への課題のエクスポート」を参照してください。エクスポートの過程で、クラウド アプリケーションやプラグインのライセンスが XML から削除されます。これにより、Jira Cloud サイトではライセンスを引き続き利用できますが、Server インスタンスではライセンスを利用できなくなる点にご注意ください。
2.最新バージョンのインストーラーのダウンロード
Download the installer for your operating system – Jira Core, Jira Software, or Jira Service Management.
3. Jira Server のインストール
Jira アプリケーションをインストールします。詳細は、「Jira アプリケーションのインストール」を参照してください。
インストールの際、既存のデータの有無について確認されます。このときに、次のステップの説明に従って XML バックアップをインポートできます。
4. Jira Cloud から Jira Server にデータをインポート
データを正しく移行するには、サーバーのタイムゾーンまたは Java 仮想マシン (JVM) のタイムゾーンを協定世界時 (UTC) に設定する必要があります。Java 環境のタイムゾーンを設定する方法をご確認ください。
In step 2 of the setup wizard (Application Properties), you'll be asked whether you have existing data. Select 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 にあるアプリを確認します。
Any app that you're currently using with Jira Cloud application will need to be installed in your Jira application installation. For example, Gliffy, Tempo, etc.
> [アプリの管理] の順に選択します。7. Jira Server にアプリをインストールします。
前のステップでメモした各アプリを Jira アプリケーションにインストールします。必ず、アプリの最新バージョンをインストールしてください。アトラシアンは、アプリの古いバージョンのインストールによってダウングレードされたデータについてはサポートを提供していません。
アプリのインストール方法の詳細については、「アプリの管理」を参照してください。アプリ ライセンス キーを手動で追加する必要があります。
8. Run update scripts in your database
After you migrate from Cloud to Server, it might happen that user mentions are shown as AccountID rather than username. This is a known GDPR-related issue. To fix it, you can run update scripts in your database. Make sure that you run the scripts in your test environment first, and create a DB backup.
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 への移行が完了した後で、ユーザーのパスワードをリセットする必要があります。これは、以下のいずれかの方法で実行できます。
Notify all users that they need to select Forgot password to reset their password. Learn how to send an email to all Jira users
システム管理者としてログインし、全員のパスワードをリセットする。
これで、Jira Cloud サイトを Jira Server インスタンスに移行できました。
既知の問題
Jira Cloud から Jira Server への移行中または移行後に、いくつかの既知の問題が発生する可能性があります。これらは主に 2 つの製品のソース コードの違いが原因です。
See more details of the issues in the following table
| 課題 | ソリューション |
|---|---|
Jira Cloud から Jira Data Center アプリにデータを移行した後、時刻が正しく表示されません。 Users may notice that the timestamps for issue creation, comments, and other activities don' match the expected local time. | この課題は、Jira Cloud から移行されたデータが協定世界時 (UTC) 以外のタイム ゾーンでインポートされた場合に発生します。 この問題を回避するには、手順 4 でデータをインポートする前に、次のいずれかを行う必要があります。
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 で追跡されている既知の問題です。 遠慮なくチケットにコメントをご記入ください。アトラシアンがユース ケースを深く理解し、この問題がカスタマーの業務にどのような影響を与えているかを把握できます。 |