ctsnap 命令

用途

收集有关 Reliable Scalable Cluster Technology (RSCT) 组件的配置、日志和跟踪信息。

语法

茨纳普 [ - ] [ -c cluster_name_pattern ] [ -C cluster_ID_pattern ] [ -d 输出目录 ] [ -D daemon_name_pattern ] [ -k stackdump_default ] [ -n node_name_pattern ] [ (N) node_ID_pattern ] [ -p | { -f 从日期 -t 至日期 } ] [ -s 假脱机目录 ] [ -S 大小 ] [ -x 鲁普特尔 ] [ - ] [ -z ]

描述

ctsnap 命令收集有关随 AIX® 或 PowerHA®一起安装的 RSCT 组件的配置,日志和跟踪信息。 此命令仅收集其运行所在的本地节点的数据。 根据安装的程序,可能会包括有关下列组件的信息:
  • 审计日志资源管理器 (IBM.AuditRM)
  • 集群安全服务 (ctsec)
  • 公共信息模型资源管理器 (IBM.CIMRM)
  • 配置资源管理器 (IBM.ConfigRM)
  • 事件管理 (ha_em)
  • 事件响应资源管理器 (IBM.ERRM)
  • 文件系统资源管理器 (IBM.FSRM)
  • 首次故障数据捕获 (ct_ffdc)
  • 组服务 (cthags)
  • 主机资源管理器 (IBM.HostRM)
  • 最低特权资源管理器 (IBM.LPRM)
  • 低级别应用程序编程接口 (lapi)
  • 管理域资源管理器IBM®.MgmtDomainRM)
  • Microsensor 资源管理器 (IBM.MicroSensorRM)
  • 恢复资源管理器 (IBM.RecoveryRM)
  • 资源监视和控制 (ctrmc)
  • 传感器资源管理器 (IBM.SensorRM)
  • 存储资源管理器 (IBM.StorageRM)
  • 拓扑服务 (cthats)
  • 虚拟共享磁盘 (vsd) (在 AIX 6.1上)
  • 可恢复虚拟共享磁盘 (rvsd) (在 AIX 6.1上)

如果其中的任何组件遇到问题,那么您都可以运行此命令以向软件服务组织提供相关信息。

ctsnap 命令的输出由压缩 tar 文件 (ctsnap.node_name.nnnnnnnn.tar.Z) 和日志文件 (ctsnap.node_name.nnnnnnnn.log) 组成,其中,node_namectsnap 在其上运行的节点的名称,nnnnnnnn 是运行 ctsnap 命令的时间戳记。 将这两个文件提供到您的软件服务组织。 缺省情况下,ctsnap 会将这些文件置于 /tmp/ctsupt 目录中。 使用 -d 标志指定其他输出目录。

