mount

Use the mount command to complete various FastBack Mount tasks. When you run the mount command, use either a Windows logon ID with Administrator authority, or log on to the Linux system as the root user.

The Administrative Command Line, sometimes called the FastBack Shell, can be used to mount (mount add) and unmount (mount del) volumes, and to view a list of mounted volumes (mount view). Because the mount add command takes so many command tags, a mount dump command is also available. This mount dump command generates FastBack Shell commands for scripting purposes.

To use the mount command, FastBack Mount must be running. The FastBackShell.ini file must contain the name or IP address of the system where FastBack Mount is installed. This information is specified in the HOSTNAMES section. The FastBackShell.ini file is stored in the installation folder for the Administrative Command Line. The default location is C:\Program Files\Tivoli\TSM\FastBack\shell.

Snapshots are mounted or unmounted on the system where FastBack Mount is running. The repository can be shared over the network or attached to a FastBack Server.

The mount command is supported in command and script file modes. 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 snapshot to the system where FastBack Mount 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 only) Virtual volume
- (Windows only) Reparse point
- (Linux only) iSCSI target
The following examples use the -target tag:
- (Windows only) In the following example V: is the virtual volume mount target:
```
-target "V:"
```
- (Windows only) In the following example a reparse point volume mount target is specified:
```
-target "C:\SNOWBIRD@FASTBACK\SnowbirtK\Snowbird\K\\"
```
- (Linux only) In the following example an iSCSI target is specified:
```
-target "ISCSI: target=<target_name> initiator=<initiator_name>"
```
-rep - This tag is required.
Use to specify the local or network share repository. For local repositories, you can specify "hostname@domain" or the full path for repository on folder.
If the repository is on a network share, include the user name, password, and domain for a user, who has access to the network share, in the following format:
```
"<path to network share> user=<username> pass=<password> 
		domain=<domain>"
```
<path to network share> can take the form of "share:\\<hostname>\<repository name>" or "\\<hostname>\<repository name>". The default name for a repository volume is "FB_REP_<drive letter>". The following example uses a network shared repository:
```
-rep "share:\\ftp2-2k3\Share_of_Rep user=administrator pass=12345 
		domain=ABC"
```
The -rep tag can direct to a Tivoli Storage Manager server. For example: -rep 'tsm: ip=<IP address> port=<port> node=<node> as node=<as node> pass=<password> branch=<branch>'
-policy - This tag is required. Use to specify the policy that includes a snapshot that is used in the backup.
-server - This tag is required. Use to specify server name that is the source for the snapshot. The following example uses this tag with a server name:
```
-server "snowbird"
```
You can alternatively use the following parameter: SAN_layout.
-volume - This tag is required. Use to specify the volume that is the source of the snapshot. The following example uses D: as the source volume:
```
-volume "D:\\"
```
-date - This tag is required. Use to specify the date of the snapshot that you want to mount.
The -rep, -policy, -server, and -volume tags specify exactly what volume is to be mounted, but not which snapshot on the volume. Specify the date in the following format: yyyy-Mmm-dd hh:mm:ss. Alternatively, specify "last snapshot" to mount the most recent snapshot on the volume. The following example uses the yyyy-Mmm-dd hh:mm:ss format to specify the date:
```
-date "2008-Sep-20 15:47:35" -when after
```
-when - Use to specify when the snapshot is mounted. The three parameter options are after, before, or exact. The default value is exact.
-login - Use to specify the user name that is used when mounting. If this tag is not specified, the user that is currently logged on to FastBack Mount is used. Use this tag only with the -domain and -pass tags.
-domain - Use to specify the domain when mounting. If no domain is specified, by default, the xpress-restore domain is used. Use this tag only with the -login and -pass tags.
-pass - Use to specify the password when mounting. Use this tag only with the -login and -domain tags.
-ro|-fw - Use to specify whether the mounted volume is read-only (-ro) or fake-write (-fw).

The following examples indicate how to specify the add type, and the corresponding tags and parameters:

