Jira の移行前のチェックリスト
移行は、複雑で困難なプロセスになることがあります。
アトラシアンではお客様を支援するため、データを Jira Server または Data Center からクラウドに移行する準備が整っていることを確認するために必要なすべての項目を示したチェックリストを作成しました。
一般的なエラーを防ぐため、移行を試す前に次の確認を完了します。
はじめる前に
1. 移行方法を確認する
確認する内容は、移行方法によって異なります。このチェックリストでは次の移行方法を網羅しています。
次に、選択した移行メソッドに対応した移行前のチェックに従います。
2. 準備
移行前のチェックを完了するには、以下へのアクセス権が必要な場合があります。
Jira Server または Cloud のユーザー インターフェイス
展開されていない Jira サポート Zip
展開されていない Jira XML バックアップ
ソース インスタンスでの SQL クエリの実行
Jira Cloud Migration Assistant のチェックリスト
Jira Cloud Migration Assistant は、データに一般的なエラーがないかどうかを自動的に確認します。次の点が確認されます。
すべてのユーザーが有効なメール アドレスを持っていること
すべてのユーザーが一意のメール アドレスを持っていること
プロジェクト名またはキーがクラウド内のプロジェクト名またはキーと競合していないこと
移行アシスタントが最新かどうか
ただし、移行アシスタントはすべてを確認するわけではありません。このため、移行を開始する前に次のリストを使用したチェックを行う必要があります。
1. ユーザーの移行計画を作成する 必須
外部ディレクトリ
アクティブな外部ユーザー ベースを同期し、ユーザー移行戦略の一環としてすべてのユーザーやグループが適切に移行されていることを確認します。また、これにより、移行中にデータが適切なユーザーに引き続きリンクされるようにします。
外部プロバイダを使用してユーザーを管理している場合、移行前に、それらのユーザーがアクティブで、内部ユーザー ベースと同期されていることを確認します。
Jira Cloud Migration Assistant はすべてのユーザーとグループを移行します。移行する具体的なユーザーまたはグループを選択する必要がある場合、アトラシアン サポートにお問い合せください。
2. Jira Server のバージョンを確認する 必須
Jira がサポート対象バージョンで実行していることを確認します。サポー対象のバージョンではない場合、移行アシスタントは機能しません。
3. 重複しているメール アドレスを修正する 必須
メール アドレスの重複は Jira Cloud でサポートされていないため、これらのユーザーを Jira Cloud Migration Assistant で移行することはできません。エラーを回避するために、移行前にメール アドレスの重複を見つけて修正する必要があります。ユーザー情報が LDAP サーバーで管理されている場合、移行前にそこでメールを更新し、Jira と同期する必要があります。ユーザー情報をローカルで管理している場合、Jira Server または Data Center の UI でそれらを修正できます。
4. 適切な権限を持っていることを確認する 必須
移行を実行するユーザーが、次の権限を持っていることを確認します。
Server インスタンスのシステム管理者グローバル権限を持っていること
宛先のクラウド サイトに存在すること
クラウドのサイト管理者権限を持っていること
移行するすべてのプロジェクトの課題の作成権限を持っていること
5. グループ名の競合を確認する 必須
クラウド サイトのグループの名前がサーバー サイトのグループと異なることを確認します (意図的に統合しようとしている場合を除く)。「移行アシスタントがグループ名の競合を処理する方法」をご確認ください。
一部の移行シナリオでは、サーバー サイトにアドオン ユーザーが発生することがあります。サーバーの世界においてアドオン ユーザーは一般的ではないため、クラウドに戻す移行の際にいくつかの問題が発生する可能性があります。移行の前に、これらのアドオン ユーザーを削除または更新します。
6. ファイアウォールの許可ルールを更新する 必須
移行アシスタントは移行を実行するためにアトラシアンのドメインに接続します。ファイアウォールまたはリバース プロキシによってドメインがブロックされると、移行は失敗します。
7. アプリの移行方法を決定する 必須
Jira Cloud Migration Assistant はアプリまたはアドオン データを移行しません。移行するアプリ データがある場合、それらのデータを適切に移行する方法を事前にベンダーに問い合わせてください。これには Portfolio for Jira などのアトラシアン製のアプリが含まれます。Portfolio for Jira を移行する必要がある場合、関連する機能リクエストをウォッチして最新情報を受け取ることができます。
Jira Cloud 内では Portfolio はスタンドアロン アプリとしては提供されていませんが、Jira Software Cloud Premium の Advanced Roadmaps として機能を利用できます。詳細情報
8. パブリック アクセス設定を確認する 必須
Jira Server または Jira Cloud サイトをインターネットに公開するように構成できます。プロジェクトを意図的に公開する場合を除き、プロジェクト権限を確認してください。Jira Server に公開プロジェクトがある場合、クラウドへの移行前にそれらの匿名アクセスのセットアップを削除します。これらのプロジェクトは移行後にいつでも公開できます。パブリック アクセス設定のチェックの詳細は、こちらをご覧ください。
9. サーバーのセットアップを確認する 必須
移行する課題またはプロジェクトの数によっては、Jira Server で OutOfMemory エラーが発し、移行全体がクラッシュします。これを防ぐため、「Jira アプリケーションのメモリの容量を増やす」に記載されているパラメーターを確認して、アプリケーションが 4 GB 以上のヒープ割り当てで実行されていることを確認します。
また、オープンなファイルの制限を確認します。理想的には、32768 に近ければ近いほど望ましいです。システムに設定されるオープンなファイルの数は、Linux ディストリビューションに応じて異なる場合があります。これをシステム コマンド経由で確認する方法が不明な場合、サポート Zip を作成し、application-properties/application.xml ファイルを開いて、<max-file-descriptor> を検索します。この数が 32768 に近い場合は、適宜調整します。詳細は、「Too many open files エラー」ドキュメントで確認できます。これは、Windows を実行している場合には適用されません。
10. サーバーのタイムゾーンを確認する (クラウド サイトを統合する場合) 必須
Jira Cloud サイトを統合するために移行アシスタントを使用している場合、課題のタイムスタンプのタイムゾーンがわずかに変わることがあります。Jira Cloud は UTC を使用します。Jira Server インスタンスがこれ以外のタイムゾーンを使用している場合、UTC との時差に基づいて時間が変更されます。
回避策として、こちらの記載に従い、Jira Server インスタンスの -Duser.timezone=UTC にシステム フラグを追加します。
11. 共有されている構成名の重複を修正する 推奨
移行での競合を防ぐために、クラウド サイトの共有設定と同じ名前を持つ、サーバー インスタンスの共有設定 (ワークフローまたは権限スキーム) の名前を変更します。競合が見つかった場合、移行中に設定の名前が変更される場合があります。
12. ストレージの上限を超えていないことを確認する 推奨
アトラシアンのクラウド プランには個別のストレージ制限があります。移行前に、現在使用しているディスク領域と、弊社のクラウド ストレージのドキュメントをご確認ください。
13. サーバー インスタンスの準備 推奨
サーバー データが正常に移行されるよう、データベース整合性チェッカー (Jira Server のネイティブ機能) と Atlassian Marketplace の Integrity Check for Jira アプリを使用して、データのステータスを確認します。
他のチェックおよび実行すべきアクションは次のとおりです。
すべての必須フィールドが値を持ち、null が使用されていないこと
移行したいアーカイブ済みのプロジェクトを再有効化していること
移行した非アクティブなユーザー ディレクトリを再有効化していること
データのクリーン アップの詳細については、「移行前のサーバー インスタンスのクリーン アップ」を参照してください。
14. クラウド サイトの準備 推奨
クラウド サイトのセットアップ時には次の点を考慮します。
クラウド サイトでは、サーバー サイトと同じ Jira 製品が有効化されている必要があります (Jira Service Management を除く)。たとえば、サーバー サイトに Jira Core と Jira Software がある場合、Jira Core プロジェクトを移行しない場合でもクラウド サイト上で両方が必要になります。これは、すべてのユーザーとグループを正常に移行するためです。移行後にこれらの製品を使用したくない場合、関連製品の無料トライアルをセットアップしてから移行後にそれらを無効化します。
クラウド サイトの言語が、サーバー サイトの言語と同じであることを確認します。言語が異なる場合、一部のフィールドが適切に移行されない場合があります。
Atlassian Access を使用する場合、移行前にそれをセットアップする必要があります。
15. データのバックアップを作成する 推奨
移行を実行する前に、現在の Jira Server サイトをバックアップすることをおすすめします。移行先の Cloud サイトに既存のデータがある場合、同様に Jira Cloud サイトもバックアップします。
16. テスト移行を実行する 推奨
テスト移行を行ってから本番環境への移行を行うことを強く推奨します。移行テストのガイダンスをご参照ください。
17. 移行プランをサポートに共有する 推奨
週末や祝日に移行を行う場合、またはクラウド上のユーザーが 1,000 人以上になる場合は、2 週間以上前に移行サポート チームにお知らせください。弊社で人員を用意し、移行を支援いたします。
アトラシアンでのクラウドへの移行のサポートについてご確認ください。
Jira サイト インポートのチェックリスト
1. Jira Server のバージョンを確認する 必須
インポートが機能するには、バックアップの XML ファイルがサポート対象のバージョンの Jira Server または Data Center から取得されたものである必要があります。
レポートの不一致の可能性
Due to JSWSERVER-14984 - Getting issue details... STATUS there might be possible reporting discrepancies between Server and Cloud in Jira versions below 8.11/8.13.15 since Server incorrectly does not render some sprints.
2. XML ファイルが有効であることを確認する 必須
entities.xml と activeobjects.xml の両方が有効な XML ファイルであることを確認します。複雑な環境を持つ大規模なお客様の環境からのエクスポートでは、XML 構造が無効になる場合があります。
3. XML ファイルの構造を確認する 必須
バックアップ ファイルがインポート用に適切に構築されていることを確認します。大きなインスタンスの場合、クラウドのバックアップ ファイルを、activeobjects.xml および entities.xml を含むデータベース ファイルと、添付ファイルやその他のメディアを含むファイルに分割することをおすすめします。これによってタイムアウト エラーを防いだり、インポート時の問題のリスクを軽減したりすることができます。
4. 失敗したアップグレード タスクを確認する 必須
Jira Server に、アップグレードに失敗したタスク、またはアップグレードが保留中となっているタスクがある場合、クラウドへのインポートが失敗することがあります。
5. 重複しているユーザー メールや無効なユーザー メールを確認する 必須
インポートに失敗する最も一般的な理由の 1 つは、メールの重複や無効なメールです。インポート チェックでは重複しているメールや無効なメールが確認されますが、これにより、時間がかかるインポートまたはアップロードに失敗したり、大規模なお客様の場合はメンテナンス時間がかかったりする場合があります。ベスト プラクティスは、このようなメール アドレスを事前に確認することです。
さらに、アドオン ユーザーが存在する場合、移行時に問題が発生する可能性があります。クラウドにインポートする前にアドオン ユーザーをクリーン アップすることで、この問題を回避できます。
6. テスト中にクラウドで受信メール ハンドラーを無効にする必須
既定では、受信メール ハンドラーはインポート後にオンになります。これによって、クラウドのメール ハンドラーがサーバーのメール ハンドラーの代わりにメールを処理する可能性があります。メールが誤って処理されないように、テスト中はこれらの機能をオフにすることを強くお勧めします。
以下を実行できます。
> [Jira 設定] > [システム] の順にクリックします。
[グローバル メール設定] を選択して、[メールのプル機能] と [メールのプロセス機能] をオフにします。
[受信メール] を選択して、すべてのメール サーバーとハンドラーを削除します。
Jira Service Management を使用している場合は、[設定] > [製品] > [メール リクエスト] の順に移動して、[メール アドレス] セクションが空であることを確認します。
7. 無効な文字や処理されていない文字を確認する 必須
古いバージョンの Jira では、制御文字を含むテキストをコピーして Jira 課題のフィールドに貼り付けることができました。Jira のバックアップ形式は XML であり、XML ではほとんどの制御文字が保存されないため、これによって問題が発生します。制御文字を含む XML が Jira にインポートされると、不可逆なエラーが発生してインポートに失敗します。
これを防ぐためにガイドに従って、entities.xml ファイルと activeobjects.xml ファイルの両方で XML バックアップから無効な文字を削除します。
8. 重複しているワークフローを修正する 必須
バックアップ ファイルに同じ名前のワークフローがある場合、インポートに失敗することがあります。製品設計により、ユーザー インターフェイスからワークフローを作成した場合、それらは別の名前を持つ可能性があります。ただし、ワークフロー名に大文字と小文字が異なる同じ名前がある場合 (例: "workflow1" と "WORKFLOW1")、インポートの失敗につながる可能性があります。
9. 重複クラスタ ジョブを見つける 必須
バックアップ ファイルに同じ ID の重複クラスタ ジョブがある場合、インポートに失敗することがあります。このページの記載に従い、インポート前に、クラスタ ジョブに重複 ID がないことを確認する必要があります。
10. 添付ファイル名の長さを確認する 必須
バックアップに 250 文字を超えるファイル名を持つ添付ファイルがある場合、インポートに失敗することがあります。
11. パブリック アクセス設定を確認する 必須
Jira Server または Jira Cloud サイトをインターネットに公開するように構成できます。プロジェクトが意図的に公開される場合を除き、Jira Server で公開されているプロジェクトのプロジェクト権限を確認し、クラウドへの移行前にそれらの匿名アクセスのセットアップを削除します。
12. クラウド ユーザーの上限を超えていないことを確認する 必須
サーバーから移行するユーザーの合計数に、クラウド内に既に存在するユーザーの数を加えた数が、サブスクリプションのユーザー階層を超えないようにします。たとえば、51 ~ 100 のユーザー サブスクリプションをお持ちの場合、110 人のアクティブ ユーザーをインポートしようとすると、移行は失敗します。
解決するには、次のいずれかを実行してください。
ユーザー数の上限が大きいプランをサブスクライブする
移行前にユーザーの数を減らす
アトラシアン サポートに問い合わせ、事前に製品アクセスなしでユーザーをインポートする。
13. サーバーのタイムゾーンを確認する 必須
Jira Site Import を使用している場合、日付のタイムスタンプのタイムゾーンがわずかにずれている可能性があります。Jira Cloud はタイムゾーンに UTC (協定世界時) を使用します。Jira Server インスタンスがこれ以外のタイムゾーンを使用している場合、UTC との時差に基づいて時間が変更されます。
回避策として、こちらの記載に従い、Jira Server インスタンスの -Duser.timezone=UTC にシステム フラグを追加します。
14. 添付ファイルのサイズを確認する 推奨
Jira Cloud へのインポートに多数の添付ファイル (未圧縮で 20+ GB) が含まれる場合、遅延やタイムアウトが発生する可能性があります。データベース バックアップ (entities.xml および activeobjects.xml ファイル) をインポートしてからメディア (添付ファイル、プロジェクト アバター、およびロゴ) を個別にインポートすることをおすすめします。
15. 孤立データを確認する 推奨
バックアップに孤立データがある場合、それらがクラウド内で適切に処理されず、インポートに失敗することがあります。一般的なシナリオとして、null プロジェクト キーがあります。
16. ストレージの上限を超えていないことを確認する 推奨
アトラシアンのクラウド プランには個別のストレージ制限があります。移行前に、現在使用しているディスク領域と、弊社のクラウド ストレージのドキュメントをご確認ください。
17. データのバックアップを作成する 推奨
移行や、本ガイドで推奨されているいずれかの更新を実行する前に、復元ポイントを確保できるよう、現在の Jira Server サイトをバックアップすることをおすすめします。移行先の Cloud サイトに既存のデータがある場合、移行後に何らかの理由で変更を元に戻す必要が発生した場合に備え、同様に Jira Cloud サイトもバックアップします。これはベスト プラクティスであり、メンテナンスを元に戻す必要が発生した場合に備えて復元ポイントを追加します。
18. テスト移行を実行する 推奨
テスト移行を行ってから本番環境への移行を行うことを強く推奨します。移行テストのガイダンスをご参照ください。
19. 移行プランをサポートに共有する 推奨
週末や祝日に移行を行う場合、またはクラウド上のユーザーが 1,000 人以上になる場合は、2 週間以上前に移行サポート チームにお知らせください。弊社で人員を用意し、移行を支援いたします。
アトラシアンでのクラウドへの移行のサポートについてご確認ください。
詳細情報とサポート
移行をサポートする多数のチャンネルをご用意しています。
移行の詳細な計画情報や FAQ については、Atlassian Cloud 移行センターを参照してください。
技術的な問題が発生していたり、戦略やベスト プラクティスで支援が必要な場合、お問い合わせください。
また、アトラシアン コミュニティもご利用ください。
エキスパートによる支援が必要な場合、アトラシアン パートナーにご相談ください。