26/02/2025, 15:31 VxRail Cluster Migration User’s Guide

VxRail Cluster Migration User’s Guide

Dell, EMC, VxRail, VMware, Cluster, Migration, Guide

Dell Technologies

Browser built in viewer

PDF Viewer
Universal Document Viewer
Google Docs View
Google Drive View
Download Document [pdf]Not Your Device? Search For Manuals / Datasheets:

File Info : application/pdf, 21 Pages, 766.00KB

Document

d35825a6b5d6e96986c6d4b6a43a5656d…

Error
Failed to load PDF document.
Reload

Lenovo ThinkCentre Neo 50a AIO, Compact 23.8 (60.45cms) entry-level all-in-one PC for small-to- Get 7%
Business
H18396 Dell EMC VxRail Desktop
4.7.x (24",
Cluster 8GB RAM/
Migration mid-sized business Powered by superfast up to 13th Gen Intel
Users Guide Cashback Up
Core processors Modularly designed for display sharing & To ₹10,000
512GB SSD, Intel Core i3),… wireless device charging (optional) AI-assisted smart meeting… Lenovo India
-34%

https://manuals.plus/m/d35825a6b5d6e96986c6d4b6a43a5656da558197a9e49030782a86278dea7e98 1/8
26/02/2025, 15:31 VxRail Cluster Migration User’s Guide
User's Guide
Dell EMC VxRail 4.7.x Cluster Migration User's Guide
Abstract
VxRail Cluster Migration enables users to migrate a VxRail cluster from the source VC to the designate

Revision history

Date December 2019 June 2020

Description Initial release Updated to include precheck, DVS, and port groups in versions 4.7.510 and

The information in this publication is provided "as is." Dell Inc. makes no representations or warrant
Use, copying, and distribution of any software that is described in this publication requires an appli
Copyright © 2020 Dell Inc. or its subsidiaries. All Rights Reserved. Dell, EMC, Dell EMC, and other tr

VxRail Cluster Migration User's Guide

Table of contents
1 About VxRail Cluster Migration .............................................................. 4 2 Sc
2.1 Supported scenarios...............................................................................
3 Validations.........................................................................................
3.1 Risks ............................................................................................
4 Requirements .......................................................................................
4.1 Operating system and .NET framework ..............................................................
5 Usage ..............................................................................................
5.1 Standard clusters.................................................................................
6 Error handling......................................................................................
6.1 Retry ............................................................................................
7 Troubleshooting ...................................................................................
8.1 Log file .........................................................................................

VxRail Cluster Migration User's Guide

1 About VxRail Cluster Migration

VxRail Cluster Migration is a script-driven feature designed to help you automate the cluster migratio
1.1 Nomenclature
Source vCenter Server -The vCenter Server that is currently managing the VxRail Cluster. It can be eit
Target vCenter Server -The vCenter Server that will manage the VxRail Cluster going forward. It must b

VxRail Cluster Migration User's Guide

2 Scope
· This script must be run on a machine that can access vCenter and VxRail Manager. · This script only

2.1

Supported scenarios
· Standard VxRail cluster · Stretched VxRail cluster -A specific deployment of VxRail cluster that ext
across two sites. See VMWare document https://docs.vmware.com/en/VMwarevSphere/6.7/com.vmware.vsphere.

Note: If the activated internal SRS version is 3.42 or 3.44, you must shut down this VM before migrati
· Switch Automation-enabled VxRail cluster -If a VxRail cluster is deployed with a Dell TOR switch, th
· Mixed VxRail cluster -The cluster is deployed with different appliance models, such as G410, E560, P

https://manuals.plus/m/d35825a6b5d6e96986c6d4b6a43a5656da558197a9e49030782a86278dea7e98 2/8
26/02/2025, 15:31 VxRail Cluster Migration User’s Guide
2.2 Unsupported scenarios
Migration is not supported if any of the following scenarios apply to your environment.
· Any kind of external storage devices are attached, including but not limited to the following: - NFS
· Active Directory is enabled on any of the hosts. · vSAN encryption is enabled in the cluster. · The
cluster. · Either source vCenter server or target vCenter server is Windows-based. · Either source vCe
VC HA refers to the High Availability configuration for the VMs of the source/target VC.

VxRail Cluster Migration User's Guide

3 Validations
The script will terminate if any of the following validations fail.
1. All the input parameters (IP, hostname, account etc.) are correct. If any of these parameters are i
2. Deployment environment is supported. None of the items described in the Unsupported Scenarios secti
3. The version of the target VC is not earlier than the source VC. 4. The vSAN health state of the VxR
- Cluster name - DVS name - Custom vSAN Storage Policy name 9. The external DNS server is valid. If th
between source/target VC and the NTP server cannot be longer than 5 minutes. - If the NTP server on th
between the source VC and the target VC cannot be longer than 5 minutes. 11. Migration might cause I/O
migration. Allow for downtime before attempting the migration.
Note: There is a known issue involving virtual machine network loss. Virtual machine network connectio
Source vCenter Server to the Target vCenter Server. Make sure the VxRail vSAN license key is at hand b

