Cloud 移行を計画する
Atlassian Server 製品の移行準備に役立つドキュメント。
Confluence の移行前のチェックリスト
移行は、複雑で困難なプロセスになる可能性があります。アトラシアンではお客様をサポートするため、データを Confluence Server または Data Center から Cloud に移行する準備が整っていることを確認するために必要なすべての項目を示したチェックリストを作成しました。
一般的なエラーを防ぐため、移行を試す前に次の確認を完了します。
はじめる前に
1. 移行方法を確認する
さまざまな Cloud 移行方法をご確認ください。このチェックリストでは次の方法を網羅しています。
次に、選択した移行メソッドに対応した移行前のチェックに従います。
2. 準備する
移行前のチェックを完了するには、以下へのアクセス権が必要な場合があります。
Confluence Server または Cloud のユーザー インターフェイスへのアクセス
展開されていない Confluence Space エクスポートへのアクセス
解凍されたサポート zip ファイルへのアクセス。サポート zip を作成する方法を確認する
ソース インスタンスで SQL を実行する方法
Confluence Cloud Migration Assistant のチェックリスト
Confluence Cloud Migration Assistant 3.3.7 以降、ならびに Confluence Server / Data Center 6.15 以降へのアップグレード
より安定した信頼性の高い移行体験を提供するために、添付ファイルやその他のメディア ファイルの移行方法を改善しました。
2022 年 9 月 19 日以降は、次のようにアップグレードすることをお勧めします。
Confluence Cloud Migration Assistant 3.3.7 以降にアップグレード
Confluence Cloud Migration Assistant を使用する前に Confluence Server または Data Center 6.15 以降にアップグレード
2023 年 1 月 31 日以降は次のバージョンを使用できなくなります。
Confluence Cloud Migration Assistant 3.3.6 以前
Confluence Cloud Migration Assistant を使用する際は Confluence Server / Data Center 6.14 以前
このお知らせとアップグレード方法に関する詳細をご確認ください。
さらなる詳細や技術的な懸念については、お問い合わせください。
移行アシスタントは、データに一般的なエラーがないかどうかを自動で確認します。次の内容を確認します。
Migration Assistant アプリが最新かどうか
ユーザーに有効で一意のメール アドレスが紐付けられているかどうか
移行プロセスでのグループの統合
クラウド サイトにすでに存在するスペース
ただし、移行アシスタントはすべてを確認するわけではありません。このため、移行を開始する前に次のリストを使用したチェックを行う必要があります。
1. ユーザーの移行プランを確認する (必須)
アシスタントはユーザーやグループを移行できますが、アシスタントには、Confluence のみを移行するのか、Jira も同様に移行するのかを判断する機能は備わっていません。
Jira も Server から Cloud に移行する、または将来その可能性がある場合は、ユーザーの移行戦略を用意することが重要です。これによって、移行後にユーザー管理の問題やコンテンツの所有状況に関する問題が発生することを防ぎます。ユーザー移行戦略の詳細をご確認ください。
Confluence のみを移行
「ユーザーの移行戦略を決定する」のガイダンスをご確認ください。
Jira Cloud Migration Assistant によって Confluence と Jira を移行する
移行アシスタントはユーザーとグループを移行しますが、Jira と Confluence でメール アドレスが同じユーザーに割り当てられていることを確認する必要があります。たとえば、userA (usera@example.com) は Confluence と Jira にアクセスできますが、両方のアプリケーションがデータベース内に UserA 用の同じメール アドレスを持っている必要があります。これは、移行アシスタントが移行中にユーザーのメール アドレスを使用してコンテンツをマッピングするためです。
Jira サイト インポート (XML バックアップ) によって Confluence と Jira を移行する
この場合は 2 つのオプションがあります。
1. ユーザーを最初に移行する
「ユーザーの移行戦略を決定する」に記載されているようにアトラシアンのサポート チームのサポートによってすべてのユーザーを事前に移行して、次に Confluence または Jira を任意の順序で移行します。
2. 最初に Jira を移行する
Confluence Cloud Migration Assistant 経由で Confluence を移行する前に、Jira を移行します。Jira サイト インポートでは Server ユーザーが Atlassian アカウントに関連付けられないため、Confluence Cloud Migration Assistant を使用した後に Jira サイトの XML がインポートされた場合は、コンテンツの所有権が失われる可能性があります。これは、アシスタントがすべてのユーザーを作成して、データベース テーブルの Atlassian アカウントのハッシュに関連付けるためです。XML インポーターはこれらを読み取れないためユーザーがすでに Cloud に存在するかどうかを判断できず、すべての Jira 課題とコメントを「不明なユーザー」に関連付けます。これは、移行が完了すると元に戻せません。
一方、Confluence Cloud Migration Assistant の実行前に Jira Server の XML をインポートする場合、移行アシスタントでは既存の Server ユーザー名を Cloud にある Atlassian アカウントにマッピングできます。
2. Cloud ユーザーの上限を超えていないことを確認する (必須)
Free プランの Confluence Cloud サイトに移行する場合、移行アシスタントは移行によってユーザーの上限を超えないことを確認します。つまり、Server から移行されるユーザーの合計と、Cloud にすでに存在するユーザーの合計は 10 人以下でなくてはなりません。10 人を超えると移行は失敗します。
Confluence Cloud サイトが別のプランの年間サブスクリプションを使用している場合は、Server から移行されるユーザーの合計と Cloud にすでに存在するユーザーの合計が、サブスクリプションのユーザー階層を超えないことを確認する必要があります。たとえば、51 ～ 100 ユーザーのサブスクリプションを契約しているときに 110 人のアクティブなユーザーをインポートしようとすると、移行は失敗します。
これを修正するには、次の手順を実行します。
ユーザー数の上限が大きいプランをサブスクライブします。
移行前にユーザー数を減らします。
アトラシアン サポートにお問い合わせのうえ、事前に製品アクセスなしでユーザーをインポートする
SQL を使用した確認 (Postgres でテスト済み)
移行を実行する前に、以下のクエリによって移行するユーザーの数とご利用の Cloud プランのユーザーの上限を照合します。必要に応じて、ユーザー数の削減、Cloud プランのアップグレード、またはサブスクリプションへのユーザー数の追加を実行します。 1
2
3
4
5
6
7
8
9
10
--USER LIMITS - TESTED ON POSTGRESQL
SELECT u.lower_user_name, d.directory_name
FROM cwd_user u
JOIN cwd_membership m ON u.id = child_user_id
JOIN cwd_group g ON m.parent_id = g.id
JOIN SPACEPERMISSIONS sp ON g.group_name = sp.PERMGROUPNAME
JOIN cwd_directory d on u.directory_id = d.id
WHERE sp.PERMTYPE='USECONFLUENCE' AND u.active = 'T' AND d.active = 'T'
GROUP BY u.lower_user_name, d.directory_name
ORDER BY d.directory_name; |
サポート Zip を使用した確認
移行を実行する前に次のクエリを使用し、移行するユーザーの数とご利用のクラウド プランのユーザーの上限とを照合します。必要に応じ、ユーザー数の削減、クラウド プランのアップグレード、サブスクリプションへのユーザー数の追加などを行います。 1
grep '<users>' application.xml |
3. 適切な権限があることを確認する (必須)
移行を実行するユーザーが、次の権限を持っていることを確認します。
Server インスタンスのシステム管理者権限を持っていること
宛先のクラウド サイトに存在すること
Cloud のサイト管理者権限を持っていること
4. Confluence Server のバージョンを確認する (必須)
移行アシスタントが機能するには、サポート対象バージョンの Confluence を使用している必要があります。サポート対象バージョンの詳細をご確認ください。
サーバーの UI から確認する
Confluence のバージョンを検証するには、次の手順を実行します。
また、Linux および Windows では次の方法も使用できます。 |
Linux で確認する
これは次のコマンドを使用して検証できます。返される数字が 7901 (Confluence 6.13.x) 以上であることを確認します。 1
grep 'createdByBuildNumber' exportDescriptor.properties |
Windows で確認する
これは次のコマンドを使用して検証できます。返される数字が 7901 (Confluence 6.13.x) 以上であることを確認します。 1
cat exportDescriptor.properties | Select-String -Pattern createdByBuildNumber |
サポート Zip を使用した確認
これは次のコマンドを使用して検証できます。返されるバージョンが 5.10.x 以上であることを確認します。 1
grep '<product name="Confluence" version=' application.xml |
5. アプリまたはアドオンのメール アドレスを修正する (必須)
この確認は、2 つ以上の Confluence Cloud サイトをマージしてみる際に適用されます。よくあるシナリオの 1 つとして、いずれかのサイトを XML バックアップとしてエクスポートして Confluence Server インスタンスにインポートし、Confluence Cloud Migration Assistant を活用して目的のクラウド サイトにマージする方法があります。これによって、Cloud サイトから Server インスタンスにアプリ (アドオン) ユーザーが移動されます。Server の世界においてアドオン ユーザーは一般的ではないため、Cloud に戻す移行の際にいくつかの問題が発生する可能性があります。移行前に、これらのユーザーを削除または更新します。
SQL を使用した確認 (Postgres でテスト済み)
次のクエリでこれらのユーザーを見つけて削除するか、メール アドレスを @connect.atlassian.com 以外のものに更新します。 1
2
--ADD-ON USERS - TESTED ON POSTGRESQL
select * from cwd_user where lower_email_address like '%connect.atlassian.com%'; |
6. 重複しているメール アドレスを修正する (必須)
移行アシスタントは重複しているメール アドレスにフラグを付け、すべてのユーザーが一意のメール アドレスを持つまで移行を実行しません。プロアクティブな手順として、あらかじめ見つけて修正することをおすすめします。ユーザー情報が LDAP サーバー内で管理されている場合、移行前に LDAP サーバー内でメールを更新し、Confluence に同期しておく必要があります。ユーザー情報がローカルで管理されている場合、メールは Confluence Server の UI 経由で修正できます。
SQL を使用した確認 (Postgres でテスト済み)
次のクエリを使用して、重複しているメール アドレス、それらのアドレスの重複回数、およびそのメール アドレスに割り当てられたユーザーを見つけることができます。 1
2
3
--DUPLICATED EMAIL ADDRESSES - TESTED ON POSTGRESQL
select lower_email_address, count(lower_email_address), array_agg(user_name) as "Users with Dupe E-Mail"
from cwd_user group by lower_email_address having count(lower_email_address) > 1; |
7. 重複しているユーザー名を修正する (必須)
移行アシスタントは重複しているユーザー名にフラグを付け、すべてのユーザーが一意のユーザー名を持つまで移行を許可しません。これは、Confluence の内部ディレクトリと Confluence の LDAP ディレクトリ内に同じユーザー名のユーザーが存在する場合に発生する可能性があります。その場合は、移行を開始する前に、ユーザーの名前を変更するか、いずれかを削除します。
SQL を使用した確認 (Postgres でテスト済み)
次のクエリを使用して重複しているユーザー名を特定します。 1
2
3
--DUPLICATED USERNAMES - TESTED ON POSTGRESQL
select lower_user_name, count(lower_user_name)
from cwd_user group by lower_user_name having count(lower_email_address) > 1; |
8. 制限されるグループの名前を変更する (必須)
Cloud 内にすでに存在していたり、Cloud 関連機能に固有のグループだったりするために、移行されないグループがあります。これらのグループが移行前に Server インスタンスに存在している場合は、グループベースのアクセスが保持されるようにグループ名を変更することが重要です。
SQL を使用した確認 (Postgres でテスト済み)
以下のクエリによって、Server インスタンスにこのようなグループが存在するかどうかを確認します。存在する場合は、移行前に Server で名前を変更します。 1
2
3
--RESTRICTED GROUPS - TESTED ON POSTGRESQL
select lower_group_name from cwd_group where lower_group_name in
('site-admins', 'system-administrators', 'atlassian-addons', 'atlassian-addons-admin'); |
9. ファイアウォールの許可ルールを更新する (必須)
移行アシスタントは移行を実行するためにアトラシアンのドメインに接続します。ファイアウォールまたはリバース プロキシによってドメインがブロックされると、移行は失敗します。許可リストに登録する必要がある IP アドレスとドメインをご確認ください。
10. アプリの移行方法を決定する (必須)
Confluence Cloud Migration Assistant は、アプリまたはアドオン データを移行しません。移行するアプリ データがある場合は、データを適切に移行する方法を事前にベンダーにお問い合わせください。これには、Team Calendars for Confluence などのアトラシアン製アプリが含まれます。Team Calendars for Confluence を移行する必要がある場合は、関連する機能のリクエストをウォッチすると最新情報を入手できます。
サポート Zip を使用した確認
次のクエリを使用して、Team Calendars または Questions for Confluence をインストールしたかどうかを確認します。 1
grep -e '<key>com.atlassian.confluence.plugins.confluence-questions</key>' -e '<key>com.atlassian.confluence.extra.team-calendars</key>' -- application.xml |
11. パブリック アクセス設定を確認する (必須)
Confluence Server をインターネットで公開するように構成できます。移行前に、これまでに公開済みのスペースが Server 内にあるかどうかを確認して、それらの匿名アクセスのセットアップを削除します (コンテンツを公開することが想定されている場合を除く)。
SQL を使用した確認 (Postgres でテスト済み)
次のクエリを使用して、自分のスペース権限を確認します。 1
2
3
select spaces.spacekey, spaces.spaceid, spacepermissions.permtype from public.spacepermissions
inner join public.spaces on spacepermissions.spaceid = spaces.spaceid where spacepermissions.permtype = 'VIEWSPACE'
and spacepermissions.permgroupname is null and spacepermissions.permusername is null; |
12. ヒープ割り当てを確認する (必須)
移行するデータの量によっては、Confluence Server で OutOfMemory エラーが発生する場合があります。これによって、移行全体がクラッシュします。これを防ぐため、アプリケーションが 4GB 以上のヒープ割り当てで実行していることを確認します (この値未満である場合は可能な限り近づけます)。
Linux で確認する
/confluence-installation-directory/bin/setenv.sh ファイルに移動して、次の両方のパラメーターが 4096m または 4g (メガバイトではなくギガバイトで設定されている場合) を上回っていることを確認します。 1
-Xms4096m -Xmx4096mまた、オープンなファイルの制限を確認します。32768 になるべく近い数が理想的です。システムに設定されるオープンなファイルの数は、Linux ディストリビューションに応じて異なる場合があります。 システム コマンドから確認する方法がわからない場合は、次の手順を実行します。
「Too many open files」エラーの詳細をご確認ください。 これは、Windows を実行している場合には適用されません。 |
Windows で確認する (サービスとして実行している場合)
/confluence-installation-directory/bin/setenv.sh ファイルに移動して、次の両方のパラメーターが 4096m または 4g (メガバイトではなくギガバイトで設定されている場合) を上回っていることを確認します。 1
-Xms4096m -Xmx4096m |
Windows で確認する (サービスとして実行していない場合)
メモリ不足エラーを修正する方法の最初のステップに従います (ステップ内の Windows サービスを探します)。 |
サポート Zip を使用した確認
次のクエリを使用して、4 GB 以上のヒープ割り当てを実行していることを確認します。 1
grep '<max-heap>' application.xml |
13. Cloud サイトをバックアップする (推奨)
移行先の Cloud サイトに既存のデータがある場合は、スペースのインポート前にサイト バックアップを作成します。サイト バックアップの作成方法をご確認ください。
14. テスト移行を実行する (推奨)
最終移行を実行する前に、テストまたはステージング Cloud サイトへのテスト移行を行うことを強く推奨します。移行のテスト方法をご確認ください。
Confluence Cloud Migration Assistant で H2 データベースはサポートされていないことにご注意ください。また、Confluence 8.0 での H2 データベースのサポートも終了しました。
15. 移行プランをサポートに通知する (推奨)
週末や祝日に移行を行う、またはクラウド上のユーザーが 1,000 人を超える場合は、少なくとも 2 週間前にサポート チームにお知らせください。アトラシアンで人員を確保したうえで、移行をサポートします。
スペース単位のインポート (XMLを使用) チェックリスト
Server から Cloud に移行する際は、Confluence Cloud Migration Assistant を使用することを強くお勧めします。この製品を使用できない、または Confluence Cloud にインポートするスペースが別の Cloud サイトからエクスポートされている (例: Cloud から Cloud への移行) 場合は、移行の実行前に次のチェックリストを使用します。
1. ユーザーの移行プランを確認する (必須)
スペース エクスポートの XML は移行先の Cloud サイトに、ユーザー、グループ、またはグループのメンバーシップをインポートしません。つまり、これらのユーザーまたはグループに制限されているページがある場合は、移行先のサイトでそのユーザーとグループを再作成しない限り、それらのページは参照できません。
2. 適切な権限があることを確認する (必須)
移行を実行するユーザーが宛先の Cloud サイト内に存在し、サイト管理者権限を付与されていることを確認します。
3. アプリの移行方法を決定する (必須)
スペース エクスポート XML は、アプリのデータ (Team Calendars などの Atlassian アプリを含む) を移行しません。移行が必要なアプリを決定した後に、アプリ データを移行できるかどうかをアプリの開発元に確認する必要があります。移行するアプリの決定方法をご確認ください。
サポート Zip を使用した確認
次のクエリを使用して、Team Calendars または Questions for Confluence をインストールしたかどうかを確認します。 1
grep -e '<key>com.atlassian.confluence.plugins.confluence-questions</key>' -e '<key>com.atlassian.confluence.extra.team-calendars</key>' -- application.xml |
4. Confluence Server のバージョンを確認する (必須)
インポートするスペースが別の Cloud サイトのものである場合、バージョンは確認不要です。
Confluence Server または Data Center からスペースをインポートする場合、インスタンスがバージョン 6.13.x 移行を実行中であることを確認します。バージョンが古い場合、インポートは正常に機能しません。以前のバージョンを実行している場合、最初にアップグレードする必要があります。
サーバーの UI から確認する
Confluence のバージョンを検証するには、次の手順を実行します。
また、Linux および Windows では次の方法も使用できます。 |
Linux で確認する
これは次のコマンドを使用して検証できます。返される数字が 7901 (Confluence 6.13.x) 以上であることを確認します。 1
grep 'createdByBuildNumber' exportDescriptor.properties |
Windows で確認する
これは次のコマンドを使用して検証できます。返される数字が 7901 (Confluence 6.13.x) 以上であることを確認します。 1
cat exportDescriptor.properties | Select-String -Pattern createdByBuildNumber |
5. XML の構造を確認する (必須)
スペース エクスポートの XML が破損していないことを確認します。
XML のスペース エクスポートを使用して確認する
Cloud にインポートする前に次のコマンドを実行して、破損しているデータがないことを確認します。 1
xmllint --noout entities.xmlXML が適切に構成されている場合、コマンドは何も返しません。値が返される場合、インポートを実行する前に報告された問題を修正します。 |
6. エクスポートが適切な種類であることを確認する (必須)
インポートするファイルがスペース エクスポート (完全なサイト エクスポートでない) ことを確認します。スペース エクスポートではない場合、インポート プロセスは失敗します。
Linux で確認する
XML ファイルを Cloud にインポートする前に次のコマンドを実行して、exportType=space が返されることを確認します。 1
grep 'exportType' exportDescriptor.properties これが返されない場合、ご利用のファイルはサイト エクスポート ファイルです。代わりにスペース エクスポートを作成する必要があります。スペース エクスポートの作成方法をご確認ください。 |
Windows で確認する
XML ファイルを Cloud にインポートする前に次のコマンドを実行して、exportType=space が返されることを確認します。 1
cat exportDescriptor.properties | Select-String -Pattern exportTypeこれが返されない場合、ご利用のファイルはサイト エクスポート ファイルです。代わりにスペース エクスポートを作成する必要があります。スペース エクスポートの作成方法をご確認ください。 |
7. 重複しているスペース キーを確認する (必須)
各スペースは一意のスペース キーに関連付けられています。インポートするスペースが Cloud 内にすでに存在しているスペース キーを持つ場合、インポートは失敗します。
Linux で確認する
以下のコマンドを実行してスペース キーを取得し、宛先の Cloud インスタンスに存在していないことをインポート前に確認します。 1
grep 'spaceKey' exportDescriptor.properties |
Windows で確認する
以下のコマンドを実行してスペース キーを取得し、宛先の Cloud インスタンスに存在していないことをインポート前に確認します。 1
cat exportDescriptor.properties | Select-String -Pattern spaceKey |
8. ヒープ割り当てを確認する (必須)
移行するデータの量によっては、Confluence Server で OutOfMemory エラーが発生する場合があります。これによって、移行全体がクラッシュします。これを防ぐため、アプリケーションが 4GB 以上のヒープ割り当てで実行していることを確認します (この値未満である場合は可能な限り近づけます)。
Linux で確認する
/confluence-installation-directory/bin/setenv.sh ファイルに移動して、次の両方のパラメーターが 4096m または 4g (メガバイトではなくギガバイトで設定されている場合) を上回っていることを確認します。 1
-Xms4096m -Xmx4096mまた、オープンなファイルの制限を確認します。32768 になるべく近い数が理想的です。システムに設定されるオープンなファイルの数は、Linux ディストリビューションに応じて異なる場合があります。 システム コマンドから確認する方法がわからない場合は、次の手順を実行します。
「Too many open files」エラーの詳細をご確認ください。 これは、Windows を実行している場合には適用されません。 |
Windows で確認する (サービスとして実行している場合)
/confluence-installation-directory/bin/setenv.sh ファイルに移動して、次の両方のパラメーターが 4096m または 4g (メガバイトではなくギガバイトで設定されている場合) を上回っていることを確認します。 1
-Xms4096m -Xmx4096m |
Windows で確認する (サービスとして実行していない場合)
メモリ不足エラーを修正する方法のステップ 1 に従います (ステップ内の Windows サービスを探します)。 |
サポート Zip を使用した確認
次のクエリを使用して、4 GB 以上のヒープ割り当てを実行していることを確認します。 1
grep '<max-heap>' application.xml |
9. クラウド サイトをバックアップする (推奨)
移行先の Cloud サイトに既存のデータがある場合は、スペースのインポート前にサイト バックアップを作成します。サイト バックアップの作成方法をご確認ください。
10. テスト移行を実行する (推奨)
最終移行を実行する前に、テストまたはステージング Cloud サイトへのテスト移行を行うことを強く推奨します。移行のテスト方法をご確認ください。
11. 移行プランをサポートに通知する (推奨)
週末や祝日に移行を行う、または Cloud 上のユーザーが 1,000 人を超える場合は、少なくとも 2 週間前にアトラシアンのサポート チームにお知らせください。アトラシアンで人員を確保したうえで、移行をサポートします。
サイト インポート (XML) チェックリスト
この方法は、Cloud サイトに Confluence のみが存在する場合に限って利用できます。この方法は多数の制限があるため、移行に使用するのは推奨しません。
Confluence Cloud Migration Assistant またはスペース単位でのインポートを活用する代わりにこの方法を使用する必要がある場合は、アトラシアンのサポート チームにお問い合わせください。お客様の移行に最適なアプローチの決定をサポートいたします。
詳細情報とサポート
移行をサポートする多数のチャネルをご用意しています。
移行計画に関する情報は、Atlassian Migration Program の Web サイトをご覧ください。
技術的な問題が発生している、または戦略やベスト プラクティスに関するサポートが必要な場合は、サポート チームにお問い合わせください。
ピア アドバイスについては、アトラシアン コミュニティでご質問ください。
専門家によるガイダンスについては、アトラシアン パートナーでご相談ください。
追加のサポートが必要な場合は「Cloud 移行ガイド」をご確認、またはライブ チャットによる Q&A を含む Cloud 移行デモにご登録ください。
この内容はお役に立ちましたか?