IBM Tivoli Storage FlashCopy Manager for VMware, Version 4.1

VMCLI detach

You can use this command to detach all attached virtual disks in a virtual machine or a backup from the ESX host. The disks were attached to the ESX host with the attach command.

Syntax

The vmcli -f detach command uses the following syntax:


vmcli command

>>-vmcli------ -f detach------+-----------------+--------------->
                              '- -t--backupType-'   

>--+------------------------+--+---------------------------+---><
   '- -B--backupID--+-----+-'  '- -I--detachObjectListFile-'   
                    '- -F-'

Parameters

-t backupType

FCM: Specifies that the detach operation is run for Tivoli® Storage FlashCopy® Manager for VMware backups.

-B backupID

The ID of the backup to be detached.

-F

This parameter forces a detach operation even if the corresponding backup task is still running, or if a backup is not completed.

-I detachObjectListFile

Specify the file that contains the list of objects to detach. The detachObjectListFile file has the following requirements:

Each line can contain only one identifier and its value, separated by a colon.
Each line needs to contain a vminstanceuuid:instanceuuid statement that specifies which source virtual machine contained in the backup is to be detached. All disks of that source virtual machine that are attached will be detached from the target virtual machine or virtual machines.

An example detachObjectListFile file is provided here:

# Lines starting with # and blank lines will be ignored
#
# Each line need to contain a "vminstanceuuid:<instanceuuid> statement that specifies 
which source VM contained in the backup is to be detached. 
# That means all disks of that source VM that have been attached are detached from 
the according target VM(s).
vminstanceuuid:vm1InstanceUuid
vminstanceuuid:vm2InstanceUuid

Comments are allowed and must be marked with a '#' character at the beginning of the line.

After the detach of a virtual machine is complete, if no other virtual machines in the backup are attached, Tivoli Storage FlashCopy Manager for VMware will automatically unmount the datastores for this backup.

Output

#TASK taskID taskType dateCreated 
#PARAM BACKUP_ID=backupID
#RUN runID runDate 
#LANG country-code (en-US,de-DE)
#PARAM BACKEND=backupType
#PARAM Version: 3.2.0.0 Build: 527
#INFO FMM0005I Start of program at: Tue 30 Aug 2011 11:11:28 PM CEST.
#PARAM BACKUP_ID=backupID
#PHASE_COUNT 1
#PHASE UNMOUNT
#PARAM COPYSERVICES_HARDWARE_TYPE=SVC|XIV|DS8000
#PARAM FLASHCOPYTYPE=COPY|NOCOPY|INCR
 #PHASE PARTITION
#PARAM STATUS=runStatus
#END RUN runID endRunDate
#END TASK taskID
#END

Feedback