Confluence の移行前のチェックリスト
Migration can be a complex and challenging process. To help you out, we’ve created this checklist of everything you need to ensure your data is ready to migrate from Confluence Data Center to Cloud.
一般的なエラーを防ぐため、移行を試す前に次の確認を完了します。
はじめる前に
1. 移行方法を確認する
さまざまな Cloud 移行方法をご確認ください。このチェックリストでは次の方法を網羅しています。
次に、選択した移行メソッドに対応した移行前のチェックに従います。
2. 準備する
移行前のチェックを完了するには、以下へのアクセス権が必要な場合があります。
access to the Confluence Data Center or Cloud user interface
展開されていない Confluence Space エクスポートへのアクセス
解凍されたサポート zip ファイルへのアクセス。サポート zip の作成方法をご確認ください。
ソース インスタンスで SQL を実行する方法
Sometimes you may experience extended performance degradation during migration, or pre-migration checks, due to certain types of scheduled background processes running. We recommended that you stop all unnecessary/non-crucial scheduled jobs on your Confluence Data Center when you start your migration journey. The impact is not necessarily from one specific job, and is more likely to be a cumulative effect of multiple jobs running during the migration window. How to check all scheduled jobs
Confluence Cloud Migration Assistant のチェックリスト
移行アシスタントは、データに一般的なエラーがないかどうかを自動で確認します。次の内容を確認します。
Migration Assistant アプリが最新かどうか
ユーザーに有効で一意のメール アドレスが紐付けられているかどうか
移行プロセスでのグループの統合
クラウド サイトにすでに存在するスペース
ただし、移行アシスタントはすべてを確認するわけではありません。このため、移行を開始する前に次のリストを使用したチェックを行う必要があります。
1. ユーザーの移行プランを確認する (必須)
アシスタントはユーザーやグループを移行できますが、アシスタントには、Confluence のみを移行するのか、Jira も同様に移行するのかを判断する機能は備わっていません。
If you’re also migrating Jira from Data Center to Cloud, or may do so in the future, it’s important to develop a user migration strategy. This helps you avoid user management and content ownership related issues post-migration. Learn more about user migration strategies
Confluence のみを移行
「ユーザーの移行戦略を決定する」のガイダンスをご確認ください。
Jira Cloud Migration Assistant によって Confluence と Jira を移行する
移行アシスタントはユーザーとグループを移行しますが、Jira と Confluence でメール アドレスが同じユーザーに割り当てられていることを確認する必要があります。たとえば、userA ([email protected]) は Confluence と Jira にアクセスできますが、両方のアプリケーションがデータベース内に UserA 用の同じメール アドレスを持っている必要があります。これは、移行アシスタントが移行中にユーザーのメール アドレスを使用してコンテンツをマッピングするためです。
最初にユーザーの移行する
「ユーザーの移行戦略を決定する」に記載されているようにアトラシアンのサポート チームのサポートによってすべてのユーザーを事前に移行して、次に Confluence または Jira を任意の順序で移行します。
2. Cloud ユーザーの上限を超えていないことを確認する (必須)
If you’re migrating to a Confluence Cloud site that’s on the Free plan, the migration assistant will check to ensure your migration won’t exceed the user limit. That means the sum of users to be migrated from Data Center, plus any users that already exist in Cloud, can’t exceed 10 or the migration will fail.
Confluence Cloud サイトが別のプランの年間サブスクリプションを使用している場合は、Server から移行されるユーザーの合計と Cloud にすでに存在するユーザーの合計が、サブスクリプションのユーザー階層を超えないことを確認する必要があります。たとえば、51 ～ 100 ユーザーのサブスクリプションを契約しているときに 110 人のアクティブなユーザーをインポートしようとすると、移行は失敗します。
これを修正するには、次の手順を実行します。
ユーザー数の上限が大きいプランをサブスクライブします。
移行前にユーザー数を減らします。
アトラシアン サポートにお問い合わせのうえ、事前に製品アクセスなしでユーザーをインポートする
SQL を使用した確認 (Postgres でテスト済み)
移行を実行する前に、以下のクエリによって移行するユーザーの数とご利用の Cloud プランのユーザーの上限を照合します。必要に応じて、ユーザー数の削減、Cloud プランのアップグレード、またはサブスクリプションへのユーザー数の追加を実行します。 --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 を使用した確認
移行を実行する前に次のクエリを使用し、移行するユーザーの数とご利用のクラウド プランのユーザーの上限とを照合します。必要に応じ、ユーザー数の削減、クラウド プランのアップグレード、サブスクリプションへのユーザー数の追加などを行います。 grep '<users>' application.xml |
3. 適切な権限があることを確認する (必須)
移行を実行するユーザーが、次の権限を持っていることを確認します。
has system admin permission on the Data Center instance
宛先のクラウド サイトに存在すること
has both an organization admin and an app admin role in Confluence Cloud. For older organizations, you might be able to use the Site Administrator role, but it has been deprecated for new organizations
4. Check your Confluence Data Center version [mandatory]
For the migration assistant to work, you need to be on a supported version of Confluence. Confluence Cloud Migration Assistant supported versions
サーバーの UI から確認する
Confluence のバージョンを検証するには、次の手順を実行します。
また、Linux および Windows では次の方法も使用できます。 |
Linux で確認する
これは次のコマンドを使用して検証できます。返される数字が 8100 (Confluence 6.15.x) 以上であることを確認します。 grep 'createdByBuildNumber' exportDescriptor.properties |
Windows で確認する
これは次のコマンドを使用して検証できます。返される数字が 8100 (Confluence 6.15.x) 以上であることを確認します。 cat exportDescriptor.properties | Select-String -Pattern createdByBuildNumber |
サポート Zip を使用した確認
これは次のコマンドを使用して検証できます。返されるバージョンが 6.15 以上であることを確認します。 grep '<product name="Confluence" version=' application.xml |
5. Fix any Marketplace app email addresses [mandatory]
The check applies when trying to merge two or more Confluence Cloud sites. One common scenario is to export one of them as an XML backup, import it to a Confluence Data Center instance, and leverage the Confluence Cloud Migration Assistant to merge it with the desired Cloud site. This would carry Marketplace app users from the Cloud site to the Server instance. As Marketplace users are not common in the Data Center world, they might cause a few issues during the migration back to Cloud. Before migrating, delete or update any of these users.
SQL を使用した確認 (Postgres でテスト済み)
次のクエリでこれらのユーザーを見つけて削除するか、メール アドレスを @connect.atlassian.com 以外のものに更新します。 --ADD-ON USERS - TESTED ON POSTGRESQL
select * from cwd_user where lower_email_address like '%connect.atlassian.com%'; |
6. 重複しているメール アドレスを修正する (必須)
The migration assistant will flag duplicate email addresses and will not allow the migration to run until all users have unique email addresses. However, as a proactive step, it's good to find and fix those beforehand. If user information is managed in an LDAP Server, emails will need to be updated in the LDAP Server and synced over to Confluence before the migration. If user information is managed locally, emails can be fixed via the Confluence Data Center UI.
SQL を使用した確認 (Postgres でテスト済み)
次のクエリを使用して、重複しているメール アドレス、それらのアドレスの重複回数、およびそのメール アドレスに割り当てられたユーザーを見つけることができます。 --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 でテスト済み)
次のクエリを使用して重複しているユーザー名を特定します。 --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 で名前を変更します。 --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 用の HTTP または HTTPS プロキシの設定
Web プロキシの設定を使用している場合、これは必須の手順です。「Confluence 用のプロキシおよび HTTPS のセットアップ」で説明されている手順を使用して、HTTP または HTTPS プロキシのどちらか、または両方を正しく設定していることを確認してください。
CCMA を使用して移行を開始する前に、以下の点に注意してください。
CCMA は HTTP と HTTPS プロキシのみをサポートしています。
使用できるプロキシ設定は、HTTP と HTTPS のどちらかだけです。そのため、お使いの Confluence サーバーに適したものを設定してください。
CCMA では、既定で HTTP プロキシが有効になっています。ただし、HTTPS プロキシを使用するには、機能フラグ
migration-assistant.enable.migration.https.proxyを有効化する必要があります。
11. Determine how you’ll migrate Marketplace apps [mandatory]
The Confluence Cloud Migration Assistant will not migrate Marketplace app data. If you have app data to migrate, contact vendors beforehand for advice on how to migrate their data properly. This includes Atlassian-built Marketplace apps like Team Calendars for Confluence. If you need to migrate Team Calendars for Confluence, you can watch the related feature request to stay up to date.
サポート Zip を使用した確認
次のクエリを使用して、Team Calendars または Questions for Confluence をインストールしたかどうかを確認します。 grep -e '<key>com.atlassian.confluence.plugins.confluence-questions</key>' -e '<key>com.atlassian.confluence.extra.team-calendars</key>' -- application.xml |
12. パブリック・アクセス設定を確認する（必須）
You can configure your Confluence Data Center or to be publicly available to the internet. Before migrating, check for any spaces in Server that have been made publicly available and remove their anonymous access setup, unless content is meant to be public.
SQL を使用した確認 (Postgres でテスト済み)
次のクエリを使用して、自分のスペース権限を確認します。 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; |
13. ヒープ割り当てを確認する（必須）
Depending on the amount of data to be migrated, Confluence Data Center might experience an OutOfMemory error. This will crash the entire migration. To prevent this, ensure that your application is running with at least 4GB of Heap Allocation (if not, make it as close as possible).
Linux で確認する
/confluence-installation-directory/bin/setenv.sh ファイルに移動して、次の両方のパラメーターが 4096m または 4g (メガバイトではなくギガバイトで設定されている場合) を上回っていることを確認します。 -Xms4096m -Xmx4096mまた、オープンなファイルの制限を確認します。32768 になるべく近い数が理想的です。システムに設定されるオープンなファイルの数は、Linux ディストリビューションに応じて異なる場合があります。 システム コマンドから確認する方法がわからない場合は、次の手順を実行します。
「Too many open files」エラーの詳細をご確認ください。 これは、Windows を実行している場合には適用されません。 |
Windows で確認する (サービスとして実行している場合)
/confluence-installation-directory/bin/setenv.sh ファイルに移動して、次の両方のパラメーターが 4096m または 4g (メガバイトではなくギガバイトで設定されている場合) を上回っていることを確認します。 -Xms4096m -Xmx4096m |
Windows で確認する (サービスとして実行していない場合)
メモリ不足エラーを修正する方法の最初のステップに従います (ステップ内の Windows サービスを探します)。 |
サポート Zip を使用した確認
次のクエリを使用して、4 GB 以上のヒープ割り当てを実行していることを確認します。 grep '<max-heap>' application.xml |
14. サーバーのタイムゾーンを変更しない (推奨)
サーバーからクラウドに移行する予定がある場合は、サーバーのタイムゾーンを変更しないことをお勧めします。サーバーのタイムゾーンを変更すると、移行が失敗する可能性があります。このようなタイムゾーン関連の障害が発生した場合は、サポートまでご連絡ください。
15. Cloud サイトをバックアップする (推奨)
移行先の Cloud サイトに既存のデータがある場合は、スペースのインポート前にサイト バックアップを作成します。サイト バックアップの作成方法をご確認ください。
16. テスト移行を実行する (推奨)
最終移行を実行する前に、テストまたはステージング Cloud サイトへのテスト移行を行うことを強く推奨します。移行のテスト方法をご確認ください。
Confluence Cloud Migration Assistant で H2 データベースはサポートされていないことにご注意ください。また、Confluence 8.0 での H2 データベースのサポートも終了しました。
17. 移行プランをサポートに通知する (推奨)
週末や祝日に移行を行う、またはクラウド上のユーザーが 1,000 人を超える場合は、少なくとも 2 週間前にサポート チームにお知らせください。アトラシアンで人員を確保したうえで、移行をサポートします。
18. ネットワークの帯域幅を確認する
本番環境への移行の直前に、サーバーでネットワーク テストを実行して、ネットワークが正常であることを確認することをお勧めします (ダウンロード、アップロード、転送帯域幅)。
速度テストを実行するために推奨される CLI ツール: Speedtest CLI: コマンド ラインのインターネット速度テスト
本番環境に追加のセキュリティ制御がないことを確認してください (例: Egress トラフィック スキャナー)。Atlassian Cloud 環境へのデータ アップロードが遅くなる可能性があります。
スペース単位のインポート (XMLを使用) チェックリスト
We highly recommend using the Confluence Cloud Migration Assistant when migrating from Data Center to Cloud. However, in cases where it can’t be used, or the space(s) to be imported to Confluence Cloud were exported from a different Cloud site (for example, in the case of a Cloud to Cloud migration), use the following checklist before running a migration.
1. ユーザーの移行プランを確認する (必須)
スペース エクスポートの XML は移行先の Cloud サイトに、ユーザー、グループ、またはグループのメンバーシップをインポートしません。つまり、これらのユーザーまたはグループに制限されているページがある場合は、移行先のサイトでそのユーザーとグループを再作成しない限り、それらのページは参照できません。
2. 適切な権限があることを確認する (必須)
Ensure that the user running the migration exists in the target cloud site and is an organization admin and an app admin (previously, product admin) in Confluence Cloud.
3. Determine how you’ll migrate Marketplace apps [mandatory]
The space export XML will not migrate any Marketplace app data, including Atlassian Marketplace apps such as Team Calendars. After deciding which Marketplace apps you need to migrate, you'll need to check with the app developers to confirm whether you are able to move app data across. Learn how to decide which apps to migrate
サポート Zip を使用した確認
次のクエリを使用して、Team Calendars または Questions for Confluence をインストールしたかどうかを確認します。 grep -e '<key>com.atlassian.confluence.plugins.confluence-questions</key>' -e '<key>com.atlassian.confluence.extra.team-calendars</key>' -- application.xml |
4. Check your Confluence Data Center version [mandatory]
インポートするスペースが別の Cloud サイトのものである場合、バージョンは確認不要です。
If you’re importing a space from Confluence Data Center, ensure the instance is running on version 6.14.x or later, otherwise, the import will not work properly. If you're running an earlier version, you’ll need to upgrade it first.
サーバーの UI から確認する
Confluence のバージョンを検証するには、次の手順を実行します。
また、Linux および Windows では次の方法も使用できます。 |
Linux で確認する
これは次のコマンドを使用して検証できます。返される数字が 7901 (Confluence 6.14.x) 以上であることを確認します。 grep 'createdByBuildNumber' exportDescriptor.properties |
Windows で確認する
これは次のコマンドを使用して検証できます。返される数字が 7901 (Confluence 6.14.x) 以上であることを確認します。 cat exportDescriptor.properties | Select-String -Pattern createdByBuildNumber |
5. XML の構造を確認する (必須)
スペース エクスポートの XML が破損していないことを確認します。
XML のスペース エクスポートを使用して確認する
Cloud にインポートする前に次のコマンドを実行して、破損しているデータがないことを確認します。 xmllint --noout entities.xmlXML が適切に構成されている場合、コマンドは何も返しません。値が返される場合、インポートを実行する前に報告された問題を修正します。 |
6. エクスポートが適切な種類であることを確認する (必須)
インポートするファイルがスペース エクスポート (完全なサイト エクスポートでない) ことを確認します。スペース エクスポートではない場合、インポート プロセスは失敗します。
Linux で確認する
XML ファイルを Cloud にインポートする前に次のコマンドを実行して、exportType=space が返されることを確認します。 grep 'exportType' exportDescriptor.properties これが返されない場合、ご利用のファイルはサイト エクスポート ファイルです。代わりにスペース エクスポートを作成する必要があります。スペース エクスポートの作成方法をご確認ください。 |
Windows で確認する
XML ファイルを Cloud にインポートする前に次のコマンドを実行して、exportType=space が返されることを確認します。 cat exportDescriptor.properties | Select-String -Pattern exportTypeこれが返されない場合、ご利用のファイルはサイト エクスポート ファイルです。代わりにスペース エクスポートを作成する必要があります。スペース エクスポートの作成方法をご確認ください。 |
7. 重複しているスペース キーを確認する (必須)
各スペースは一意のスペース キーに関連付けられています。インポートするスペースが Cloud 内にすでに存在しているスペース キーを持つ場合、インポートは失敗します。
Linux で確認する
以下のコマンドを実行してスペース キーを取得し、宛先の Cloud インスタンスに存在していないことをインポート前に確認します。 grep 'spaceKey' exportDescriptor.properties |
Windows で確認する
以下のコマンドを実行してスペース キーを取得し、宛先の Cloud インスタンスに存在していないことをインポート前に確認します。 cat exportDescriptor.properties | Select-String -Pattern spaceKey |
8. ヒープ割り当てを確認する (必須)
Depending on the amount of data to be migrated, Confluence Data Center might experience an OutOfMemory error. This will crash the entire migration. To prevent this, ensure that your application is running with at least 4GB of Heap Allocation (if not, make it as close as possible).
Linux で確認する
/confluence-installation-directory/bin/setenv.sh ファイルに移動して、次の両方のパラメーターが 4096m または 4g (メガバイトではなくギガバイトで設定されている場合) を上回っていることを確認します。 -Xms4096m -Xmx4096mまた、オープンなファイルの制限を確認します。32768 になるべく近い数が理想的です。システムに設定されるオープンなファイルの数は、Linux ディストリビューションに応じて異なる場合があります。 システム コマンドから確認する方法がわからない場合は、次の手順を実行します。
「Too many open files」エラーの詳細をご確認ください。 これは、Windows を実行している場合には適用されません。 |
Windows で確認する (サービスとして実行している場合)
/confluence-installation-directory/bin/setenv.sh ファイルに移動して、次の両方のパラメーターが 4096m または 4g (メガバイトではなくギガバイトで設定されている場合) を上回っていることを確認します。 -Xms4096m -Xmx4096m |
Windows で確認する (サービスとして実行していない場合)
メモリ不足エラーを修正する方法のステップ 1 に従います (ステップ内の Windows サービスを探します)。 |
サポート Zip を使用した確認
次のクエリを使用して、4 GB 以上のヒープ割り当てを実行していることを確認します。 grep '<max-heap>' application.xml |
9. クラウド サイトをバックアップする (推奨)
移行先の Cloud サイトに既存のデータがある場合は、スペースのインポート前にサイト バックアップを作成します。サイト バックアップの作成方法をご確認ください。
10. テスト移行を実行する (推奨)
最終移行を実行する前に、テストまたはステージング Cloud サイトへのテスト移行を行うことを強く推奨します。移行のテスト方法をご確認ください。
ステージング環境を使用してテスト移行を実行する場合、本番データをステージング環境にコピーする前に、ステージングの Server ID ([管理] > [システム] > [システム情報]) を保存してください。本番を複製後の最後のステップで、ステージングの Server ID を保存された値に更新します。
11. 移行プランをサポートに通知する (推奨)
週末や祝日に移行を行う、または Cloud 上のユーザーが 1,000 人を超える場合は、少なくとも 2 週間前にアトラシアンのサポート チームにお知らせください。アトラシアンで人員を確保したうえで、移行をサポートします。
サイト インポート (XML) チェックリスト
この方法は、Cloud サイトに Confluence のみが存在する場合に限って利用できます。この方法は多数の制限があるため、移行に使用するのは推奨しません。
Confluence Cloud Migration Assistant またはスペース単位でのインポートを活用する代わりにこの方法を使用する必要がある場合は、アトラシアンのサポート チームにお問い合わせください。お客様の移行に最適なアプローチの決定をサポートいたします。
詳細情報とサポート
移行をサポートする多数のチャンネルをご用意しています。
移行計画に関する情報は、Atlassian Migration Program の Web サイトをご覧ください。
技術的な問題が発生している、または戦略やベスト プラクティスに関するサポートが必要な場合は、サポート チームにお問い合わせください。
ピア アドバイスについては、アトラシアン コミュニティでご質問ください。
専門家によるガイダンスについては、アトラシアン パートナーでご相談ください。
追加のサポートが必要な場合は「Cloud 移行ガイド」をご確認、またはライブ チャットによる Q&A を含む Cloud 移行デモにご登録ください。
この内容はお役に立ちましたか?