/usr/cluster/bin/cluster -V
/usr/cluster/bin/cluster [subcommand] -?
/usr/cluster/bin/cluster subcommand [options] -v [clustername …]
/usr/cluster/bin/cluster check [-F] [-C checkid[,…]]|-E checkid[,…]] [-e explorerpath[,…]] [-j jarpath[,…]] [-k keyword[,…]] [-n node[,…]] [-o outputdir] [-s severitylevel] [clustername]
/usr/cluster/bin/cluster create -i {- | clconfigfile} [clustername]
/usr/cluster/bin/cluster export [-o {- | configfile}] [-t objecttype[,…]] [clustername]
/usr/cluster/bin/cluster monitor-heartbeat [-v] [clustername]
/usr/cluster/bin/cluster list [clustername]
/usr/cluster/bin/cluster list-checks [-F] [-K] [-C checkid[,…]|-E checkid[,…]] [-j jar-path[,…]] [-o outputdir] [clustername]
/usr/cluster/bin/cluster list-cmds [clustername]
/usr/cluster/bin/cluster rename -c newclustername [clustername]
/usr/cluster/bin/cluster restore-netprops [clustername]
/usr/cluster/bin/cluster set {-p name=value} [-p name=value] […] [clustername]
/usr/cluster/bin/cluster set-netprops {-p name=value} [-p name=value] […] [clustername]
/usr/cluster/bin/cluster show [-t objecttype[,…]] [clustername]
/usr/cluster/bin/cluster show-netprops [clustername]
/usr/cluster/bin/cluster shutdown [-y] [-g graceperiod] [-m message] [clustername]
/usr/cluster/bin/cluster status [-t objecttype[,…]] [clustername]
cluster 命令显示和管理群集范围的配置和状态信息。此命令还可以关闭全局群集。
以下 cluster 子命令可以在区域群集中运行:
cluster show-列出区域群集、节点、资源组、资源类型和资源属性。
cluster status-显示区域群集组件的状态。
cluster shutdown-按顺序关闭区域群集。
cluster list-显示区域群集的名称。
cluster list-cmds-列出以下命令,支持在区域群集内使用这些命令:
clnode
clreslogicalhostname
clresource
clresourcegroup
clresourcetype
clressharedaddress
cluster
几乎所有与 cluster 命令一起使用的子命令都在群集模式下运行。您可以从群集的任何节点中运行这些子命令。但是,create、set-netprops 和 restore-netprops 子命令例外。您必须在非群集模式下运行这些子命令。
仅当 options 是 –? 选项或 –V 选项时,才可以省略 subcommand。
cluster 命令没有短格式。
每个选项都有长和短两种格式。在 选项 中给出每个选项的两种格式以及该选项的描述。
在全局区域中使用此命令。
支持以下子命令:
检查并报告是否正确配置了群集。
仅可以在全局区域中运行该子命令。
该子命令有以下三种模式:基本检查、交互式检查和功能检查。
基本检查在未指定 -k interactive 或 -k functional 关键字时运行。基本检查读取并评估某些配置信息,以确定可能的错误或未满足的要求。
交互式检查由 –k interactive 选项指定。如果未指定 –C–E 选项,则系统会运行所有可用的交互式检查。
交互式检查与基本检查类似,但交互式检查需要检查无法确定的用户的信息。例如,检查可能会提示用户指定固件版本。交互检查不会中断群集功能。
功能检查由 –k functional -Ccheckid 选项指定。–k functional 选项要求 –C 选项的功能检查的检查 ID 不得超过一个。–E 选项与 –k functional 选项一起使用时无效。
功能检查执行群集配置的特定功能或行为,例如触发故障转移或使节点发生紧急情况。这些检查需要用户输入提供某些群集配置信息(例如要故障转移到的节点),并确定是开始执行检查还是继续执行检查。
因为某些功能检查涉及到中断群集服务,所以在您阅读完检查的详细描述并确定是否要先使群集脱离生产环境之前,请勿启动任何功能检查。使用 cluster list-checks -v -C checkID 命令可以显示功能检查的完整描述。
当从运行的群集的活动成员发出该子命令时,该子命令会运行配置检查。这些检查可以确保群集满足成功运行该群集所需的最低要求。
当从没有作为活动群集成员运行的节点发出该子命令时,该子命令会在该节点上运行预安装检查。这些检查可以确定应当进行修复的漏洞,以做好准备安装群集并避免可能出现的可用性降低情况。
每个配置检查都会生成一组报告,这些报告保存在指定或默认的输出目录中。而每个报告都包含一个摘要,显示执行的检查总数以及失败次数(按严重级别分组)。
每个报告均以普通文本和 XML 这两种格式生成。XML 格式的 DTD 位于 /usr/cluster/lib/cfgchk/checkresults.dtd 文件中。生成的报告只有英文版本。
超级用户以外的用户需要具有 solaris.cluster.read 基于角色的访问控制 (Role-Based Access Control, RBAC) 授权才能使用该子命令。请参见 rbac(5) 手册页。
通过使用存储在 clconfigfile 文件中的配置信息创建新的群集。clconfiguration(5CL) 手册页中描述了该配置信息的格式。
仅可以在全局区域中运行该子命令。
您必须在非群集模式下运行该子命令。还必须从尚未配置为群集一部分的主机运行该子命令。Oracle Solaris Cluster 软件必须已安装在将要成为群集的一部分的每个节点上。
如果没有指定群集名称,则该群集的名称会取自 clconfigfile 文件。
超级用户以外的用户需要具有 solaris.cluster.modify 基于角色的访问控制 (Role-Based Access Control, RBAC) 授权才能使用该子命令。请参见 rbac(5) 手册页。
导出配置信息。
仅可以在全局区域中运行该子命令。
如果使用 –o 选项指定一个文件,则会将配置信息写入该文件。如果未指定 –o 选项,则会将输出写入标准输出 (stdout)。
以下选项限制了导出的信息:
仅导出指定类型的组件的配置信息。
仅可以导出在其上发出 cluster 命令的群集的配置信息。如果指定除了在其上发出 cluster 命令的群集以外的某群集的名称,该子命令会失败。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
显示群集的名称。
您可以在全局区域中或区域群集中使用该子命令。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
显示一个列表,其中包含每个可用检查的检查 ID 和说明。
仅可以在全局区域中使用此命令。
检查 ID 以指明检查类型的字母作为开头。
功能检查
交互式检查
多个节点上的基本检查
单个节点上的基本检查
–v 选项显示检查操作的详细信息,其中包括检查的关键字。显示功能检查的详细描述很重要,这样可以确定是否在运行该检查之前从生产环境中删除该群集。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
显示所有可用 Oracle Solaris Cluster 命令的列表。
您可以在全局区域中或区域群集中使用该子命令。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
在动态重新配置 (Dynamic Reconfiguration, DR) 期间手动为群集节点重新启用心跳超时监视。
仅可以在全局区域中运行该子命令。独占 IP 区域群集不支持 monitor-heartbeat 子命令。
对 CPU 或内存板执行 DR 操作时,受影响的节点将变得无响应,所以将在所有其他节点上暂停对该节点的心跳监视。DR 完成后,将自动重新启用对该受影响节点的心跳监视。如果 DR 操作未完成,您可能需要使用 monitor-heartbeat 子命令手动重新启用心跳监视。如果受影响的节点无法重新加入群集,将被取消群集成员资格。
有关重新启用心跳超时监视的说明,请参见Oracle Solaris Cluster 4.2 Hardware Administration Manual 中的Kernel Cage Dynamic Reconfiguration Recovery。有关 DR 的一般信息,请参见Oracle Solaris Cluster Concepts Guide 中的Dynamic Reconfiguration Support。
重命名群集。
仅可以在全局区域中使用此命令。
将 –c 选项与该子命令一起使用可为群集指定新的名称。
超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
重置群集的群集专用网络设置。
仅可以在全局区域中运行该子命令。您必须在非群集模式下运行该子命令。
仅当 set-netprops 子命令失败并存在以下条件时才使用该子命令:
您要尝试修改专用网络属性。
失败表明节点上的群集配置不一致。在这种情况下,需要运行 restore-netprops 子命令。
必须在群集的每个节点中运行该子命令。该子命令可以修复群集配置。该子命令还会删除因修改 IP 地址范围失败而导致的不一致性。如果失败,则为更改配置设置所做的任何尝试都不能保证正常进行。
超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
修改群集的属性。
仅可以在全局区域中运行该子命令。
超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
修改专用网络属性。
仅可以在全局区域中运行该子命令。
您必须在非群集模式下运行该子命令。但设置 num_zoneclusters 属性时,也可以在群集模式下运行该子命令。
超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
显示有关群集组件的详细配置信息。
仅可以在全局区域中运行该子命令。
以下选项限制了显示的信息:
仅显示指定类型的组件的配置信息。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
显示关于群集专用网络属性的信息。
仅可以在全局区域中运行该子命令。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
按顺序关闭全局群集。
仅可以在全局区域中运行该子命令。
如果在全局群集中发出该命令,则 Oracle Solaris Cluster 软件会关闭整个全局群集,包括与该全局群集关联的所有区域群集。不能在区域群集中使用 cluster 命令。
如果提供除了在其上发出 cluster 命令的群集以外的某群集的名称,该子命令会失败。
仅从群集中的某个节点运行该子命令。
该子命令将执行以下操作:
使群集中正在运行的所有资源组脱机。如果任何转换失败,该子命令将无法完成任务并显示一条错误消息。
卸载所有群集文件系统。如果卸载失败,该子命令将无法完成任务并显示一条错误消息。
关闭所有活动的设备服务。如果设备的任何转换失败,该子命令将无法完成任务并显示一条错误消息。
停止群集中的所有节点。
在该子命令开始关闭群集之前,它会在所有节点上发出一条警告消息。发出警告之后,该子命令会发出一条最终消息,提示您确认是否要关闭该群集。要阻止发出该最终消息,请使用 –y 选项。
默认情况下,shutdown 子命令会在关闭群集之前等待 60 秒。可以使用 –g 选项指定不同的延迟时间。
要指定与警告一起显示的消息字符串,请使用 –m 选项。
超级用户以外的用户需要具有 solaris.cluster.admin RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
显示群集组件的状态。
您可以在全局区域中或区域群集中使用该子命令。
选项 –t objecttype[,…] 仅显示指定类型的组件的状态信息。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。请参见 rbac(5) 手册页。
支持以下选项:
显示帮助信息。
指定此选项时,subcommand 可有可无。
如果没有指定 subcommand,将显示所有可用子命令的列表。
如果指定了 subcommand,将显示该子命令的用法。
如果指定此选项和其他选项,将会忽略其他选项。
指定要运行的检查。系统不会运行未指定的检查。如果 –E 选项与 –C 选项一起指定,则 –C 选项会被忽略。
对于 –k functional 关键字,需要使用 –C 选项并且必须仅指定一个要运行的 checkid ID。
此选项只能与 check 和 list-checks 子命令一起使用。
为群集指定新的名称。
将此选项与 rename 子命令一起使用可更改群集的名称。
指定要排除的检查。除了指定的那些检查,所有检查都在运行。如果 –C 选项与 –E 选项一起指定,则 –C 选项会被忽略。
–E 选项与 –k functional 关键字一起使用时无效。
此选项只能与 check 和 list-checks 子命令一起使用。
指定到已解压缩的 Oracle Explorer 或 Sun Explorer 归档的路径,用作系统的备用数据源。explorerpath 的值必须是全限定路径位置。
此选项只能与 check 子命令一起使用。
忽略 /var/cluster/logs/cluster_check/cfgchk.lck 文件(如果存在),强制执行该子命令。仅当确定未运行 check 和 list-checks 子命令时,才使用该选项。
在依据默认设置 60 秒关闭群集之前更改时间。
指定 graceperiod(秒)。
使用 clconfigfile 文件中的配置信息。请参见 clconfiguration(5CL) 手册页。
要通过标准输入 ( stdin) 提供配置信息,请使用破折号 (-) 指定该选项。
如果指定其他选项,则这些选项优先于群集配置文件中的选项和信息。
指定到包含检查的其他 jar 文件的路径。 jarpath 必须是全限定路径。
此选项只能与 check 和 list-checks 子命令一起使用。
列出可用检查中的所有关键字。此选项会覆盖所有其他选项。
此选项只能与 list-checks 子命令一起使用。
仅运行包含指定关键字的检查。使用 cluster list-checks -k 命令可以确定分配给可用检查的关键字。
–k functional 关键字需要 –C 选项具有单个 checkid。您不能一次指定多个功能检查或者在同一命令中指定任何其他关键字。
此选项只能与 check 和 list-checks 子命令一起使用。
指定要与发出 shutdown 子命令时显示的警告一起显示的消息字符串。
标准警告消息是 system will be shut down in …。
如果message包含多个单词,请使用单引号 (') 或双引号 (“) 标记将其隔开。 shutdown 命令会在群集关闭前 7200、3600、1800、1200、600、300、120、60 和 30 秒发出消息。
仅在指定的节点或一组节点上运行检查。node 的值可以是节点名称,也可以是节点 ID 号。
此选项只能与 check 子命令一起使用。
将群集配置信息写入一个文件或标准输出 (stdout)。clconfiguration(5CL) 手册页中描述了该配置信息的格式。
如果您使用该选项指定文件名称,该选项将创建新的文件。然后将配置信息置于该文件中。如果您使用该选项指定 -,则会将配置信息发送到标准输出 (stdout)。命令的所有其他标准输出将受到抑制。
此格式的 –o 选项只能与 export 子命令一起使用。
指定要将 check 子命令生成的报告保存到的目录。
此格式的 –o 选项只能与 check 和 list-checks 子命令一起使用。
必须已存在或能够创建输出目录 outputdir。位于 outputdir 中的先前报告会被新的报告覆盖。
如果未指定 –o 选项,则目录 /var/cluster/logs/cluster_check/datestamp/ 会默认用作 outputdir。
修改群集范围的属性。
允许使用多个 –p name= value 实例。
将此选项与 set 和 set-netprops 子命令一起使用可修改以下属性:
指定资源组管理器 (Resource Group Manager, RGM) 跨可用节点分布资源组负载的方式。仅可以在全局群集中设置 concentrate_load 属性。在区域群集中,concentrate_load 属性的默认值为 FALSE。 如果将该值设置为 FALSE,则 RGM 会尝试将资源组负载均匀地分布到该资源组的节点列表中列出的所有可用节点或区域上。如果在全局群集中将该值设置为 TRUE,则资源组负载会在不超过任何配置的硬负载限制或软负载限制的情况下集中分布到尽可能少的节点或区域上。默认值为 FALSE。
如果资源组 RG2 对资源组 RG1 声明了 ++ 或 +++ 关联,请避免为 RG2 设置任何非零负载因子。而应为 RG1 设置较大的负载因子,以抵偿 RG2 在与 RG1 相同的节点上联机时施加的额外负载。这样可使 Concentrate_load 功能按预期方式工作。或者,可以对 RG2 设置负载因子,但是避免对这些负载因子设置任何硬负载限制;请仅设置软限制。这样 RG2 在超出软负载限制的情况下也能联机。
每个节点的硬负载和软负载限制均使用 clnode create-loadlimit、clnode set-loadlimit 和 clnode delete-loadlimit 命令创建和修改。有关说明,请参见 clnode(1CL) 手册页。
为所有共享设备指定全局默认隔离算法。
该属性可以接受的值为 nofencing、nofencing-noscrub、pathcount 或 prefer3。
检查和删除任何永久性组保留 (Persistent Group Reservation, PGR) 密钥之后,nofencing 设置会关闭共享设备的隔离功能。
nofencing-noscrub 设置可以关闭共享设备的隔离功能,无需首先检查或删除 PGR 密钥。
pathcount 设置根据附加到共享设备的 DID 路径的数目确定隔离协议。对于使用不少于 3 个 DID 路径的设备,该属性设置为 SCSI-3 协议。
prefer3 设置为所有设备的设备隔离功能指定 SCSI-3 协议。pathcount 设置已指定给不支持 SCSI-3 协议的所有设备。
默认情况下,该属性已设置为 prefer3。
定义发送心跳的频率(毫秒)。
默认情况下,Oracle Solaris Cluster 软件使用的心跳量程为 1 秒(或 1,000 毫秒)。指定一个介于 100 和 10,000 毫秒之间的值。
定义时间间隔(毫秒),在这段时间之后,如果没有从同级节点接收到任何心跳,则相应路径会声明为关闭。
默认情况下,Oracle Solaris Cluster 软件使用的心跳超时时间为 10 秒(或 10,000 毫秒)。指定一个介于 2,500 和 60,000 毫秒之间的值。
通过 set 子命令,可以跨所有适配器修改群集的全局心跳参数。
Oracle Solaris Cluster 软件依靠专用互连上的心跳检测群集节点之间的通信故障。如果减少心跳超时时间,Oracle Solaris Cluster 软件可以更快地检测故障。减少心跳超时时间值时检测故障所需的时间也会减少。因此,Oracle Solaris Cluster 软件可以更快地从故障中恢复。更快的恢复会提高群集的可用性。
使用 set 子命令减小心跳参数的值时,即使在理想条件下,也始终存在可能发生可疑路径超时和节点紧急情况的风险。始终测试并全面将心跳参数的较低值限定在相关工作负载条件之下后,才能在群集中真正实施这些值。
为 heartbeat_timeout 指定的值必须始终大于或等于为 heartbeat_quantum 指定的值的五倍 (heartbeat_timeout >= (5* heartbeat_quantum))。
指定群集的安装模式设置。可以为 installmode 属性指定 enabled 或 disabled。
当 installmode 属性处于启用状态时,节点不会尝试在引导时重置其法定配置。并且,在这种模式下,很多管理功能都被阻止。首次安装群集时,installmode 属性处于启用状态。
在所有节点首次加入群集并且共享法定设备已添加到配置中之后,您必须明确禁用 installmode 属性。禁用 installmode 属性之后,法定投票计数会设置为默认值。如果在创建群集期间自动配置了法定设备,则 installmode 属性也会在配置法定设备之后被禁用。
指定 RGM 资源执行程序所用的安全策略。允许的 resource_security 值为 SECURE、WARN、OVERRIDE 或 COMPATIBILITY。
Start 和 Validate 之类的资源方法始终以 root 用户身份运行。如果方法可执行文件不归 root 所有或具有组或全局写权限,将存在不安全状况。在这种情况下,如果 resource_security 属性设置为 SECURE,在运行时资源方法执行将失败并返回错误。如果 resource_security 设置为任何其他值,将允许资源方法执行,但显示警告消息。为了最大限度地保证安全性,请将 resource_security 设置为 SECURE。
resource_security 设置还会修改声明了 application_user 资源属性的资源类型的行为。声明了 application_user 资源属性的资源类型通常是一个代理,该代理使用 scha_check_app_user(1HA ) 接口对应用程序可执行文件的所有权和权限执行额外的检查。有关更多信息,请参见 r_properties(5) 手册页的 application_user 部分。
指定时间间隔(秒),超过该间隔后所有非活动的 UDP 会话都会被删除。
(可选)可以将该属性设置为任意整数。
该属性仅应用于 UDP 服务以及启用了循环负载平衡方案的负载平衡策略 Lb_weighted。
默认情况下,该属性已设置为 480 秒(8 分钟)。
仅可以使用 set-netprops 子命令修改专用网络属性。
仅当默认的专用网络地址与某个已经在使用的地址发生冲突时,才必须修改这些专用网络设置。当现有地址范围不足以满足持续增长的群集配置时,也必须修改这些专用网络设置。
修改网络属性时,期望群集的所有节点都可用并且位于非群集模式下。仅在群集的某一个节点上修改专用网络设置,因为设置会被传播到所有节点。
设置 private_netaddr 属性时,还可以设置 private_netmask 属性或 max_nodes 和 max_privatenets 属性,或者所有属性。如果尝试设置 private_netmask 属性以及 max_nodes 或 max_privatenets 属性,将出现一个错误。您必须始终同时设置 max_nodes 和 max_privatenets 这两个属性。
默认专用网络地址为 172.16.0.0,其默认网络掩码为 255.255.240.0。
如果因群集配置不一致而无法设置属性,请在非群集模式下,在每个节点上运行 cluster restore-netprops 命令。
专用网络属性如下所示:
指定您希望成为群集一部分的节点的最大数量。该属性只能通过结合 private_netaddr 和 max_privatenets 属性(或 private_netmask 属性)来设置。max_nodes 的最大值为 64。最小值为 2。
指定您希望在群集中使用的专用网络的最大数量。仅可以结合 private_netaddr 和 max_nodes 属性(或 private_netmask 属性)设置该属性。max_privatenets 的最大值为 128。最小值为 2。
指定要为全局群集配置的区域群集的数量。Oracle Solaris Cluster 软件组合使用该值、节点数和为全局群集指定的专用网络数来计算专用网络的网络掩码。
Oracle Solaris Cluster 软件使用专用网络的网络掩码来确定保留给群集使用的专用网络 IP 地址的范围。
可以在群集模式或非群集模式下设置该属性。
如果不为该属性指定值,默认设置为 12。可以为该属型指定 0。
指定专用网络地址。
指定群集专用网络掩码。在这种情况下指定的值必须大于或等于默认的网络掩码 255.255.240.0。仅可以结合 private_netaddr 属性设置该属性。
如果要分配比默认地址范围更小的 IP 地址范围,可以改用除 private_netmask 属性之外的属性或者 max_nodes 和 max_privatenets 属性。
指定可以对物理群集配置的独占 IP 区域群集的数量。该命令会调用名为 modify_xip_zc 的 shell 脚本,然后使用可配置的独占 IP 区域群集的数量对应的条目更新 clprivnet 配置文件。num_xip_zoneclusters 属性必须是 num_zoneclusters 属性的子集。
对于专用网络属性的每种组合,该命令将执行以下任务:
该命令将默认网络掩码 255.255.240.0 分配给专用互连。默认 IP 地址范围最多可以容纳 64 个节点和 10 个专用网络。
如果指定的网络掩码小于默认网络掩码,则该命令会失败然后退出,并显示一条错误消息。
如果指定的网络掩码大于或等于默认的网络掩码,则该命令会将指定的网络掩码分配给专用互连。生成的 IP 地址范围最多可以容纳 64 个节点和 10 个专用网络。
要分配比默认地址范围更小的 IP 地址范围,可以改用除 private_netmask 属性之外的属性或者 max_nodes 和 max_privatenets 属性。
该命令可以计算能够支持指定数量的节点和专用网络的最小网络掩码。该命令随后将计算的网络掩码分配给专用互连。该命令还指定可以对物理群集配置的独占 IP 区域群集的数量。
该命令可以计算能够支持指定数量的节点和专用网络的最小网络掩码。
该命令会将计算结果与指定的网络掩码进行比较。如果指定的网络掩码小于计算的网络掩码,则该命令会失败然后退出,并显示一条错误消息。如果指定的网络掩码大于或等于计算的网络掩码,则该命令会将指定的网络掩码分配给专用互连。
仅报告级别至少为 severitylevel 的违规。
此选项只能与 check 子命令一起使用。
每个检查都分配有一个严重级别。指定严重级别可以从报告中排除严重级别较轻的失败检查。severity 的值是按最低到最高严重级别顺序列出的以下值之一:
没有指定该选项时,会默认使用 information 严重级别。严重级别 information 表明所有严重级别的失败检查都将包括在报告中。
指定 export、show 和 status 子命令的对象类型。
使用该选项可以将 export、show 和 status 子命令的输出仅限制到指定类型的对象。支持以下对象或组件类型。请注意,对某些对象类型而言,状态并不适用。
|
在标准输出 (stdout) 中显示详细信息。与 check 子命令一起使用时,显示执行期间的详细进度。与 list-checks 子命令一起使用时,提供关于检查的更多详细信息。
显示该命令的版本。
如果是与其他选项、子命令或操作数一起指定该选项,将忽略所有这些内容。仅显示该命令的版本。不会发生任何其他处理。
禁止发出用于询问您是否确认要关闭的提示. 群集会立即关闭,无需用户干预。
支持以下操作数:
要管理的群集的名称。
对于除了 create 以外的所有子命令,您指定的 clustername 必须与您在其上发出 cluster 命令的群集的名称匹配。
使用 create 子命令指定新的唯一群集名称。
Intro(1CL) 手册页列出了该命令集中所有命令的一整套退出状态代码。返回的退出代码还与 scha_calls(3HA) 手册页中介绍的返回代码兼容。
如果命令对于所有指定的操作数均成功执行,则返回零 (CL_NOERR)。如果某个操作数出错,命令会继续处理操作数列表中的下一个操作数。返回的退出代码始终反映最先发生的错误。
此命令返回下列退出状态代码:
没有错误
您发出的命令已成功完成。
交换空间不足
某个群集节点耗尽了交换内存或其他操作系统资源。
参数无效
您键入的命令不正确,或者使用 –i 选项提供的群集配置信息语法不正确。
权限被拒绝
指定的对象不可访问。要发出命令,可能需要拥有超级用户或 RBAC 访问权限。有关更多信息,请参见 su(1M) 和 rbac(5) 手册页。
I/O 错误
发生了物理输入/输出错误。
没有这样的对象
由于以下某个原因,找不到您所指定的对象:
该对象不存在。
您尝试使用 –o 选项创建的配置文件路径中的某个目录不存在。
您尝试使用 –i 选项访问的配置文件包含错误。
此外,check 子命令在其放置检查报告的同一输出目录中创建名为 cluster_check_exit_code.log 的文本文件。如果该子命令本身退出 CL_NOERR,则会在该文件中报告一个代码,指出所有违规检查的最高严重级别。以下是可能的检查代码:
未报告任何违规。报告中可能存在严重级别为 information 或 warning 的检查输出。
critical
high
medium
low
以下命令可显示所有可用的群集配置信息。
# cluster show === Cluster === Cluster Name: schost clusterid: 0x4FA7C35F installmode: disabled heartbeat_timeout: 9999 heartbeat_quantum: 1000 private_netaddr: 172.16.0.0 private_netmask: 255.255.240.0 max_nodes: 64 max_privatenets: 10 num_zoneclusters: 12 udp_session_timeout: 480 concentrate_load: True resource_security: SECURE global_fencing: prefer3 Node List: phys-schost-1, phys-schost-2 === Host Access Control === Cluster name: schost Allowed hosts: None Authentication Protocol: sys === Cluster Nodes === Node Name: phys-schost-1 Node ID: 1 Enabled: yes privatehostname: clusternode1-priv reboot_on_path_failure: disabled globalzoneshares: 1 defaultpsetmin: 1 quorum_vote: 1 quorum_defaultvote: 1 quorum_resv_key: 0x4FA7C35F00000001 Transport Adapter List: net3, net1 Node Name: phys-schost-2 Node ID: 2 Enabled: yes privatehostname: clusternode2-priv reboot_on_path_failure: disabled globalzoneshares: 1 defaultpsetmin: 1 quorum_vote: 1 quorum_defaultvote: 1 quorum_resv_key: 0x4FA7C35F00000002 Transport Adapter List: net3, net1 === Transport Cables === Transport Cable: phys-schost-1:net3,switch1@1 Endpoint1: phys-schost-1:net3 Endpoint2: switch1@1 State: Enabled Transport Cable: phys-schost-1:net1,switch2@1 Endpoint1: phys-schost-1:net1 Endpoint2: switch2@1 State: Enabled Transport Cable: phys-schost-2:net3,switch1@2 Endpoint1: phys-schost-2:net3 Endpoint2: switch1@2 State: Enabled Transport Cable: phys-schost-2:net1,switch2@2 Endpoint1: phys-schost-2:net1 Endpoint2: switch2@2 State: Enabled === Transport Switches === Transport Switch: switch1 State: Enabled Type: switch Port Names: 1 2 Port State(1): Enabled Port State(2): Enabled Transport Switch: switch2 State: Enabled Type: switch Port Names: 1 2 Port State(1): Enabled Port State(2): Enabled === Quorum Devices === Quorum Device Name: d4 Enabled: yes Votes: 1 Global Name: /dev/did/rdsk/d4s2 Type: shared_disk Access Mode: scsi3 Hosts (enabled): phys-schost-1, phys-schost-2 === Device Groups === === Registered Resource Types === Resource Type: SUNW.LogicalHostname:4 RT_description: Logical Hostname Resource Type RT_version: 4 API_version: 2 RT_basedir: /usr/cluster/lib/rgm/rt/hafoip Single_instance: False Proxy: False Init_nodes: All potential masters Installed_nodes: <All> Failover: True Pkglist: <NULL> RT_system: True Global_zone: True Resource Type: SUNW.SharedAddress:2 RT_description: HA Shared Address Resource Type RT_version: 2 API_version: 2 RT_basedir: /usr/cluster/lib/rgm/rt/hascip Single_instance: False Proxy: False Init_nodes: <Unknown> Installed_nodes: <All> Failover: True Pkglist: <NULL> RT_system: True Global_zone: True === Resource Groups and Resources === === DID Device Instances === DID Device Name: /dev/did/rdsk/d1 Full Device Path: phys-schost-2:/dev/rdsk/ c0t600A0B8000485B6A000058584EDCBD7Ed0 Full Device Path: phys-schost-1:/dev/rdsk/ c0t600A0B8000485B6A000058584EDCBD7Ed0 Replication: none default_fencing: global DID Device Name: /dev/did/rdsk/d2 Full Device Path: phys-schost-2:/dev/rdsk/ c0t600A0B8000485B6A0000585A4EDCBDA4d0 Full Device Path: phys-schost-1:/dev/rdsk/ c0t600A0B8000485B6A0000585A4EDCBDA4d0 Replication: none default_fencing: global DID Device Name: /dev/did/rdsk/d3 Full Device Path: phys-schost-2:/dev/rdsk/ c0t600A0B8000485B6A0000585C4EDCBDCAd0 Full Device Path: phys-schost-1:/dev/rdsk/ c0t600A0B8000485B6A0000585C4EDCBDCAd0 Replication: none default_fencing: global DID Device Name: /dev/did/rdsk/d4 Full Device Path: phys-schost-2:/dev/rdsk/ c0t600A0B8000485B6A0000585E4EDCBDF1d0 Full Device Path: phys-schost-1:/dev/rdsk/ c0t600A0B8000485B6A0000585E4EDCBDF1d0 Replication: none default_fencing: global DID Device Name: /dev/did/rdsk/d5 Full Device Path: phys-schost-2:/dev/rdsk/ c0t600A0B8000485B6A000058604EDCBE1Cd0 Full Device Path: phys-schost-1:/dev/rdsk/ c0t600A0B8000485B6A000058604EDCBE1Cd0 Replication: none default_fencing: global DID Device Name: /dev/did/rdsk/d6 Full Device Path: phys-schost-2:/dev/rdsk/ c0t600A0B8000486F08000073014EDCBED0d0 Full Device Path: phys-schost-1:/dev/rdsk/ c0t600A0B8000486F08000073014EDCBED0d0 Replication: none default_fencing: global DID Device Name: /dev/did/rdsk/d7 Full Device Path: phys-schost-2:/dev/rdsk/ c0t600A0B8000486F08000073034EDCBEFAd0 Full Device Path: phys-schost-1:/dev/rdsk/ c0t600A0B8000486F08000073034EDCBEFAd0 Replication: none default_fencing: global DID Device Name: /dev/did/rdsk/d8 Full Device Path: phys-schost-2:/dev/rdsk/ c0t600A0B8000486F08000073054EDCBF1Fd0 Full Device Path: phys-schost-1:/dev/rdsk/ c0t600A0B8000486F08000073054EDCBF1Fd0 Replication: none default_fencing: global DID Device Name: /dev/did/rdsk/d9 Full Device Path: phys-schost-2:/dev/rdsk/ c0t600A0B8000486F08000073074EDCBF46d0 Full Device Path: phys-schost-1:/dev/rdsk/ c0t600A0B8000486F08000073074EDCBF46d0 Replication: none default_fencing: global DID Device Name: /dev/did/rdsk/d10 Full Device Path: phys-schost-2:/dev/rdsk/ c0t600A0B8000486F08000073094EDCBF71d0 Full Device Path: phys-schost-1:/dev/rdsk/ c0t600A0B8000486F08000073094EDCBF71d0 Replication: none default_fencing: global DID Device Name: /dev/did/rdsk/d11 Full Device Path: phys-schost-1:/dev/rdsk/c3t0d0 Replication: none default_fencing: global DID Device Name: /dev/did/rdsk/d12 Full Device Path: phys-schost-1:/dev/rdsk/c4t0d0 Replication: none default_fencing: global DID Device Name: /dev/did/rdsk/d13 Full Device Path: phys-schost-1:/dev/rdsk/c4t1d0 Replication: none default_fencing: global DID Device Name: /dev/did/rdsk/d14 Full Device Path: phys-schost-2:/dev/rdsk/c3t0d0 Replication: none default_fencing: global DID Device Name: /dev/did/rdsk/d15 Full Device Path: phys-schost-2:/dev/rdsk/c4t0d0 Replication: none default_fencing: global DID Device Name: /dev/did/rdsk/d16 Full Device Path: phys-schost-2:/dev/rdsk/c4t1d0 Replication: none default_fencing: global === NAS Devices === Nas Device: qualfugu Type: sun_uss userid: osc_agent === Zone Clusters === Zone Cluster Name: zc1 zonename: zc1 zonepath: /zones/zc1 autoboot: TRUE brand: solaris10 bootargs: <NULL> pool: <NULL> limitpriv: <NULL> scheduling-class: <NULL> ip-type: shared enable_priv_net: TRUE resource_security: COMPATIBILITY --- Solaris Resources for zc1 --- Resource Name: net address: schost-1 physical: auto Resource Name: net address: schost-2 physical: auto --- Zone Cluster Nodes for zc1 --- Node Name: phys-schost-1 physical-host: phys-schost-1 hostname: vzschost1a --- Solaris Resources for phys-schost-1 --- Node Name: phys-schost-2 physical-host: phys-schost-2 hostname: vzschost2a --- Solaris Resources for phys-schost-2 --- Zone Cluster Name: zc2 zonename: zc2 zonepath: /zones/zc2 autoboot: TRUE brand: solaris bootargs: <NULL> pool: <NULL> limitpriv: <NULL> scheduling-class: <NULL> ip-type: shared enable_priv_net: TRUE resource_security: COMPATIBILITY --- Solaris Resources for zc2 --- --- Zone Cluster Nodes for zc2 --- Node Name: phys-schost-1 physical-host: phys-schost-1 hostname: vzschost1b --- Solaris Resources for phys-schost-1 --- Node Name: phys-schost-2 physical-host: phys-schost-2 hostname: vzschost2b --- Solaris Resources for phys-schost-2 --- Zone Cluster Name: zc3 zonename: zc3 zonepath: /zones/zc3 autoboot: TRUE brand: solaris bootargs: <NULL> pool: <NULL> limitpriv: <NULL> scheduling-class: <NULL> ip-type: shared enable_priv_net: TRUE resource_security: COMPATIBILITY --- Solaris Resources for zc3 --- --- Zone Cluster Nodes for zc3 --- Node Name: phys-schost-2 physical-host: phys-schost-2 hostname: vzschost1c --- Solaris Resources for phys-schost-2 ---示例 2 显示关于选定群集组件的配置信息
以下命令可显示关于资源、资源类型以及资源组的信息。仅显示关于群集的信息。
# cluster show -t resource,resourcetype,resourcegroup Single_instance: False Proxy: False Init_nodes: <Unknown> Installed_nodes: <All> Failover: True Pkglist: <NULL> RT_system: True Resource Type: SUNW.qfs RT_description: SAM-QFS Agent on SunCluster RT_version: 3.1 API_version: 3 RT_basedir: /opt/SUNWsamfs/sc/bin Single_instance: False Proxy: False Init_nodes: All potential masters Installed_nodes: <All> Failover: True Pkglist: <NULL> RT_system: False === Resource Groups and Resources === Resource Group: qfs-rg RG_description: <NULL> RG_mode: Failover RG_state: Managed Failback: False Nodelist: phys-schost-2 phys-schost-1 --- Resources for Group qfs-rg --- Resource: qfs-res Type: SUNW.qfs Type_version: 3.1 Group: qfs-rg R_description: Resource_project_name: default Enabled{phys-schost-2}: True Enabled{phys-schost-1}: True Monitored{phys-schost-2}: True Monitored{phys-schost-1}: True示例 3 显示群集状态
以下命令可显示所有群集节点的状态。
# cluster status -t node === Cluster Nodes === --- Node Status --- Node Name Status --------- ------ phys-schost-1 Online phys-schost-2 Online --- Node Status --- Node Name Status --------- ------
或者,也可以使用 clnode 命令显示相同信息。
# clnode status === Cluster Nodes === --- Node Status --- Node Name Status --------- ------ phys-schost-1 Online phys-schost-2 Online示例 4 创建群集
以下命令可以从群集配置文件 suncluster.xml 创建名为 cluster-1 的群集。
# cluster create -i /suncluster.xml cluster-1示例 5 更改群集的名称
以下命令可以将群集的名称更改为 cluster-2 。
# cluster rename -c cluster-2示例 6 禁用群集的 installmode 属性
以下命令可以禁用群集的 installmode 属性。
# cluster set -p installmode=disabled示例 7 修改专用网络
以下命令可修改群集的专用网络设置。该命令将专用网络地址设置为 172.10.0.0。该命令还可以计算和设置能够支持指定的八个节点和四个专用网络的最小专用网络掩码,并指定您要为全局群集配置八个区域群集。该命令还标识可以在非群集模式下对物理群集配置的独占 IP 区域群集的数量。
# cluster set-netprops \ -p private_netaddr=172.10.0.0 \ -p max_nodes=8 \ -p max_privatenets=4 \ -p num_zoneclusters=8 \ -p num_xip_zoneclusters=3
还可以在非群集模式下按如下所示指定该命令:
# cluster set-netprops \ -p private_netaddr=172.10.0.0 \ -p max_nodes=8,\ -p max_privatenets=4 \ -p num_zoneclusters=8 \ -p num_xip_zoneclusters=3示例 8 列出可用检查
以下命令可列出群集上所有可用的检查(以单行的格式显示)。可用的实际检查因发行版或更新而异。
# cluster list-checks M6336822 : (Critical) Global filesystem /etc/vfstab entries are not consistent across all Oracle Solaris Cluster nodes. S6708689 : (Variable) One or more Oracle Solaris Cluster resources cannot be validated M6708613 : (Critical) vxio major numbers are not consistent across all Oracle Solaris Cluster nodes. S6708255 : (Critical) The nsswitch.conf file 'hosts' database entry does not have 'cluster' specified first. S6708479 : (Critical) The /etc/system rpcmod:svc_default_stksize parameter is missing or has an incorrect value for Oracle Solaris Cluster. F6984121 : (Critical) Perform cluster shutdown F6984140 : (Critical) Induce node panic …示例 9 在群集上运行基本检查
以下命令在详细模式下在 schost 群集的所有节点上运行所有可用的基本检查,其中 phys-schost-1 是群集成员。输出会重定向至文件 basicchks.18Nov2011.schost。
phys-schost-1# cluster check -v -o basicchks.18Nov2011.schost示例 10 在群集上运行交互式检查
以下命令可以运行除了具有 vfstab 关键字的那些检查之外的所有可用交互式检查。检查的输出会保存到文件 interactive.chk.18Nov2011。
# cluster check -k interactive -E vfstab -o interactive.chk.18Nov2011 cluster-1示例 11 在群集上运行功能检查User supplies information when prompted
以下命令可显示功能检查 F6968101 的详细描述并在包含 phys-schost-1、phys-schost-2 和 phys-schost-3 群集成员的群集上运行该检查。检查的输出会保存到文件 F6968101.failovertest.19Nov2011。因为该检查涉及到故障转移群集节点,所以在使群集脱离生产环境之前,请勿启动该检查。
phys-schost-1# cluster list-checks -v -C F6968101 initializing... F6968101: (Critical) Perform resource group switchover Keywords: SolarisCluster4.x, functional Applicability: Applicable if multi-node cluster running live. Check Logic: Select a resource group and destination node. Perform '/usr/cluster/bin/clresourcegroup switch' on specified resource group either to specified node or to all nodes in succession. Version: 1.118 Revision Date: 13/07/09 cleaning up...示例 12 在指定的节点上运行有限的检查Take the cluster out of production phys-schost-1# cluster check -k functional -C F6968101 \ -o F6968101.failovertest.19Nov2011 initializing... initializing xml output... loading auxiliary data... starting check run... phys-schost-1, phys-schost-2, phys-schost-3: F6968101.... starting: Perform resource group switchover ============================================================ >>> Functional Check <<<Follow onscreen directions …
以下命令在详细模式下运行严重级别为 high 或更高的所有检查。这些检查仅在节点 phys-schost-1 上运行。
# cluster check -v -n phys-schost-1 -s high initializing... initializing xml output... loading auxiliary data... filtering out checks with severity less than High starting check run... phys-schost-1: M6336822.... starting: Global filesystem /etc/vfstab entries... phys-schost-1: M6336822 not applicable phys-schost-1: S6708689.... starting: One or more Oracle Solaris Cluster... phys-schost-1: S6708689 passed … phys-schost-1: S6708606 skipped: severity too low phys-schost-1: S6708638 skipped: severity too low phys-schost-1: S6708641.... starting: Cluster failover/switchover might... phys-schost-1: S6708641 passed …
/usr/cluster/lib/cfgchk/checkresults.dtd
/var/cluster/logs/cluster_check/
/outputdir/cluster_check_exit_code.log
有关下列属性的说明,请参见 attributes(5):
|
Intro(1CL)、init(1M)、su(1M)、scha_calls(3HA)、attributes(5)、rbac(5)、clconfiguration(5CL)
超级用户可以运行此命令的所有格式。
所有用户都可以运行带有 –?(帮助)或 –V(版本)选项的此命令。
要运行带有子命令的 cluster 命令,超级用户以外的用户需要具有 RBAC 授权。请参见下表。
|