3.1

Risks
Do not perform the migration if vSAN resync or vMotion is active on the cluster. Wait until these task

3.1.1 Possible impacts

Acknowledge these possible impacts before performing the migration.

VxRail Cluster Migration User's Guide

1. If the original cluster is Log Insight enabled, after migration, the source VC/PSC and the target V
2. The VMs of the internal VC/PSC still exist after migration, even though they are not in use. 3. Cus
be migrated. They will need to be reinstalled and reconfigured. 4. VxRail value-added APP downloaded a
migrated. Any value-added APP or 3rd party tools registered with VxRail vCenter Server, such as Recove
- Resource pool(s) - vAPPs - Permissions/Roles/Users - VM/Host Groups and rules. - Host profiles - Hos
Custom vSAN storage policies will be migrated if there is no conflict. See the Usage section for more

VxRail Cluster Migration User's Guide

4 Requirements

4.1

Operating system and .NET framework

This script supports Windows systems with .NET Framework. Other operating systems are not supported at

Operating System
Windows 10 Windows Server 2012 Windows 7 & Server 2008

.NET Framework
4.7 4.7 4.6

Run Cluster Migration Script

https://manuals.plus/m/d35825a6b5d6e96986c6d4b6a43a5656da558197a9e49030782a86278dea7e98 3/8
26/02/2025, 15:31 VxRail Cluster Migration User’s Guide
Success Success Success

4.2 PowerShell 5.1

1. Run $PSVersionTable to check PowerShell version.

If you are running a PS version earlier than 5.1, see https://docs.microsoft.com/enus/powershell/scrip

4.3 PowerShell environment configuration
1. Change Execution Policy to RemoteSigned Launch a PowerShell console as administrator, run the follo
And verify the change with:
Get-ExecutionPolicy

VxRail Cluster Migration User's Guide

