lphistory 命令

在线编辑

用途

显示或清除已在当前资源监视和控制 (RMC) 会话期间运行的最小特权 (LP) 命令的历史记录列表。

语法

  • 要列示特定数量的先前发出的命令：
    • 在本地节点上：

      勒菲斯托里 [ 乌 用户标识 ] [ - mapped_ID ] [ -C 命令名 ] [ -S 命令路径 ] [ B MMddhhmmyyyy ] [ -E MMddhhmmyyyy ] [ -L a | c | e | m | n | t | u | x ] [-] [-电视] [记录数]

    • 在域内所有的节点上：

      lphistory -a [ -u 用户 ID ] [ -m 映射 ID ] [ -C 命令名 ] [ -S 命令路径 ] [ -B MMddhhmmyyyy ] [ -E MMddhhmmyyyy ] [ -L a | c | e | m | n | t | u | x ] [ -h ] [ -TV ] [ 记录数 ]

    • 在域内节点子集上：

      lphistory -n 主机 1 [ , host2...] [ -u 用户 ID ] [ -m 映射 ID ] [ -C 命令名 ] [ -S 命令路径 ] [ -B MMddhhmmyyyy ] [ -E MMddhhmmyyyy ] [ -L a | c | e | m | n | t | u | x ] [ -h ] [ -TV ] [ 记录数 ]

  • 要清除历史列表：
    • 在本地节点上：

      lphistory -c [ -u 用户 ID ] [ -m 映射 ID ] [ -C 命令名 ] [ -S 命令路径 ] [ -B MMddhhmmyyyy ] [ -E MMddhhmmyyyy ] [ -h ] [ -TV ]

    • 在域内所有的节点上：

      lphistory -c -a [ -u 用户 ID ] [ -m 映射 ID ] [ -C 命令名 ] [ -S 命令路径 ] [ -B MMddhhmmyyyy ] [ -E MMddhhmmyyyy ] [ -h ] [ -TV ]

    • 在域内节点子集上：

      lphistory -c -n 主机 1 [ , host2...] [ -u 用户 ID ] [ -m 映射 ID ] [ -C 命令名 ] [ -S 命令路径 ] [ -B MMddhhmmyyyy ] [ -E MMddhhmmyyyy ] [ -h ] [ -TV ]

描述

lphistory 命令列示已由最小特权资源管理器运行的 LP 命令的历史记录。 命令历史记录在 RSCT 审计日志中保留为记录。 缺省情况下，仅列示每条审计日志记录中的命令字符串（路径名加参数）。 -L 标志控制 lphistory 的输出格式；根据需要使用它来显示特定字段。 选择标志（-B、-C、-E、-m、-S 或 -u）控制传递至 lsaudrec 的选择字符串。

lphistory 命令采用一个可选参数：要列示的记录数量。 num_records 的缺省值为 10。 如果不使用任何选择标志，那么会列示审计日志中的最新记录数量（由 num_records 指定）。 否则，会列示一个或多个选择标志所选择的记录中的最新记录数量（由 num_records 指定）。 此选择过程适用于由 -a 标志或 -n 标志指定的每个节点上的审计记录。 如果既不指定 -a 也不指定 -n，那么该选择过程适用于本地节点上的审计记录。

-B 标志和 -E 标志采用时间戳记作为参数。 时间戳记的格式为 MMddhhmmyyyy，其中 MM 是由两位数构成的月份 (01-12)、dd 是由两位数构成的月份日期 (01-31)、hh 是由两位数构成的小时 (00-23)、mm 是由两位数构成的分钟 (00-59)，而 yyyy 是由四位数构成的年份。

可以对与标识相关的参数（user_ID 和 mapped_ID）以及命令名使用通配符 (%)。 % 可以放在字符串的开头或结尾，也可以放在字符串中的任何位置。 指定 command_path 时不能使用任何通配符。

可以使用 -c 标志来除去审计日志记录。 如果不指定任何选择标志，那么将除去最小特权资源管理器的所有审计日志记录。 否则，会除去一个或多个选择标志所选择的记录。 -c 标志不能与 -L 标志或 num_records 参数配合使用。

标志

-a
为域内所有节点显示先前发出的 LP 命令。

CT_MANAGEMENT_SCOPE 环境变量确定集群的作用域。 如果未设置 CT_MANAGEMENT_SCOPE，那么首先会选择管理域作用域（如果存在管理域），其次选择对等域作用域（如果存在对等域），最后选择本地作用域，直到作用域对于该命令有效为止。 该命令对找到的第一个有效域运行一次。 例如，如果既存在管理域，也存在对等域，并且未设置 CT_MANAGEMENT_SCOPE，那么此命令适用于管理域。 如果希望此命令适用于对等域，请将 CT_MANAGEMENT_SCOPE 设为 2。

不能将此标志与 -n 标志一起指定。

