How to Migrate Tenant Replicas From a Standard Switch (vSS) to a Distributed Switch (vDS)

KB ID: 3246
Published: 2020-07-30
Last Modified: 2026-04-08
mailbox
Get weekly article updates
By subscribing, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.

Cheers for trusting us with the spot in your mailbox!

Now you’re less likely to miss what’s been brewing in our knowledge base with this weekly digest

error icon

Oops! Something went wrong.

Please, try again later.

Purpose

This article documents how a Veeam Cloud Service Provider (VCSP or simply SP) would migrate their tenant(s)'s replica(s) from a virtual Standard Switch (vSS) to a virtual Distributed Switch (vDS).

Solution

Part 1: Update the Hardware Plan Configuration

  1. Edit the Hardware Plan used by tenants that are being migrated to a vDS.
  2. On the Network step of the wizard, click the Configure VLAN ID range link.
Network configuration step in the New VMware Hardware Plan wizard, showing fields for specifying the number of networks and a link to configure VLAN ID range.
  1. In the VLANs Configuration window, select the current VLAN configuration and click Edit.
VLANs Configuration window displaying a host with its associated virtual switch, VLAN ranges for internet access, internal VLANs, and an Edit button to modify settings.
  1. Configure the ranges for "VLANs with Internet access" and "VLANs without Internet access" so that only pre-allocated networks remain, then click OK.
VLAN Pool Settings window for specifying ranges of VLANs with and without Internet access, showing input fields for VLAN numbers and selections for host and virtual switch.
  1. In the VLANs Configuration window, click Add and configure a new VLAN entry for the virtual Distributed Switch (vDS).
VLANs Configuration window showing a host with associated virtual switch and VLAN ranges, with the Add button highlighted to allow adding new VLAN configurations.
  1. After the VLAN Configuration section is updated, go back ot the Network step of the wizard, and increase the number of networks on the Network configuration tab. The values should be increased to match the total number of networks.
Network configuration step in the New VMware Hardware Plan wizard, showing fields to specify two networks with internet access and two internal networks.
  1. Apply the configuration settings.
    For each tenant using this hardware plan, the new vDS networks will appear on the host.

Part 2: Reconfigure Tenant Replicas on SP-Side

  1. Update each tenant replica that will be migrated to change the network adapter manually to the vDS VLAN.
    There are two ways to accomplish this:
    • In vSphere Web Client, right-click on the old VLAN and select the option: Migrate VMs to Another Net…

      or
    • In vSphere Web Client, edit the Network adapter settings for each VM. 
    Note: When the network configuration is changed, two networks will appear in the VM configuration because existing snapshots still use the old network configuration. When these snapshots are removed according to the retention policy, only the new network will be shown for the VM.

Part 3: Update Tenant(s) Replication Jobs

  1. Coordinate with Tenants to have them remap networks for their replication jobs.
    There are two ways they can accomplish this:
    • Change replication jobs settings: 
      1. Edit replication job.
      2. On the Name step, enable the select option: Network remapping
      3. On the Network step, Add a network mapping to switch jobs to the new network.

      or
    • In the tenant's Veeam Backup & Replication Console, under the Backup Infrastructure > Service Providers section, right-click on the service provider entry and select the option "Manage default gateways" to remap Windows VMs.

If this KB article did not resolve your issue or you need further assistance with Veeam software, please create a Veeam Support Case.

To submit feedback regarding this article, please click this link: Send Article Feedback
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.

Spelling error in text

Thank you!

Thank you!

Your feedback has been received and will be reviewed.

Oops! Something went wrong.

Please, try again later.

You have selected too large block!

Please try select less.

KB Feedback/Suggestion

This form is only for KB Feedback/Suggestions, if you need help with the software open a support case

By submitting, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.
Verify your email to continue your product download
We've sent a verification code to:
  • Incorrect verification code. Please try again.
An email with a verification code was just sent to
Didn't receive the code? Click to resend in sec
Didn't receive the code? Click to resend
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

error icon

Oops! Something went wrong.

Please, try again later.