User Tools

Site Tools


tsm:backup_preview

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.

tsm/backup_preview.txt · Last modified: 2021/01/01 21:25 (external edit)