2. Restart PowerShell After these environment configurations are done, restart PowerShell (also as adm

4.4

Posh-SSH
1. Install the Posh-SSH module for PowerShell. The minimum version is 2.1. Launch a PowerShell console

Install-Module -Name Posh-SSH

Verify the installation with:

Get-Module -ListAvailable -Name Posh-SSH

VxRail Cluster Migration User's Guide

5 Usage
To use this script, open a PowerShell console as administrator, go to the directory of this script, ru
There are four workflows in total to be performed sequentially, and each has different functionalities
1. ClusterMigrationScan - Environment precheck - Input parameter validation.
2. ClusterMigrationEnvPrepare - Backup necessary configs on source VC, and recreate/import them on tar
3. ClusterMigrationExec - Remove hosts from source VC - Add hosts to target VC - Reconfigure necessary
4. ClusterMigrationWrapup - Update config files and DB in VxRail Manager VM - Restore configs changed
Each workflow will return a RequestId and display on the console. You can use the requestId to monitor
The workflows are performed in a fixed order, they cannot be skipped or reversed. If any workflow fail
5.1 Standard clusters
5.1.1 Syntax
.\vxrail-cluster-migration.ps1 -VxMIP <string> -VxMRootPassword <string> -VxMMysticPassword <string> -
Note: Highlighted section is available in VxRail 4.7.510 and later. Parameters

10

VxRail Cluster Migration User's Guide

-VxMIP Required. Specify the VxRail Manager IPv4 address.

-VxMRootPassword Required. Specify the VxRail Manager root account password.
-VxMMysticPassword Required. Specify the VxRail Manager mystic account password. Note that this is dif
-SourceVCAdminAccount Required. Specify username and password for source VC admin account.
-TargetVCAdminAccount Required. Specify username and password for target VC admin account.
-TargetVCManagementAccount Required. Specify username and password for target VC management account.
-TargetPSCManagementAccount Required. Specify username and password for target PSC management account.
-TargetVCHostname Required. Specify the host name of target VC.
-TargetVCIp Required. Specify the IP address of target VC.
-TargetPSCHostname Required. Specify the host name of target PSC.

https://manuals.plus/m/d35825a6b5d6e96986c6d4b6a43a5656da558197a9e49030782a86278dea7e98 4/8
26/02/2025, 15:31 VxRail Cluster Migration User’s Guide
-TargetPSCIp Required. Specify the IP address of target PSC.
-DatacenterName Required. Specify the name of the datacenter that you plan to migrate to on target VC.
-VxMName Required. Specify the VM name of the VxRail Manager of current cluster.
-SSOTenant Required. Specify the SSO tenant on target VC.
-EsxiRootAccount Required. Specify the root accounts for all the ESXi hosts.
-ReuseCustomPolicy Optional. Specify that the existing custom storage policies created on target VC sh
-RequestId Optional. Specify the request Id for a certain workflow.
-Action Optional. Specify whether to retry or dismiss the operation with provided request Id.
-NoPrompt Optional. Turns off the warning message prompt. This parameter is reserved for automation sc
Note: The following additional parameters are available in VxRail 4.7.510 and later.
-NewDvsName Optional. Modifies the name of Distributed Switch at ClusterMigrationScan when DVS name is
-PortGroups

11

VxRail Cluster Migration User's Guide

Optional. Modifies the name of Port Groups Switch at ClusterMigrationScan when the names of some port
5.1.2 Examples
5.1.2.1 Run a precheck (Vxrail 4.7.510 and later)
Only perform precheck to see if the cluster is ready for migration.
.\vxrail-cluster-migration.ps1 -VxMIP "10.10.10.10" -VxMRootPassword "Password!" -VxMMysticPassword "P
5.1.2.2 Modify DVS or Port Groups during the migration (Vxrail 4.7.510 and later)
If the names of DVS or Port Groups are conflicted in target VC, modify them by specifying -NewDvsName
.\vxrail-cluster-migration.ps1 -VxMIP "10.10.10.10" -VxMRootPassword "Password!" -VxMMysticPassword "P

12

VxRail Cluster Migration User's Guide

5.1.2.3 Run Migration

Run the command in PowerShell console to see if the cluster is ready for migration. It will show the p
.\vxrail-cluster-migration.ps1 -VxMIP "10.10.10.10" -VxMRootPassword "Password!" -VxMMysticPassword "P

Note: If -NoPrompt is NOT specified, warning messages will display. You must read these messages, and

5.2

Stretched clusters
For 2-Node clusters and stretched clusters, the following parameters are needed in addition the ones f

13

VxRail Cluster Migration User's Guide

5.2.1 Syntax
.\vxrail-cluster-migration.ps1 -VxMIP <string> -VxMRootPassword <string> -VxMMysticPassword <string> -
Note: Highlighted section is available in VxRail 4.7.510 and later.
5.2.2 Parameters
-VxMIP Required. Specify the VxRail Manager IPv4 address.
-VxMRootPassword Required. Specify the VxRail Manager root account password.
-VxMMysticPassword Required. Specify the VxRail Manager mystic account password. Note that this is dif
-SourceVCAdminAccount Required. Specify username and password for source VC admin account.
-TargetVCAdminAccount Required. Specify username and password for target VC admin account.
-TargetVCManagementAccount Required. Specify username and password for target VC management account.
-TargetPSCManagementAccount Required. Specify username and password for target VC management account.
-TargetVCHostname Required. Specify the host name of target VC.
-TargetVCIp Required. Specify the IP address of target VC.
-TargetPSCHostname Required. Specify the host name of target PSC.
-TargetPSCIp Required. Specify the IP address of target PSC.

https://manuals.plus/m/d35825a6b5d6e96986c6d4b6a43a5656da558197a9e49030782a86278dea7e98 5/8
26/02/2025, 15:31 VxRail Cluster Migration User’s Guide
-DatacenterName Required. Specify the datacenter name on target VC.
-VxMName Required. Specify the VM name of the VxRail Manager of current cluster.
-SSOTenant Required. Specify the SSO tenant on target VC.
-EsxiRootAccount Required. Specify the root accounts for all the ESXi hosts.

14

VxRail Cluster Migration User's Guide

-WitnessHostname Required. Specify the witness host name for the stretched cluster.
-WitnessIP Required. Specify the IP address of the witness host.
-WitnessAccount Required. Specify the root account for the witness host.
-Stretched Required. Specify the cluster is a stretched cluster.
ReuseCustomPolicy Optional. Specify that the existing custom storage policies created on target VC sho
-RequestId Optional. Specify the request Id for the certain workflow.
-Action Optional. Specify either to retry or dismiss regarding the operation with provided request Id.
-NoPrompt Optional. Specify if the warning message prompt should be turned off.
Note: The following additional parameters are available in VxRail 4.7.510 and later.
-NewDvsName Optional. Specify a new name of the Distributed Switch if need to modify the name of Distr
-PortGroups Optional. Modifies the name of Port Groups Switch at ClusterMigrationScan. When the parame
-Precheck Optional. Specify to perform a precheck "ClusterMigrationScan" to see if the cluster is read
5.2.3 Examples
5.2.3.1 Run a precheck (Vxrail 4.7.510 and later)
Only perform precheck to see if the cluster is ready for migration.
.\vxrail-cluster-migration.ps1 -VxMIP "10.10.10.10" -VxMRootPassword "Password!" -VxMMysticPassword "P

15

VxRail Cluster Migration User's Guide

"dell13g-03.externalvc.com"=@{"username"="root";"password"="Esxpassword!"}} -WitnessHostname 10.10.200

