ctfile.cfg 文件

在线编辑

用途

控制各种 RSCT 组件的跟踪和日志记录。

描述

要启动跟踪和日志记录控制，系统管理员可以创建 RSCT 文件配置 (RFC) 文件 /etc/ctfile.cfg。 系统管理员可以将样本配置文件 /opt/rsct/cfg/ctfile.cfg复制到 /etc 目录，然后对其进行修改。 配置文件中的控制信息在下次启动指定的组件 (例如守护程序) 时生效。

支持跟踪和日志记录控制的 RSCT 组件 (在样本配置文件中列出) 从 /etc/ctfile.cfg获取以下信息:
  • 要在其下写入组件跟踪文件和日志文件的目录树的绝对路径。 此路径可以引用远程文件系统。
  • 指示是否对每个组件禁用跟踪的标志。
  • 指示是否对所有 RSCT 组件禁用跟踪的标志。
  • 启用跟踪时，每个组件和每个跟踪文件的跟踪文件大小。 某些组件写入多个跟踪文件。
  • 要跟踪的信息量。
  • 指示是否对每个组件禁用日志记录的标志。
  • 指示是否对所有 RSCT 组件禁用日志记录的标志。

将忽略仅包含字符 NL 或空格的行。 如果行的第一个非空格字符是数字符号字符 (#) ，那么该行是注释，因此将被忽略。 所有其他行都必须包含一个或多个标记。 如果一行上有多个令牌，那么这些令牌必须以空格分隔。 标记行可以包含前导空格或尾部空格。 空格是空格和制表符的任意组合。

The trace and log root directory token

跟踪和日志根目录令牌是名称/值对。 格式是：
CT_TRACE_LOG_ROOT_DIR=path_name
路径名必须是绝对路径名。 如果未指定此令牌，那么将假定跟踪和日志根目录为 /var/ct。 在任一情况下，都将使用跟踪和日志根目录作为路径名前缀来构造所有跟踪和日志文件路径名。

The trace disable token

跟踪禁用标记是后跟可选组件名称的名称/值对。 格式是：
CT_TRACE_DISABLE={true|false} [component_name]
可以多次指定此令牌，每个令牌在单独的行上指定。 如果未指定此令牌，那么将对引用此文件的所有组件启用跟踪，并且不会在另一个跟踪禁用令牌行中以其他方式指定跟踪。 如果使用值 true 指定此令牌，并且未指定组件名称，那么将对引用此文件的所有组件禁用跟踪，并且不会在另一个跟踪禁用令牌行中以其他方式指定跟踪。 如果使用值 false 指定此令牌，并且未指定任何组件名称，那么将对引用此文件的所有组件启用跟踪，并且不会在其他跟踪禁用令牌行中指定此跟踪。 如果指定了组件名称，那么将启用或禁用该组件的跟踪以分别与值 false 或 true 匹配。 对于组件，指定该组件的令牌行优先于未指定组件的任何令牌行。 如果多个令牌行指定同一组件，那么最后一个此类令牌行具有优先顺序。 组件名称是资源管理器 (派生自资源管理器 .mdef 文件) ， mc (对于 RMC 守护程序) 和 ctcasd (对于集群认证服务守护程序) 的资源管理器名称。 具体而言，组件名称必须是构造跟踪文件的完整路径名时使用的名称。 这里有个示例：
CT_TRACE_DISABLE=true
CT_TRACE_DISABLE=false mc
CT_TRACE_DISABLE=false IBM.MgmtDomainRM
对管理域资源管理器和 RMC 守护程序启用跟踪。 对于所有其他组件，将禁用跟踪。

The trace file size token

跟踪文件大小标记是后跟组件名称和跟踪文件名的名称/值对。 它具有以下格式:
CT_TRACE_FILE_SIZE=nnn[K] component_name file_name
其中 nnn 是指定跟踪文件的大小 (以字节计)。 如果指定了可选的 K 后缀，那么将以 1024 字节为单位指定大小。 RSCT 跟踪工具将文件大小向上舍入到页边界。 如果未指定跟踪文件大小标记，那么组件将使用编程到组件中的文件大小。

The trace level token

跟踪级别标记是后跟组件名称的名称/值对。 格式是：
CT_TRACE_LEVELS=string component_name
级别字符串采用标准跟踪工具格式，例如 Comp_ID :category = level。 如果未指定跟踪级别标记，那么组件将使用编程到组件中的跟踪级别。 跟踪级别确定跟踪文件中记录的信息量。

The logging disable token

日志记录禁用标记是后跟可选组件名称的名称/值对。 格式是：
CT_LOGGING_DISABLE={true|false} [component_name]
可以多次指定此令牌，每个令牌在单独的行上指定。 如果未指定此令牌，那么将对引用此文件的所有组件启用日志记录，并且不会在另一个日志记录禁用令牌行中另行指定。 如果使用值 true 指定此令牌，并且未指定任何组件名称，那么将对引用此文件的所有组件禁用日志记录，并且不会在其他日志记录禁用令牌行中指定此记录。 如果使用值 false 指定此令牌，并且未指定组件名称，那么将对引用此文件的所有组件启用日志记录，并且不会在另一个日志记录禁用令牌行中另行指定。 如果指定了组件名称，那么将启用或禁用该组件的日志记录以分别与值 false 或 true匹配。 对于组件，指定该组件的令牌行优先于未指定组件的任何令牌行。 如果多个令牌行指定同一组件，那么最后一个此类令牌行具有优先顺序。 组件名称是资源管理器 (派生自资源管理器的 .mdef 文件) ， mc (对于 RMC 守护程序) 和 ctcasd (对于集群认证服务守护程序) 的资源管理器名称。 具体而言，组件名称必须是用于构造日志记录文件的完整路径名的名称。

文件

/etc/ctfile.cfg
由系统管理员创建的 RSCT 文件配置 (RFC) 文件的位置
/opt/rsct/cfg/ctfile.cfg
样本 ctfile.cfg 文件的位置

实现细节

此文件是 Reliable Scalable Cluster Technology (RSCT) AIX® 的文件集的一部分。

位置

/etc/ctfile.cfg