Reference Guide › Command-Line Scripting › CA VMware vCenter Server CLI Commands › dpmvc faulttolerance Command--Specify Fault Tolerant Operations

dpmvc faulttolerance Command--Specify Fault Tolerant Operations

The dpmvc faulttolerance command turns on, turns off, enables, disables, tests fault tolerance, or migrates the secondary VM.

This command has the following format:

dpmvc faulttolerance {-turn_on|-turn_off|-enable|-disable|-test_ft|-migrate_secondary }
[-datacenter_name datacentername]
-vm_name vmname
[-esx_host_name esxhostname]
-vc_server vcservername
[-sc sc_url]
[-wait timeout]
[-pre]
[-post]
[-locale iso639value]

-turn_on

Turns on fault tolerance for the specified VM.

(Optional) Specifies the ESX host name of the secondary VM.

-turn_off

Turns off fault tolerance for the specified VM.

Note: This operation deletes the secondary VM.

-enable

Enables fault tolerance for the specified VM.

-disable

Disables fault tolerance for the specified VM.

-test_ft

Tests fault tolerance on the specified VM.

-migrate_secondary

Migrates the fault tolerance secondary VM to another ESX server. The -esx_host_name option is required.

-vm_name vmname

Specifies the VM.

-datacenter_name datacentername

(Optional) Specifies the data center where the VM is located.

-esx_host_name esxhostname

(Optional) Specifies the VMware ESX server where the VM resides.

-vc_server vcservername

Specifies the vCenter Server to access when you have multiple vCenter Servers. Optional for single vCenter Server environments.

-sc sc_url

(Optional) Defines the URL for the service controller host.

Example: https://hostname:port/...

hostname

Defines the fully qualified host where the service controller is installed.

Example: localhost.ca.com

port

Defines the listening port for the service controller server.

Example: 80

-wait timeout

(Optional) Indicates whether to display the status of the job and not return until the operation completes, fails, or the timeout period is met (if you specify a timeout value). If you do not specify this option, the CLI returns without waiting for completion. If there is no response, the optional timeout value defines the timeout period in minutes. If you enter the wait option with no timeout value, the CLI uses the default wait time from the caimgconf.cfg file or defaults to 120 minutes. In addition to any positive integer, the following timeout values are also possible:

""

No timeout value.

0

Wait indefinitely.

-pre

(Optional) Specifies whether to generate an event before the operation is performed.

-post

(Optional) Specifies whether to generate an event after the operation is performed.

-locale iso639value

(Optional) Specifies an IS0 639_3166 combination to override the default English output, for example, fr_FR for French. To use the locale of the command prompt, specify "native".