Veritas NetBackup™ 命令参考指南

注册或创建产品日志配置设置。现有的全部日志设置将被覆盖。请不要使用该选项来向使用统一日志记录的那些日志设置列表添加产品。而是仅将此选项用于修改现有的统一日志记录设置。请参见示例。

提供应从中读取产品日志配置设置的绝对路径。

在 UNIX 系统上，使用产品日志配置文件的绝对路径（例如，/opt/vrts/ProductA/log.conf）。

在 Windows 系统上，使用产品日志注册表设置的路径（例如，\\SOFTWARE\VERITAS\PRODUCTA\）

如果没有为产品配置创建者 ID，则将从主日志记录配置文件中注销和删除产品日志配置设置。也将删除相应的产品日志配置文件。

创建或修改指定 LogSet 的日志配置设置。使用文本字符串 Default 或文本字符串 ALL 作为 LogSet。如果 LogSet 为 Default，则 –s 配置设置为默认设置。如果 LogSet 为 ALL，则 –s 配置设置适用于给定产品 ID 的所有创建者。

列出以下各项之一：

为产品指定缩写名称或简称。用逗号分隔多个名称。

对指定的创建者 ID 创建或修改日志配置设置。可以为创建者 ID 提供有效的创建者 ID（一个数字），或者文本字符串 Default 或文本字符串 ALL。如果创建者 ID 为 Default，则 –s 配置设置为默认设置。如果创建者 ID 为 ALL，则 –s 配置设置适用于给定产品 ID 的所有创建者。

创建或修改 productID 的日志配置设置。

不显示错误或提示性消息（静默模式）。

从产品日志记录的配置文件中注销和删除指定 OID 和产品的日志配置设置。可以用 -s, --setting keyname=value 选项删除单个设置。

当和 -a（添加选项）一起使用时，设置单个配置设置。keyname 是配置设置的名称，value 是该设置的值。可以在命令行上使用多个 -s keyname=value 参数。

当和 -r 选项一起使用时，删除配置设置。使用 -r 选项时仅使用一个键名。要删除多个设置，请提供多个 -s 选项。有关特定的键名，请参见“键名和值”部分。

显示此命令的版本信息。

提供目录的绝对路径或相对路径。无默认值。如果为创建者 ID 指定相对路径，该路径相对于产品 ID 日志目录（由日志配置文件中的 Default.LogDirectory 指定）。

设置调试日志消息的详细级别 （调试日志供 工程人员使用。（调试日志供 Veritas 工程人员使用。）有效值介于 0 到 6 之间。

设置诊断日志消息的详细级别（诊断日志供 NetBackup 管理员和用户使用。）有效值介于 0 到 6 之间。零 (0) 表示无调试消息。

动态重新加载调试和诊断设置。60 秒之后，重新加载 0-60 间的整数。大于 60 的整数在指定秒数重新加载。

将所有日志消息发送到标准输出（默认为终端）和日志文件。有效值为 true 和 false（默认值）。

将应用程序日志消息发送到 Stderr（默认为终端）和日志文件。有效值为 true 和 false（默认值）。

将应用程序日志消息发送到操作系统日志（UNIX 上为 syslog，Windows 上为事件日志）。有效值为 true 和 false（默认值）。

指定日志文件滚动的时间。如果滚动日志文件，则会关闭当前的日志文件并打开一个新文件。目的是使日志文件不致于太大，并可删除或存档较早的日志文件。有效值为 FileSize、LocalTime、Periodic、FileSize | LocalTime、FileSize | Periodic 和 None。

FileSize 表示当日志达到 MaxLogFileSizeKB 所设置的大小时开始回转。FileSize 是默认值。

LocalTime 表示日志文件每天应在 RolloverAtLocalTime 指定的时间回转一次。

Periodic 表示日志文件应在 RolloverAtLocalTime 指定的秒数后回转。

FileSize | LocalTime 表示当达到 FileSize 或 LocalTime 时（无论哪个先达到），将重新记录日志文件。