如果需要,可以使用 ctsnap 收集有关假脱机的跟踪文件的信息。 使用 -c-C-D-f-n-N-p-s-S-t 标志可捕获跟踪信息的子集。 可以使用 ctsnap -k stackdump_default 命令为下列 RSCT 子系统生成堆栈转储:
  • 审计日志资源管理器 (IBM.AuditRM)
  • 公共信息模型资源管理器 (IBM.CIMRM)
  • 配置资源管理器 (IBM.ConfigRM)
  • 事件响应资源管理器 (IBM.ERRM)
  • 文件系统资源管理器 (IBM.FSRM)
  • 通用资源管理器 (IBM.GblResRM)
  • 组服务(cthags
  • 最低特权资源管理器 (IBM.LPRM)
  • Microsensor 资源管理器 (IBM.MicroSensorRM)
  • 恢复资源管理器 (IBM.RecoveryRM)
  • 资源监视和控制(ctrmc
  • 传感器资源管理器 (IBM.SensorRM)
  • 存储资源管理器 (IBM.StorageRM)
  • 拓扑服务(cthats

要格式化所有 RSCT 资源管理器的跟踪文件内容,请使用 -x 标志。

还可以使用 ctsnap 命令从 RSCT 文件配置文件 (ctfile.cfg) 获得跟踪和日志记录根目录。

标志

-a
仅收集与 Linux® 操作系统上的 High Availability Cluster Multi-Processing (HACMP) 集群相关的信息。
--c 集群名称模式
指定将跟踪收集限制为某些集群名称的选择模式。 将模式解析为 Perl-language 正则表达式。
--C 群组 ID 模式
指定将跟踪收集限制为某些集群标识的选择模式。 将模式解析为 Perl-language 正则表达式。
--d output_dir
指定输出目录。 缺省目录是 /tmp/ctsupt
--D 守护进程名称模式
指定将跟踪收集限制为某些守护程序的选择模式。 将模式解析为 Perl-language 正则表达式。
--f from_date
指定您要收集信息的日期。 from_date 参数的格式是:
yyyy-mm-dd[.hh[:mm[:ss]]] 
注:-f-t 标志结合使用。
-k stackdump_default
为这些 RSCT 子系统生成堆栈转储: cthags、"cthats"、"ctrmc"、"IBM.AuditRM"、"IBM.CIMRM"、"IBM.ConfigRM"、"IBM.ERRM"、"IBM.FSRM"、"IBM.GblResRM"、"IBM.LPRM"、"IBM.MicroSensorRM"、"IBM.RecoveryRM"、"IBM.SensorRM"和 "IBM.StorageRM
--n 节名模式
指定将跟踪收集限制为某些节点名称的选择模式。 将模式解析为 Perl-language 正则表达式。
--N Node_ID_pattern
指定将跟踪收集限制为某些节点标识的选择模式。 将模式解析为 Perl-language 正则表达式。
-
指定以前多少天值得收集假脱机跟踪信息。
--s spool_dir
捕获指定假脱机目录的跟踪文件。
--S 尺寸
指定要收集的所有跟踪文件的最大累积大小(以兆字节计)。
--t 至日期
指定要收集信息的日期。 to_date 参数的格式是:
yyyy-mm-dd[.hh[:mm[:ss]]] 
注:-t-f 标志结合使用。
-x runrpttr
格式化所有 RSCT 资源管理器的跟踪文件内容。

使用此标志可增加 ctsnap 输出文件的大小,因此,您可能需要增加包含输出目录的文件系统的大小。

-h
将命令的用法语句写到标准输出。
-z
即使在集群感知 AIX (CAA) 环境中,也会阻止收集 snap caa 信息。

安全性

只有 root 用户才能运行此命令。

退出状态

0
命令成功运行。
1
命令不成功。

标准输出

当指定 -h 标志时,此命令的用法语句将写入标准输出。

标准错误

错误消息将写入标准错误 (以及 ctsnap.host_name.nnnnnnnn.log 文件)。

实现细节

此命令是用于 AIX® 操作系统的 rsct.core.utils 文件集的一部分。

示例

  1. 要收集 RSCT 支持信息,请输入:
    ctsnap
  2. 要收集 RSCT 支持信息并将其放在 /tmp/mydir 目录中,请输入:
    ctsnap -d /tmp/mydir
  3. 要捕获 /opt/traces 目录的所有跟踪文件,请输入:
    ctsnap -s /opt/traces
  4. 要捕获配置资源管理器守护程序的 /opt/traces 目录的所有跟踪文件,请输入:
    ctsnap -s /opt/traces -D '.*ConfigRM.*' 
  5. 要捕获日期范围 08-28-200808-29-2008/opt/traces 目录的所有跟踪文件,请输入:
    ctsnap -s /opt/traces -f 08-28-2008 -t 08-29-2008
  6. 要捕获先前四天的 /opt/traces 目录的所有跟踪文件,请输入:
    ctsnap -s /opt/traces -p 4
  7. 要捕获 /opt/traces 目录的所有跟踪文件以获取最新的 50 MB 跟踪信息,请输入:
    ctsnap -s /opt/traces -S 50

位置

/opt/rsct/bin/ctsnap
包含 ctsnap 命令

文件

/tmp/ctsupt
包含输出文件的缺省目录的位置。
/tmp/ctsupt/ctsnap.host_name.nnnnnn.log
命令执行的日志文件的位置,其中 nnnnnnnn 是时间戳记,host_name 为命令在其上运行的主机的名称。
tmp/ctsupt/ctsnap.host_ name.nnnnnn。 tar.Z
包含所收集数据的压缩 tar 文件的位置,其中 nnnnnnnn 为时间戳记, host_name 为命令在其上运行的主机的名称。