The migration coordinator can migrate an NSX Data Center for vSphere environment with vRealize Automation if it is configured in a supported topology.

The following resources that are created using vRealize Automation are supported for migration:
In NSX-T Data Center 3.1 or later
  • On-demand routed networks without services
  • On-demand routed networks with DHCP server
  • On-demand private networks (isolated networks)
  • On-demand security groups
  • Existing security groups
In addition, the following pre-created objects in NSX-v that are consumed in vRealize Automation deployments are supported for migration:
  • Existing networks (Logical Switches, VLAN Distributed Virtual Port Groups)
  • Existing security groups
  • Distributed Logical Router (DLR)
Starting in NSX-T Data Center 3.1.1
  • On-demand outbound networks with NAT only
  • On-demand outbound networks with DHCP, NAT, one-arm load balancer
  • On-demand outbound networks with DHCP, NAT, inline load balancer
  • On-demand outbound networks with DHCP, NAT, one-arm load balancer, inline load balancer
  • On-demand one-arm load balancer on existing networks
  • On-demand security groups or existing security groups with load balancer

The version of vRealize Automation that you are using in your integrated environment must support the topologies mentioned in this topic for migration. For information about topologies that vRealize Automation supports for migration, see the vRealize Automation 8 NSX-V to NSX-T Migration Guide.

Caution: In topologies that contain a vRealize Automation created Edge Services Gateway (ESG), if you have user-defined Edge firewall rules on the ESG, these rules are not migrated to NSX-T. In NSX-v, the default action for Edge firewall rules is to block all traffic. However, in NSX-T, the default action is to allow all traffic. Therefore, only user-defined Edge firewall rules with either deny or reject action are not migrated to NSX-T.
In the network topology diagrams that follow later in this topic, the following guidelines are used:
Before migration topology
Objects that are pre-created or existing in NSX-v are shown in a dark gray color. The pre-created topology in NSX-v can match any one of the following four NSX-v topologies that are supported for migration:
  • ESG with High Availability and L4-L7 Services (Topology 1)
  • ESG with No L4-L7 Services (Topology 2)
  • Two Levels of ESG with L4-L7 Services on Second-Level ESG (Topology 3)
  • One-Armed Load Balancer (Topology 4)

For details about these supported topologies, see Topologies Supported by Migration Coordinator.

The on-demand routed networks, outbound networks, and private networks that are shown in orange represent the resources that were created in vRealize Automation.

After migration topology
The existing or pre-created objects in the NSX-v topology map to NSX-T Data Center objects in a dark gray color. The on-demand resources created in vRealize Automation map to NSX-T objects in an orange color.
Note:
  • In all the supported topologies, vRealize Automation does not create Distributed Logical Router (DLR) or north-facing Edge Services Gateways (ESG). vRealize Automation can only consume an existing DLR in its Network Profile and use it for creating the on-demand routed networks.
  • In all the supported topologies, BGP is supported between north-facing Edge Services Gateways and physical ToR switches, and OSPF is supported between Edge Services Gateways and the DLR.

On-Demand Routed Networks Without Services (Topology A)

This topology supports the following configurations:
  • Logical Switches created in vRealize Automation connect to an existing Distributed Logical Router in NSX-v.
  • Workload VMs created using vRealize Automation are attached to the Logical Switches created in vRealize Automation.
The configurations are migrated to NSX-T Data Center as follows:
  • A tier-1 gateway is created for each vRealize Automation created Logical Switch that is connected to the Distributed Logical Router.
  • The downlink interfaces of the Distributed Logical Router map to the downlink interfaces on the tier-1 gateway.
  • An NSX-T segment is created for each vRealize Automation created Logical Switch.
  • Workload VMs created in vRealize Automation are attached to the NSX-T segments.
Figure 1. Topology A: Before and After Migration

Topology A contains pre-created networks and on-demand routed networks without services.

On-Demand Routed Networks with DHCP Server Only (Topology B)

This topology supports the following configurations:
  • Logical Switches created in vRealize Automation connect to an existing Distributed Logical Router in NSX-v.
  • An Edge Services Gateway with a DHCP server configuration is created using vRealize Automation.
  • The Edge Services Gateway is attached to the vRealize Automation created Logical Switch.
