--- schema_version: "1" id: aaba3948094dbd2d0f60308724527e62f6fe17e94de3f0f59f3227a4ab6bc364 title: Pre-Migration Checklist collection: tableau version: current locale: en-us portal_url: https://docs.salesforce.com/tableau/current/en-us/api/migration_sdk/docs/how_to_migrate.md canonical_url: https://help.tableau.com/current/api/migration_sdk/en-us/docs/how_to_migrate.html source_site: help.tableau.com content_type: documentation content_hash: 0c63a76c5a4c266f6e3a34b852c055e57560a302f47efd1704bdf549ba77bba8 description: Documentation for the Tableau Migration SDK --- # Pre-Migration Checklist 🕐 _5 min read_ **Important**: Before starting this topic, review the [Plan Your Migration](/current/api/migration_sdk/en-us/docs/planning.html) topic to make sure that you have a complete migration plan. After you have a complete migration plan, use this topic to migrate from Tableau Server to Tableau Cloud. The [Tableau Migration Software Development Kit (SDK)](https://github.com/tableau/tableau-migration-sdk) requires that you have a licensed Tableau Cloud environment that is properly licensed and configured. To migrate smoothly, complete the tasks in this topic before you use the Migration SDK. ## Step 1: Upgrade your Tableau Server Upgrade your existing installation of Tableau Server to the latest version. For more information, see the [upgrade instructions for Windows](https://help.tableau.com/current/server/en-us/upgrade.htm) or the [upgrade instructions for Linux](https://help.tableau.com/current/server-linux/en-us/upgrade.htm). ## Step 2: Create a Tableau Cloud site The Migration SDK is compatible with both a licensed and trial Tableau Cloud Site. However, work with your account team to create a site that meets your user, content, and license type requirements. **Note**: This step might require licensing a Tableau Cloud environment. Work with your account team to ensure you retain access to both Tableau Server and Tableau Cloud during the migration process. ## Step 3: Configure all required Tableau Cloud site settings For more information, see [Customize the Site and Content Settings](https://help.tableau.com/current/online/en-us/to_customize_site_and_content.htm) ## Step 4: Configure Tableau Cloud user authentication By default, Tableau Cloud sends a Site Invite Notification email to all users when they’re added to a site. If you want to disable that automated notification, disable the **Site Invite Notification** in **Settings** under the General tab. For more information, see [Authentication](https://help.tableau.com/current/online/en-us/security_auth.htm). ## Step: 5: Set the correct time zone The Migration SDK doesn’t consider the time zone setting. You must set the correct time zone on the destination site. ## Step 6: Configure Tableau Server to allow embedded credential migration Use the following steps to allow embedded credential migration from Tableau Server to Tableau Cloud. ### In Tableau Cloud: 1. Sign in to Tableau Cloud as a site administrator. 2. Select **Settings > General**, and scroll down to **Manage Content Migration**. ![Manage Content Migration area in General Settings](/tableau/current/en-us/api/migration_sdk/en-us/assets/sdk-plan-manage-content-migration.png "Manage Content Migration area in General Settings") 3. Click **Create new key** to generate an encryption key pair. **Note**: The public key is only displayed once. If you lose the key before completing the configuration, you must generate a new key. 4. In the resulting window, click **Copy to clipboard** and then close the window. 5. Paste the public key to a file and store it in a safe location. The TSM administrator will use the public key to allow migration. You can view the public key expiration date on the **Settings** page. ### In the TSM CLI: 1. Open a Windows Command Prompt with an account that is a member of the Administrators group on a node in the cluster. 2. Use `tsm security authorize-credential-migration` to allow embedded credential migration to the Tableau Cloud site. For more information, see [tsm security](https://help.tableau.com/current/server/en-us/cli_security_tsm.htm). ``` tsm security authorize-credential-migration --source-site-url-namespace --destination-site-url-namespace --destination-server-url --authorized-migration-runner --destination-public-encryption-key ``` **Note**: When running TSM commands from a remote node, use `tsm login` to authenticate a session with the Tableau Server Administration Controller service before running `tsm security authorize-credential-migration`. ## Step 7: Configure database connectivity Some Cloud-accessible databases require you to [authorize access to cloud data published to Tableau Cloud](https://help.tableau.com/current/pro/desktop/en-us/publish_tableau_online_ip_authorization.htm). If Tableau Bridge is required: 1. [Install and configure Tableau Bridge](https://help.tableau.com/current/online/en-us/qs_refresh_local_data.htm) 2. [Configure Tableau Bridge client pools](https://help.tableau.com/current/online/en-us/to_enable_bridge_live_connections.htm) **Important**: Configure your own Bridge Pool. The Default Bridge Pool doesn’t support some aspects of the Migration SDK. For more information about Tableau Bridge, see [Plan Your Bridge Deployment](https://help.tableau.com/current/online/en-us/to_bridge_scale.htm) ## Step 8: Configure OAuth clients For OAuth credentials to function, you must configure the destination site with any OAuth clients used on the source site. For more information, see [OAuth Connections](https://help.tableau.com/current/online/en-us/protected_auth.htm). ## Step 9: (Optional) Automate user provisioning and group synchronization By default the Migration SDK migrates your groups exactly as they exist on Tableau Server. However it will not continue to sync your groups. If you want to create new groups during the migration, we recommend taking this step now, and opting to not migrate Groups using the Migration SDK. For more information, see [Automate User Provisioning and Group Synchronization](https://help.tableau.com/current/online/en-us/scim_config_online.htm).