/usr/cluster/bin/clsnmphost -V
/usr/cluster/bin/clsnmphost [subcommand] -?
/usr/cluster/bin/clsnmphostsubcommand [[options]] -v [host]
/usr/cluster/bin/clsnmphost add [-c community[,…]]
[-n node,…] host […]
/usr/cluster/bin/clsnmphost add -i {- | clconfigfile}
[-ccommunity[,…]] [-n node[,…]] host […]
/usr/cluster/bin/clsnmphost export [-o {- | clconfigfile}]
[-c community[,…]] [-n node[,…]] [+ | host…]
/usr/cluster/bin/clsnmphost list [-c community[,…]]
[-n node[,…]] [+ | host…]
/usr/cluster/bin/clsnmphost remove [-c community[,…]]
[-n node[,…]] {+ | host…}
/usr/cluster/bin/clsnmphost show [-c community[,…]]
[-n node[,…]] [+ | host…]
clsnmphost 命令可管理将接收 SNMP 事件通知的简单网络管理协议 (Simple Network Management Protocol, SNMP) 主机和团体名称。SNMP 主机使用群集管理信息库 (Management Information Base, MIB) 提供访问控制机制。当 MIB 发送 SNMP 陷阱通知时，使用此命令配置的 SNMP 主机可以确定要将陷阱通知发送到的主机。有关群集 MIB 的更多信息，请参见 clsnmpmib(1CL) 手册页。
此命令没有简短格式。
此命令的一般格式如下所示：
clsnmphost [subcommand] [options] [operands]
仅当 options 指定选项 –? 或 –V 时，才可以省略 subcommand。
此命令的每个选项都有长格式和简短格式两种格式。在本手册页“选项”部分给出了每个选项的两种格式，以及对该选项的描述。
有关更多信息，请参见 Intro(1CL) 手册页。
仅可以在全局区域中使用此命令。
支持以下子命令：
将 SNMP 主机添加到将接收群集 MIB 陷阱通知并可以访问 MIB 表的主机列表中。
仅可以在全局区域中运行该子命令。
如果在不带 –n 选项的情况下使用 add 子命令，则仅影响当前节点。如果在不带 –c 选项的情况下使用 add，则该子命令会使用 public 作为默认团体名称。使用 IP 地址或主机名指定主机。
如果指定的团体名称不存在，此命令将创建该团体。使用 –i 选项从 clconfigfile 导入一个或多个主机配置。
超级用户以外的用户需要具有 solaris.cluster.modify 基于角色的访问控制 (role–based access control, RBAC) 授权才能使用该子命令。请参见 rbac(5) 手册页。
导出指定节点的 SNMP 主机信息。
仅可以在全局区域中运行该子命令。
使用 –n 选项可指定一个或多个要导出其 SNMP 主机信息的节点。如果在不带 –n 选项的情况下使用 export，则该子命令将仅导出当前节点的 SNMP 主机信息。
有关 export 子命令的输出格式的更多信息，请参见 clconfiguration(5CL) 手册页。默认情况下，所有输出都会发送到标准输出。使用 –o 选项后跟文件名可将输出重定向到该文件。
通过使用 –c 选项，可以将 export 子命令的输出限定为仅与特定团体中主机相关的信息。将一个或多个主机指定为操作数可将输出信息限定为仅与这些主机相关的信息。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
列出在指定节点上配置的 SNMP 主机。
仅可以在全局区域中运行该子命令。
如果在不带 –n 选项的情况下使用 list 子命令，则仅列出当前节点上的 SNMP 主机。默认情况下，该子命令会列出节点上的所有主机。要将输出限定为与特定主机有关的信息，请将一个或多个主机指定为操作数。也可以使用 –c 选项仅列出指定团体中的这些主机。
superuser（超级用户）以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
从节点配置中删除一个 SNMP 主机。
仅可以在全局区域中运行该子命令。
要从配置中删除某个主机，必须将该主机名指定为操作数。如果在不带 –n 选项的情况下使用 remove 子命令，则仅删除当前节点上的 SNMP 主机。要删除所有主机，请使用加号 (+)。要从特定团体中删除一个或多个主机，请使用 –c 选项。
superuser（超级用户）以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
显示指定节点上的 SNMP 主机信息。
仅可以在全局区域中运行该子命令。
如果在不带 –n 选项的情况下使用 show 子命令，则仅显示当前节点上的 SNMP 主机信息。默认情况下，show 子命令会显示所有主机及其团体的信息。要将输出限定为仅与团体中特定主机相关的信息，请使用 –c 选项，或将一个或多个主机名指定为操作数。
superuser（超级用户）以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
支持以下选项：
显示帮助信息。
指定此选项时，子命令可有可无。
如果在不带子命令的情况下使用此选项，将会显示可用子命令的列表。
如果将该选项与子命令结合使用，将会显示该子命令的用法选项。
使用该选项时，不会执行任何其他处理。
指定将与主机名结合使用的 SNMP 团体名称。还可以将该选项与其他子命令结合使用以缩小子命令作用范围。例如，与 remove 子命令结合使用时，–c 选项可用于从特定 community 中删除一个或多个主机。如果使用不带 –c 选项的 add 子命令，该子命令会使用 public 作为默认团体名称。
指定可用于验证或修改 SNMP 主机配置的配置信息。此信息必须符合 clconfiguration(5CL) 手册页中定义的格式。此信息可包含在文件中或者通过标准输入提供。要指定标准输入，请指定减号 (-) 而不是文件名。
指定一个节点或一系列节点。可以使用节点名称或节点 ID 指定每个节点。clsnmphost 命令的所有格式都接受此选项。
以 clconfiguration(5CL) 手册页定义的格式写入群集 SNMP 主机配置信息。可以将此信息写入文件或标准输出中。
要写入标准输出，请指定减号 (-) 而不是文件名。如果指定标准输出，将抑制命令的所有其他标准输出。
如果提供文件名，配置会被复制到以该名称命名的新文件中。
–o 选项仅对 export 子命令有效。如果没有指定 –o 选项，输出将显示到标准输出。
显示该命令的版本。
不要将该选项与子命令、操作数或其他选项一起指定，因为子命令、操作数或其他选项会被忽略。–V 选项只显示命令的版本。不会执行任何其他操作。
将详细信息显示到标准输出。
可以将该选项与命令的任何格式一同指定，尽管一些子命令可能不会生成扩展输出。例如，指定详细选项时 export 子命令不会生成扩展输出。
支持以下操作数：
指定所有 SNMP 主机条目。
指定供访问群集上的 SNMP MIB 的主机的 IP 地址、IPv6 地址或名称。
如果命令对于所有指定的操作数均成功执行，则返回零 (CL_NOERR)。如果某个操作数出错，命令会继续处理操作数列表中的下一个操作数。返回的退出代码始终反映最先发生的错误。
此命令返回下列退出状态代码：
没有错误
您发出的命令已成功完成。
交换空间不足
某个群集节点耗尽了交换内存或其他操作系统资源。
参数无效
您键入的命令不正确，或者使用 –i 选项提供的群集配置信息语法不正确。
权限被拒绝
指定的对象不可访问。要发出命令，可能需要拥有超级用户或 RBAC 访问权限。有关更多信息，请参见 su(1M) 和 rbac(5) 手册页。
遇到内部错误
内部错误表示软件缺陷或其他缺陷。
I/O 错误
发生了物理输入/输出错误。
没有这样的对象
由于以下某个原因，找不到您所指定的对象：
该对象不存在。
您尝试使用 –o 选项创建的配置文件路径中的某个目录不存在。
您尝试使用 –i 选项访问的配置文件包含错误。
以下命令可将主机 myhost 添加到当前节点 private 上团体的 SNMP 主机列表中。
# clsnmphost add -c private phys-schost-1
将主机添加到 public 以外的其他团体时，必须指定团体名称。
示例 2 通过指定主机 IP 和 IPv6 地址添加主机以下命令可将主机添加到当前节点上团体 public 的 SNMP 主机列表中。该命令的首个版本通过指定主机的 IP 地址来添加主机。该命令的第二个版本通过指定主机的 IPv6 地址来添加主机。
# clsnmphost add -c public 192.168.12.12示例 3 删除主机or # clsnmphost add -c public fe:1::5
以下命令可从团体 private 中删除所有主机。
# clsnmphost remove -c private +示例 4 列出当前节点上的主机
以下命令可列出当前节点上的所有主机。
# clsnmphost list phys-schost-1 192.168.12.12示例 5 列出主机及其团体名称
以下命令使用详细选项 –v 列出当前节点上的所有主机及其团体名称。
# clsnmphost list -v --- SNMP hosts on node phys-schost-1 --- Host Name Community --------- --------- phys-schost-1 private 192.168.12.12 public示例 6 显示 SNMP 主机配置
以下命令可显示节点 phys-cluster-2 上 SNMP 主机的所有配置信息。
# clsnmphost show -n phys-schost-2 --- SNMP Host Configuration on phys-schost-2 --- SNMP Host Name: phys-schost-2 Community: private
有关下列属性的说明，请参见 attributes(5)：
|
clsnmpmib(1CL)、cluster(1CL)、Intro(1CL)、sceventmib(1M)、su(1M)、scha_calls(3HA)、attributes(5)、rbac(5)、clconfiguration(5CL)
超级用户可以运行此命令的所有格式。
所有用户都可以运行带有 –?（帮助）或 – V（版本）选项的此命令。
要运行带有其他子命令的 clsnmphost 命令，超级用户以外的用户需要具有 RBAC 授权。请参见下表。
|