The configurations are migrated to NSX-T Data Center as follows:
  • A tier-1 gateway is created for each vRealize Automation created Logical Switch that is connected to the Distributed Logical Router.
  • The downlink interfaces of the Distributed Logical Router map to the downlink interfaces on the tier-1 gateway.
  • An NSX-T segment is created for each vRealize Automation created Logical Switch.
  • Workload VMs created in vRealize Automation are attached to the NSX-T segments.
  • DHCP server configuration on the Edge Services Gateway is migrated to a Local DHCP server configuration on the NSX-T segment.
  • DHCP leases of the workload VMs that are attached to the vRealize Automation created Logical Switch are migrated to NSX-T.
Figure 2. Topology B: Before and After Migration

Topology B contains pre-created networks and on-demand routed networks with DHCP server only.

On-Demand Private Networks (Topology C)

This topology contains vRealize Automation created Logical Switches that are not connected to either the Distributed Logical Router or the Edge Services Gateway. That is, there is no routing in this topology. The isolated on-demand private networks allow Layer 2 connectivity between workload VMs on the same Logical Switch. This topology supports the following configurations:
  • Workload VMs are created in vRealize Automation and attached to the vRealize Automation created Logical Switches.
  • Optional: An Edge Services Gateway is created in vRealize Automation, and DHCP server is configured on this ESG. The ESG is attached to the vRealize Automation created Logical Switch.
The configurations are migrated to NSX-T Data Center as follows:
  • An NSX-T segment is created for each vRealize Automation created Logical Switch.
  • Workload VMs created in vRealize Automation are attached to the NSX-T segment.
  • Local DHCP server is configured on the NSX-T segment.
Figure 3. Topology C: Before and After Migration

Topology B contains on-demand private networks with DHCP server only.

On-Demand Security Groups (Topology D)

This topology supports creating Security Groups using vRealize Automation. You can do the following configurations in the Security Groups through vRealize Automation:
  • Add only VM vNICs as static members.
  • Add Security Policies.
  • Add firewall rules in the Security Policy. The rules can have a combination of IP addresses and applications, with or without port and protocol combinations.
  • Apply Security Policies to the vRealize Automation created Security Groups.

If the firewall rules in the vRealize Automation created Security Policy contain IP addresses, vRealize Automation creates an IP set. If the rule contains port and protocol combinations, vRealize Automation creates the necessary applications in the firewall rule.

After migration, the vRealize Automation created Security Groups map to Groups in NSX-T. An L4 application in the firewall rule on NSX-v maps to an L4 service in the NSX-T firewall rule. However, if the rule contains an L7 application, the mapping can be any one of the following:
  • An L7 application without port and protocol combination in an NSX-v firewall rule maps to a single Context Profile in an NSX-T firewall rule.
  • An L7 application with port and protocol combination in an NSX-v firewall rule maps to a single Context Profile and a L4 service in an NSX-T firewall rule.

Existing Security Groups (Topology E)

In this topology, vRealize Automation consumes or references existing or pre-created Security Groups in the NSX-v environment. However, with existing Security Groups, limited functionality is supported. Using vRealize Automation, you can add only vNICs of workload VMs as static members in the existing Security Groups. You cannot create Distributed Firewall rules in vRealize Automation and apply them to existing Security Groups.

After migration, the Security Groups in NSX-v map to Groups in NSX-T. Security Tags created through vRealize Automation are not supported for migration to NSX-T. If you have assigned pre-created NSX-v Security Tags to workload VMs, these tags are migrated to NSX-T, but this information is not updated in vRealize Automation.

On-Demand Outbound Networks with NAT Only (Topology F)

