Mount

Edit online

Use the mount command to complete various IBM Storage Protect 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, the IBM Storage Protect recovery agent must be running. Use the set_connection command to connect a RecoveryAgentShell.exe to the mount application.

Snapshots are mounted or unmounted on the system where the IBM Storage Protect recovery agent is running.

Syntax for mounting a disk

Read syntax diagramSkip visual syntax diagramRecoveryAgentShell.exe -cmountadd -rep "tsm: ip= IP host_name port=portNumbernode=nodeName-as_node=nodeNamepass=NodePassword" -vmnamevmname-typedisk-disk disk_number datedate_format-target "ISCSI:target=target_nameinitiator=initiator_name"

Syntax for mounting partition

Read syntax diagramSkip visual syntax diagramRecoveryAgentShell.exe -cmountadd -rep "tsm: ip= IP host_name port=portNumbernode=nodeName-as_node=nodeNamepass=NodePassword" -vmnamevmname-disk disk_numbervhdx datedate_format-type partition-PartitionNumberpartNum -target volume_letter"ISCSI:target=target_nameinitiator=initiator_name"

Command types

add
Use this command type to mount a disk or volume of a snapshot to the system where IBM Storage Protect recovery agent is running.
The following list identifies the tags and parameters for the add command type:
-target
This tag is required. Use this tag to specify the following targets:
  • Virtual volume - only for a partition mount
  • Reparse point - only for a partition mount
  • iSCSI target
-rep
This tag is required. Use it to specify the IBM Storage Protect server that is storing the snapshots, and the IBM Storage Protect node that has access to the 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 IBM Storage Protect 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 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 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).
-disk
This tag is required. Use it to specify the disk number of the source backed up machine to be mounted.
-ExpireProtect
This tag is optional. During a mount operation, the snapshot on the IBM Storage Protect server is locked to prevent it from expiring during the operation. Expiration might occur because another snapshot is added to the mounted snapshot sequence. This value specifies whether to disable expiration protection during the mount operation. You can specify one of the following values:
Yes
Specify Yes to protect the snapshot from expiration. This value is the default. The snapshot on the IBM Storage Protect server is locked and the snapshot is protected from expiration during the mount operation.
No
Specify No to disable expiration protection. The snapshot on the IBM Storage Protect server is not locked and the snapshot is not protected from expiration during the mount operation. As a result, the snapshot might expire during the mount operation. This expiration can produce unexpected results and negatively impact the mount point. For example, the mount point can become unusable or contain errors. However, expiration does not affect the current active copy. The active copy cannot expire during an operation.
When the snapshot is on a target replication server, the snapshot cannot be locked because it is in read-only mode. A lock attempt by the server causes the mount operation to fail. To avoid the lock attempt and prevent such a failure, disable expiration protection by specifying No.
dump
Use this command type to get a list of all the available backups to mount.
The following list identifies the tags and parameters for the dump command type:
-rep
This tag is required. Use this tag to specify the IBM Storage Protect server storing the snapshots, and to specify the IBM Storage Protect node that has access to the 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.
remove
Use this type to remove the connection to the IBM Storage Protect server. A connection cannot be removed when it is in use, such as when mounted volumes exist.
The following list identifies the tag for the remove command type:
  • -rep - This tag is required. Use this tag to specify the IBM Storage Protect server connection to be removed.
view
Use this type to view a list of all mounted snapshots. This type has no tags.

Example commands

The following examples use the -target tag:
  • 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\\"
  • In the following example an iSCSI target is specified:
    -target "ISCSI: target=<target_name> initiator=<initiator_name>"
In this example, a snapshot of virtual machine named VM-03ent is located on the IBM Storage Protect server with IP 10.10.10.01. Disk number 1 of this snapshot is mounted to the system where the IBM Storage Protect recovery agent is running. The following command 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 "2014-Jan-21 10:46:57 AM -ExpireProtect=Yes"
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 virtual machine.
    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>]
In the following example, remove the connection to the IBM Storage Protect server (10.10.10.01) using node NodeName: 
mount remove -rep "tsm: NodeName@ip"
The following example uses the view type: 
mount view
Related links for mounting a Hyper-V snapshot