The include options specify objects that you want to include for backup and archive services.
The include options specify any of the following:
If you do not assign a specific management class to objects, Tivoli® Storage Manager uses the default management class in the active policy set of your policy domain. Use the query mgmtclass command to display information about the management classes available in your active policy set.
You can include remotely accessed files by specifying Universal Naming Convention (UNC) names in your include statement.
This option is valid for all clients. The server can also define include.fs.nas.
Place this option in the dsm.sys file within a server stanza. You can set these options on the Include-Exclude tab in the Preferences editor.
Place these options in the client options file (dsm.opt). You can set these options on the Include-Exclude tab in the Preferences editor.
include.archive /home/test/* archmc
include.backup /home/test/*
include.archive c:\test\*\ archmc
include.backup c:\test\*
Includes a file or a group of files that are symbolic links or aliases, within a broad group of excluded files for backup processing only.
The default is File.
For AIX® JFS2 file systems: Use the snapshotcachesize option in the dsm.sys file or with the include.fs option, to specify an appropriate snapshot size so that all old data blocks can be stored while the snapshot-based file backup or archive occurs.
To control how Tivoli Storage Manager processes your file space for incremental backup, you can specify these additional options in your dsm.sys file, as values of the include.fs option: diskcachelocation and memoryefficientbackup.
Each of the include.fs, memoryefficientbackup and diskcachelocation options must be on the same line in the options file.
include.fs /home
memoryefficientbackup=diskcachemethod
diskcachelocation=/usr
include.fs /usr
memoryefficientbackup=diskcachemethod
diskcachelocation=/home
include.fs /Volumes/hfs3
memoryefficientbackup=diskcachemethod
diskcachelocation=/Volumes/hfs2
AIX JFS2 filesystems only: include.fs
/kalafs1 snapshotproviderfs=JFS2
If these options appear both in the options file and an include.fs option, the include.fs values are used for the specified file space in place of any values in an option file or on the command line.
include.fs d: memoryefficientbackup=diskcachem
diskcachelocation=e:\temp
include.fs e: memoryefficientbackup=diskcachem
diskcachelocation=c:\temp
If these options appear both
in the options file and an include.fs option, the include.fs values are used for the specified file space
in place of any values in an option file or on the command line.For Linux x86_64 clients: Use the snapshotcachesize option in these situations:
Using the snapshotcachesize option in these situations lets you specify an appropriate snapshot size, so that all old data blocks can be stored while the image backup occurs.
A snapshot size of 100 percent ensures a valid snapshot.
For AIX JFS2 file systems: Use the snapshotcachesize option in these situations:
Using the snapshotcachesize option in these situations lets you specify an appropriate snapshot size, so that all old data blocks can be stored while the image backup occurs.
This option is valid for AIX, HP-UX, Solaris, and all Linux clients only.
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 as values of the include.image option: snapshotproviderimage, presnapshotcmd, postsnapshotcmd.
If the pattern begins with a single or double quotation mark, or contains any embedded blanks or equal signs, you must surround the value in either single (') or double (") quotation marks. The opening and closing quotation marks must be the same type of quotation marks.
For the include.image option, the pattern is the name of a mounted file system or raw logical volume.
For the include.image option, the pattern is the name of a file system or raw logical volume.
include virtual_filespace_name\group_name management_class_name
include virtual_filespace_name/group_name management_class_name
include MyVirtualFileSpace/MyGroup TEST
include MyVirtualFileSpace\MyGroup TEST
optional_parameter | Use with option |
---|---|
ieobjtype | include.dedup |
memoryefficientbackup | include.fs |
diskcachelocation | include.fs |
dynamicimage | include.image |
postsnapshotcmd | include.image |
presnapshotcmd | include.image |
snapshotcachesize | include.image |
snapshotproviderfs | include.image |
snapshotproviderimage | include.image |
include /home/proj/text/devel.*
include /home/proj/text/* textfiles
include * managall
include /WAS_ND_NDNODE mgmtclass
include /WAS_APPNODE mgmtclass
include.image /home
include.archive /home/proj/text/
* myarchiveclass
include.backup /home/proj/text/
* mybackupclass
include.compression /home/proj/text/
devel.*
include.encrypt /home/proj/gordon/*
include.fs.nas netappsj/vol/vol0
homemgmtclass
include.dedup /Users/Administrator/Documents/Important/.../*
AIX only:
include.image /home
MGMTCLASSNAME
snapshotproviderimage=JFS2
snapshotcachesize=40
include.image /home
snapshotproviderimage=NONE
include.fs /kalafs1
snapshotproviderfs=JFS2
LINUX only:
include.image /home
snapshotproviderimage=LINUX_LVM
include.image /myfs1 dynamicimage=yes
include.image /home MGMTCLASSNAME
snapshotproviderimage=NONE
include.image /myfs1 dynamicimage=yes
include.attribute.symlink /home/spike/.../*
include.fs /usr
memoryefficientbackup=diskcachemethod
Windows only:
include c:\proj\text\devel.*
include c:\proj\text\* textfiles
include ?:* managall
include WAS_ND_NDNODE mgmtclass
include WAS_APPNODE mgmtclass
include.backup c:\win98\system\* mybackupclass
include.archive c:\win98\system\* myarchiveclass
include.encrypt c:\win98\proj\gordon\*
include.compress c:\test\file.txt
include.subfile c:\test\file.txt
include.image h: MGMTCLASSNAME
snapshotproviderimage=vss
include.image x:
snapshotproviderimage=none
include.image y:
snapshotproviderimage=vss
include.image z: MGMTCLASSNAME
snapshotproviderimage=none
include.fs c:
snapshotproviderfs=vss
include.systemstate ALL mgmtc3
include.dedup c:\Users\Administrator\Documents\Important\...\*
include.dedup e:\*\* ieobjtype=image
include.dedup ALL ieobjtype=systemstate
include.dedup ALL ieobjtype=ASR
include.encrypt ?:\...\*