AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systems


The virtualmountpoint option defines a virtual mount point for a file system if you want to consider files for backup that begin with a specific directory within that file system.

Using the virtualmountpoint option to identify a directory within a file system provides a direct path to the files you want to back up, saving processing time. It is more efficient to define a virtual mount point within a file system than it is to define that file system using the domain option, and then to use the exclude option in your include-exclude options list to exclude the files that you do not want to back up.

Use the virtualmountpoint option to define virtual mount points for multiple file systems, for local and remote file systems, and to define more than one virtual mount point within the same file system. Virtual mount points cannot be used in a file system handled by automounter.

You can use the virtualmountpoint option to back up unsupported file systems, with certain limitations. For information about using virtualmountpoint with unsupported file systems, see File system and ACL support.

Note: If the directory that you want to specify as a virtual mount point is a symbolic link, set the followsymbolic option to Yes. If that option is set to no (the default), you are not permitted to use a symbolic link as a virtual mount point. Also, if you back up a file system, then add a virtual mount point, and then do another incremental on the file system, the files and directories in the virtual mount point directory are expired, because they are logically contained within the virtual mount point directory and not the file system.

After you define a virtual mount point, you can specify the path and directory name with the domain option in either the default client options file or on the incremental command to include it for incremental backup services. When you perform a backup or archive using the virtualmountpoint option, the query filespace command lists the virtual mount point in its response along with other file systems. Generally, directories that you define as virtual mount points are treated as actual file systems and require that the virtualmountpoint option is specified in the dsm.sys file to restore or retrieve the data.

Note: When you specify a virtualmountpoint option, the path that it specifies is added to the default backup domain (domain all-local). The virtualmountpoint path is always considered a local "mount point" regardless of the real file system type it points to.

Supported Clients

This option is valid for all UNIX clients except Mac OS X. The Tivoli® Storage Manager client API does not support this option.

Options File

Place this option in the dsm.sys file within a server stanza.


Read syntax diagramSkip visual syntax diagram
   .- -------------------------------.   
   V                                 |   
>>---VIRTUALMountpoint-- --directory-+-------------------------><


Specifies the path and directory name for the directory you want to use as the virtual mount point for a file system. You cannot use wildcard characters in either the path or directory names.

Define only one virtual mount point with each virtualmountpoint option that you include in your client system-options file. Use the virtualmountpoint option as many times as necessary to define all of the virtual mount points that you want to use.


Options file:
virtualmountpoint /afs/
virtualmountpoint /afs/
Command line:
Does not apply.