Cloud Migration Assistant for Confluence

Confluence Server から Cloud への移行

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

description Step-by-step instructions on how to use the Cloud Migration Assistant for Confluence to move your data from Confluence Server to Confluence Cloud.

The Cloud Migration Assistant for Confluence is an app that helps you easily move content, users, and groups from Confluence Server to Confluence Cloud. Built and maintained by Atlassian, the app is free to install and use.

Once installed, you can choose what you want to move to the cloud, start migrating at your convenience, and monitor the progress of everything throughout the migration process.

When to use the Cloud Migration Assistant for Confluence

  • When you want to migrate your Confluence Server data to a new or existing cloud site.

  • When you want to move users from Confluence Server to an existing Confluence Cloud site.

  • When you want to run a test or trial migration from Confluence Server to Confluence Cloud.

  • When the Atlassian Support team has recommended using the app.

The Cloud Migration Assistant for Confluence will not work for Jira products.

移行の前に


Check out the Cloud Migration Center to find out everything you need to know before migrating. You can also use our helpful guide to plan your migration from start to finish.


移行前のチェックリスト



Confluence Data Center



Check for possible data conflicts in your cloud site

You can reduce the risk of running into issues, or the migration failing, if you conduct some manual checks in your server and cloud sites.

1. Check for group conflicts

Make sure that there are no groups already in your cloud site with the same name as groups from your server site, unless you are intentionally trying to merge them.

If we find a group in your server site that has the same name as a group in your cloud site (either Jira or Confluence), we will merge the users from the server group into the cloud group. The server group users will inherit the permissions of the cloud group. This also applies to groups with Jira product access that have the same name as a Confluence group you are migrating. This is because all users and groups are managed in a central location in your cloud site.

If you don’t want this to happen, you’ll need to make sure all groups across server and cloud have unique names before running your migration plan.


tip/resting Created with Sketch.

The following groups manage admin access and are blacklisted. They will not be migrated at all: "site-admins", "system-administrators", "atlassian-addons", "atlassian-addons-admin". Users in these groups will still be migrated; if you want them to be in one of the blacklisted groups you’ll need to manually add them after migration.

2. Check for space key conflicts

Before migrating, check that there are no spaces with the same space key between your server and cloud sites.

If a space from your server site has the same space key as a space in your cloud site your migration will fail. This is because every space in Confluence Cloud must have a unique space key. If you find a conflict you can:

If the migration assistant finds a conflict, the space will not migrate.

If a space key conflict is caused by a previous test migration you can reset your cloud site before migrating.


Install the Cloud Migration Assistant for Confluence app

If your Confluence Server site is version 6.13 or above you won't need to install anything because it comes pre-installed, although you may be asked to update the app. See the next step to locate the migration assistant within your server site.


バージョン 5.10 ~ 6.12 でアプリをインストールするには、次の手順を実行します。

  1. Confluence Server で、 > [アプリケーション管理] に進みます。
  2. [新しいアドオンを検索] を選択します。 
  3. Cloud Migration Assistant for Confluence アプリを検索します。 
  4. [インストール] を選択したら完了です。

If your Confluence Server site is behind a firewall, you'll need to allow access to the domain: atlassian.com

Use the app to set up and run your migration

Once you have the app installed, there are five key steps to set up and run your migration from server to cloud:

  1. Connect to cloud

  2. Choose what to migrate

  3. Check for errors

  4. Review your migration

  5. Migrate

The sections below describe each step in detail and explain some common errors that you may come across. If you have technical questions or issues while using the migration assistant, get in touch with our Technical Support team.

テスト移行を実行する

We strongly recommend doing a trial run of your migration to a test or staging site before running your final migration. Check out our guidance on testing your migration.

1. Connect to your destination Confluence Cloud site

You’ll be asked to add a name for your migration and choose which cloud site you would like to migrate to. You need to be an admin in both your server and the destination cloud sites.

If you have already connected a cloud site, you should see it in the dropdown. If there is nothing there, you will need to either connect a new cloud site or sign up for a new cloud license.

