Incremental
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 of
the object. 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
- Specifies
whether changes since the last backup operation affect the processing.
If
mode=modified, only objects that changed since the last backup operation are processed. Ifmode=absolute, every object is processed, regardless of whether the object changed since the last backup operation.If the copy group mode is set to modified, it can be overridden by using the client absolute option. For more information about the absolute option, see Absolute.
- 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 and directories
that are new or were changed since the last incremental backup. During a full incremental backup,
the client queries the server. IBM Spectrum® Protect uses
this information when it performs the following actions:
A full incremental backs up all files and 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. IBM Spectrum Protect 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 for UNIX and Linux®
Syntax for Windows
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 backup-archive
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. |
| detail |
Command line only. |
| 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 IBM Spectrum Protect 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 IBM Spectrum Protect 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 and specify the option to create the difference snapshot. In
the following example, /home is the NFS mount point for a NAS/N-Series file
server volume.
incremental /home -snapdiff -diffsnapshot=create - 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