--- name: wanclouds-vpc-plus-planning title: Planning for migration description: To get the best results from your VPC migration, spend time analyzing your classic environment and learning how the VPC+ Cloud Migration tool will handle different components of your environment. Use the following information to start planning your migration journey. last-updated: 2022-02-02 --- > ## Documentation Index > The table of contents for this documentation set is at https://cloud.ibm.com/docs/wanclouds-vpc-plus?format=markdown > The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt > Use these files to discover more information as needed. {:shortdesc: .shortdesc} {:codeblock: .codeblock} {:screen: .screen} {:external: target="_blank" .external} {:pre: .pre} {:tip: .tip} {:note: .note} {:important: .important} {:table: .aria-labeledby="caption"} # Planning for migration {: #planning-for-migration} To get the best results from your VPC migration, spend time analyzing your classic environment and learning how the VPC+ Cloud Migration tool will handle different components of your environment. Use the following information to start planning your migration journey. {:shortdesc} ## Preparing for differences in classic and VPC environments {: #review-tasks} | Task | Details | | --- | --- | | Review [quotas and service limits](https://cloud.ibm.com/docs/wanclouds-vpc-plus?topic=vpc-quotas&format=markdown) | Ensure that your IBM Cloud® classic infrastructure components that you are migrating are within the VPC quotas and service limits. | | Review [migration considerations](https://cloud.ibm.com/docs/wanclouds-vpc-plus?topic=wanclouds-vpc-plus-migration-considerations&format=markdown) | Review information about specific infrastructure components. | | Review [comparisons between infrastructure environments](https://cloud.ibm.com/docs/cloud-infrastructure?topic=cloud-infrastructure-compare-infrastructure&format=markdown) | Some components of your classic infrastructure might not exist in VPC such as dedicated virtual servers, available server profiles, and IPv6 addressing. | | Review [VPC pricing](https://www.ibm.com/cloud/vpc/pricing){: external} | Pricing might vary between IBM Cloud classic and VPC infrastructures. | {: caption="Table 1. Review tasks" caption-side="top"} ## Granting permissions and access {: #grant-permissions-and-access} | Task | Details | | --- | --- | | Permissions for classic and VPC | Contact your account administrator for permissions. | | Grant access between VPC Image Services and IBM Cloud Object Storage | Grant this access if you want to migrate your primary boot volume, secondary volumes, and images from classic infrastructure. For more information, see [Granting access between services](https://cloud.ibm.com/docs/vpc?topic=vpc-object-storage-prereq&format=markdown). | {: caption="Table 2. Permissions and access tasks" caption-side="top"} ## Gathering IBM Cloud account information {: #gather-account-information} | Account information | Details | | --- | --- | | Username | Create a username specifically for VPC+ Cloud Migration. In the IBM Cloud console, select **Manage > Access (IAM) > Users.** Select **Users** and then click **Invite user**, supplying the email address name of the user. This allows you to delete the username after your migration is complete. For more information, see [Inviting users to an account](https://cloud.ibm.com/docs/account?topic=account-iamuserinv&format=markdown). | | API keys | You need a classic infrastructure API key. You will also need to create an IBM Cloud API key (VPC API key) specifically for VPC+ Cloud Migration. Your IBM Cloud API key must have “Reader, Writer” access. You can verify the level of access in the IBM Cloud console by clicking **Manage > Access (IAM)** and selecting **Authorizations**. For more information, see [Managing classic infrastructure API keys](https://cloud.ibm.com/docs/account?topic=account-classic_keys&format=markdown) and [Managing user API keys](https://cloud.ibm.com/docs/account?topic=account-userapikey&format=markdown). | | IBM Cloud Object Storage and resource instance ID (service credentials)| Your Object Storage bucket is used to store your images and volumes during the migration process and its resource instance ID allows VPC+ Cloud Migration to access your IBM Cloud Object Storage and import the images that you want to migrate. For more information, see [IBM Cloud Object Storage getting started tutorial](https://cloud.ibm.com/docs/cloud-object-storage?topic=cloud-object-storage-getting-started-cloud-object-storage&format=markdown) and [Service credentials](https://cloud.ibm.com/docs/services/cloud-object-storage/iam?topic=cloud-object-storage-service-credentials&format=markdown). | | (Optional) VRA (Vyatta 5600) configuration file | If you want to migrate your Access Control Lists, VPN gateways, and public gateways, you need a VRA set command configuration file in `txt` format. JSON format is not supported. | {: caption="Table 3. Required IBM Cloud account information" caption-side="top"} ## Establishing connection between classic and VPC {: #establish-connection-classic-vpc} In some cases, resources in VPC still might need to access resources back in classic, such as databases or interprocess communication. In these cases, creating a transit gateway provides a bridge between the two environments. The VPC+ Cloud Migration tool can help create the transit gateway, or you can create it through the IBM Cloud. If you want to learn more, see [About IBM Cloud Transit Gateway](https://cloud.ibm.com/docs/transit-gateway?topic=transit-gateway-about&format=markdown). Review the [Planning for IBM Cloud Transit Gateway](https://cloud.ibm.com/docs/wanclouds-vpc-plus?topic=transit-gateway-helpful-tips&format=markdown) information if you want to establish a connection between your VPC and classic infrastructure. For IBM Cloud Transit Gateway use cases, check out the following information: * [Interconnect one or more VPCs in the same MZR and an IBM classic network](https://cloud.ibm.com/docs/transit-gateway?topic=transit-gateway-about&format=markdown#use-case-3-interconnect-one-or-more-vpcs-in-the-same-mzr-and-an-ibm-classic-network) * [Interconnect VPCs and an IBM classic network to access all your resources across all MZRs](https://cloud.ibm.com/docs/transit-gateway?topic=transit-gateway-about&format=markdown#use-case-4-interconnect-vpcs-and-an-ibm-classic-network-to-access-all-your-resources-across-all-mzrs) ## Migration process overview {: #migration-process-overview} The following table outlines the end-to-end process of your migration journey by using the VPC+ Cloud Migration tool. | Migration task | Details | | --- | --- | | [Create an instance of VPC+ Cloud Migration through the IBM Cloud catalog](https://cloud.ibm.com/docs/wanclouds-vpc-plus?topic=wanclouds-vpc-plus-getting-started-tutorial&format=markdown#step-3-create) | Create an instance of VPC+ Cloud Migration through the IBM Cloud catalog so that you have access to the VPC+ Cloud Migration tool. | | [Access the VPC+ Cloud Migration tool](https://cloud.ibm.com/docs/wanclouds-vpc-plus?topic=wanclouds-vpc-plus-getting-started-tutorial&format=markdown#step-4-access) | Log in by using your IBMid. | | [Add your IBM Cloud account to VPC+ Cloud Migration](https://cloud.ibm.com/docs/wanclouds-vpc-plus?topic=wanclouds-vpc-plus-getting-started-tutorial&format=markdown#step-5-add-account) | In order for VPC+ Cloud Migration to access details of your IBM Cloud configuration, you must add your IBM Cloud accounts information. | | [Discover your IBM Cloud classic infrastructure](https://cloud.ibm.com/docs/wanclouds-vpc-plus?topic=wanclouds-vpc-plus-migrate-discovery&format=markdown) | After you add your IBM Cloud accounts to VPC+ Cloud Migration, the VPC+ Cloud Migration tool can discover your classic infrastructure resources that can be migrated. | [Edit your discovered resources](https://cloud.ibm.com/docs/wanclouds-vpc-plus?topic=wanclouds-vpc-plus-edit-resources&format=markdown) | VPC+ Cloud Migration creates a workspace after discovering your environment. In the workspace you can add, delete, or edit any section of your VPC. | | [Provision your resources in VPC](https://cloud.ibm.com/docs/wanclouds-vpc-plus?topic=wanclouds-vpc-plus-migrate-provision&format=markdown) | You can either provision your entire VPC or select the components that you want to provision, allowing you to migrate the rest at a later time. | | [Validate your resources in VPC](https://cloud.ibm.com/docs/wanclouds-vpc-plus?topic=wanclouds-vpc-plus-migrate-validate&format=markdown) | After you provision your VPC environment, and before you make your VPC live, you will want to validate your VPC environment to ensure it is ready for production. | | (Optional) Create a transit gateway | If you want to establish a connection between your VPC and classic infrastructure, you can create a transit gateway. Refer to [Establishing connection between classic and VPC](https://cloud.ibm.com/docs/wanclouds-vpc-plus?topic=wanclouds-vpc-plus-planning-for-migration&format=markdown#establish-connection-classic-vpc). | {: caption="Table 4. Migration process overview" caption-side="top"} ## Next steps {: #planning-next-steps} Refer to [Getting started with VPC+ Cloud Migration](https://cloud.ibm.com/docs/wanclouds-vpc-plus?topic=wanclouds-vpc-plus-getting-started-tutorial&format=markdown) to start your migration journey.