You can use the VSA V1 to V2 Migration workflow to migrate virtualization clients, subclients, backup sets, and tenant virtualization clients from Indexing Version 1 to the latest version of indexing.
Important Considerations
-
When you perform the migration to the latest version of indexing, you must select virtualization clients from one company at a time.
-
You cannot schedule this workflow to run at a user-defined time. The job will fail.
-
If 2FA multi factor authentication is enabled, the VSA V1 to V2 Migration workflow fails. To avoid this problem, before migrating, disable 2FA multi factor authentication, and then run the workflow. After the migration completes, re-enable 2FA multi factor authentication.
-
If horizontally scaled deduplication is used within the storage pool, migrating to the latest version of indexing can cause data blocks to be rebaselined on storage.
-
After the migration completes, de-configure the VSA Indexing Version 1 client and do not re-enable it. De-configuring the client allows data aging to occur based on the days based retention option as described in Advanced - Data Aging and Deconfigured Clients.
When to Use the VSA V1 to V2 Migration Workflow
The latest version of indexing is enabled by default when you create a new virtualization client in a new Commvault installation. However, if you have existing virtualization clients in your CommCell environment that were installed before Service Pack 15, and you are upgrading them to a more recent feature release, then you can use the VSA V1 to V2 Migration workflow to migrate the virtualization clients to the latest version of indexing. However, you must manually download the workflow from the Commvault Store because it not installed by default.
For the latest version of indexing, you must have admin privilege when executing the workflow. For information, see Workflow Security.
Supported virtualization clients
You can use the VSA V1 to V2 Migration workflow for the following virtualization clients:
-
Amazon EC2
-
Azure
-
Azure Stack Hub
-
Hyper-V
-
Nutanix AHV
-
Openstack
-
VMware (and vCloud)
Workflow Process
The workflow performs the following actions:
-
For clients with multiple agents, migrates only the VSA instance.
-
Updates the VSA Indexing Version 1 virtualization clients and subclients, adding a _V1 suffix to them. (New VSA client names and subclient names will be the same as the original names.)
-
Clones all backup sets and subclients under the VSA Indexing Version 1 client and migrates them to the latest version of indexing.
-
Copies all properties configured on the VSA, the backup set, and the subclient.
-
After the migration completes, disables backup activity on the Indexing Version 1 client at the VSA level.
-
Sends an email to the administrator (and any others who are specified in the workflow) that indicates whether the workflow completed successfully or failed.
-
After the migration completes, the first backup job that you run on the migrated client is a full backup.
What Is Not Migrated
The following items are not included in the migration process:
-
Clients that have multiple virtual server instances (V9-style clients).
-
For clients with multiple agents, only the VSA instance is migrated.