The following example shows how to mount a snapshot from a repository on a network share:
```
mount add -target X: -rep "C:\My_Folder_Repository" -policy 
		"Alta L" -server alta -volume E:\ -date "2008-Sep-20 15:47:35" 
		-when after
```
In this example, a snapshot, E:, is on Alta. This snapshot is mounted to the system where FastBack Mount is running, X:. The snapshot is pulled from the network share repository, "C:\My_Folder_Repository", by the policy, "Alta L". The exact snapshot on the volume to be mounted is the snapshot after September 20, 2008 at 3:47:35 PM.
The following example shows how to mount the most recent snapshot of a volume as a read-only volume, and as a particular user:
```
mount add -login admin -pass admin123 -domain xpress-restore -target 
		X: -rep "share:\\snowbird\FB_REP_G user=administrator pass=12345 
		domain=my_domain" -policy "Brighton Nighlty" -server Brighton 
		-volume E:\ -date "last snapshot" -ro
```
In this example, a snapshot, E:, is on the server named Brighton. The snapshot is mounted to the system where FastBack Mount is running, X:. The snapshot is pulled from the network share repository named "\\snowbird\FB_REP_G". G is a drive letter for one FastBack repository volume. This share requires a user, password, and domain. This information is supplied in the parameters for -rep. In addition, logon credentials are required for FastBack Mount that are provided at the beginning with -login, -pass, and -domain.

del

Use this command type to unmount one or all snapshots from the system where FastBack Mount 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 to be unmounted. The target to be unmounted can be a virtual volume, reparse point, or iSCSI initiator that was created by using the mount command. Use everything to unmount all volumes.
-force - Use this tag to force a snapshot to be unmounted. The default option is not to force a snapshot to be unmounted.

For example, to force a snapshot that is mounted at the directory, c:\gever to be unmounted, use the following command:

mount del -target "c:\gever" -force

To unmount a snapshot that is mounted as volume V:, use the following command:

mount del -target V:

To unmount a snapshot that is mounted as an iSCSI initiator, use the following command:

mount del -target "ISCSI:<target_name>"

dump

Use this type to get a memory dump of all available snapshots in various formats. For example, to dump all snapshots from a network share repository, using a tape format, use the following command:

mount dump -type local -rep "C:\My_Folder_Repository" -for 
	TapeBackup -full -file "C:\dump.txt"

The following list identifies some of the parameters for the dump type:

-type - Use local for a local repository or share for a network-shared repository, or a repository on the folder.
-rep - This tag is required. Use to specify the local or network share repository. For local, you can specify hostname@domain, or, for a repository on folder, the full path.
-os - Use this tag to specify the operating system. The options are windows, linux, and all. The default option is windows.
-for - Use this tag and the TapeBackup parameter to dump each snapshot as an Administrative Command Line command.
-full - Use this tag to carry out a memory dump of all snapshots of each volume. This tag is optional.
If -full is not specified, only the last snapshot of each volume is dumped.
-file - Use this tag to identify a file name to store the memory dump text. This tag is optional.
If -file is not specified, the memory dump text is only printed to stdout.

In the following example, you can dump a full list of snapshots that can be mounted from the local repository, in the terminal:

mount dump -type local -full

 ------------------------------------------------------------------
|SNOWBIRD@OFFICE Alta J      alta      J:\  Last snapshot          
|SNOWBIRD@OFFICE Alta J      alta      J:\  2009-Aug-22 20:01:49   
|SNOWBIRD@OFFICE Snowbird K  snowbird  K:\  Last snapshot          
|SNOWBIRD@OFFICE Snowbird K  snowbird  K:\  2009-Aug-22 20:24:11   
 ------------------------------------------------------------------

remove

Use this type to remove the connection to a non-local repository. There is only one tag for the remove type:

-rep - This tag is required. Use this tag to specify the repository. Connections to this repository are removed.

In the following example, remove all network share repository connections to a repository at "C:\My_Folder_Repository":

mount remove -rep "C:\My_Folder_Repository"

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


 ------------------------------------------------------------------
| The following virtual volumes exist:                             
| 'Y:\' is mount of [snowbird@fbperf]-['AltBriPar I LAN'-'alta'-   
|		'I:\' at 8/22/2009 8:54:42 PM]                                
| 'W:\' is mount of [snowbird@fbperf]-['AltBriPar I LAN'-          
|		'brighton'-'I:\' at 8/22/2009 8:54:42 PM]                     
| 'V:\' is mount of [snowbird@fbperf]-['AltBriPar I LAN'-          
|		'parkcity'-	'I:\' at 8/22/2009 8:54:42 PM]                   
 ------------------------------------------------------------------

The following syntax diagram is for the mount command: