包括选项

在线编辑

包括选项指定想要包含在备份和归档服务中的对象。

包括选项指定以下任一情况：

想要为备份及归档服务包含的一大组已排除对象内的对象。
要包含在备份，归档，映像和空间管理服务中的一组已排除对象中的对象。
想要为备份、归档及映像服务包含的一大组已排除对象内的对象。
为备份或归档处理而包含的文件，也是您要为加密处理而包含的文件。
为备份或归档处理而包含的文件，也是您要为压缩处理而包含的文件。
要为其指定特定管理类的对象。
为不明确指定管理类的所有对象指定的管理类。
要为其指定节省内存备份处理的文件空间
要在其中使用 diskcachelocation 选项以使特定文件系统使用不同特定位置来存放磁盘高速缓存的文件空间。

如果未向对象分配特定的管理类，将使用策略域的活动策略集中的缺省管理类。使用 query mgmtclass 命令显示活动策略集中可用的管理类的信息。

Windows 操作系统通过在 include 语句中指定通用命名约定 (UNC) 名称可排除远程访问的文件。

请记住: 备份/归档客户机将其处理的文件与包含/排除语句中指定的模式进行比较，从选项文件的底部到顶部进行读取。

注：

exclude.dir 语句覆盖与模式匹配的所有 include 语句。
exclude.fs 和 exclude.dir 语句覆盖与模式匹配的所有 include 语句。
include 语句不区分大小写。
服务器也可以通过 inclexcl 选项定义这些选项。

支持的客户机

此选项适用于所有客户机。服务器也可以定义 include.fs.nas。

选项文件

Linux 操作系统 Oracle Solaris 操作系统 AIX 操作系统 Mac OS X 操作系统将此选项放在客户机系统选项文件 (dsm.sys) 的服务器节中。可以在首选项编辑器中的包括/排除选项卡上设置这些选项。

Windows 操作系统将这些选项放在客户机选项文件 (dsm.opt) 中。可以在首选项编辑器中的包括/排除选项卡上设置这些选项。

语法

include、include.backup、include.file

使用这些选项为备份处理包含文件或分配管理类。

include 选项影响归档和备份处理。如果您要为归档和备份处理分配不同的管理类，那么总是以它们自己的管理类指定 include.archive 和 include.backup。在本例中，当执行归档操作时，将分配 archmc 管理类。执行归档操作时将分配管理类，因为 include.backup 仅用于备份处理，而不用于归档处理。 Linux 操作系统

