IBM Tivoli Storage FlashCopy Manager for VMware, Version 4.1

VMCLI attach

You can use this command to attach a backup on an ESX host to a target virtual machine, to enable a single file or disk restore.

Syntax

The vmcli -f attach command uses the following syntax:

vmcli -f attach  -B backupID [-H esxHost] -I attachObjectListFile

Parameters

-B backupID

Specifies the ID of the backup to be attached.

-H esxHost

Specifies the ESX host where the datastore in the selected backup is attached. If -H parameter is not specified, the value of the AUXILIARY_ESX_HOST profile parameter in the profile is used.

-I attachObjectListFile

Specifies the file that contains the list of disks in the backup to attach to the VM. The attachObjectListFile has the following requirements:

The file contains one VM identifier per line, optionally specifying an alternative target VM.
All the disks in a backup can be attached to an existing VM that is specified after the :: symbol.
If no disks are specified, all the backup disks are attached to the specified VM.
The specified disks in the backup are attached to the target VM and added to the VM configuration.

The following example shows a sample attachObjectListFile:

# vminstanceuuid:sourceVmInstanceUuid[::vminstanceuuid:targetVmInstanceUuid]
# [diskkey:key1,key2,...]

# attach all backed-up virtual disks of vm2InstanceUuid to the (same) 
# source VM
vminstanceuuid:vm2InstanceUuid::vminstanceuuid:vm2InstanceUuid 

# attach all backed-up virtual disks of vm3InstanceUuid to vm4InstanceUuid
vminstanceuuid:vm3InstanceUuid::vminstanceuuid:vm4InstanceUuid 

# attach the disks with the specified keys of vm3InstanceUuid to vm4InstanceUuid
vminstanceuuid:vm3InstanceUuid::vminstanceuuid:vm4InstanceUui diskkey:2000,2001

# register the complete VM vm4InstanceUuid 
vminstanceuuid:vm4InstanceUuid

Output

#TASK taskID attach task create date in format yyyyMMddHHmmssS 
#PARAM OBJECT=vminstanceuuid:vminstanceuuid of a vm 
#PARAM OBJECT=vminstanceuuidvminstanceuuid of a vm#LANG country-code (en-US,de-DE)
#PARAM BACKUP_ID=backupID
#RUN 129 20110830230817768
#LANG en_US#PARAM 
#PARAM BACKEND=FCM
#PARAM Version: 3.2.0.0 Build: 527
#PARAM AUXILIARY_ESX_HOST=esxHost
#PARAM BACKUP_ID=backupID
#PHASE_COUNT 1
#PARAM OBJECT=vminstanceuuid:vminstanceuuid
#PARAM OBJECT=vminstanceuuid:vminstanceuuid
#PHASE MOUNT
#PARAM COPYSERVICES_HARDWARE_TYPE=SVC
#PARAM FLASHCOPYTYPE=INCR
#PARAM DSURLS=oldDsUrl1 newDsUrl1
#CHILD sourcedatacenter:dataCenterName 
#PARENT vmuuid:vmUuid
#CHILD sourceesxhost:esxHostName
#PARENT vmuuid:vmUuid
#CHILD vminstanceuuid:vmInstUuid
#PARENT vmuuid:vmUuid
#CHILD attachedvmname:vmName
#PARENT vmuuid:vmUuid
#CHILD sourcedatacenter:dataCenterName
#PARENT vmuuid:vmUuid
#CHILD sourceesxhost:esxHostName
#PARENT vmuuid:vmUuid
#CHILD vminstanceuuid:5vmInstUuid
#PARENT vmuuid:vmUuid
#CHILD attachedvmname:attachedvmname
#PARENT vmuuid:vmUuid
#PARAM STATUS=runStatus
#END RUN runID endRunDate
#END TASK taskID
#END

Feedback