When you’re ready to go, check the box to allow Atlassian to move your data from your server site to your cloud site. If you’re unable to grant Atlassian this access, you won’t be able to migrate with the migration assistant and will need to do a space import instead.

2. Choose what you'd like to migrate

すべてをまとめて移行することも、別の段階に分割することもできます。

選択肢は次のとおりです。

  • all or none of your users and groups

  • 移行したい個別のスペース (およびそれらの添付ファイル)

ユーザーとグループ

You can choose to either migrate all or none of your users.

When you migrate all your users, they will be added to their groups when they get to cloud. The first time you migrate users, you will need to review and approve group permissions after you migrate. When you approve group permissions, your users will be given Confluence access and will be added to your bill.

We won’t send an invitation to your users. To invite your users you can choose to send an invitation from the Administration space after you have migrated, or send a link for them to log in themselves.

Selecting no users

When you select none under users and groups, we will still migrate some user data connected to the spaces you are migrating. This is to make sure that mentions, comments, and page history stay active.

User data that will be migrated every time includes:

  • 氏名

  • username (discarded after migration)

  • email address

We will only migrate this information for users directly connected to the spaces you are migrating. We will not give these users product access or add them to any groups. They will appear in your cloud site user list.

If you choose to migrate users later, their product and group access will be updated.

Other things to be aware of when migrating users and groups:

  • Confluence Cloud is subscription-based and billed on a per-user basis. If you plan to migrate your users, make sure you check the licensing options or calculate the cost with our pricing calculator.

  • If you use an external user management system, we recommend synchronizing it with your local directory before migrating. This is to make sure that your users and groups are up to date before you transfer any data.

  • Users with disabled status in your server site will be migrated as active but without any product access. This means they will not be counted as active Confluence users for billing purposes.

  • If we find a group in your server site that has the same name as a group in your cloud site, we will merge the users from the server group into the cloud group.

  • Global settings and global site permissions are not migrated with this tool. You’ll need to set these manually after migration.

  • If you have users that already exist in your destination cloud site and you choose to migrate users with this app, the following will occur:

    • If a user has product access in cloud, but has disabled status in your server site, they will continue to have product access in cloud after migration.

    • If a user does not have product access in cloud, but is enabled in your server site, they will be granted product access through the migration process.

If you use Confluence as a knowledge base for Jira Service Desk, your Jira Service Desk users may also be migrated along with your Confluence users. This will happen if you can see your Jira Service Desk users in the cwd_user table in Confluence. This issue is being tracked on a public Jira ticket: MIG-16 - Getting issue details... STATUS

スペース

If you want to migrate all or some of your spaces choose Select spaces from the options. You will then be able to select what spaces you want to migrate. If you aren’t migrating any spaces you will be taken straight to check for errors.

Select the spaces you want to add to your migration. You can filter the list or search for particular spaces, or click Select all if you want to migrate everything at once. You won’t be able to migrate spaces with space keys that already exist in your Confluence Cloud destination site.

If a space has a MIGRATED status, we have detected that you have already migrated this space to the same cloud site.

If a space has a QUEUED status, it has already been added to a migration that is waiting to be run.

If you have lots of spaces and attachments, you might want to break the migration up into a few smaller migrations. The migration assistant can be slow to load and process tasks when there is lots to manage.

When you've chosen all your spaces, select Add items to plan

3. Check for errors

In this step, the Cloud Migration Assistant for Confluence will review your migration and check for common errors. It will check if your:

  • migration assistant app is up to date

  • users have valid and unique email addresses

  • groups will merge through the migration process

  • spaces already exist in your cloud site

You may also encounter other issues during the migration process; this step only checks for the issues mentioned here.

If there is a green tick (tick) then the check has passed. If you get a warning sign (warning) then you can continue, but you need to be aware of a potential issue.

If a check comes back with a red error (error) then you will need to resolve the error before you can run your migration.

If you decide to Continue and fix later, you can come back to view the errors once you have saved your migration.

アプリをアップグレードする

The migration assistant may be out of date. If you get this error, you’ll need to update it before running any migrations.

Users and groups errors

All users will need to have a valid and unique email address. If we detect invalid emails or multiple users with the same email, you will get an error. You will need to fix these email addresses before you can run your migration.

