Managed Object - DrConfigMigrationManager

Property of: DrConfigServiceInstanceContent
See also: DrConfigConfigurationTask, DrConfigMigrationDataSpec, DrConfigMigrationSpec
Since: DrConfig API 7.0

Managed Object Description

This managed object provides operations to control migration process. Migration process is invoked via the Migrate operation. This operation will connect to the specified endpoints(appliances) in DrConfigMigrationSpec, will export the data via the exportMigrationData() operation and modify the power state of the specified appliances.

Properties

Name	Type	Description
None

Methods

Methods defined in this Managed Object
DrConfigMigrationManager_GetRunningTask, ExportMigrationData, Migrate

DrConfigMigrationManager_GetRunningTask

The currently active retrieve update task or null.

Required Privileges: System.Read

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the DrConfigMigrationManager used to make the method call.

Return Value

Type	Description
ManagedObjectReference to a DrConfigConfigurationTask

Faults

Type	Description
vmodl.RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

ExportMigrationData

Export data from the appliance.

Required Privileges: DrConfig.Admin

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the DrConfigMigrationManager used to make the method call.

exportSpec P

DrConfigMigrationDataSpec

MigrationDataSpec containing information about what data to be exported.

Since DrConfig API 7.0

P Required privilege: exportSpec

Return Value

Type	Description
ManagedObjectReference to a DrConfigConfigurationTask	ConfigurationTask Task that will contain a result of type MigrationDataInfo.

Faults

Type	Description
vmodl.RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
vmodl.fault.InvalidArgument	Thrown if invalid data component is specified in the MigrationDataSpec;
vmodl.fault.SystemError	General error.
DrConfigFaultExportFault	Fails when a data component cannot be exported.
DrConfigFaultServiceBusy	Thrown if there is already running migration task.

Events

Type
None

Migrate

Migrate external appliance data into this appliance.

Required Privileges: DrConfig.Admin

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the DrConfigMigrationManager used to make the method call.
migrationSpec* P	DrConfigMigrationSpec[]	An array of DrConfigMigrationSpec containing information about one or more appliances from which we want to export data and migrate into one appliance. Can be used to migrate Site Recovery Manager appliance and vSphere Replication appliance into one appliance when Combined appliance is available. *Since* DrConfig API 7.0
adminUser* P	xsd:string	The name of a user with sufficient privileges to perform configuration tasks on the infrastructure and management nodes as well as SSO service configuration tasks on the infrastructure node. If the adminUser is empty or null reconfiguration won't be triggered. This means no network operations will be done after the data is migrated. And the reconfiguration must be triggered manually. Reconfiguration can be triggered via configureSrm operation in DrConfigConfigurationManager managed object *Since* DrConfig API 7.0
adminPass* P	xsd:string	Password for the adminUser *Since* DrConfig API 7.0

*Need not be set PRequired privilege - see tooltip for details

Return Value

Type	Description
ManagedObjectReference to a DrConfigConfigurationTask	ConfigurationTask Task that will contain the result of the operation. No result type is expected. This task will indicate the success or the failure of the migration operation. If reconfiguration is triggered the result type of this operation will be the ConfigurationTask result of the configureSrm operation

Faults

Type	Description
vmodl.RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.
vmodl.fault.InvalidArgument	Thrown if some of the arguments are invalid.
vmodl.fault.SystemError	General error.
DrConfigFaultDownloadFault	Fails when migration data component cannot be collected.
DrConfigFaultExportFault	Fails when a data component cannot be exported.
DrConfigFaultImportFault	Fails when a data component cannot be imported.
DrConfigFaultServiceBusy	Thrown if there is already running migration task.

Events

Type
None