FileSize | Periodic 表示当达到 FileSize 或 Periodic 时（无论哪个先达到），将重新记录日志文件。

None 表示日志文件不滚动。

当 RolloverMode 设置为 FileSize 时，指定发生回转前允许的日志文件最大大小（以 KB 为单位）。有效值介于 1 到 4294967295 之间。默认值是 51200 (51.2 MB)。

当 RolloverMode 设置为 Periodic 时，指定日志文件开始回转前的时间段（以秒为单位）。有效值介于 1 到 2147483648 之间。默认值为 43200（12 小时）。

当 RolloverMode 设置为 LocalTime 时，指定一天中日志文件开始回转的时间。有效值为 00:00 到 23:59。默认值为 00:00（本地午夜时间）。

指定在日志目录中最多可为每个统一日志记录创建者保留的文件数。有效值介于 1 到 4294967295 之间。

vxlogmgr --auto 命令使用 NumberOfLogFiles 来确定要删除或移动的日志文件（从最早的文件开始）的数目。例如，一个日志目录包含 7 个由特定创建者创建的文件。 将 NumberOfLogFiles 设置为 5，vxlogmgr --auto --del 命令将删除该创建者创建的两个最早的文件。

有效值为 true 和 false。默认值为 false。如果为 true，则日志文件的数目不超过 NumberOfLogFiles。

为 -o 选项所指定的统一日志记录创建者指定一个或多个备用名称。当使用 vxlogview 命令执行搜索时，可以使用这些名称来替代创建者 ID。每个名称的最大长度为 80 个字符。可以指定多个名称，以空格分隔。

指定外部本地化库的绝对路径和文件名。此选项仅供 Veritas 内部使用。使用此选项可以禁用统一日志记录。

指定与统一日志记录产品或创建者关联的本地化资源的名称。此选项仅供 Veritas 内部使用。使用此选项可以禁用统一日志记录。

此设置指定与统一日志记录产品或创建者关联的本地化资源目录的名称。此选项仅供 Veritas 内部使用。使用此选项可以禁用统一日志记录。

一个八进制数，用于指定为日志文件（该日志文件是由 -o 选项所指定的创建者创建的）分配的 UNIX 文件权限。在大多数情况下，不需要使用此选项。

在将 LogToOslog 设置为 true 时，指定添加到每条 syslog 消息开头的字符串。SyslogIdent 可以是最多为 80 个字符的任何字符串。在大多数情况下，不需要使用此选项。

指定传递给 syslog openlog 函数的 syslog 选项值。在启用 LogToOslog 时，会将日志消息发送到 UNIX syslog。有效值介于 0 到 4294967295 之间。在大多数情况下，不需要使用此选项。

指定与发送到 syslog 的日志消息关联的 syslog 功能值。在启用 LogToSyslog 时，会将日志消息发送到 syslog。在大多数情况下，不需要使用此选项。

有效值包括：LOG_KERN、LOG_USER、LOG_MAIL、LOG_DAEMON、LOG_AUTH、LOG_LPR、LOG_NEWS、LOG_UUCP、LOG_CRON、LOG_LOCAL0、LOG_LOCAL1、LOG_LOCAL2、LOG_LOCAL3、LOG_LOCAL4、LOG_LOCAL5、LOG_LOCAL6 和 LOG_LOCAL7。默认值为 LOG_USER。

在启用了 LogToOslog 时，指定与发送到 Windows 事件日志的日志消息相关联的类别编号。在大多数情况下，不需要使用此选项。

指定 Windows 安全描述符定义语言 (SDDL) 字符串。此字符串可以为 -o 选项指定的创建者所创建的日志文件设置访问控制列表 (ACL)。在大多数情况下，不需要使用此选项。

在 Windows 上启用 LogToOslog 选项时，指定将日志消息发送到的 Windows 事件日志。此选项仅供内部使用。使用此选项可以禁用统一日志记录。