If you have chosen to migrate all users, we will check to see if you have any groups with the same name already in your cloud site. If we find groups with the same name, we will merge the users from the server group into the cloud group with the same name. You can continue with your migration without fixing this issue, but it’s important to check that this won’t cause permission escalation.

tip/resting Created with Sketch.

The following groups manage admin access and are blacklisted. They will not be migrated at all: "site-admins", "system-administrators", "atlassian-addons", "atlassian-addons-admin". Users in these groups will still be migrated; if you want them to be in one of the blacklisted groups you’ll need to manually add them after migration.

Space errors

If you’re migrating spaces we will check to see if there will be any space key conflicts. If you get an error you can:

You will need to resolve any space key conflicts before you can run your migration.

4. Review your migration

This is the final step in setting up your migration.

If everything looks correct and you want to start your migration, click Run. If you would like to start your migration later or you still have errors to fix, click Save. If you choose to run your migration plan, it will still be saved to your migration dashboard. There, you can view the progress and details of all your migrations.

5. Manage your migrations

Your saved migration will be listed on the migration dashboard, where you can view details or run it. You can also check the status of a migration, monitor the progress, stop a migration that's currently running, or create a new one.

You can create as many migrations as you need. At this time, migrations can't be edited or deleted, so if you create a migration that can't be used, just create a new one.

計画ステータスの定義

SAVED Your migration is saved and ready to run.

RUNNING Your migration is currently in progress.

FINISHED  All tasks in your migration have been completed.

STOPPED Your migration has been manually stopped. Once stopped, it can't be resumed. Any step already in progress will first need to finish before the plan is shown as fully stopped. Some users, groups, and spaces may already have been migrated to your Confluence Cloud site.

FAILED We were unable to complete the migration plan. This might be because a space key already exists in the destination site, or the migration hit an unexpected error. Some users, groups, and spaces may already have been migrated to your Confluence Cloud site.

After migrating

After migrating spaces, it may take a while for them to appear in the space directory. However, you can still access them via a direct link.

移行のタイプによっては、移行の完了後に実行が必要な操作があります。

ユーザーとグループ

ユーザーとグループが正しくセットアップされていることを確認するには、次の手順を実行します。

  • [インポートしたグループを確認] に移動して、グループのメンバーを確認し、権限を承認します。

  • Add users to the generic groups if necessary. The generic groups are: "site-admins", "system-administrators", "atlassian-addons", "atlassian-addons-admin".

  • 外部のユーザー管理システムを使用している場合は、ユーザーが正しく同期されていることを確認します。

  • When you are ready, invite your users by using the resend invite link on the Users page. When they first log in they may be prompted to set a new password and add personal details.

スペース

スペースの移行が正常に完了したことを確認するには、次の手順を実行します。

  • コンテンツとスペースを確認するか、ユーザーに自身のコンテンツを確認してもらいます。

  • Check for any instances of Former User. This means that we were unable to match content to a user.

  • Link your other Atlassian products by going to Settings > Application links.

  • Use the Jira macro repair to update any links to Jira. On your cloud site go to Settings > Jira macro repair and follow the steps.

Confluence short links like https://confluence.example.com/x/PywS may not work after migrating. Replacing them with internal links (or full URLs if they’re not in your Confluence site)\before migrating should solve this issue.

その後、必要なアプリをインストールして、ユーザーのオンボーディングを実行できます。

For a full list of post-migration recommendations, refer to the Confluence migration planning guide.

詳細情報とサポート

We have a number of channels available to help you with your migration. For more Confluence migration planning information and FAQs, visit the Atlassian Cloud Migration Center.

Need more support with strategy, best practices, or planning questions? Our migration planning specialists can help with planning your migration from Confluence Server to Confluence Cloud.

If you have technical questions or issues, get in touch with our Technical Support team.

また、アトラシアン コミュニティもご利用ください。

フィードバックを送信する

Your feedback is invaluable in helping us improve our products. Please take a moment to let us know what you think by leaving a review of the Cloud Migration Assistant for Confluence on the Atlassian Marketplace.

最終更新日 2019 年 6 月 21 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.