by Uddave Jajoo, Indianapolis CUGC Leader
Remove Machines from Old Catalog
- Identify the pool of machines to migrate from one cluster to another.
- In the Studio console, navigate to the delivery group tab and select the respective delivery group, right click, and select Edit Delivery group.
- Export the list of desktop assignment from delivery group before removing the machines from the catalog and save it locally on the Delivery controller. (Will be utilized in next section.)
- In Studio console, navigate to machine catalog and right click on the catalog, select View Machines.
- Turn the maintenance mode on those machines from within Studio console.

- Remove the machines form the delivery group and leave the assigned users intact.

- Right click on the machines, select Delete and Select the option “Remove the machines from catalog but do not delete the virtual machines.”

- Click Next, then Finish.

- Right click on the machine catalog and select manage AD Accounts and select the machine account and click remove. In the wizard, select the option to leave them in active directory.

vMotion Machines from one cluster to another
- Navigate to vCenter console, select the OldCluster and navigate to VMs tab.
- Select all the required virtual machines which we need to migrate. Note: All machines should be powered off, so that you can migrate easily across cluster.
- Right click on the selected virtual machines and select Migrate. When prompted, select Yes and proceed further.

- In the next window, select the Compute and Storage migration option, click Next and select the NewCluster, click Next.


- In the next window, select Storage based on the least utilized and click Next.

- In the next window, change the networks to the distributed vSwitch for the corresponding VLAN.
Example– Source Network :- OLDVLAN need to change to Destination Network – NEWVLAN

- Select vMotion with higher priority and click Next.

- In the next window, review the selections and select Finish.
Create New Standalone machine catalog in the Studio Console
Note: For the machines that need to be migrated, make sure to Edit one of the VM config parameters in vSphere as below:
XdConfig XdProvisioned=false

- Create New Machine catalog, Click Next.
- In operating System, select Single Session OS and click Next.

- In Machine management select the option as below: “Machines that are power Managed” and “Another Service or technology.”

- In the Desktop Experience select the option, “I want users to connect to the same(static) Desktop each time they log on.”

- In the next window, select the minimum functional level as 1811 or newer if the VDA agent is 1912 or higher.

- Modify the exported list to include the parameter [VirtualMachinePath] within the csv file.
- Add the value against [VirtualMachinePath] header as below:
- [VirtualMachinePath],[ADComputerAccount],[AssignedUsers]
- XDHyp:\Connections\HostingConnectionName\DataCenterName.datacenter\ClusterName.cluster\MachineName.vm,Domain\MachineName,Domain\UserName

- Click on Import List and point to the location of exported list saved in the Section1-Step3.
- Select the CSV file containing VirtualMachinePath, ADComputerAccount and AssignedUsers.

- The machine name will show up along with the user assigned to the machine.

- Click Next and in the Scopes leave default and click Next.
- Enter the machine catalog name and description.

- Click Finish. Wait for the catalog to be created and it should contain the machine added during the catalog creation process.
Add New machine catalog to the existing Delivery group
- Right click on the new machine catalog, select View machines.

- Execute start operation on the machine from Studio, by right click on the machine. Select Yes when prompted.

- Verify in vCenter console that machine got powered on and gets registered in the Studio console.
- Navigate to vCenter and power on the migrated machines.
- In the studio console, verify that machines shows up as registered.
- Turn off the MM Mode on the machine.
- Navigate to the delivery groups tab and select the respective delivery group, Right click on the DG and select “Add Machines.”

- The newly created catalog will show up in the wizard and click Next.

- In the next window, it will show the machine which is being added to the delivery group along with the AssignedUserIDs. Select Next.

- In the summary tab, review the selection and click Finish.
Note: Published Name property of Desktop needs to be updated for machines/VDIs added to new Delivery group. Use below command, execute in PowerShell on Delivery Controller.
Desktop Name – MachineName%
$Desktops= Get-BrokerPrivateDesktop -MaxRecordCount 300 -Filter {DNSName -like “MachineName*”}
Foreach ($Desktop in $Desktops) {Set-BrokerPrivateDesktop -MachineName $Desktop.MachineName -PublishedName “DesktopName“}