This topology supports the following configurations:
  • On-demand outbound networks (Logical Switches) are created using vRealize Automation. For example, networks 2 and 3 in the before migration topology represents the on-demand outbound networks.
  • The uplink interface of the vRealize Automation created Edge Services Gateways (ESG-3 and ESG-4) are connected to an existing transit Logical Switch (192.178.14.0/24).
  • The vRealize Automation created VMs on the on-demand outbound networks have a static IP address.
  • Network address translation (NAT) rules are created using vRealize Automation. SNAT action is configured on the uplink interface of ESG-3 and ESG-4. The SNAT rules allow only outgoing traffic from the VMs on the outbound networks to the external clients on the public network. Port forwarding is not supported on vRealize Automation created SNAT rules.

    Example: NAT rule configuration on ESG-3 and ESG-4.

    ESG-3 ESG-4

    Original

    Action: SNAT

    Applied on: vNIC (uplink interface)

    Protocol: any

    Source IP range: 192.168.200.1-192.168.200.14

    Source ports: any

    Destination IP range: any

    Destination ports: any

    Original

    Action: SNAT

    Applied on: vNIC (uplink interface)

    Protocol: any

    Source IP range: 192.168.210.1-192.168.210.14

    Source ports: any

    Destination IP range: any

    Destination ports: any

    Translated

    IP address: 192.178.14.4

    Port range: any

    Translated

    IP address: 192.178.14.5

    Port range: any
Figure 4. Topology F: Before Migration

Topology F: Before Migration

The configurations are migrated to NSX-T Data Center as follows:
  • For each vRealize Automation created outbound network that is connected to an ESG, a tier-1 gateway is created and an NSX-T overlay segment is attached to the downlink of this tier-1 gateway.
  • NAT rules with SNAT action are configured on the tier-1 gateways. These SNAT rules have the same configuration as the SNAT rules on the vRealize Automation created ESGs.
  • Tier-1 gateways are created in the same edge cluster where the tier-0 gateway is created.
Figure 5. Topology F: After Migration

Topology F: After Migration

On-Demand Outbound Networks with DHCP, NAT, One-Arm Load Balancer (Topology G)

This topology supports the following configurations:
  • On-demand outbound networks (Logical Switches) are created using vRealize Automation. For example, networks 2 and 3 in the before migration topology diagram represents the on-demand outbound networks.
  • The uplink interface of the vRealize Automation created Edge Services Gateways (ESG-3 and ESG-4) are connected to an existing transit Logical Switch in NSX-v (for example, 192.178.14.0/24).
  • ESG-3 is configured with a one-arm load balancer and NAT rules (SNAT action).
  • ESG-4 is configured with a DHCP server and NAT rules (SNAT action).
  • The vRealize Automation created VMs on the on-demand outbound network 2 have a static IP address.
  • The vRealize Automation created workload VMs on the outbound network 3 are assigned an IP address by the DHCP server.
  • Network address translation (NAT) rules are created using vRealize Automation. SNAT action is configured on the uplink interface of ESG-3 and ESG-4. SNAT rules allow only outgoing traffic from the VMs on the outbound networks to the external clients on the public network.
    Example: NAT rule configuration on ESG-3 and ESG-4.
    ESG-3 ESG-4

    Original

    Action: SNAT

    Applied on: vNIC (uplink interface)

    Protocol: any

    Source IP range: 192.168.200.1-192.168.200.14

    Source ports: any

    Destination IP range: any

    Destination ports: any

    Original

    Action: SNAT

    Applied on: vNIC (uplink interface)

    Protocol: any

    Source IP range: 192.168.210.1-192.168.210.14

    Source ports: any

    Destination IP range: any

    Destination ports: any

    Translated

    IP address: 192.178.14.4

    Port range: any

    Translated

    IP address: 192.178.14.5

    Port range: any
  • Example: One-arm load balancer configuration on ESG-3:
    • Virtual Server IP: 192.168.200.14
    • Default Pool: Pool-1
    • Pool-1 has three VMs: 192.168.200.10/24, 192.168.200.11/24, 192.168.200.12/24

    The other load balancer configuration settings are not listed here because they are not of interest in this migration example.

  • Example: Internal interface of ESG-3 has two IP addresses configured: primary IP address and secondary IP address.
    • Primary IP address: 192.168.200.1/24. It connects the outbound network to the downlink (internal) interface of the ESG-3.
    • Secondary IP address: 192.168.200.14/24. It is used as the virtual server IP.

    If necessary, you can configure a single IP address on the internal interface of the ESG-3. In that case, the virtual server IP is the same as the primary IP address.

  • Example: DHCP server configuration on ESG-4:
    • DHCP pool range: 192.168.210.20-192.168.210.40
    • Default gateway: 192.168.210.1

    The other DHCP server settings are not listed here because they are not of interest in this migration example.

Figure 6. Topology G: Before Migration