include.archive /home/test/* archmc 
include.backup /home/test/*

include.archive c:\test\*\ archmc 
include.backup c:\test\*

include.archive

为归档处理包含文件或指定管理类。

include.attribute.symlink

将作为符号链接或别名的一个文件或一组文件包含在仅用于备份处理的一大组已排除文件中。

注： Mac OS X ，包括别名。

include.compression

如果将 compression 选项设置为 yes，那么将为压缩处理包含文件。此选项适用于备份和归档。

include.dedup

包含用于客户机端重复数据删除的文件。要控制客户机端重复数据删除操作，请将 ieobjtype 指定为 include.dedup 选项的值。缺省情况下，所有可以进行重复数据删除的对象均包含在客户机端重复数据删除中。

有效的 ieobjtype 参数是：

文件
图像
SYSTEMState
Asr

缺省值为 File。

include.encrypt

包含要进行加密处理的指定文件。缺省情况下，客户机不执行加密处理。

要点：include.encrypt 选项是在备份/归档客户机上启用加密的唯一途径。如果没有使用 include.encrypt 语句，那么不会进行加密。

限制：

加密与客户机端重复数据删除不兼容。客户机端重复数据删除不会对包含的要进行加密的文件进行重复数据删除。
对于针对 IBM® Storage Protect 服务器 8.1.1 及更高级别或 IBM Storage Protect7.1.8 及更高版本 7 级别的不依赖 LAN 的备份和归档操作，不再支持使用 include.encrypt 选项进行客户机加密。对已加密备份版本和归档副本的不依赖 LAN 的复原和检索操作继续受支持。如果需要使用 include.encrypt 选项加密数据（其中数据在加密后再发送到服务器），请使用基于 LAN 的备份或归档操作。
加密与使用持续增量式备份方式（MODE=IFIncremental 和 MODE=IFFull）的 VMware 虚拟机备份不兼容。如果为客户机配置加密，那么无法使用持续增量式备份。
加密与 IBM Storage Protect for Virtual Environments Data Protection for VMware 恢复代理程序不兼容。如果将客户机配置为加密，那么可以使用客户机来复原通过 V7.1 客户机完全或增量备份方式（MODE=Full 和 MODE=Incremental）创建的备份。但是，无法使用 Recover Agent 来复原已加密备份。

include.fs

AIX 操作系统对于 AIX® JFS2 文件系统: 请使用 dsm.sys 文件中的 snapshotcachesize 选项或与 include.fs 选项配合使用，以指定相应的快照大小，以便在发生基于快照的文件备份或归档时可以存储所有旧数据块。

要控制客户机如何处理文件空间以进行增量备份，可以在 dsm.sys 文件中将以下附加选项指定为 include.fs 选项的值：diskcachelocation 和 memoryefficientbackup。

每个 include.fs、memoryefficientbackup 和 diskcachelocation 选项都必须位于选项文件中的同一行。

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

如果在选项文件和 include.fs 选项中同时出现这些选项，include.fs 值将用于指定的文件空间，替代选项文件中或命令行上的任何值。

include.fs

如果已配置打开的文件支持，那么客户机会对其他应用程序锁定（或正在使用）的文件执行快照备份或归档。快照允许从时间点副本 (匹配拍快照时的文件系统) 进行备份。对文件系统的后续更改将不包含在备份中。可以将 include.fs 选项的 snapshotproviderfs 参数设置为 none 以指定哪些驱动器不使用打开的文件支持。

要控制客户机如何处理文件空间以进行增量备份，可以在 dsm.opt 文件中将以下附加选项指定为 include.fs 选项的值：diskcachelocation 和 memoryefficientbackup。

include.fs d: memoryefficientbackup=diskcachem 
  diskcachelocation=e:\temp
include.fs e: memoryefficientbackup=diskcachem 
  diskcachelocation=c:\temp

如果在选项文件和 include.fs 选项中同时出现这些选项，include.fs 值将用于指定的文件空间，替代选项文件中或命令行上的任何值。

include.fs.nas

使用 include.fs.nas 选项将管理类绑定到网络连接存储器 (NAS) 文件系统。通过在 dsm.sys 文件中将 toc 选项与 include.fs.nas 选项一起使用，也可指定客户机是否在 NAS 文件系统映像备份期间保存目录 (TOC) 信息。此选项仅适用于 AIX 和 Solaris 的用户。

include.fs.nas

使用 include.fs.nas 选项将管理类绑定到网络连接存储器 (NAS) 文件系统。通过在客户机选项文件 (dsm.opt) 中将 toc 选项与 include.fs.nas 选项一起使用，也可指定客户机是否在 NAS 文件系统映像备份期间保存目录 (TOC) 信息。

include.image

包含文件空间或逻辑卷，或者在与 backup image 命令一起使用时分配管理类。 backup image 命令忽略所有其他包括选项。

Linux 操作系统针对 Linux® x86_64 用户：在以下情况下请使用 snapshotcachesize 选项：

使用 backup image 命令
在 dsm.sys 文件中
使用 include.image 选项

在这些情境中使用 snapshotcachesize 选项使您可以指定适当的快照大小，以便在进行映像备份时可以存储所有的旧数据块。

百分之百的快照大小能确保快照有效。

AIX 操作系统对于 AIX JFS2 文件系统: 在以下情况下使用 snapshotcachesize 选项:

使用 backup image 命令
在 dsm.sys 文件中
使用 include.image 选项

在这些情境中使用 snapshotcachesize 选项使您可以指定适当的快照大小，以便在进行映像备份时可以存储所有的旧数据块。

Linux 操作系统 Oracle Solaris 操作系统 AIX 操作系统此选项对 AIX， Linux和 Oracle Solaris 客户机有效。

include.image

包含文件空间或逻辑卷，或者在与 backup image 命令一起使用时分配管理类。 backup image 命令忽略所有其他包括选项。

缺省情况下，客户机执行脱机映像备份。要启用并控制联机映像操作，您可以在 dsm.opt 文件中指定以下选项作为 include.image 选项的值：snapshotproviderimage、presnapshotcmd 和 postsnapshotcmd。

include.systemstate

此选项将系统状态备份绑定到指定管理类。如果指定此选项，请指定 all 模式。如果不指定此选项，系统状态备份将绑定到缺省管理类。

参数

模式

指定要为备份或归档处理包含的对象或分配特定管理类。

注: 对于 NAS 文件系统: 必须将 NAS 节点名作为文件规范的前缀，以指定包含语句所应用于的文件服务器。如果未指定 NAS 节点名，那么已识别的文件系统指的是在客户机选项文件 (dsm.sys) 中或在命令行上指定的 NAS 节点名。

注: 对于 NAS 文件系统: 必须将 NAS 节点名作为文件规范的前缀，以指定要应用 include 语句的文件服务器。如果未指定 NAS 节点名，那么标识的文件系统指的是在客户机选项文件 (dsm.opt) 中或在命令行上指定的 NAS 节点名。

如果模式以单引号或双引号开始，或者包含任何内嵌的空格或等号，那么必须为该值加上单引号 (') 或双引号 (")。起始或结束引号必须属于同一类型。

Linux 操作系统 Oracle Solaris 操作系统 AIX 操作系统对于 include.image 选项，模式是已安装的文件系统或原始逻辑卷的名称。

Windows 操作系统对于 include.image 选项，模式是文件系统或原始逻辑卷的名称。

注: 当您指定 include.systemstate时，唯一有效的模式是 all。

optional_parameter

管理类名称

指定要分配给对象的管理类的名称。如果未指定管理类，那么使用缺省管理类。要在 include 语句上将管理类与备份组关联，请使用下列语法：

include virtual_filespace_name\group_name management_class_name

include virtual_filespace_name/group_name management_class_name

其中：

虚拟文件空间名称

在 Backup Group 命令中指定与组关联的 IBM Storage Protect 服务器虚拟文件空间的名称。

group_name

它是您在运行 Backup Group 命令时创建的组的名称。

管理类名

它是要与组中文件关联的管理类的名称。

例如，一个名为 MyGroup 的组存储在名为 MyVirtualFileSpace 的虚拟文件空间中。要将名为 TEST 的管理类与组相关联，请使用以下语法: Linux 操作系统

include MyVirtualFileSpace/MyGroup TEST

include MyVirtualFileSpace\MyGroup TEST

表 1. 其他可选参数
optional_parameter	与选项一起使用
ieobjtype	include.dedup
memoryefficientbackup	include.fs
diskcachelocation	include.fs
动态映像	include.image
快照后命令	include.image
预快照命令	include.image
快照缓存大小	include.image
快照提供程序	include.image
快照提供者图像	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.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 ?:\...\*

命令行：

不适用。