-B MMddhhmmyyyy
以格式 MMddhhmmyyyy 指定开始时间戳记，其中 MM 是由两位数构成的月份 (01-12)、dd 是由两位数构成的日期 (01-31)、hh 是由两位数构成的小时 (00-23)、mm 是由两位数构成的分钟 (00-59)，而 yyyy 是由四位数构成的年份。 时间可以从右向左截断，MM 除外。 如果没有指定所有位数，那么年缺省为当前年份、分钟缺省为 0、小时缺省为 0，而日期缺省为 01。 必须至少指定月份。 命令仅列示或除去当时或稍后创建的那些记录。
–c
清除 LP 命令的历史记录。 不能将此标志与 number_of_commands 参数或 -n 标志一起指定。
-C 命令名称
指定命令名。 lphistory -C 仅列出或删除包含 command_name 的记录，该记录是没有完全限定路径的命令的名称（例如 mkrsrc ）。 可以在 command_name 中使用通配符。
-E MMddhhmmyyyy
以格式 MMddhhmmyyyy 指定结束时间戳记，其中 MM 是由两位数构成的月份 (01-12)、dd 是由两位数构成的日期 (01-31)、hh 是由两位数构成的小时 (00-23)、mm 是由两位数构成的分钟 (00-59)，而 yyyy 是由四位数构成的年份。 时间可以从右向左截断，MM 除外。 如果没有指定所有位数，那么年缺省为当前年份、分钟缺省为 0、小时缺省为 0，而日期缺省为 01。 必须至少指定月份。 命令仅列示或除去当时或之前创建的那些记录。
-L a | c | e | m | n | t | u | x
缺省情况下，仅列示每条审计日志记录中的命令字符串（路径名加参数）。 如果指定此标志，那么参数是下列其中一个或多个字母；字段的显示顺序与字母在标志参数中的显示顺序相同。
a
以下列顺序显示审计日志中的所有字段：t、u、m、n、x 和 c（指定 -L a 等价于指定 -L tumnxc）
c
显示命令字符串（缺省值）
e
显示标准错误输出
m
显示已映射的标识
n
显示在其中运行该命令的节点的名称
t
显示时间字段
u
显示已认证的用户身份
x
显示 LP 命令退出状态

不能将此标志与 -c 标志一起指定。

-m 映射 ID
指定已映射的身份。 lphistory -m 仅列示或除去包含 mapped_ID 的那些记录。 可以在 mapped_ID 中使用通配符。
-n主机1 [ ， host2 ， …]
指定集群中要在其上检索或清除 LP 命令历史记录列表的一个或多个节点。 （缺省情况下，会检索或清除本地节点的历史记录列表。）

此标志仅在管理域或对等域中有效。 如果未设置 CT_MANAGEMENT_SCOPE 环境变量，那么首先会选择管理域作用域（如果存在管理域），然后选择对等域作用域，直到作用域对于该命令有效为止。 该命令对找到的第一个有效域运行一次。

不能将此标志与 -a 标志一起指定。

-S 命令路径
指定命令路径名。 lphistory -S 仅列出或删除包含 command_path 的记录，该记录与 LPCommands 类中的 CommandPath 的值相同（例如 /opt/rsct/bin/mkrsrc ）。 不能在 command_path 中使用通配符。
-u 用户名
指定已认证的用户身份。 lphistory -u 仅列示或除去包含 user_ID 的那些记录。 可以在 user_ID 中使用通配符。
-h
将命令的用法语句写到标准输出。
-T
将命令的跟踪消息写到标准错误。
-V
将命令的详细消息写到标准输出。

参数

记录数
指定要从历史记录列表显示的命令数量。 最少可以列示 1 个命令，最多可以列示 100 个命令。 缺省值为 10。 不能将此参数与 -c 标志一起指定。

安全性

要运行 lphistory 命令，需要 IBM.LPCommands 资源类的类 ACL 中的写许可权。 许可权在所连接系统的 LP ACL 中指定。 请参阅 lpacl 文件以获取有关 LP ACL 的常规信息，并参阅 RSCT Administration Guide 以获取有关修改这些 ACL 的信息。

退出状态

0
命令已成功运行。
1
RMC 发生错误。
2
命令行接口 (CLI) 脚本发生错误。
3
在命令行上指定了不正确的标志。
4
在命令行上指定了不正确的参数。
5
发生了一个由于不正确的命令行输入而导致的 RMC 错误。
6
未找到资源。

环境变量

CT_CONTACT
确定用来与 RMC 守护程序进行会话的系统。 当 CT_CONTACT 设置为主机名或 IP 地址时，该命令将联系指定主机上的 RMC 守护程序。 如果未设置 CT_CONTACT ，那么该命令将与运行该命令的本地系统上的 RMC 守护程序联系。 RMC 守护程序会话的目标和管理作用域确定了被处理的 LP 资源。
CT_MANAGEMENT_SCOPE
确定用来与 RMC 守护程序进行会话以处理 LP 资源的管理作用域。 管理作用域确定可以处理资源的可能目标节点集。 有效值为：
0
指定本地作用域。
1
指定本地作用域。
2
指定对等域作用域。
3
指定管理域作用域。

如果未设置此环境变量，那么使用本地作用域。

实现细节

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

标准输出

当指定 -h 标志时，此命令的用法语句将写入标准输出。 当指定 -V 标志时，此命令的详细消息将写入标准输出。

标准错误

所有跟踪消息都写到标准错误。

示例

  1. 要列示本地节点上先前发出的 20 个 LP 命令，请输入：
    lphistory 20
  2. 假设 nodeA 位于管理域中，并且 CT_MANAGEMENT_SCOPE 设置为 3。 要列出 nodeA上的 LP 命令历史记录，请输入:
    lphistory -c -n nodeA
  3. 要显示最后调用的 15 个 LP 命令以及时间、用户标识、映射标识、机制、返回码、标准错误、命令名以及命令字符串，请输入：
    lphistory -L a 15
  4. 要显示以 rsrc 结尾的 LP 命令名，请输入：
    lphistory -C %rsrc
  5. 要显示 2006 年 4 月 18 日下午 11 点 30 分之后调用的 LP 命令，请输入：
    lphistory -B 041823302006

位置

/opt/rsct/bin/lphistory
包含 lphistory 命令。