5.2.3.2 Modify DVS or Port Groups during the migration (Vxrail 4.7.510 and later)
If the names of DVS or Port Groups are conflicted in target VC, modify them by specifying -NewDvsName
.\vxrail-cluster-migration.ps1 -VxMIP "10.10.10.10" -VxMRootPassword "Password!" -VxMMysticPassword "P
5.2.3.3 Run Migration
Run the command in PowerShell console, it will show the progress and a status message. .\vxrail-cluste
-VxMRootPassword "Password!" -VxMMysticPassword "Password!" -SourceVCAdminAccount @{username="administ
"dell13g-02.externalvc.com"=@{"username"="root";"password"="Esxpassword!"}; "dell13g-03.externalvc.com

16

VxRail Cluster Migration User's Guide

Notes: Witness host name, witness IP and witness account are required. Also, -Stretched indicator is
5.3 Monitoring
Specify the request Id and watch the progress for this operation.
5.3.1 Example
.\vxrail-cluster-migration.ps1 -VxMIP "10.10.10.10" -VxMRootPassword "Password!" -VxMMysticPassword "P
Notes: The monitor operation does not require -Action parameter. It will query VxRail Manager for the

17

VxRail Cluster Migration User's Guide

6 Error handling
Errors or failure might occur during the migration process. Refer to the KB article https://support.em
Following is an example of an error.

Each workflow has different ways to report and handle errors. The following table below shows the diff

https://manuals.plus/m/d35825a6b5d6e96986c6d4b6a43a5656da558197a9e49030782a86278dea7e98 6/8
26/02/2025, 15:31 VxRail Cluster Migration User’s Guide
Report failure Abandon when failure Retry after failure Restart after failure

Scan Report after all steps complete Automatically abandoned Unsupported Supported

EnvPrepare | Exec | Wrapup Report immediately Not abandoned Supported Unsupported

If ClusterMigrationScan fails, you will not be able to retry with given request Id. Instead, you must
If ClusterMigrationEnvPrepare, ClusterMigrationExec, or ClusterMigrationWrapup fails, you will not be
6.1 Retry
To retry a failed request, specify the given requestId and invoke the -Action Retry parameter. This ac

18

VxRail Cluster Migration User's Guide

6.1.1 Example
.\vxrail-cluster-migration.ps1 -VxMIP "10.10.10.10" -VxMRootPassword "Password!" -VxMMysticPassword "P
Note: ClusterMigrationScan does not support retry. It will automatically be abandoned regardless of wh

19

VxRail Cluster Migration User's Guide

7 Troubleshooting
When an error occurs, an error message and the corresponding KB article link will display on the scree

20

VxRail Cluster Migration User's Guide

8 Logging
Logging functionality is implemented such that you can verify the success and failure after automated

8.1

Log file
In the same directory as vxrail-cluster-migration.ps1, a log file is created with the following naming

ClusterMigration-<VxMIP>-YYYY-mm-dd.log

For example, ClusterMigration-10.10.10.10-2019-08-21.log. ClusterMigration- is the log prefix, 10.10.1

8.2 Log content

Each log record has these components:
Timestamp LogLevel [InvocationFunction] - Log Message
For example, the following log record shows an event regarding ClusterMigrationScan.
2019-08-20T11:26:27.8239566+08:00 INFO [Call-ClusterMigrationAPI] - ClusterMigrationScan Triggered wit
Log Level is usually INFO. When exceptions occur, log level can become ERROR. For example:
2019-08-20T11:27:33.4868576+08:00 ERROR [ClusterMigrationScan] - Invoke-RestMethod - { "DvsNameConflic
conflicting with existing ones in target VC 10.62.81.113." }

Learn more about

Contact a Dell Technologies Expert

21

VxRail Cluster Migration User's Guide

View more resources

https://manuals.plus/m/d35825a6b5d6e96986c6d4b6a43a5656da558197a9e49030782a86278dea7e98 7/8
26/02/2025, 15:31 VxRail Cluster Migration User’s Guide

Join the conversation @DellEMC_

Microsoft Word for Office 365

This site uses Google AdSense ad intent links. AdSense automatically generates these links and they may help creators earn money.

New Galaxy Book4 Pro 16 GB/512 GB 2024|Samsung Galaxy Book4 Series Laptop|U5 Processor|Windows 11 Hom

₹151,789

https://manuals.plus/m/d35825a6b5d6e96986c6d4b6a43a5656da558197a9e49030782a86278dea7e98 8/8