Topology G: Before Migration
The configurations are migrated to NSX-T Data Center as follows:
  • For each vRealize Automation created outbound network that is connected to an ESG, a tier-1 gateway is created and an NSX-T overlay segment is attached to the downlink of this tier-1 gateway.
  • NAT rules with SNAT action are configured on the tier-1 gateways. These SNAT rules have the same configuration as the SNAT rules on the vRealize Automation created ESGs.
  • Tier-1 gateways are created in the same edge cluster where the tier-0 gateway is created.
  • Load balancer service configuration on ESG-3 is migrated to a load balancer service configuration on the tier-1 gateway. This tier-1 gateway is connected to the NSX-T overlay segment 2 on the downlink.
  • DHCP service configuration on ESG-4 is migrated to a Gateway DHCP server configuration on the tier-1 gateway. This tier-1 gateway is connected to the NSX-T overlay segment 3 on the downlink.

    Migration coordinator uses a default DHCP server IP address to configure the Gateway DHCP server in NSX-T. If necessary, you can enter a different server IP address during the Resolve Configuration step of the migration. Follow the instructions that are shown on the Submit Input page of the migration coordinator UI to specify a different server IP address.

  • In NSX-v, lease time is configured at the level of DHCP IP pool, whereas in NSX-T lease time is configurable at the level of each segment. If the DHCP service on an NSX-v network is configured with multiple DHCP IP pools, migration coordinator takes the highest lease time from among all the DHCP IP pools and configures it on the NSX-T segment.
  • DHCP leases of the workload VMs that are attached to the vRealize Automation created outbound network 3 are migrated to NSX-T.
Figure 7. Topology G: After Migration

Topology G: After Migration

On-Demand Outbound Networks with DHCP, NAT, Inline Load Balancer (Topology H)

This topology supports the following configurations:
  • On-demand outbound networks (Logical Switches) are created using vRealize Automation. For example, networks 2 and 3 in the before migration topology diagram represents the on-demand outbound networks.
  • The uplink interfaces of the vRealize Automation created Edge Services Gateways (ESG-3 and ESG-4) are connected to an existing transit Logical Switch in NSX-v (for example, 192.178.14.0/24).
  • ESG-3 is configured with an inline load balancer, DHCP server, and NAT rules (SNAT action).
  • ESG-4 is configured with only NAT rules (SNAT action).
  • The vRealize Automation created VMs on the on-demand outbound network 2 are assigned an IP address by the DHCP server.
  • The vRealize Automation created VMs on the on-demand outbound network 3 have a static IP address.
  • Network address translation (NAT) rules are created using vRealize Automation. SNAT action is configured on the uplink interface of ESG-3 and ESG-4. SNAT rules allow only outgoing traffic from the VMs on the outbound networks to the external clients on the public network.

    For an example of NAT rule configuration on ESG-3 and ESG-4, see the before migration topology description of Topology G that is explained earlier in this topic.

  • Example: Inline load balancer configuration on ESG-3:
    • Virtual Server IP: 192.178.14.6
    • Default Pool: Pool-1
    • Pool-1 has two VMs: 192.168.200.10/24, 192.168.200.11/24

    The other load balancer configuration settings are not listed here because they are not of interest in this migration example.

  • Example: Uplink interface of ESG-3 has two IP addresses configured: primary IP address and secondary IP address.
    • Primary IP address: 192.178.14.4/24. It connects ESG-3 to the transit Logical Switch.
    • Secondary IP address: 192.178.14.6/24. It is used as the virtual server IP.
  • Example: DHCP server configuration on ESG-3:
    • DHCP pool range: 192.168.200.20-192.168.200.40
    • Default gateway: 192.168.200.1

    The other DHCP server settings are not listed here because they are not of interest in this migration example.

Figure 8. Topology H: Before Migration

