clffdc 命令

在线编辑

用途

从集群中的每个节点收集 SNAP 数据，并将 SNAP 数据存储在已启动此命令的节点上的单个方便集群快照 (csnap) 压缩 tar 文件中。 SNAP 数据包含在确定和解决系统问题时可能需要的配置信息。

语法

clffdc -c component [-l localCorrelator] [-p priority] [-v verbosity] [-f file] 
[-n lineNumber] [-g correlator] [-s]

描述

clffdc命令从集群感知AIX(CAA) 集群中的所有节点捕获快照数据。 当检测到严重问题时，操作系统可能会自动触发集群范围的 SNAP 操作。 可以使用 clffdc 命令来简化集群中的 SNAP 数据收集。

将在缺省目录中创建集群范围的 SNAP 文件。 对于 Virtual I/O Server (VIOS) 环境，集群范围的 SNAP 文件位于 /home/ios/logs/ssp_ffdc 目录中。 对于非 VIOS 环境，集群范围的 SNAP 文件位于 /var/adm/ras/cl_ffdc 目录中。

集群中的每个节点都将创建 SNAP 文件。 从每个节点中收集 SNAP 文件，并在已启动集群范围的 SNAP 操作的节点上合并为单个方便 csnap 文件。 csnap 文件名使用以下格式：

csnap_date_time_by_component_priority_ccorrelator.tar.gz

SNAP 文件名使用以下格式：

snap_date_time_by_component_priority_ccorrelator.tar.gz

一次只能执行单个集群范围的 SNAP 操作。 如果前一个集群范围的 SNAP 操作正在进行，那么无法启动新的集群范围的 SNAP 操作，直到前一个操作超时为止。 每个集群范围的 SNAP 操作都与 CAA 存储库磁盘上的相关因子值相关联。 当执行新的集群范围的 SNAP 操作时，此相关因子值就会增大。 如果启动集群范围的 SNAP 操作时不可访问存储库磁盘，那么不会生成 csnap 文件。 在这种情况下，每个节点将生成具有时间戳记的 SNAP 文件，但是未指定相关因子值。

如果集群范围的 SNAP 操作正在进行时已启动该集群范围的 SNAP 操作的节点脱机，那么每个节点都将创建 SNAP 文件，但是不会创建 csnap 文件。 如果集群范围的 SNAP 操作正在进行时非发起方节点脱机，那么该发起方节点在从可用节点中捕获 csnap 文件之前将等待超时。

新的发起方节点可以通过运行 clffdc -g 命令来收集 SNAP 文件。

-c， -f和 -n 标志用于标识代码中请求 SNAP 数据的位置 (如果 SNAP 文件是由 AIX 操作系统自动创建的)。 如果您手动收集 SNAP 数据，那么必须指定 -c 标志来标识在进行 SNAP 收集期间负责调用任何其他相关联的同伴组件的组件。

每个新的集群范围的 SNAP 操作将删除位于缺省目录中的旧 csnap 文件和旧 SNAP 文件。

标志

--c 分
指定已请求集群范围的 SNAP 操作的组件。 component 属性可以具有下列值：
  • CAA (集群感知 AIX)
  • RSCT (Reliable Scalable Cluster Technology)
  • VIOS (Virtual I/O Server)
  • POOL（共享存储池）
  • PHA (PowerHA SystemMirror)
  • FULL
注: FULL 值指示使用 snap -a 命令在每个节点上收集完整快照数据。 任何其他值指示在每个节点上收集的微型 SNAP 数据。 微型 SNAP 数据使用所指定的组件启动，并且包括与该组件相关联的所有伙伴组件。
-文件夹
指定已启动集群范围的 SNAP 操作的组件中的源文件名。 如果未指定文件名，那么缺省情况下会使用 clffdc.c 文件名。
--g 相关器
收集集群范围的 SNAP 文件。 收集操作将在每个节点上收集一系列具有所指定 correlator 值的 SNAP 文件，并在发起方节点上合并这些 SNAP 文件以创建单个 csnap 文件。 correlator 值被指定为十进制值。 此标志在与 -s 标志配合使用时很有用，或者当前一个集群范围的 SNAP 操作在可以生成 csnap 文件之前中断时，此标志很有用。

每个节点将生成具有所指定相关因子值的 SNAP 文件。 可以使用此标志来收集各个 SNAP 文件，并创建用于表示整个集群中的 SNAP 数据的 csnap 文件。

-l localCorrelator
请求在本地节点上执行 SNAP 操作。 localCorrelator 值是十进制格式的相关因子值，用来为获得的 SNAP 文件命名。
-优先权
指定集群范围的 SNAP 操作的优先级。 priority 属性可以具有下列值：
  • 1（高优先级）
  • 2（中等优先级）
  • 3（低优先级）
优先级用作所获得的 SNAP 文件和 csnap 文件中的名称的一部分。
-n lineNumber
指定请求了集群范围的 SNAP 操作的调用者的行号。
-s
启动分阶段的集群范围的 SNAP 收集。 分阶段的收集指示在每个节点上创建 SNAP 文件，但是并不收集到发起方节点上的 csnap 文件。 此标志在与 -g 标志配合使用时很有用，它会将 SNAP 文件收集到发起方节点上的单个 csnap 文件中。
-v verbosity
指定集群范围的 SNAP 操作的详细程度。 可以使用 -v 标志指定的可能值为 0 或 1。 您可以指定 1 以在集群范围的 SNAP 操作期间收集某些组件的更多信息。

退出状态

0
命令成功完成。
>0
发生问题。

示例

  1. 要收集与 CAA 组件相关联的中等优先级的集群范围的 SNAP 数据，请输入以下命令：
    clffdc -c CAA -p 2
    注: 在 VIOS 环境中，关联的组件为 CAA， RSCT， POOL和 VIOS。 在 PowerHA 环境中，相关联的组件为 CAA、RSCT 和 PHA。 所指定组件和每个相关联的同伴组件将收集集群范围的 SNAP 操作的 SNAP 数据。
  2. 要收集其中包含（由 snap -a 命令收集的）所有 SNAP 数据的低优先级的集群范围的 SNAP 数据，请输入以下命令：
    clffdc -c FULL -p 3
  3. 要启动与具有高优先级的 PHA 组件 (PowerHA SystemMirror) 关联的登台集群范围的 SNAP 操作，请输入以下命令:
    clffdc -c PHA -p 1 -s
  4. 要将每个节点上具有相关因子值 77 的 SNAP 文件收集到发起方节点上的单个方便 csnap 文件中，请输入以下命令：
    clffdc -g 77

文件

/usr/sbin/clffdc
包含 clffdc 命令。
/var/adm/ras/cl_ffdc
包含非 VIOS 环境中的 clffdc 命令输出。
/home/ios/logs/ssp_ffdc
包含 VIOS 环境中的 clffdc 命令输出。