Domain

Domain objects are backed up only if you start the incremental command without a file specification.

Tivoli® Storage Manager uses the domain value in the following situations to determine which file systems to process during an incremental backup:

Tivoli Storage Manager uses the domain value in the following situations to determine which drives to process during an incremental backup:

• When you run an incremental backup by using the incremental command and you do not specify which file systems to process
• When you run an incremental backup by using the incremental command and you do not specify which drives to process
• When your Tivoli Storage Manager administrator defines a schedule to run an incremental backup for you, but does not specify which file systems to process
• When your Tivoli Storage Manager administrator defines a schedule to run an incremental backup for you, but does not specify which drives to process
• When you select the Backup Domain action from the Tivoli Storage Manager backup-archive client GUI

There are several places where the domain option can be defined:

• In an options file.
• On the command line, when entered with a Tivoli Storage Manager command.
• In a client option set, which is defined on the Tivoli Storage Manager server with the define clientopt command.
• As an option on a scheduled command, which is defined on the Tivoli Storage Manager server with the define schedule command.

If any of these sources contain a domain definition, the client backs up that domain. If more than one source specifies a domain, the client backs up all specified domains. The same domain object can be defined more than once, but the effect is the same as defining it only once. If you do not specify a domain, Tivoli Storage Manager backs up the default domain, as described in the all-local parameter.

You can exclude objects from the domain by specifying the exclusion operator (-) before the object. If any domain definition excludes an object, that object is excluded from the domain, even if another definition includes the object. You cannot use the domain exclusion operator (-) in front of any domain keyword that begins with all-.

If you start the incremental command with a file specification, Tivoli Storage Manager ignores any domain definitions and backs up only the file specification.

You can include a virtual mount point in your client domain.

Important: If you are running GPFS™ for AIX® or GPFS for Linux x86_64 in a multinode 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 situation, you can do one of the following tasks:

• Explicitly configure the domain statement in the client user options file (dsm.opt) to list the file systems you want that node to back up.
• Set the exclude.fs option in the client system-options file to exclude the GPFS file system from backup services.

Automounted file systems

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

If you back up a file system with the domain option set to all-local, any subdirectories that are mount points for an automounted file system (AutoFS) are excluded from backup. Any files that exist on the server for the automounted subdirectory are expired.

When your perform 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 loop devices and local file systems that are handled by automounter, set the domain option to all-auto- lofs.

Use the automount option with the domain parameters, all-auto-nfs and all-auto- lofs to specify one or more automounted file systems to be mounted and added into the domain. If you specify the automount option, automounted file systems are remounted if they go offline during the execution of the incremental command.

Virtual mount points cannot be used with automounted file systems.

For HP-UX, the domain option is enhanced with the keywords all-, auto-lofs, and all-auto-nfs to support automounted file systems. To use this enhancement, you must use the automounter, AutoFS. To activate AutoFS, set the autofs parameter to 1 in the /etc/rc.config.d/nfsconf file. Changing this parameter requires a reboot. If you encounter problems with NFS automounted file systems, install patches PHCO_24777 and PHNE_26388 (or later patches). For more information, refer to the HP-UX documentation.

For Mac OS X, automounted file systems are not supported. If an automounted file system is part of a domain statement, the backup fails and no files in the automounted file system are processed. Back up and restore the automounted file system from the host system. Do not back up or restore the automounted file system over a network connection.

Supported Clients

This option is valid for all clients. The server can also define this option. The Tivoli Storage Manager client API does not support this option.

Options File

Place this option in the options file, dsm.opt. You can set this option on the Backup tab, Domain for Backup section of the Preferences editor.

Place this option in the options file, dsm.opt or dsm.sys. In the dsm.sys file, you must place this option within a server stanza. You can set this option on the Backup tab, Domain for Backup section of the Preferences editor.

Parameters

all-local

Backup all local volumes on the system, and the Windows system state. This is the default setting. Local volumes are defined as volumes which are formatted with a supported file system (ReFS, NTFS, FAT32, FAT, or GPFS) on a direct-attached storage device, including SAN and iSCSI attached storage. Directories that are mapped to drive letters by using the Windows subst command are included in a backup if the mapped directory is on a local disk.

The following types of volumes are not included when all-local is specified:

• Network attached volumes, including CIFS shares that are mapped to drive letters.
• Removable volumes, including CD/DVD drives, USB thumb drives, and floppy diskette drives. Some USB-attached hard disks are included in the all-local domain if Windows does not classify them as a removable storage device.

Backs up all local file systems except LOFS file systems and LOFS through automounter. This parameter 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 file systems you specify in your default client domain.

-domain

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

all-lofs

Backs up all loopback file systems, except those file systems that are handled by automounter. This parameter is not supported on Mac OS X.

all-nfs

Backs up all network file systems, except those file systems that are handled by automounter. This parameter is not supported on Mac OS X.

all-auto-nfs

Backs up all network file systems (but not local file systems) which are handled by automounter. This parameter is not supported on Mac OS X.

all-auto-lofs

Backs up all loop devices and local file systems that are handled through automounter. This parameter is not supported on Mac OS X.

object

Specifies the domain objects to include in the domain.

An object name must be enclosed in quotation marks if the name includes any spaces.

-object

Specifies the domain objects to exclude from the domain.

An object name must be enclosed in quotation marks if the name includes any spaces.

systemstate

Backup the Windows system state. The systemstate domain is included in the all- local domain.

-systemstate

Exclude system state from backup processing.

Domain definition interaction

Domain can be defined in several sources, and the result is a summation of all domain definitions. As an example of the interaction of domain definitions, consider how domain definitions from several sources yield different backup results. In the table, FS followed by a number (for example, FS1) is a file system. This table shows only commands that are entered on the command line. For scheduled commands, the command-line column is not relevant, and options from the scheduled command must be considered.

Domain can be defined in several sources, and the result is a summation of all domain definitions. As an example of the interaction of domain definitions, consider how domain definitions from several sources yield different backup results. In the table, FS followed by a number (for example, FS1) is a drive. This table shows only commands that are entered on the command line. For scheduled commands, the command-line column is not relevant, and options from the scheduled command must be considered.

domain all-local
domain -FS1