====== Preview backup files ======
This work only on command line, and allow to extract a list of files that will be backup with their management class, or exclude, with the associated rule into inclexcl file.
CFS-CLU01-H:/media/nss/DATA/tsm # /opt/tivoli/tsm/client/ba/bin/dsmc -optfile=/media/nss/DATA/tsm/dsm.opt
IBM Tivoli Storage Manager
Command Line Backup-Archive Client Interface
Client Version 6, Release 3, Level 0.0
Client date/time: 11/25/11 10:28:25
(c) Copyright by IBM Corporation and other(s) 1990, 2011. All Rights Reserved.
Node Name: BLDATA01
Session established with server TSM1: AIX
Server Version 6, Release 2, Level 3.0
Server date/time: 11/25/11 10:28:25 Last access: 11/25/11 10:28:10
tsm> prev backup /media/nss/DATA/tsm/*
Preview output has been successfully written to file 'dsmprev.txt'.
tsm> quit
CFS-CLU01-H:/media/nss/DATA/tsm # cat dsmprev.txt
Preview generated on 11/25/11 10:28:51.
Name: Size: Type: Status: Pattern: Source: Mgmt Class:
/media/nss/DATA/tsm/TSM 0 B Directory Included - - MC_DIRMC
/media/nss/DATA/tsm/journaldbs 0 B Directory Included - - MC_DIRMC
/media/nss/DATA/tsm/dsm.opt 936 B .opt Included - - DEFAULT
/media/nss/DATA/tsm/dsmerror.log 824 B .log Excluded /media/nss/DATA/tsm/.../*.log "/media/nss/DATA/tsm/inclexcl.lst" DEFAULT
/media/nss/DATA/tsm/dsmprev.txt 0 B .txt Included - - DEFAULT
/media/nss/DATA/tsm/dsmsched.log 32.43 KB .log Excluded /media/nss/DATA/tsm/.../*.log "/media/nss/DATA/tsm/inclexcl.lst" DEFAULT
/media/nss/DATA/tsm/dsmwebcl.log 5.69 KB .log Excluded /media/nss/DATA/tsm/.../*.log "/media/nss/DATA/tsm/inclexcl.lst" DEFAULT
/media/nss/DATA/tsm/inclexcl.lst 87 B .lst Included - - DEFAULT
/media/nss/DATA/tsm/myJbberror.log 1.68 KB .log Excluded /media/nss/DATA/tsm/.../*.log "/media/nss/DATA/tsm/inclexcl.lst" DEFAULT
/media/nss/DATA/tsm/rc.tsm 2.55 KB .tsm Included - - DEFAULT
/media/nss/DATA/tsm/TSM.PWD 135 B .PWD Included - - DEFAULT
/media/nss/DATA/tsm/tsmjbbd.ini 6.95 KB .ini Included - - DEFAULT
/media/nss/DATA/tsm/TSM/gskcrypt64-8.0.14.11.linux.x86_64.rpm 1.46 MB .rpm Included - - DEFAULT
/media/nss/DATA/tsm/TSM/gskssl64-8.0.14.11.linux.x86_64.rpm 7.24 MB .rpm Included - - DEFAULT
/media/nss/DATA/tsm/TSM/TIVsm-API64.x86_64.rpm 35.44 MB .rpm Included - - DEFAULT
/media/nss/DATA/tsm/TSM/TIVsm-APIcit.x86_64.rpm 1.94 MB .rpm Included - - DEFAULT
/media/nss/DATA/tsm/TSM/TIVsm-BA.x86_64.rpm 71.23 MB .rpm Included - - DEFAULT
/media/nss/DATA/tsm/TSM/TIVsm-BAcit.x86_64.rpm 1.94 MB .rpm Included - - DEFAULT
/media/nss/DATA/tsm/TSM/TIVsm-BAhdw.x86_64.rpm 1.68 MB .rpm Included - - DEFAULT
/media/nss/DATA/tsm/TSM/TIVsm-filepath-6.3.0-0-rhel55.x86_64.rpm 142.77 KB .rpm Included - - DEFAULT
/media/nss/DATA/tsm/TSM/TIVsm-filepath-6.3.0-0-rhel60.x86_64.rpm 164.29 KB .rpm Included - - DEFAULT
/media/nss/DATA/tsm/TSM/TIVsm-filepath-6.3.0-0-sles10sp3.x86_64.rpm 135.50 KB .rpm Included - - DEFAULT
/media/nss/DATA/tsm/TSM/TIVsm-filepath-6.3.0-0-sles11sp1.x86_64.rpm 137.51 KB .rpm Included - - DEFAULT
/media/nss/DATA/tsm/TSM/TIVsm-JBB.x86_64.rpm 325.32 KB .rpm Included - - DEFAULT
/media/nss/DATA/tsm/TSM/TIVsm-msg.FR_FR.x86_64.rpm 3.42 MB .rpm Included - - DEFAULT
/media/nss/DATA/tsm/journaldbs/tsm_media_nss_DATA.jdb.jbbdb 5.56 KB .jbbdb Excluded /media/nss/DATA/tsm/journaldbs/.../* "/media/nss/DATA/tsm/inclexcl.lst" DEFAULT
/media/nss/DATA/tsm/journaldbs/tsm_media_nss_DATA.jdbInc.jbbdb 2.11 KB .jbbdb Excluded /media/nss/DATA/tsm/journaldbs/.../* "/media/nss/DATA/tsm/inclexcl.lst" DEFAULT
CFS-CLU01-H:/media/nss/DATA/tsm #
=== Domain ===
What do you want to backup ?
Samples for Windows, you can use one or more lines (example 1 per drive letter):
domain c: d: e:
domain c: systemobject
domain ALL-LOCAL -systemobject
domain ALL-LOCAL -c:
domain ALL-LOCAL -\\florence\e$
Samples for UNIX, Linux:
domain "-/Volumes/disk2"
=== Exclude/Include options ===
Only a file include into a valid domain is able to be backupped. **IMPORTANT: include/exclude rules are read from the bootom to top.** If a file reach a rule, this rule is applied and the next file is checked.
exclude /home/jones/proj1/*.*
exclude.compression /home/jones/proj1/file.txt
include /home/jones/proj1/*.jpg MC_PICTURE
include /home/jones/proj1/file.txt
Tivoli Storage Manager examines the statements (reading from bottom to top) and determines that the /home/jones/proj1/file.txt file is a candidate for
backup, but is not a candidate for compression processing. The jpg files from directory /home/jones/proj1 are backupped to TSM server with a different Management Class than the default.
=== exclude, exclude.backup, exclude.file, exclude.file.backup ===
Use these options to exclude a file or group of files from backup services.
== exclude.archive ==
Excludes a file or a group of files that match the pattern from archive services only.
== exclude.compression ==
Excludes files from compression processing if the compression option is set to yes. This option applies to backups and archives.
== exclude.dir ==
Excludes a directory, its files, and all its subdirectories and their files from backup processing. For example, the statement exclude.dir c:\test\dan\data1 excludes the c:\test\dan\data1 directory, its files, and all its subdirectories and their files.
== exclude.encrypt ==
Excludes the specified files from encryption processing. This option does not affect whether files are excluded from backup or archive processing, only whether they are excluded from encryption processing.
== exclude.fs.nas ==
Excludes file systems on the NAS file server from an image backup when used with the backup nas command. The NAS node name must be prefixed to the file system name, for example: netappsj1/vol/vol1. To apply this exclude to all NAS nodes, replace the NAS node name with a wildcard, for example: */vol/vol1. The backup nas command ignores all other exclude statements including exclude.dir statements. This option is valid for all Windows clients.
== exclude.image ==
Excludes mounted file systems and raw logical volumes that match the specified pattern from full image backup operations. Incremental image backup operations are unaffected by exclude.image. This option is valid for Windows XP clients only.
== exclude.subfile ==
Excludes files from adaptive subfile backup processing. This option does not apply to archive processing.
== exclude.systemobject ==
Excludes individual system objects from backup services. Excluded system object types that you backed up previously are not expired during subsequent backups. This option only excludes the system object types that you specify from subsequent backups. This option is valid for Windows XP clients only.
== exclude.systemservice ==
Excludes individual system services components from system state backup. Input can be the keyword or component name to be excluded from processing. If you specify the component name and there are spaces, enclose the name in quotation marks. Table 50 shows valid system services components and their corresponding keywords:
The valid values for the exclude.systemobject option are\\
ACTIVEDIRECTORY, CERTSERVERDB, CLUSTERDB, COMPLUSDB, EVENTLOG, FRS, REGISTRY, RSM, SYSFILES, SYSVOL, and WMI.
=== include, include.backup, include.file ===
Use these options to include files or assign management classes for backup processing.
The include option affects archive and backup processing. If you want to
assign different management classes for archive and backup processing, always
specify include.archive and include.backup with their own management classes.
In the following example, the archmc management class is assigned when an
archive operation is performed, because include.backup is used only for
backup processing, it is not used for archive processing.\\
include.archive c:\test\*\ archmc\\
include.backup c:\test\*
include.archive
Includes files or assigns management classes for archive processing.
include.compression
Includes files for compression processing if you set the compression option to
yes. This option applies to backups and archives.
include.encrypt
Includes the specified files for encryption processing. By default, Tivoli Storage
Manager does not perform encryption processing.
Attention: The include.encrypt option is the only way to enable encryption on
the Backup-Archive client. If no include.encrypt statements are used,
encryption will not occur.
include.fs
If open file support has been configured (see “Configuring Open File Support
(OFS)” on page 29), Tivoli Storage Manager performs a snapshot backup or
archive of files that are locked (or ″in use″) by other applications. The snapshot
allows the backup to be taken from a point-in-time copy that matches the file
system at the time the snapshot is taken. Subsequent changes to the file system
are not included in the backup. You can set the snapshotproviderfs parameter
of the include.fs option to none to specify which drives do not use open file
support.
To control an open file support operation with LVSA, you can specify these
additional options in your dsm.opt file or as values of the include.fs option:
snapshotproviderfs, presnapshotcmd, postsnapshotcmd. Also, if you selected
the LVSA as your snapshot provider, the following additional options can be
set: snapshotcachelocation, snapshotcachesize, snapshotfsidleretries,
snapshotfsidlewait, See Chapter 9, “Using processing options,” on page 165 for
more information about these options.
To control how Tivoli Storage Manager processes your file space for
incremental backup, you can specify these additional options in your dsm.opt
file or as values of the include.fs option: diskcachelocation and
memoryefficientbackup. If these options appear both in the options file and an
include.fs option, the include.fs values will be used for the specified file space
in place of any values in an option file or on the command line.\\
Examples:
Options file or include/exclude file:
include.fs d: memoryefficientbackup=diskcachem
diskcachelocation=e:\temp
include.fs e: memoryefficientbackup=diskcachem
diskcachelocation=c:\temp
include.fs.nas
Use the include.fs.nas option to bind a management class to Network Attached
Storage (NAS) file systems. You can also specify whether Tivoli Storage
Manager saves Table of Contents (TOC) information during a NAS file system
image backup, using the toc option with the include.fs.nas option in your
client options file (dsm.opt). See “Toc” on page 399 for more information.
include.image
Includes a file space or logical volume, or assigns a management class when
used with the backup image command. The backup image command ignores
all other include options.\\
By default, Tivoli Storage Manager performs an offline image backup. To
enable and control an online image operation, you can specify these options in
your dsm.opt file or as values of the include.image option:
snapshotproviderimage, presnapshotcmd, postsnapshotcmd. Also, if you
selected the LVSA as your snapshot provider, the following additional options
can be set: snapshotcachelocation, snapshotcachesize, snapshotfsidleretries,
snapshotfsidlewait
include.subfile
Includes files for adaptive subfile backup processing. This option does not
apply to archive processing. This option is valid for all Windows clients.
include.systemobject
Assigns management classes for backup of Windows XP system objects. By
default, Tivoli Storage Manager binds all system objects to the default
management class. You cannot use this option to bind individual systemobject
components to a different management class. You cannot use this option to
include or exclude a system object from processing. This option is valid for
Windows XP only.\\
**Note:** Other include-exclude statements do not affect system object processing.
It is unnecessary to explicitly include the Windows Registry staging
directory include c:\adsm.sys\...\* for back up, to ensure that the
Windows Registry is backed up properly. If you accidentally exclude a
directory that is critical to a system object backup, the system object
backup is not affected.
== include.systemstate ==
Assigns management classes for back up of the system state. The default is to bind the system state object to the default management class.