ONTAP 支持的环境变量
环境变量用于在 NDMP 启用的备份应用程序和存储系统之间进行关于备份或恢复操作的信息通讯。ONTAP 支持环境变量，这些变量都有关联的默认值。但是，您可以手动修改这些默认值。
如果手动修改备份应用程序所设置的值，应用程序可能出现不可预知的行为。这是因为备份或恢复操作执行的可能不是备份应用程序期望它们执行的操作。但在某些情况下，合理修改可能会有助于识别或处理问题。
下表列出转储和 SMTape 常见行为的环境变量，并且这些变量仅支持转储和 SMTape。这些表还包含 ONTAP 支持的环境变量（如果使用）的工作方式描述：
转储和 SMTape 支持的环境变量
| 环境变量 | 有效值 | 默认状态 | 描述 |
|---|---|---|---|
| DEBUG | Y 或 N | N | 指定打印调试的信息。 |
| FILESYSTEM | string | none | 指定要备份的数据的根路径名称。 |
| NDMP_VERSION | return_only | none | 不应修改 NDMP_VERSION 变量。由备份操作创建，NDMP_VERSION 变量返回 NDMP 的版本。 ONTAP 在备份期间设置 NDMP_VERSION 变量，以供内部使用并传递给备份应用程序作为参考。NDMP 会话的 NDMP 版本不使用此变量设置。 |
| PATHNAME_SEPARATOR | return_value | none | 指定路径名称的分隔符。 此字符取决于要备份的文件系统。对于 ONTAP，此变量赋值为 |
| TYPE | dump 或 smtape | dump | 指定支持执行磁带备份与恢复操作的备份类型。 |
| VERBOSE | Y 或 N | N | 增加执行磁带备份或恢复操作的日志消息。 |
转储支持的环境变量
| 环境变量 | 有效值 | 默认状态 | 描述 |
|---|---|---|---|
| ACL_START | return_only | none | 由备份操作创建，ACL_START 变量是直接访问恢复或可重启 NDMP 备份操作所使用的偏移值。 偏移值是转储文件中的字节偏移，ACL 数据（Pass V）从该位置开始，并在备份结束时返回。直接访问恢复操作使用它来正确恢复备份数据，ACL_START 值必须在恢复操作开始时传递。可重启 NDMP 备份操作使用 ACL_START 值来通知备份应用程序备份流不可重启部分的开始位置。 |
| BASE_DATE | 0、-1 或 DUMP_DATE 值 | -1 | 指定开始日期为增量备份。 如果设置为 -1，则禁用 BASE_DATE 增量说明符。如果对级别 0 的备份设置为 0，则启用增量备份。初始备份后，先前增量备份的 DUMP_DATE 变量值会赋给 BASE_DATE 变量。 这些变量是基于级别/更新的增量备份的替代品。 |
| DIRECT | Y 或 N | N | 指定恢复应直接快进到磁带上文件数据所在的位置而不是扫描整个磁带。 为使直接访问恢复工作，备份应用程序必须提供位置信息。如果此变量设置为 Y，备份应用程序应指定文件或目录的名称和定位信息。 |
| DMP_NAME | string | none | 指定多子树备份的名称。 此变量对于多子树备份是必需的。 |
| DUMP_DATE | return_value | none | 请勿直接更改此变量。如果 BASE_DATE 变量设置为不同于 -1 的值，备份将创建它。 DUMP_DATE 变量是通过在转储软件计算的 32 位时间值前面附加 32 位级别值派生而来。级别从传给 BASE_DATE 变量的最后一个级别值开始递增。生成的值用作后续增量备份的 BASE_DATE 值。 |
| ENHANCED_DAR_ENABLED | Y 或 N | N | 指定是否启用增强的 DAR 功能。 增强 DAR 功能支持目录 DAR 和以 NT 流进行的文件 DAR。它可以提高性能。 在恢复期间使用增强 DAR 必需满足以下条件：
|
| EXCLUDE | pattern_string | none | 指定备份数据时要排除的文件或目录。 排除列表是以逗号分隔的文件或目录名称的列表。如果文件或目录匹配列表中的任何一个名称，它将从备份排除。 指定排除列表中的名称时，适用以下规则：
注 如果同时将 NON_QUOTA_TREE 设置为 |
| EXTRACT | Y、N 或 E | N | 指定要恢复的备份数据集的子树。 备份应用程序指定要提取的子树名称。如果指定的文件匹配已备份内容的目录，将递归提取此目录。 要在恢复时不使用 DAR 重命名文件、目录或 Qtree，必须将 EXTRACT 环境变量设置为 E。 |
| EXTRACT_ACL | Y 或 N | Y | 指定在恢复操作时恢复备份文件中的 ACL。 默认情况下恢复数据时将恢复 ACL，但 DAR 除外（DIRECT=Y）。 |
| FORCE | Y 或 N | N | 确定恢复操作是否必须检查目标卷上的卷空间和接口节点可用性。 将此变量设置为 Y 会导致恢复操作跳过目标路径的卷空间和接口节点的可用性检查。 如果目标卷上没有足够的卷空间或接口节点，恢复操作将根据目标卷可用的空间和接口节点尽可能多地恢复数据。卷空间或接口节点不可用时，恢复操作停止。 |
| HIST | Y 或 N | N | 指定将文件的历史记录信息发送到备份应用程序。 大多数商业备份应用程序将 HIST 变量设置为 Y。如果要提高备份操作的速度，或希望使用文件历史记录集合进行问题故障诊断，可将此变量设置为 N。 注 如果备份应用程序不支持文件历史记录，请勿将 HIST 变量设置为 |
| IGNORE_CTIME | Y 或 N | N | 指定如果文件自先前增量备份后仅 ctime 值发生变化，则不增量备份此文件。 即使文件或它的属性尚未更改，某些应用程序（如病毒扫描软件）也会更改接口节点中文件的 ctime 值。因此，增量备份可能备份尚未更改的文件。仅在增量备份因为 ctime 值被修改而需要无法接受的时间或空间时，才应指定 IGNORE_CTIME 变量。 注 默认情况下，NDMP dump 命令将
|
| IGNORE_QTREES | Y 或 N | N | 指定恢复操作不从备份 Qtree 恢复 Qtree 信息。 |
| LEVEL | 0 -31 | 0 | 指定备份级别。 级别 0 拷贝整个数据集。指定大于 0 的增量备份级别，则拷贝自上次增量备份后的所有文件（新建或已修改的）。例如，级别 1 备份自级别 0 备份后新建或修改的文件，级别 2 备份自级别 1 备份后新建或修改的文件，以此类推。 |
| LIST | Y 或 N | N | 列出备份的文件名称和接口节点编号而不真正恢复数据。 |
| LIST_QTREES | Y 或 N | N | 列出备份的 Qtree 而不真正恢复数据。 |
| MULTI_SUBTREE_ NAMES | string | none | 指定备份是多子树备份。 多个子树在字符串中指定，此字符串是以换行分隔、以 null 结束的子树名称列表。子树通过共同根目录的相对路径名称来指定，根目录必须指定为列表的最后一个元素。 如果使用此变量，还必须使用 DMP_NAME 变量。 |
| NDMP_UNICODE_ FH | Y 或 N | N | 指定文件的历史记录信息不但包含文件的 NFS 名称，还包含 Unicode 名称。 大多数备份应用程序不使用此选项，除非备份应用程序可接收这些额外的文件名，否则不应设置。此外，必须设置 HIST 变量。 |
| NO_ACLS | Y 或 N | N | 指定备份数据时不允许复制 ACL。 |
| NON_QUOTA_TREE | Y 或 N | N | 指定备份数据时必须忽略 Qtree 中的文件和目录。 如果设置为 Y，FILESYSTEM 变量指定的数据集的 Qtree 中的项目不备份。仅在 FILESYSTEM 变量指定整个卷时，此变量才起作用。NON_QUOTA_TREE 变量仅适用于级别 0 备份，且如果指定了 MULTI_SUBTREE_NAMES 变量则不起作用。 注 如果同时将 NON_QUOTA_TREE 设置为 |
| NOWRITE | Y 或 N | N | 指定恢复操作不向磁盘写入数据。 此变量用于调试。 |
| RECURSIVE | Y 或 N | Y | 指定在DAR 恢复期间展开目录项。 必须同时启用 DIRECT 和 ENHANCED_DAR_ENABLED 环境变量（设置为 Y）。如果禁用 RECURSIVE 变量（设置为 N），则仅从磁带恢复原始源路径中所有目录的权限和 ACL，而不恢复目录的内容。如果 RECURSIVE 变量设置为 N 或 RECOVER_FULL_PATHS 变量设置为 Y，恢复路径必须以原始路径结束。 注 如果禁用 RECURSIVE 变量并且有多个恢复路径，所有恢复路径都必须包含在最长的恢复路径中。否则，将显示一条错误消息。 例如，以下是有效的恢复路径，因为所有的恢复路径均包含在 foo/dir1/deepdir/myfile 中：
以下是无效的恢复路径：
|
| RECOVER_FULL_PATHS | Y 或 N | N | 指定在 DAR 后恢复完整路径的权限和 ACL。 必须同时启用 DIRECT 和 ENHANCED_DAR_ENABLED（设置为 Y）。如果 RECOVER_FULL_PATHS 设置为 Y，恢复路径必须以原始路径结尾。如果目标卷中已存在目录，其权限和 ACL 将不会从磁带恢复。 |
| UPDATE | Y 或 N | Y | 更新元数据信息以启用基于级别的增量备份。 |
SMTape 支持的环境变量
| 环境变量 | 有效值 | 默认状态 | 描述 |
|---|---|---|---|
| BASE_DATE | DUMP_DATE | -1 | 指定开始日期为增量备份。 BASE_DATE 是参考快照标识的字符串表示。通过使用 BASE_DATE 字符串，SMTape 可查找参考快照拷贝。 基准备份不需要 BASE_DATE。对于增量备份，先前基准或增量备份的 DUMP_DATE 变量值会赋给 BASE_DATE 变量。 备份应用程序会根据先前的 SMTape 基准或增量备份为 DUMP_DATE 赋值。 |
| DUMP_DATE | return_value | none | DUMP_DATE 位于 SMTape 备份的末尾，它包含可标识此备份所用快照拷贝的字符串标识。此快照拷贝可以用作后续增量备份的参考快照拷贝。 生成的 DUMP_DATE 值用作后续增量备份的 BASE_DATE 值。 |
| SMTAPE_BACKUP_SET_ID | string | none | 标识基准备份的相关增量备份的顺序。 备份集标识是在基准备份过程中生成的 128 位 Unique ID。备份应用程序会在增量备份期间将此标识赋值给 SMTAPE_BACKUP_SET_ID 变量。 |
| SMTAPE_SNAPSHOT_NAME | 卷中可用的任何有效快照拷贝 | Invalid | 当 SMTAPE_SNAPSHOT_NAME 变量设置为某个快照拷贝，此快照拷贝及其较旧的快照拷贝均会备份到磁带。 对于增量备份，此变量指定增量快照拷贝。BASE_DATE 变量提供基准快照拷贝。 |
| SMTAPE_DELETE_SNAPSHOT | Y 或 N | N | 当 SMTAPE_DELETE_SNAPSHOT 变量设置为 Y 时，SMTape 将在备份操作完成时删除由其自动创建的快照拷贝，但不会删除由备份应用程序创建的快照拷贝。 |
| SMTAPE_BREAK_MIRROR | Y 或 N | N | 当 SMTAPE_BREAK_MIRROR 变量设置为 Y 时，DP 类型的卷将在成功恢复后更改为 RW 卷。 |