Topology H: Before Migration
The configurations are migrated to NSX-T Data Center as follows:
  • For each vRealize Automation created outbound network that is connected to an ESG, a tier-1 gateway is created and an NSX-T overlay segment is attached to the downlink of this tier-1 gateway.
  • NAT rules with SNAT action are configured on the tier-1 gateways. These SNAT rules have the same configuration as the SNAT rules on the vRealize Automation created ESGs.
  • Tier-1 gateways are created in the same edge cluster where the tier-0 gateway is created.
  • Load balancer service on ESG-3 is migrated to a load balancer service on the tier-1 gateway. This tier-1 gateway is connected to the NSX-T overlay segment 2 on the downlink.
  • DHCP service configuration on ESG-3 is migrated to a Gateway DHCP server on the tier-1 gateway.

    Migration coordinator uses a default DHCP server IP address to configure the Gateway DHCP server in NSX-T. If necessary, you can enter a different server IP address during the Resolve Configuration step of the migration. Follow the instructions that are shown on the Submit Input page of the migration coordinator UI to specify a different server IP address.

  • In NSX-v, lease time is configured at the level of DHCP IP pool, whereas in NSX-T lease time is configurable at the level of each segment. If the DHCP service on an NSX-v network is configured with multiple DHCP IP pools, migration coordinator takes the highest lease time from among all the DHCP IP pools and configures it on the NSX-T segment.
  • DHCP leases of the workload VMs that are attached to the vRealize Automation created outbound network 2 are migrated to NSX-T.
Figure 9. Topology H: After Migration

Topology H: After Migration

On-Demand Outbound Networks with DHCP, NAT, One-Arm Load Balancer, Inline Load Balancer (Topology I)

This topology supports the following configurations:
  • On-demand outbound networks (Logical Switches) are created using vRealize Automation. For example, networks 2 and 3 in the before migration topology diagram represents the on-demand outbound networks.
  • Both outbound networks are connected to the downlink interfaces of a single vRealize Automation created Edge Services Gateway (ESG-3). This topology diagram shows two outbound networks connected to ESG-3. However, you can have more than two outbound networks connected to the same ESG.
  • The uplink interface of ESG-3 is connected to an existing transit Logical Switch in NSX-v (for example, 192.178.14.0/24).
  • The following services are configured on ESG-3:
    • NAT rules with SNAT and DNAT action.
    • DHCP server
    • One-arm load balancer
    • Inline load balancer
  • The vRealize Automation created VMs on the on-demand outbound networks 2 and 3 are assigned an IP address by the DHCP server.
  • Example: Inline load balancer configuration on ESG-3. It load balances traffic on network 2:
    • Virtual Server IP: 192.178.14.5
    • Default Pool: Pool-1
    • Pool-1 has two VMs: 192.168.200.10/24, 192.168.200.11/24

    The other load balancer configuration settings are not listed here because they are not of interest in this migration example.

  • Example: One-arm load balancer configuration on ESG-3. It load balances traffic on network 3:
    • Virtual Server IP: 192.168.210.2
    • Default Pool: Pool-2
    • Pool-2 has two VMs: 192.168.210.11/24, 192.168.210.12/24
  • NAT rules with SNAT action and DNAT action are configured on ESG-3. Port forwarding is supported for both SNAT and DNAT rules.
  • Example: SNAT rules configuration on ESG-3.
    SNAT Rule 1 SNAT Rule 2

    Original

    Applied on: vNIC (uplink interface)

    Protocol: any

    Source IP range: 192.168.200.1-192.168.200.14

    Source ports: any

    Destination IP range: any

    Destination ports: any

    Original

    Applied on: vNIC (uplink interface)

    Protocol: any

    Source IP range: 192.168.210.1-192.168.210.14

    Source ports: any

    Destination IP range: any

    Destination ports: any

    Translated

    IP address: 192.178.14.5

    Port range: any

    Translated

    IP address: 192.178.14.4

    Port range: any
  • Example: DNAT rule configuration on ESG-3.

    Original

    Protocol: any

    Source IP range: any

    Source ports: any

    Destination IP range: 192.178.14.5

    Destination ports: 100

    Translated

    IP address: 192.178.200.35

    Port range: 80
  • Example: DHCP server configuration on ESG-3 has two IP pools:
    • DHCP IP pool 1: 192.168.200.20-192.168.200.40
    • Default gateway for pool 1: 192.168.200.1
    • DHCP IP pool 2: 192.168.210.20-192.168.210.40
    • Default gateway for pool 2: 192.168.210.1

    The other DHCP server settings are not listed here because they are not of interest in this migration example.

Figure 10. Topology I: Before Migration

