The incremental command backs up all new or changed data in the locations that you specify, unless you exclude them from backup services.
You
can back up all new or changed files or directories in the default
client domain or from file systems, directories, or files.
To incrementally back up selected files or directories, enter a file specification in the command. If you do not enter a file specification, the default is to back up files or directories in the default domain.
AIX® only: You
can enable snapshot-based incremental backup by using the option snapshotproviderfs=JFS2.
The following attributes in the management class that is assigned to the file or directory affect whether the data is backed up:
- Frequency
- The number of days that must elapse between successive backups
for the file. The frequency attribute applies
only to a full incremental backup. This management
class attribute is ignored during a journal-based backup. This management class attribute is ignored during
a journal-based backup.
- Mode
- Permits or denies backup of files or directories according to
the following values:
- modified: Files are backed up only if they were changed since the last backup.
- absolute: Files are backed up without regard to whether they were changed since the last backup.
- Serialization
- Permits or denies backup of files or directories according to
the following values:
- static: To be backed up, data must not be modified during backup or archive.
- shared static: If data in the file or directory changes during each of the allowed attempts to back up or archive it, it is not backed up or archived. The value of the changingretries option determines how many attempts are made. The default is 4.
- dynamic: The object is backed up or archived on the first attempt whether or not data changes during the process.
- shared dynamic: The object is backed up or archived on the last attempt, even if data changes during the process.
Using the include option in an include-exclude list, you can override the default management class for a file or group of files.
You can perform either a full incremental backup or an incremental-by-date backup. The default is a full incremental backup.
If
you are journaling a file system and the journal is valid, the full
incremental backup performs a journal-based backup. More than one
journal-based backup session can be started, but only one journal-based
backup session can proceed. All other journal-based backup sessions
that need access to the same file space must wait until the current
journal-based backup session completes before the next session can
proceed. You can perform a full incremental backup without the journal
by using the nojournal option.
You can also use the selective command to perform a backup that backs up only the files, directories, or empty directories that you specify regardless of whether they were changed.
A full incremental backs
up all files or directories that are new or were changed since the
last incremental backup. During a full incremental backup, the client
queries the server. Tivoli® Storage Manager uses
this information when it performs the following actions:
A full incremental backs up all files or directories
that are new or were changed since the last incremental backup. During
a full incremental backup, the client queries the server or the journal
database. Tivoli Storage Manager uses
this information when it performs the following actions:
- Backing up new files or directories.
- Backing up files or directories whose contents were changed since the previous backup.
- Marking inactive backup versions on the server for files or directories that are deleted from the workstation.
- Rebinding backup versions to management classes if the management class assignments change.
Supported Clients
This command is valid for all clients.
Syntax
.-------------------. V | >>-Incremental--+------------+----+---------------+-+---------->< '- --options-' +- --filespec---+ '- --"filespec"-'
Syntax
Parameters
- filespec
- Specifies the path and file name that you want to back up. Use
wildcard characters to select a group of files or all the files in
a directory. If you do not specify a file specification, the domain option
determine what to back up.
If you specify a file system, all new and changed files are backed up. In addition, the last incremental date for the file space is updated on the server. If you specify a file or directory, the last incremental date is not updated. This means that the file or directory might be backed up again if a later backup is performed by using the incrbydate option. If you specify a file system, specify the file system without a trailing slash.
- filespec
- Specifies the path and file name that you want to back up. Use
wildcards to select a group of files or all the files in a directory.
You can specify as many file specifications as available resources
or other operating system limits permit. Separate file specifications
with a space. You can also use the filelist option
to process a list of files. The Tivoli Storage Manager client
opens the file that you specify with this option and processes the
list of files within according to the specific command. If you do
not specify a file specification, the domain option
determines what to backup.
If you specify a file system, all new and changed files are backed up. In addition, the last incremental date for the file space is updated on the server. If you specify a file or directory, the last incremental date is not updated. This means that the file or directory might be backed up again if a later backup is performed by using the incrbydate option. If you specify a file system, specify the file system without a trailing slash.
| Option | Where to use |
|---|---|
| absolute | Command line only. |
| autofsrename |
Client options file (dsm.opt) only. |
| changingretries |
Client options file (dsm.opt) or command line. |
| changingretries |
dsm.sys file or command line. |
| compressalways |
Client options file (dsm.opt) or command line. |
| compressalways |
Client user-options file (dsm.opt) or command line. |
| compression |
Client options file (dsm.opt) or command line. |
| compression |
dsm.sys file within a server stanza or command line. |
| diffsnapshot |
Command line only. |
| dirsonly | Command line only. |
| domain |
Client options file (dsm.opt) or command line. |
| domain |
dsm.sys file or the client user-options file (dsm.opt) or command line. |
| encryptiontype |
System-options file (dsm.sys) within a server stanza. |
| encryptiontype |
Client options file (dsm.opt). |
| encryptkey |
Client options file (dsm.opt). |
| encryptkey |
System-options file (dsm.sys) within a server stanza. |
| filelist | Command line only. |
| filesonly | Command line only. |
| incrbydate | Command line only. |
| memoryefficientbackup |
Client user-options file (dsm.opt), server, or command line. |
| memoryefficientbackup |
Client user-options file (dsm.opt), client system-options file (dsm.sys), server, or command line. |
| nojournal |
Command line only. |
| nojournal |
Command line only. |
| postsnapshotcmd |
Client options file (dsm.opt) or with include.fs option. |
| preservelastaccessdate |
Client user-options file (dsm.opt) or command line. |
| preservelastaccessdate |
Client options file (dsm.opt) or command line. |
| presnapshotcmd |
Client options file (dsm.opt) or with include.fs option. |
| removeoperandlimit |
Command line only. |
| resetarchiveattribute |
Client options file (dsm.opt). |
| skipntpermissions |
Client options file (dsm.opt) or command line. |
| skipntsecuritycrc |
Client options file dsm.opt) or command line. |
| snapdiff |
Command line only. |
| snapshotcachesize |
Client options file (dsm.opt) or with the include.fs option. |
| snapshotproviderfs |
System-options file (dsm.sys) within a server stanza or with the include.fs option. |
| snapshotproviderimage |
Client options file (dsm.opt) or with the include.image option. |
| snapshotroot | Command line only. |
| subdir |
Client options file (dsm.opt) or command line. |
| subdir |
Client user-options file (dsm.opt) or command line. |
| tapeprompt |
Client options file (dsm.opt) or command line. |
| tapeprompt |
Client user-options file (dsm.opt) or command line. |
Examples
- Task
- Run an incremental backup of the client domain that
is specified in your client user-options file (dsm.opt).
Incremental - Run an incremental backup that backs up all files in
the domain regardless of whether they were changed since the last
backup.
Incremental -absolute - Task
- Run an incremental backup of the default client domain that is
specified in your client options file (dsm.opt).
Incremental - Run an incremental backup of the domain that is specified
in your client user options file. Adding the -absolute option
forces a backup of all files in the domain, even if they were not
changed since the last incremental backup.
Incremental -absolute - Task
- Run an incremental backup of the C, D, and E drives.
incremental c: d: e: - Task
- Run an incremental backup of the \home\ngai directory
and its contents on the current drive.
i \home\ngai\ - Task
- Run an incremental backup for the /home, /usr,
and /proj file systems.
Incremental /home /usr /proj - Task
- Run an incremental backup for the /proj/test directory.
Incremental /proj/test/ - Task
- Run an incremental-by-date backup for the /home file
system.
Incremental -incrbydate /home - Task
- Run an incremental backup of the abc file
in the /fs/dir1 directory.
Incremental -subdir=yes /fs/dir1/abc - Task
- Run an incremental backup of the directory object /fs/dir1,
but not any of the files in the /fs/dir1 directory.
Incremental /fs/dir1 - Task
- Run an incremental backup of the directory object /fs/dir1,
all of the files in the fs/dir1 directory, and
all files and subdirectories under /fs/dir1.
Incremental -subdir=yes /fs/dir1/ - Task
- Assuming that you initiated a snapshot of the /usr file
system and mounted the snapshot as /snapshot/day1,
run an incremental backup of all files and directories under the local
snapshot and manage them on the Tivoli Storage Manager server
under the file space name /usr.
dsmc inc /usr -snapshotroot=/snapshot/day1 - Task
- Assuming that you initiated a snapshot of the C drive
and mounted the snapshot as \\florence\c$\snapshots\snapshot.0,
run an incremental backup of all files and directories under the local
snapshot and manage them on the Tivoli Storage Manager server
under the C:\ drive file space name.
dsmc inc c: -snapshotroot=\\florence\c$\snapshots\snapshot.0 - Task
- Run an incremental backup for the /home file
system by using the snapdiff option. Tell Tivoli Storage Manager to create
the difference snapshot. Here /home is the NFS
mount point for a NAS/N-Series file server volume.
incremental /home -snapdiff -diffsnapshot=create - Task
- Run an incremental backup of the /proj file
system by using the snapdiff option. Tell Tivoli Storage Manager to use
the latest snapshot on the file server as the difference snapshot.
Here /proj is the NFS mount point for a NAS/N-Series
file server volume.
incremental /proj -snapdiff -diffsnapshot=latest - Task
- Run a snapdiff incremental backup from a
snapshot taken of a network share //homestore.example.com/vol1 mounted
on drive H, where homestore.example.com is a
file server.
incremental -snapdiff H: - Task
- Run a snapdiff incremental backup from a
snapshot taken of a network share //homestore.example.com/vol1 mounted
on drive H, where homestore.example.com is a
file server. The -diffsnapshot option value of
LATEST means that the operation uses the latest snapshot (the active
snapshot) for volume H.
incremental -snapdiff H: -diffsnapshot=LATEST