IBM Tivoli Storage Manager for Virtual Environments, Version 7.1

Mount command

Use the mount command to complete various Data Protection for VMware Recovery Agent tasks.

The Recovery Agent CLI can be used to mount (mount add) and unmount (mount del) volumes and disks, and to view a list of mounted volumes (mount view).To use the mount command, Data Protection for VMware Recovery Agent must be running. Use the set_connection command to connect a TDPVMwareShell.exe to the mount application.

Snapshots are mounted or unmounted on the system where Data Protection for VMware Recovery Agent is running.

The mount command is supported in command mode. The following command types are available. The appropriate tags and parameters are listed alongside each command type.
add
Use this command type to mount a disk or volume of a snapshot to the system where Data Protection for VMware Recovery Agent is running. The following list identifies the tags and parameters for the add type:
  • -target - This tag is required.
    Use this tag to specify the following targets:
    • Windows operating systems Windows operating systems Virtual volume - only for a partition mount
    • Windows operating systems Windows operating systems Reparse point - only for a partition mount
    • Windows operating systems Linux operating systems Windows operating systems Linux operating systems iSCSI target
    The following examples use the -target tag:
    • Windows operating systems Windows operating systems In the following example V: is the virtual volume mount target:
      -target "V:"
    • In the following example a reparse point volume mount target is specified:
      -target "C:\SNOWBIRD@FASTBACK\SnowbirtK\Snowbird\K\\"
    • Windows operating systems Linux operating systems Windows operating systems Linux operating systems In the following example an iSCSI target is specified:
      -target "ISCSI: target=<target_name> initiator=<initiator_name>"
  • -rep - This tag is required.
    Use it to specify the Tivoli® Storage Manager server that is storing the VMware snapshots, and the Tivoli Storage Manager node that has access to the VMware backups. For example:
    tsm: ip=<ip/host_name> port=<port_number>
     node=<node_name> pass=<node_password> 
    You can also specify the as_node and from_node options. If the password field is empty, the Data Protection for VMware Recovery Agent attempts to use the password for the stored node.
  • -type - This tag is required. Use it to specify that you want to mount a disk or a partition. The options are:
    • -type disk
    • -type partition
  • -VMname - This tag is required. Use it to specify the VMware machine name that is source of the snapshot. The specified value is case-sensitive.
  • -disk - This tag is required. Use it to specify the disk number of the source backed up VMware machine to be mounted.
  • -date - This tag is required. Use it to specify the date of the snapshot that you want to mount. The date format is yyyy-Mmm-dd hh:mm:ss. For example:
    -date "2013-Apr-12 22:42:52 AM"
    To view the active (or latest) snapshot, specify last snapshot.
  • -PartitionNumber - This tag is optional. If the -type is partition, enter the partition number to mount.
  • -ro|-fw - Use this tag to specify whether the mounted volume is read-only (-ro) or fake-write (-fw).
The following example shows how to specify the add type to mount a disk:
mount add -rep "tsm: ip=10.10.10.01 port=1500 node=tsm-ba pass=password"
-target "iscsi: target=test1 initiator=initiator_name" -type disk 
-vmname VM-03ENT -disk 1 -date "2013-Jan-21 10:46:57 AM"
In this example, a snapshot of VMware named VM-03ent is located on a Tivoli Storage Manager server with IP 10.10.10.01. Disk number 1 of this snapshot is mounted to the system where Data Protection for VMware Recovery Agent is running.
del
Use this command type to dismount one or all mounted backups from the system where Data Protection for VMware Recovery Agent is running. The following list identifies the tags and parameters for the del type:
  • -target - This tag is required. Use this tag to specify the target for dismounting. The target for dismounting can be a virtual volume, reparse point, or iSCSI target created using the mount command. Use the everything variable to dismount all mounted backups.
  • -force - Use this tag to force an unmount. The default option is not to force an unmount if the target is currently in use.
For example, to force an unmount of a snapshot that is currently mounted at the directory, c:\gever, use the following command:
mount del -target "c:\gever" -force
To dismount a snapshot currently mounted as volume V:, use the following command:
mount del -target V:
To dismount a snapshot currently mounted as an iSCSI target, use the following command:
mount del -target "ISCSI:<target_name>"
dump
Use this command type to get a list of all the available backups to mount.
  • -rep - This tag is required. Use this tag to specify the Tivoli Storage Manager server storing the VMware snapshots, and to specify the Tivoli Storage Manager node that has access to the VMware backups. For example:
    tsm: ip=<IP/host name> port=<PortNumber>
    node=<NodeName> pass=<NodePassword>
  • -file - This tag is optional. Use this tag to identify a file name to store the dump text. If this tag is not specified, the dump text is printed only to stdout.
The following examples show how to specify the dump type:
  • List all the available backed up VMs.
    mount dump –type TSM –for TSMVE -rep P -request 
    ListVM [–file <FileNameAndPath>]
  • List all the available disk snapshots of a VMware.
    mount dump –type TSM –for TSMVE -rep P -request 
    ListSnapshots -VMName P [-file <FileNameAndPath>]
  • List all the available partitions of a disk snapshot.
    mount dump –type TSM –for TSMVE -rep P -request 
    ListPartitions -VMName P -disk P -date P [-file <FileNameAndPath>]
remove
Use this type to remove the connection to a Tivoli Storage Manager server. A connection cannot be removed when it is in use, such as when mounted volumes exist. There is only one tag for the remove type:
  • -rep - This tag is required. Use this tag to specify the Tivoli Storage Manager server connection to be removed.
In the following example, remove the connection to a Tivoli Storage Manager server (10.10.10.01) using node NodeName:
mount remove -rep "tsm: NodeName@ip"
view
Use this type to view a list of all mounted snapshots. This type has no tags. The following example uses the view type:
mount view

Mounting a disk

The following syntax diagram is for the command for mounting a disk:
Read syntax diagramSkip visual syntax diagram
>>-TDPVMwareShell.exe -c--mount--add---------------------------->

>-- -rep -"tsm: -ip--=--+-IP -------+--port--=--portNumber------>
                        '-host_name-'                        

>--node--=--nodeName--+------------------------+---------------->
                      '- -as_node--=--nodeName-'   

>--pass--=--NodePassword"-- -vmname--vmname-- -type--disk------->

>-- -disk----disk_number----date--date_format------------------->

>-- -target -"ISCSI:--target--=--target_name--initiator--=--initiator_name"-><

Mounting a partition

The following syntax diagram is for the command for mounting a partition:
Read syntax diagramSkip visual syntax diagram
>>-TDPVMwareShell.exe -c--mount--add-- -rep "tsm:--------------->

>--ip--=--+-IP---------+--port--=--portNumber------------------->
          '- host_name-'                        

>--node--=--nodeName--+------------------------+---------------->
                      '- -as_node--=--nodeName-'   

>--pass--=--NodePassword"-- -vmname--vmname--------------------->

>-- -disk--+-disk_number-+--date--date_format------------------->
           '-vmdk--------'                      

>-- -type partition-- -PartitionNumber--partNum----------------->

>-- -target -+-volume_letter--------------------------------------------------+-><
             '-"ISCSI:--target--=--target_name--initiator--=--initiator_name"-'   



Feedback