Tivoli Header

Tivoli Storage Manager for UNIX Backup-Archive Clients Installation and User's Guide

Domain

The domain option specifies the file systems that you want to include for incremental backup in your client domain.

Notes:

  1. The Tivoli Storage Manager Client API does not support this option.
  2. The server can also define this option.

Use the domain option in your client system options file to define your default client domain. Tivoli Storage Manager uses your default client domain in the following situations to determine which file systems to process during an incremental backup:

If you do not use the domain option to specify file systems in your client options file, Tivoli Storage Manager uses the all-local parameter as the default.

Note:
You can include a virtual mount point in your client domain. For information about defining a virtual mount point, see Virtualmountpoint.

When you use the domain option with the incremental command, Tivoli Storage Manager adds file systems that you specify to the file system defined in your client options file. For example, if you enter the following in your client options file:

   domain /home /usr /datasave

and the following on the command line:

   dsmc incremental -domain="/fs1 /fs2"

Tivoli Storage Manager performs an incremental backup for your /home, /usr, /datasave, /fs1, and /fs2 file systems .

If you use both a file specification and the domain option with the incremental command, Tivoli Storage Manager ignores the domain option and processes only those file systems that you specify in the file specification. For example, if you enter:

   dsmc incremental /fs1 /fs2 -domain="/fs3 /fs4"

.

Tivoli Storage Manager performs an incremental backup for the /fs1 and /fs2 file systems only.

Attention: If you are running GPFS for AIX in a multi-node cluster, and all nodes share a mounted GPFS file system, Tivoli Storage Manager processes this file system as a local file system. Tivoli Storage Manager backs up the file system on each node during an incremental backup. To avoid this, you can do one of the following:

Automounted File Systems

When performing a backup with the domain option set to all-local, files handled by automounter and loopback file systems are not backed up.

When performing a file system backup with the domain option set to all-local, any subdirectories that are mount points for an automounted file system (autofs) are excluded from backup when the automounter has mounted these mount points. Any files that exist on the server for the automounted subdirectory are expired.

When performing a backup with the domain option set to all-lofs, all explicit loopback file systems (lofs) are backed up and all automounted file systems are excluded. For loopback file systems handled by automounter, set the domain option to all-auto-lofs.

You should use the automount option with the domain option to specify one or more automounted file systems to be mounted and added into the domain. The automounted file systems are remounted if they have gone offline in the meantime by using the automount option. See Automount for more information.

Virtual mount points cannot be used with automounted file systems.

For HP-UX: The domain option is enhanced with the new keywords all-auto-lofs and all-auto-nfs to support automounted file systems. To use this enhancement, set the autofs parameter to 1 in the /etc/rc.config.d/nfsconf file. Changing this parameter requires a reboot. For further information please refer to the HP documentation on this issue.

The following UNIX platforms support automounter, LOFS, or LOFS through automounter, as indicated:

Platform automounter LOFS LOFS through automounter
AIX and AIX 5L yes yes yes
Solaris yes yes yes
HP-UX yes yes no
SGI yes no yes
OS/390 UNIX yes no no

Notes:

  1. The Linux clients are not enabled for automounter support.

  2. The Linux operating system does not support loopback file systems (LOFS). Instead a loop device is available to allow devices or files mounted as whole file systems. Loop devices are supported by the Tivoli Storage Manager Linux clients in the same way as loopback file systems for other UNIX operating systems. They are not part of the local domain, but domain LOFS. You must use the domain option to add them to your domain.

Supported Clients

This option is valid for all UNIX clients.

Options File

Place this option in the client system options file dsm.sys or the client user options file dsm.opt.

Syntax

           .- -----------------.
           V .-all-local-----. |
>>-DOMain----+---------------+-+-------------------------------><
             +-domain--------+
             +-all-lofs------+
             +-all-nfs-------+
             +-all-auto-nfs--+
             '-all-auto-lofs-'
 
 

Parameters

all-local
Backs up all local file systems except LOFS file systems and LOFS through automounter. This is the default.

The /tmp directory is not included.

domain
Defines the file systems to include in your default client domain.

When you use domain with the incremental command, it processes these file systems in addition to those you specify in your default client domain.

all-lofs
Backs up all loopback file systems, except those handled by automounter.

all-nfs
Backs up all network file systems, except those handled by automounter.

all-auto-nfs
Backs up all network file systems which are handled by automounter.

all-auto-lofs
Backs up all loopback file systems which are handled through automounter.

Examples

Options file:

domain /tst /datasave /joe
"domain all-local"
 

Command line:
-domain=""/fs1 /fs2""
-domain=/tmp
 


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]