After NSX-T migration from NSX Virtual Distributed Switch (N-VDS) to converged VDS (C-VDS), you must update impacted vSphere network resources in vRealize Automation Cloud to continue using those resources in new and existing cloud templates and deployments.

After N-VDS to C-VDS migration, your vSphere networks may appear to be missing from vRealize Automation Cloud network profiles in which they are members. To avoid losing these vSphere type networks, and continue to allocate them in existing and new deployments, you must manually update all listed C-VDS networks in vRealize Automation Cloud Cloud Assembly.

Note: While users do not need the VMware Cloud on AWS Cloudadmin role to create VMware Cloud on AWS cloud accounts in vRealize Automation Cloud for N-VDS, they do need that permission level to access C-VDS assets after N-VDS to C-VDS migration. Active Directory members with containerized permissions need host switch-level access (ReadOnly) to migrated C-VDS resources in vRealize Automation Cloud. Cloud Administrator group (Cloudamin role) users have host switch-level permissions. vRealize Automation Cloud users who are not members of the VMware Cloud on AWS Cloud Administrator group cannot access migrated C-VDS resources.
  • Active Directory members who are assigned the Cloudadmin role in VMware Cloud on AWS prior to the N-VDS to C-VDS migration in NSX-T have the Cloudadmin role in VMware Cloud on AWS after N-VDS to C-VDS migration, and thus have the required access level to migrated C-VDS resources.
  • Active Directory members who are not assigned the Cloudadmin role in VMware Cloud on AWS before N-VDS to C-VDS migration in NSX-T must be assigned the Cloudadmin role after the migration.
  • For related information about VMware Cloud on AWS and vRealize Automation Cloud credentials, see Credentials required for working with cloud accounts in vRealize Automation Cloud.
Note:

This procedure is specific to actions needed in vRealize Automation Cloud to update vSphere networks after N-VDS to C-VDS migration has been performed in NSX-T. There is no action needed in vRealize Automation Cloud on NSX networks after N-VDS to C-VDS migration; NSX networks require no manual intervention after N-VDS to C-VDS migration.

NSX networks that are attached to vCenter cloud accounts, as well as to VMware Cloud on AWS cloud accounts, are supported and do not require the manual intervention described in this procedure. However, NSX networks that are attached to VMware Cloud on Dell cloud accounts may require the manual intervention described here. For related information, see VMware Cloud on AWS (VMConAWS) and VMware Cloud on Dell EMC Migration from N-VDS to VDS (82487).

While an NSX-T administrator can migrate NSX-T on VDS (N-VDS) network types to converged VDS (C-VDS) network types in NSX, this action impacts existing vSphere network resources in vRealize Automation Cloud. The vRealize Automation Cloud administrator can perform post-migration actions to reconcile those resources in vRealize Automation Cloud with the associated changes in NSX-T and vCenter Server. Note that C-VDS, or simply VDS, is also referred to elsewhere as vSphere 7 Virtual Distributed Switch (VDS).

For related information about NSX-T converged VDS (C-VDS), see VMware Knowledge Base article NSX-T on VDS (79872).

Note: This sample scenario illustrates the steps needed to reconcile resources in a vRealize Automation Cloud environment after N-VDS to C-VDS migration. You can use this example and procedure in vRealize Automation Cloud to reconcile changes made in vCenter Server after migrating from N-VDS to C-VDS in NSX-T.

Example: vRealize Automation Cloud resources pre-migration

This example illustrates sample NSX-T resources in a sample vRealize Automation Cloud environment prior to N-VDS to C-VDS migration.

  • This example contains NSX-T and vCenter cloud accounts, as shown below.

    cvds1

  • The example contains several vSphere networks, as shown below.

    cvds2

  • The example network configuration contains CIDR and DNS settings, as shown below.

    cvds3

  • The example also includes existing IP ranges, as shown below.

    cvds4

  • The example contains a network profile (ex-np) which contains several N-VDS (N-VDS) networks, including seg-5, as shown below.cvds5
  • In this example, the existing seg5 network component is shown in the following sample cloud template syntax. The network is tagged as an N-VDS network. We will illustrate needed post-migration updates to the seg5 network later in this example.

    cvds6

  • The example cloud template generates the deployment, as shown below.

    cvds7

  • The example machine IP addresses are displayed in the sample deployment, as shown below.

    cvds8

Example: Post-migration Step 1 – Run data collection after N-VDS to C-VDS migration and enumeration

In the above section, screen shots were used to illustrate the infrastructure used in an example vRealize Automation Cloud environment, concluding with the output cloud template and deployment.

After you or another administrator perform N-VDS to C-VDS migration in NSX-T, wait at least 10 minutes to allow vRealize Automation Cloud to perform its periodic data collection and enumeration process to fetch and display impacted resources in vRealize Automation Cloud.

After allowing vRealize Automation Cloud data collection to complete, click Infrastructure > Networks to view and access available C-VDS networks. Notice the seg5 network, as shown below.

enumeration

Example: Post-migration Step 2 – Add previously defined CIDR and DNS to migrated C-VDS networks

Edit a migrated C-VDS network to add CIDR and DNS details that had been specified in the pre-migration N-VDS definition and change the network tagging.

  1. Add CIDR and DNS details that had been defined in its pre-migration N-VDS definition
  2. Add a new tag for the sample C-VDS seg-5 network segment, such as seg5-cvds.

    add details

    Note that the original N-VDS seg-5 network was tagged as seg5-nvds, as seen in earlier screens. The change in resource tagging details is required by network reconfiguration. vRealize Automation Cloud requires that you include a different tag name in the cloud template for the C-VDS network than the tag used in the original N-VDS network. The changed tagging identifies a change in the cloud template when generating a valid redeployment.

Example: Post-migration Step 3 – Add updated IP range information

You can edit network IP ranges to IP range details that had been specified in the pre-migration N-VDS definition, by using a command line API or by using a menu sequence in vRealize Automation Cloud.

  • Option 1: Use the API to update IP range data, as shown in the following sample screen.

    update IP range api

  • Option 2: Use the user interface to update IP range data, as shown in the following sample screen.

    update ip range UI

Example: Post-migration Step 4 – Update network profiles to correct missing networks

Post-migration, N-VDS networks are reconciled and deleted from vRealize Automation Cloud Cloud Assembly after data collection and enumeration. Impacted network profiles (such as the example ex-np) have missing networks. To correct the missing networks issue, update each N-VDS network as a C-VDS network, as shown below.

update nw profiles

Example: Post-migration Step 5 – Update network constraints in cloud templates

For existing deployments, you must update network constraints in cloud template to match the new C-VDS networks in the updated network profiles. Updated network constraints are also needed to perform iterative deployments and to reconfigure networks from their original vSphere N-VDS representation to vSphere C-VDS representation.

For new deployments, the specified C-VDS resources are used, thus this step is not required. Iterative deployments and network reconfiguration simply work as designed.

  1. For this example, change network constraints in the cloud template from seg5-nvds to seg5-cvds, as shown below.

    update con 1

  2. Perform an iterative deployment to reconfigure the network, as shown below.

    update con 2

  3. After successful redeployment, notice that the network custom properties display the updated constraints, as shown below.

    update constraints 3

    Because the IP range was updated earlier with the new C-VDS data, the machine IP address does not change in the redeployment, as shown below.

    update con 4