Topology I: Before Migration
The configurations are migrated to NSX-T Data Center as follows:
  • For the vRealize Automation created outbound networks that are connected to a single ESG, a tier-1 gateway is created and NSX-T overlay segments are attached to the downlink of this tier-1 gateway.
  • SNAT and DNAT rules are configured on the tier-1 gateway. These rules have the same configuration as the SNAT and DNAT rules on the vRealize Automation created ESG-3.
  • Tier-1 gateway is created in the same edge cluster where the tier-0 gateway is created.
  • Load balancer service configurations on ESG-3 are migrated to the load balancer service configurations on the tier-1 gateway.
  • DHCP service configuration on ESG-3 is migrated to a Gateway DHCP server on the tier-1 gateway.

    Migration coordinator uses a default DHCP server IP address to configure the Gateway DHCP server in NSX-T. If necessary, you can enter a different server IP address during the Resolve Configuration step of the migration. Follow the instructions that are shown on the Submit Input page of the migration coordinator UI to specify a different server IP address.

  • In NSX-v, lease time is configured at the level of DHCP IP pool, whereas in NSX-T lease time is configurable at the level of each segment. When the DHCP service on an NSX-v network is configured with multiple DHCP IP pools, migration coordinator takes the highest lease time from among all the DHCP IP pools and configures it on the NSX-T segment.
  • DHCP leases of the workload VMs that are attached to the vRealize Automation created outbound networks are migrated to NSX-T.
Figure 11. Topology I: After Migration

Topology I: After Migration

On-Demand One-Arm Load Balancer on Existing Networks (Topology J)

This topology has the following configurations:
  • A one-arm load balancer is configured on a vRealize Automation created ESG. This ESG is connected to an existing network in NSX-v. The existing network can either be a VLAN or a Logical Switch.
    The before topology diagram shows a single one-arm load balancer on an existing network 1. For the purposes of this topology description, a single one-arm load balancer on a vRealize Automation created ESG is considered. However, this topology also supports the following configurations:
    • Multiple vRealize Automation created one-arm load balancers connected to a single existing network. One load balancer is configured on each vRealize Automation created ESG. All ESGs are deployed as part of a single vRealize Automation deployment.
    • Multiple vRealize Automation created one-arm load balancers, where one load balancer is connected to each different existing network. One load balancer is configured on each vRealize Automation created ESG. All ESGs are deployed as part of a single vRealize Automation deployment.
  • The vRealize Automation created workload VMs that are connected to an existing network have a static IP address.
  • Example: One-arm load balancer configuration on ESG-3.
    • Virtual Server IP: 192.168.100.2
    • Default Pool: Pool-1
    • Pool-1 has two VMs: 192.168.100.10/24, 192.168.100.11/24
Figure 12. Topology J: Before Migration

Topology J: Before Migration
The configurations are migrated to NSX-T Data Center as follows:
  • ESG-3 in the NSX-v topology is migrated to a standalone tier-1 gateway in the NSX-T topology. This tier-1 gateway is not connected to the tier-0 gateway.
  • The load balancer configuration on ESG-3 is migrated to a load balancer configuration on the tier-1 gateway.
Figure 13. Topology J: After Migration

Topology J: After Migration

On-Demand Security Groups or Existing Security Groups with Load Balancer (Topology K)

This topology supports a vRealize Automation created ESG with a single load balancer configured on it. The ESG can be connected either to an existing network or to an on-demand network that is created through vRealize Automation.

An existing Security Group is a part of the vRealize Automation Network Profile, or an on-demand/existing Security Group is present in the vRealize Automation deployment that contains on-demand networks.

In the input deployment configuration file, vRealize Automation automatically adds the virtual server IP of the load balancer inside an IP set object. This IP set is added as a member of the Security Group in the vRealize Automation Network Profile. Or the IP set is added as a member of the on-demand or existing Security Group from the blueprint that is associated with the load balanced pool members.

When such a topology is migrated to NSX-T, the ESG maps to a tier-1 gateway in the NSX-T topology. Load balancer service configuration on ESG is migrated to a load balancer service configuration on the tier-1 gateway. The Security Group in NSX-v maps to a Group in NSX-T. This NSX-T Group contains a nested Group that has the virtual server IP of the load balancer.