/usr/cluster/bin/clresource subcommand [-?]
/usr/cluster/bin/clresource -V
/usr/cluster/bin/clresource subcommand [options] -v [resource]...
/usr/cluster/bin/clresource clear [-f errorflag] [-g [resourcegroup,]...] [-t [resourcetype,]...] -n node [,…]] [-Z {zoneclustername | global}] {+ | resource...}
/usr/cluster/bin/clresource create -g resourcegroup -t resourcetype [-d] [-p "property-name[{node-specifier,...}]"= value] [-x "extension-property[{node-specifier,...}]"=value] [-y standard-property=value] [-Z {zoneclustername | global}] resource
/usr/cluster/bin/clresource create -i {- | clconfiguration} -t resourcetype [-a] [-d] [-g [resourcegroup,]...] [-p " property-name[{node-specifier,...}]"=value] [-x " extension-property[{node-specifier,...}]"=value] [-y standard-property=value] {+ | resource...}
/usr/cluster/bin/clresource delete [-F] [-g [resourcegroup,]...] [-t [resourcetype,...]] [-Z {zoneclustername | global}] {+ | resource...}
/usr/cluster/bin/clresource disable [-r] [-g [resourcegroup,]...] [-t [resourcetype,]...] [-n node[,…]] [-Z {zoneclustername | global}] {+ | resource...}
/usr/cluster/bin/clresource enable [-r] [-g [resourcegroup,]...] [-t [resourcetype,]...] [ -n node[,…]] [-Z {zoneclustername | global}] {+ | resource...}
/usr/cluster/bin/clresource export [-o {- | configfile}] [+ | resource...]
/usr/cluster/bin/clresource list [-g [resourcegroup,]...] [-t [resourcetype,]...] [ -n node[,…]] [-Z {zoneclustername [,...] | global | all}] [+ | resource...]
/usr/cluster/bin/clresource list-props [-l listtype] [-g [resourcegroup,]...] [-p "property-name[{node-specifier,…}]",...] [-t [resourcetype,]...] [-x "extension-property[{node-specifier,…}]"...] [-y "standard-property[{node-specifier,…}]",...] [-Z {zoneclustername [,...] | global | all}] [+ | resource...]
/usr/cluster/bin/clresource monitor [-g [resourcegroup,]...] [-t [resourcetype,]...] [ -n node[,…]] [-Z {zoneclustername | global}] {+ | resource...}
/usr/cluster/bin/clresource set [-g [resourcegroup,]...] [-p " property-name[{node-specifier,…}]"=value] [-t [resourcetype,]...] [-x "extension-property[{node-specifier,…}]"= value] [-y standard-property [+= | -=]value] [-Z {zoneclustername | global}] {+ | resource...}
/usr/cluster/bin/clresource show [-g [resourcegroup,]...] [-p property-name[{node-specifier,…}]",...] [-t [resourcetype,]...] [-x "extension-property[{node-specifier,…}]",...] [-y " standard-property[{node-specifier,…}]",...] [-Z {zoneclustername [,...] | global | all}] [+ | resource...]
/usr/cluster/bin/clresource status [-g [resourcegroup,]...] [-s [state,]...] [-t [resourcetype,]...] [ -n node[,…]] [-Z {zoneclustername [,...] | global | all}] [+ | resource...]
/usr/cluster/bin/clresource unmonitor [-g [resourcegroup,]...] [-t [resourcetype,]...] [ -n node[,…]] [-Z {zoneclustername | global}] {+ | resource...}
clresource 命令可管理 Oracle Solaris Cluster 数据服务的资源。clrs 命令是 clresource 命令的简短格式。clresource 命令和 clrs 命令是相同的。您可以使用此命令的任一种格式。
此命令的一般格式如下所示:
clresource [subcommand] [options] [operands]
仅当 options 指定 –? 选项或 –V 选项时,才可以省略 subcommand。
此命令的每个选项都有长格式和简短格式两种格式。在本手册页的 选项 部分给出了每个选项的两种格式,以及对该选项的描述。
在区域群集中,可以将 clresource 命令与所有子命令(export 除外)一起使用。
也可以将 –Z 选项与所有子命令(export 除外)一起使用来指定要将操作限制到的特定区域群集的名称。另外,还可以将区域群集名称附加到资源名称 (zoneclustername : resource),以便将操作限制到特定的区域群集。
您可以从全局群集节点访问所有区域群集信息,但无法从特定区域群集访问其他区域群集信息。如果不将操作限制到特定区域群集,则所用的子命令仅会在当前群集中运行。
一个区域群集中的某个资源可能对另一个区域群集中的某个资源存在依赖性,或者对全局群集中的某个资源存在依赖性。另外,全局群集中的某个资源可能对该全局群集中的任一区域群集上的某个资源存在依赖性。只能从全局群集设置这种群集间依赖性。
您可以使用以下命令指定群集间依赖性:
# clresource set -p resource_dependencies=target-zc :target-rs source-zc: source-rs
例如,如果需要指定从区域群集 ZC1 中的资源 R1 到区域群集 ZC2 中的资源 R2 的依赖性,请使用以下命令:
# clresource set -p resource_dependencies=ZC2:R2 ZC1:R1
如果需要指定区域群集 ZC1 资源 R1 对全局群集资源 R2 的依赖性,请使用以下命令:
# clresource set -p resource_dependencies=global:R2 ZC1:R1
支持现有资源依赖性(Strong、Weak 、Restart 和 Offline-Restart)。
资源状况和资源状态是基于每个节点进行维护的。一个给定的资源在每个群集节点上可以具有不同的状况和状态。
资源组管理器 (Resource Group Manager, RGM) 基于对资源调用的方法在每个节点上设置资源状况。例如,在给定节点上对某个资源成功运行 STOP 方法后,该资源在此节点上的状况将为 OFFLINE。如果 STOP 方法返回非零值或超时,则该资源的状况为 Stop_failed
可能的资源状况包括:
Online
Offline
Start_failed
Stop_failed
Monitor_failed
Online_not_monitored
Starting
Stopping
Not_online
除资源状况外,RGM 还可以维护资源状态,资源状态可由资源本身使用 API 设置。Status Message 字段实际上包括两个组成部分:状态关键字和状态消息。状态消息由资源有选择性地进行设置,它是在状态关键字后面输出的任意文本字符串。
资源状态可能值的描述如下:
资源已联机,但其性能或可用性可能在某方面出现了下降。
资源遇到错误,无法正常运行。
资源已脱机。
资源已联机,正在提供服务。
当前状态是未知或正在转换。
支持以下子命令:
清除与指定为命令操作数的资源关联的错误标志。此子命令接受使用加号 (+) 作为操作数来指定清除所有资源的错误标志。
您可以在全局群集中或区域群集中使用该子命令。
以下选项可以过滤操作数列表,以限制要在其上清除错误标志的资源:
只清除操作数列表内属于 resourcegroup 中资源组成员的资源。
清除指定的一个或多个节点上的资源。如果未提供 –n 选项,该命令将清除所有节点上的资源。
只清除操作数列表内属于 resourcetype 中资源类型的实例的资源。
只清除您指定的一个或多个特定群集中的资源。要从全局群集清除区域群集中的资源,请使用 –Z 选项指定区域群集。
默认情况下,clear 子命令将会清除 STOP_FAILED 错误标志。要显式指定要清除的错误标志,请使用 –f 选项。– f 选项接受的唯一错误标志是 STOP_FAILED 错误标志。
超级用户以外的用户需要具有 solaris.cluster.admin RBAC 授权才能使用该子命令。
创建作为命令操作数指定的资源。
您可以在全局群集中或区域群集中使用该子命令。
要从全局群集在特定区域群集中创建资源,可以使用 –Z 选项指定区域群集的名称。
将 create 和 –i 选项一起使用以指定配置文件时,该子命令接受使用加号 (+) 作为操作数。使用 + 操作数时,将会创建配置文件中提供的尚不存在的所有资源。
默认情况下,创建的资源处于启用状态,且启用了监视功能。但是,仅当资源的资源组联机后,该资源才会联机并受到监视。要在禁用状态下创建资源,请指定 –d 选项。
创建资源时,可以使用以下选项设置属性值:
设置标准属性或扩展属性,前提是它们的名称是唯一的。
设置扩展属性。
设置标准属性。
node-specifier 是 –p 和 –x 选项的可选限定符。它指示创建资源时将只在指定节点上设置属性,而不在群集中其他节点上设置指定的属性。如果未使用 node-specifier,则会在群集中的所有节点上设置指定的属性。node-specifier 语法的示例包括:
-x "myprop{phys-schost-1}"
大括号 ({}) 表示您只想要在节点 phys-schost-1 上设置指定的属性。对于大多数 shell,必须将大括号包含在引号中。
可以使用以下语法在两个节点上设置属性:
-x "myprop{phys-schost-1,phys-schost-2}"
超级用户以外的用户需要具有 solaris.cluster.modify 基于角色的访问控制 (role-based access control, RBAC) 授权才能使用此子命令。
另请参见 delete 子命令的描述。
删除作为命令操作数指定的资源。此子命令接受使用加号 (+) 作为操作数来指定删除所有资源。
您可以在全局群集中或区域群集中使用该子命令。
此子命令将按照为满足资源间依赖性而需要遵照的顺序删除多个资源,而不管在命令行上以哪种顺序指定了资源。
同时删除多个资源时,该命令将在多个步骤中执行。如果命令被中断(例如,某个节点发生故障),某些资源组的配置可能会处于无效状态。要更正此问题并完成资源的删除,请在某个正常运行的节点上再次发出同一命令。
以下选项可以过滤操作数列表,以限制删除的资源:
只删除操作数列表内属于 resourcegroup 中资源组的成员的资源。
只删除操作数列表内属于 resourcetype 中资源类型的实例的资源。
只删除您指定的一个或多个特定群集中的资源。要从全局群集删除区域群集中的资源,请使用 –Z 选项指定区域群集。
默认情况下,仅当符合以下条件时,才会删除某个资源:
必须已禁用该资源。
必须已消除该资源的所有依赖性。
要强制删除指定的资源,请指定 –F 选项。请慎用此选项,因为它会有以下效果:
删除所有指定的资源,即使是未禁用的资源。
从其他资源的资源依赖性设置中删除所有指定的资源。
这些效果可能会导致群集中的服务丧失。未删除的相关资源也可能被置于无效状况或错误状况。
超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。
另请参见 create 子命令的描述。
禁用指定为命令操作数的资源。此子命令接受使用加号 (+) 作为操作数来指定禁用所有资源。
您可以在全局群集中或区域群集中使用该子命令。
以下选项可以过滤操作数列表,以限制禁用的资源:
只禁用操作数列表内属于 resourcegroup 中资源组的成员的资源。
可以使用 –n node 来禁用一个或多个节点上的资源。
只禁用操作数列表内属于 resourcetype 中资源类型的实例的资源。
只禁用您指定的一个或多个特定群集中的资源。要从全局群集删除区域群集中的资源,请使用 –Z 选项指定区域群集。
–r 选项将会禁用依赖于指定为命令操作数的资源的任何资源。即使这些资源未指定为命令操作数,也会将其禁用。–g 选项和 –t 选项不适用于仅为满足资源依赖性而禁用的资源。
此子命令不会影响资源的监视状态。如果该资源在启用的情况下是受监视的,则禁用后仍受监视。如果后来重新启用该资源,则还会继续监视该资源。
该子命令将按照为满足资源间依赖性而需要遵照的顺序禁用资源,而不管在命令行上以哪种顺序指定了资源。
超级用户以外的用户需要具有 solaris.cluster.admin RBAC 授权才能使用该子命令。
另请参见 enable 子命令的描述。
启用指定为命令操作数的资源。此子命令接受使用加号 (+) 作为操作数来指定启用所有资源。
您可以在全局群集中或区域群集中使用该子命令。
以下选项可以过滤操作数列表,以限制启用的资源:
仅启用操作数列表内属于 resourcegroup 中资源组的成员的资源。
可以使用 –n node 来启用一个或多个节点上的资源。
仅启用操作数列表内属于 resourcetype 中资源类型的实例的资源。
仅启用您指定的一个或多个特定群集中的资源。要从全局群集启用区域群集中的资源,请使用 –Z 选项指定区域群集。
要确保满足所有必需的资源依赖性,请指定 –r 选项。–r 选项将会启用指定为命令操作数的资源所依赖的任何资源。即使这些资源未指定为命令操作数,也会将其启用。–g 选项和 –t 选项不适用于仅为满足资源依赖性而禁用的资源。
该子命令将按照为满足资源间依赖性而需要遵照的顺序启用资源,而不管在命令行上以哪种顺序指定了资源。
超级用户以外的用户需要具有 solaris.cluster.admin RBAC 授权才能使用该子命令。
另请参见 disable 子命令的描述。
以 clconfiguration(5CL) 手册页所述的格式导出群集资源配置。
只能在全局群集中使用该子命令。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。
显示指定为命令操作数的资源的列表。默认情况下,会显示所有资源。
您可以在全局群集中或区域群集中使用该子命令。
以下选项可以过滤操作数列表,以限制显示的资源:
只显示操作数列表内属于 resourcegroup 中资源组的成员的资源。
可以使用 –n node 来仅列出在一个或多个节点上处于联机状态的那些资源。
只显示属于 resourcetype 中资源类型的实例的资源。
只显示您指定的一个或多个特定群集中的资源。要从全局群集显示区域群集中的资源,请使用 –Z 选项指定区域群集。
此子命令接受使用加号 (+) 作为操作数来指定显示所有资源配置。可以通过指定 –g 选项或 –t 选项,将显示的信息限定于特定资源组或资源类型。如果未提供操作数,则会显示指定资源组中的所有资源,或显示属于指定资源类型的实例的所有资源。
如果指定 –v 选项,还将显示列表中每个资源的资源组和资源类型。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。
显示指定为命令操作数的资源的属性列表。
您可以在全局群集中或区域群集中使用该子命令。
以下选项可以过滤操作数列表,以限制要显示其属性的资源:
仅显示操作数列表内属于 resourcegroup 中资源组成员的资源的属性。
仅显示操作数列表内属于 resourcetype 中资源类型实例的资源的属性。
–l 选项指定要显示的资源属性的类型:
指定显示标准属性和扩展属性。
指定只显示扩展属性。默认情况下,只显示扩展属性。
指定只显示标准属性。
如果未指定 –l 选项,则只显示扩展属性。要显示标准属性,请使用 –p 选项或 –y 选项显式指定这些属性。
以下选项用于限制要显示的资源属性集:
只显示 property-name 中指定的属性。您可以在 property-name 中指定标准属性和扩展属性。
只显示一个或多个节点上的、已在 extension-property 中指定的扩展属性。
只显示 standard-property 中指定的标准属性。
node-specifier 是 –p、–x 和 –y 选项的可选限定符。它指示将只显示指定节点上的属性,而不显示群集中其他节点上的指定属性。如果未使用 node-specifier,则会显示群集中所有节点上的指定属性。node-specifier 语法的示例包括:
-x "myprop{phys-schost-1}"
大括号 ({}) 表示您只想要显示节点 phys-schost-1 上的指定属性。对于大多数 shell,必须将大括号包含在引号中。
可以使用以下语法显示两个节点上的属性:
-x "myprop{phys-schost-1,phys-schost-2}"
如果指定 –v 选项,还将显示每个属性的描述。
此子命令接受使用加号 (+) 作为操作数来指定显示所有资源属性。如果未提供操作数,则会显示指定资源组中所有资源的属性,或显示属于指定资源类型的实例的所有资源的属性。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。
列出您指定的一个或多个特定群集中的资源的属性。要从全局群集列出区域群集中的资源,请使用 –Z 选项指定区域群集。
开启对指定为命令操作数的资源的监视。此子命令接受使用加号 (+) 作为操作数来指定开启对所有资源的监视。
您可以在全局群集中或区域群集中使用该子命令。
以下选项可以过滤操作数列表,以限制要对其开启监视的资源:
只对操作数列表内属于 resourcegroup 中资源组的成员的资源开启监视。
只对在一个或多个节点上处于联机状态的那些资源开启监视。
只对操作数列表内属于 resourcetype 中资源类型的实例的资源开启监视。
只对您指定的一个或多个特定群集中的资源开启监视。要从全局群集开启对区域群集中资源的监视,请使用 –Z 选项指定区域群集。
开启对某个资源的监视后,仅当符合以下条件时,才会监视该资源:
已启用该资源。
包含该资源的资源组至少已在一个群集节点上联机。
超级用户以外的用户需要具有 solaris.cluster.admin RBAC 授权才能使用该子命令。
另请参见 unmonitor 子命令的描述。
设置指定为命令操作数的资源的特定属性。此子命令接受使用加号 (+) 作为操作数来指定修改所有资源的特定属性。
您可以在全局群集中或区域群集中使用该子命令。
以下选项可以过滤操作数列表,以限制要修改其属性的资源:
只修改操作数列表内属于 resourcegroup 中资源组成员的资源的属性。
只修改操作数列表内属于 resourcetype 中资源类型实例的资源的属性。
使用以下选项设置属性值:
设置标准属性或扩展属性,前提是它们的名称是唯一的。
设置扩展属性。
设置标准属性。
node-specifier 是 –p 和 –x 选项的可选限定符,用于更新每节点扩展属性。它指示仅在指定节点上设置相应属性,而不在群集中其他节点上设置指定的属性。如果未使用 node-specifier,则会在群集中的所有节点上设置指定的属性。node-specifier 语法的示例包括:
-x "myprop{phys-schost-1}"
大括号 ({}) 表示您只想要在节点 phys-schost-1 上设置指定的属性。对于大多数 shell,必须将大括号包含在引号中。
可以使用以下语法在两个节点上设置属性:
-x "myprop{phys-schost-1,phys-schost-2}"
只设置您指定的一个或多个特定群集中的资源的属性。要从全局群集设置区域群集中资源的属性,请使用 –Z 选项指定区域群集。
超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。
显示指定为命令操作数的资源的配置。默认情况下,会显示所有资源的配置。
您可以在全局群集中或区域群集中使用该子命令。
以下选项可以过滤操作数列表,以限制要显示其配置的资源的列表:
只显示操作数列表内属于 resourcegroup 中资源组成员的资源的配置。
可以使用 –n node 来仅显示在一个或多个节点上处于联机状态的那些资源的配置。
只显示操作数列表内属于 resourcetype 中资源类型实例的资源的配置。
只显示您指定的一个或多个特定群集中的资源。要从全局群集显示区域群集中的资源,请使用 –Z 选项指定区域群集。
以下选项用于限制显示的资源属性集:
只显示 property-name 中指定的属性。您可以在 property-name 中指定标准属性和扩展属性。
只显示一个或多个节点上的、已在 extension-property 中指定的扩展属性。
只显示 standard-property 中指定的标准属性。
node-specifier 是 –p、–x 和 –y 选项的可选限定符。它指示将只显示指定节点上的属性,而不显示群集中其他节点上的指定属性。如果未使用 node-specifier,则会显示群集中所有节点上的指定属性。node-specifier 语法的示例包括:
-x "myprop{phys-schost-1}"
大括号 ({}) 表示您只想要显示节点 phys-schost-1 上的指定属性。对于大多数 shell,必须将大括号包含在引号中。
可以使用以下语法显示两个节点上的属性:
-x "myprop{phys-schost-1,phys-schost-2}"
此子命令接受使用加号 (+) 作为操作数来指定显示所有资源配置。可以通过指定 –g 选项或 –t 选项,将显示的信息限定于特定资源组或资源类型。如果未提供操作数,该子命令将显示所有指定资源的配置。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。
显示指定为命令操作数的资源的状态。默认情况下,会显示所有资源的状态。
以下选项可以过滤操作数列表,以限制要显示其状态的资源的列表:
仅显示操作数列表内属于 resourcegroup 中资源组成员的资源的状态。
可以使用 –n node 来仅显示在一个或多个节点上处于联机状态的那些资源的状态。不能同时指定 –n 和 – s 选项。
仅显示操作数列表内处于 state 中的状况的资源的状态。不能同时指定 –n 和 – s 选项。
仅显示操作数列表内属于 resourcetype 中资源类型实例的资源的状态。
显示您指定的一个或多个特定群集中的资源的状态。要从全局群集显示区域群集中资源的状态,请使用 –Z 选项指定区域群集。
此子命令接受使用加号 (+) 作为操作数来指定显示所有资源的状态。可以通过指定 –g 选项或 –t 选项,将显示的信息限定于特定资源组或资源类型。如果未提供操作数,将会显示所有指定资源的状态。
超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。
关闭对指定为命令操作数的资源的监视。此子命令接受使用加号 (+) 作为操作数来指定关闭对所有资源的监视。
您可以在全局群集中或区域群集中使用该子命令。
如果关闭对某个被禁用资源的监视,该资源不会受到影响。该资源及其监视器已脱机。
以下选项可以过滤操作数列表,以限制要对其关闭监视的资源:
只对操作数列表内属于 resourcegroup 中资源组的成员的资源关闭监视。
只对在一个或多个节点上处于联机状态的那些资源关闭监视。
只对操作数列表内属于 resourcetype 中资源类型的实例的资源关闭监视。
只对您指定的一个或多个特定群集中的资源关闭监视。要从全局群集关闭对区域群集中资源的监视,请使用 –Z 选项指定区域群集。
超级用户以外的用户需要具有 solaris.cluster.admin RBAC 授权才能使用该子命令。
另请参见 disable 子命令和 monitor 子命令的描述。
支持以下选项:
显示帮助信息。使用该选项时,不会执行任何其他处理。
指定此选项时,子命令可有可无。
如果仅指定此选项而不使用子命令,将会显示此命令的子命令列表。
如果使用子命令且指定此选项,将会显示该子命令的用法选项。
当基于群集配置文件 (clconfiguration(5CL)) 创建资源时,将自动执行以下附加操作:
注册资源类型
创建资源组
创建操作数列表中指定的资源所依赖的资源
群集配置信息包含的信息必须足以执行以下所有操作:
启用要注册的资源类型
启用要创建的资源组
启用要创建的资源
此选项仅可以与 create 子命令一同指定。如果指定此选项,还必须指定 –i 选项并提供配置文件。
创建资源后禁用该资源。此选项仅可以与 create 子命令一同指定。默认情况下,资源在启用状态下创建。
启用某个资源并不保证该资源联机。仅当某个资源的资源组已至少在一个节点上联机后,该资源才会联机。
显式指定要通过 clear 子命令清除的错误标志。此选项仅可以与 clear 子命令一同指定。默认情况下,clear 子命令将会清除 STOP_FAILED 错误标志。
– f 选项接受的唯一错误标志是 STOP_FAILED 错误标志。
强制删除未禁用的资源。此选项仅可以与 delete 子命令一同指定。
请慎用此选项,因为它会有以下效果:
删除所有指定的资源,即使是未禁用的资源。
从其他资源的资源依赖性设置中删除所有指定的资源。
这些效果可能会导致群集中的服务丧失。未删除的相关资源也可能被置于无效状况或错误状况。
指定一个资源组或资源组列表。
对于除 create 以外的子命令,该命令仅对操作数列表内属于指定的资源组成员的资源起作用。使用 –g 选项指定资源组。
随 create 子命令指定了 –g 选项时, clresource 将在指定的资源组中创建资源。使用此选项时,只能指定一个资源组。
指定用于创建或修改资源的配置信息。此信息必须符合 clconfiguration(5CL) 手册页中定义的格式。此信息可包含在文件中或者通过标准输入提供。要指定标准输入,请指定 - 而不是文件名。
仅会创建或修改作为命令操作数提供的资源。在命令中指定的选项将会覆盖配置信息中设置的任何选项。如果配置信息中缺少配置参数,则必须在命令行中指定这些参数。
将 –i 选项与 create 子命令结合使用时, clresource 将会注册所有必需的资源类型,并创建所有必需的资源组。您必须提供注册和配置所需的全部信息。所有其他配置数据将被忽略。
指定要通过 list-props 子命令显示的资源属性的类型。此选项仅可以与 list-props 子命令一同指定。
必须根据以下列表为 listtype 指定一个值:
指定显示标准属性和扩展属性。
指定只显示扩展属性。默认情况下,只显示扩展属性。
指定只显示标准属性。
如果未指定 –l 选项,则只显示扩展属性。要显示标准属性,请使用 –p 选项或 –y 选项显式指定这些属性。
指定目标全局群集或区域群集中的一个节点或一系列节点。可以使用节点名称或节点 ID 指定每个节点。
如果指定 –Z 选项,则仅可以使用 –n 选项指定区域群集主机名,而不能指定全局群集主机名。如果未指定 –Z 选项,则仅可以使用 –n 选项指定全局群集主机名。
可以与此选项一起指定的子命令如下所述:
只禁用操作数列表中承载在指定节点上的资源。
只启用操作数列表中承载在指定节点上的资源。
只显示操作数列表中承载在指定节点上的那些资源的列表。
只监视操作数列表中承载在指定节点上的那些资源。
只显示操作数列表中承载在指定节点上的那些资源的配置信息。
仅报告操作数列表中承载在指定节点上的资源的状态。
只取消监视操作数列表中承载在指定节点上的那些资源。
指定要将资源配置信息写入到的位置。此位置可以是文件,也可以是标准输出。要指定标准输出,请指定短划线 (-) 而不是文件名。如果指定标准输出,将会抑制该命令的其他所有标准输出。此选项仅可以与 export 子命令一同指定。
只会写入作为命令操作数提供的资源的配置信息。信息是采用 clconfiguration(5CL) 手册页中定义的格式写入的。
设置作为命令操作数提供的资源的属性值。只能随 create 子命令和 set 子命令指定此选项的赋值格式。
使用 –p 选项可以指定任何标准属性或扩展属性。如果某个资源类型的某个扩展属性与该资源类型的某个标准属性同名,则使用 –p 选项会返回错误。在这种情况下,请使用 –x 选项指定扩展属性,使用 –y 选项指定标准属性。
有关标准属性的描述,请参见 r_properties(5) 手册页。
有关某个资源类型的扩展属性的描述,请参见该资源类型的文档。
与此选项一起使用的运算符如下所述:
将属性设置为指定值。create 子命令和 set 子命令接受此运算符。
将一个或多个值添加到某个字符串数组值。只有 set 子命令接受此运算符。仅可以为接受字符串值列表的属性指定此运算符,例如 Resource_dependencies 。
从某个字符串数组值中删除一个或多个值。只有 set 子命令接受此运算符。仅可以为接受字符串值列表的属性指定此运算符,例如 Resource_dependencies 。
要在群集节点的子集上设置每节点扩展属性,请在设置属性时指定节点。将节点列表括在大括号中,并将其附加在属性名称的后面,如下所示:
name{node}
node 是以逗号分隔的节点名称或节点 ID 的列表。有关每节点扩展属性的更多信息,请参见 rt_properties(5) 手册页。
要设置每节点资源对群集节点子集的依赖性,请采用以下格式指定每个每节点依赖性:
myres1@node1,myres2@node2,myres3@node3
对于 gds-rs 资源,以下命令设置资源 trancos-3-rs 对节点 ptrancos1 的依赖性和资源 trancos-4-rs 对节点 ptrancos2 的依赖性:
# clresource set -p \ resource_dependencies=trancos-3-rs@ptrancos1,trancos-4-rs@ptrancos2 gds-rs phys-schost-1# clresource show -p resource_dependencies gds-rs === Resources === Resource: gds-rs Resource_dependencies: trancos-3-rs@ptrancos1 trancos-4-rs@ptrancos2
要设置本地节点范围的资源依赖性,请采用以下格式指定 LOCAL_NODE 限定符:
myres1{LOCAL_NODE},myres2{LOCAL_NODE}
对于 gds-rs 资源,以下命令设置本地节点对资源 trancos-3-rs 的依赖性:
# clresource set -p resource_dependencies=trancos-3-rs{LOCAL_NODE} gds-rs phys-schost-1# clresource show -p resource_dependencies gds-rs === Resources === Resource: gds-rs Resource_dependencies: trancos-3-rs{LOCAL_NODE}
有关每节点资源依赖性和依赖性范围限定符的更多信息,请参见 r_properties(5) 手册页。
为 list-props 子命令和 show 子命令指定属性列表。
使用 –p 选项可以指定任何标准属性或扩展属性。如果某个资源类型的某个扩展属性与该资源类型的某个标准属性同名,则使用 –p 选项会返回错误。在这种情况下,请使用 –x 选项指定扩展属性,使用 –y 选项指定标准属性。
有关标准属性的描述,请参见 r_properties(5) 手册页。
有关某个资源类型的扩展属性的描述,请参见该资源类型的文档。
如果未指定此选项,list-props 子命令和 show 子命令将会列出所有资源属性或大多数资源属性,具体取决于是否同时指定了 –v 选项。
以递归方式启用或禁用资源,以确保满足所有必需的依赖性。此选项仅可以与 disable 子命令和 enable 子命令一同指定。
此选项与这些子命令一起使用的效果如下所示:
禁用依赖于指定为命令操作数的资源的任何资源。即使这些资源未指定为命令操作数,也会将其禁用。
启用指定为命令操作数的资源所依赖的任何资源。即使这些资源未指定为命令操作数,也会将其启用。
为 list 子命令和 status 子命令指定状况列表。
此选项将会限制输出,以便只包括在节点列表中的一个或多个节点上处于指定状况之一的资源。
可能的状况如下:
Online
Offline
Start_failed
Stop_failed
Monitor_failed
Online_not_monitored
Starting
Stopping
Not_online
指定一个资源类型或资源类型列表。
对于接受此选项的所有子命令(create 除外),该命令只对同时满足以下两个条件的资源起作用:
资源在操作数列表中。
资源是 – t 选项指定的资源类型的实例。
将 –t 选项与 clresource create 一起指定时,将会创建指定类型的资源。只能指定一个资源类型。
有关资源类型名称格式的描述,请参见Oracle Solaris Cluster 数据服务规划和管理指南 中的合法的 RGM 名称。
如果使用 + 操作数,此选项会指定命令要对其资源组已暂停的资源起作用。
如果指定 + 操作数时未指定 –u 选项,命令将会忽略其资源组已暂停的所有资源。当随 clear、disable、 enable、monitor、set 或 unmonitor 命令指定了 + 操作数时,–u 选项有效。
将 + 操作数与 clear、 disable、enable、monitor、 set 或 unmonitor 子命令一起使用时,除非同时指定了 – u 选项,否则命令将会忽略其资源组已暂停的所有资源。
显示该命令的版本。
指定此选项时,不要将其与子命令、操作数或其他选项结合使用。子命令、操作数或其他选项将被忽略。–V 选项只显示命令的版本。不会执行任何其他操作。
将详细消息显示到标准输出。
可以在任何格式的此命令中指定该选项。
请不要同时指定 –v 选项和 –o 选项。否则 –v 选项将被忽略。–o 选项会抑制其他所有标准输出。
设置或修改作为命令操作数提供的资源的扩展属性值。
通常,使用 –p 选项可以指定任何标准属性或扩展属性。如果某个资源类型的某个扩展属性与该资源类型的某个标准属性同名,则使用 –p 选项会返回错误。在这种情况下,请使用 –x 选项指定扩展属性,使用 –y 选项指定标准属性。
只能随 create 子命令和 set 子命令指定此选项的赋值格式。
有关某个资源类型的扩展属性的描述,请参见该资源类型的文档。
与此选项一起使用的运算符如下所述:
将属性设置为指定值。create 子命令和 set 子命令接受此运算符。
将一个或多个值添加到某个字符串数组值。只有 set 子命令接受此运算符。仅可以为接受字符串值列表的属性指定此运算符,例如 Resource_dependencies 。
从某个字符串数组值中删除一个或多个值。只有 set 子命令接受此运算符。仅可以为接受字符串值列表的属性指定此运算符,例如 Resource_dependencies 。
要在群集节点的子集上设置每节点扩展属性,请在设置属性时指定节点。将节点列表括在大括号中,并将其附加在属性名称的后面,如下所示:
name{node}
node 是以逗号分隔的节点名称或节点 ID 的列表。有关每节点属性的更多信息,请参见 rt_properties(5) 手册页。
为 list-props 子命令和 show 子命令指定扩展属性列表。
有关某个资源类型的扩展属性的描述,请参见该资源类型的文档。
使用 –p 选项可以指定任何标准属性或扩展属性。如果某个资源类型的某个扩展属性与该资源类型的某个标准属性同名,则使用 –p 选项会返回错误。在这种情况下,请使用 –x 选项指定扩展属性,使用 –y 选项指定标准属性。
如果未指定此选项,list-props 子命令和 show 子命令将会列出所有资源属性或大多数资源属性,具体取决于是否同时指定了 –v 选项。
设置或修改作为命令操作数提供的资源的标准属性值。
使用 –p 选项可以指定任何标准属性或扩展属性。如果某个资源类型的某个扩展属性与该资源类型的某个标准属性同名,则使用 –p 选项会返回错误。在这种情况下,请使用 –x 选项指定扩展属性,使用 –y 选项指定标准属性。
只能随 create 子命令和 set 子命令指定此选项的赋值格式。
有关标准属性的描述,请参见 r_properties(5) 手册页。
与此选项一起使用的运算符如下所述:
将属性设置为指定值。create 子命令和 set 子命令接受此运算符。
将一个或多个值添加到某个字符串数组值。只有 set 子命令接受此运算符。仅可以为接受字符串值列表的属性指定此运算符,例如 Resource_dependencies 。
从某个字符串数组值中删除一个或多个值。只有 set 子命令接受此运算符。仅可以为接受字符串值列表的属性指定此运算符,例如 Resource_dependencies 。
为 list-props 子命令和 show 子命令指定标准属性列表。
有关标准属性的描述,请参见 r_properties(5) 手册页。
使用 –p 选项可以指定任何标准属性或扩展属性。如果某个资源类型的某个扩展属性与该资源类型的某个标准属性同名,则使用 –p 选项会返回错误。在这种情况下,请使用 –x 选项指定扩展属性,使用 –y 选项指定标准属性。
如果未指定此选项,list-props 子命令和 show 子命令将会列出所有资源属性或大多数资源属性,具体取决于是否同时指定了 –v 选项。
指定一个或多个存在资源且您要对其执行操作的群集。
除 export 子命令以外的所有子命令均支持此选项。
如果指定此选项,还必须指定以下列表中的参数之一:
指定使用此选项的命令仅对名为 zoneclustername 的区域群集中的所有指定资源起作用。
指定使用此选项的命令仅对全局群集中的所有指定资源进行操作。
如果在全局群集中使用此参数,则会指定使用此参数的命令对所有群集(包括全局群集和所有区域群集)中的所有指定资源起作用。
如果在某区域群集中使用此参数,则会指定使用此参数的命令仅对该区域群集中的所有指定资源起作用。
仅支持以下操作数:
指定要管理的一个或多个资源。如果子命令接受多个资源,则可以使用加号 (+) 指定所有资源。
如果命令对于所有指定的操作数均成功执行,则返回零 (CL_NOERR)。如果某个操作数出错,命令会继续处理操作数列表中的下一个操作数。返回的退出代码始终反映最先发生的错误。
可返回下列退出代码:
没有错误
您发出的命令已成功完成。
交换空间不足
某个群集节点耗尽了交换内存或其他操作系统资源。
参数无效
您键入的命令不正确,或者使用 –i 选项提供的群集配置信息语法不正确。
权限被拒绝
指定的对象不可访问。要发出命令,可能需要拥有超级用户或 RBAC 访问权限。有关更多信息,请参见 su(1M) 和 rbac(5) 手册页。
对象处于错误状况
您尝试修改一个在特定时间无法修改,或任何时候均无法修改的属性、资源组或其他对象。
资源方法失败
资源方法失败。方法因以下某个原因而失败:
尝试创建资源或修改资源属性时,validate 方法失败。
尝试启用、禁用或删除资源时,validate 以外的其他方法失败。
属性无效
您使用 –p、–y 或 –x 选项指定的属性或值不存在或不被允许。
没有这样的对象
由于以下某个原因,找不到您所指定的对象:
该对象不存在。
您尝试使用 –o 选项创建的配置文件路径中的某个目录不存在。
您尝试使用 –i 选项访问的配置文件包含错误。
对象已存在
您所指定的设备、设备组、群集互连组件、节点、群集、资源、资源类型、资源组或专用字符串已存在。
类型无效
您使用 –t 或 –p 选项指定的类型不存在。
这些退出值与 scha_calls(3HA) 手册页中描述的返回码兼容。
此示例将在名为 rg-failover 的资源组中创建一个名为 rs-nfs 的资源。该资源是 SUNW.nfs 资源类型的实例。创建的资源处于启用状况,并开启了资源监视功能。
# clresource create -g rg-failover -t SUNW.nfs rs-nfs
以下两个命令中的任何一个都在区域群集 ZC 内的资源组 rg-failover 中创建一个名为 rs-nfs 的资源。可以从全局群集节点执行这些命令,也可以在区域群集 ZC 内执行这些命令。如果从区域群集执行命令,则使用区域群集名称显式定义资源范围的操作是可选的。
# clresource create -g rg-failover -t SUNW.nfs -Z ZC rs-nfs
# clresource create -g rg-failover -t SUNW.nfs ZC:rs-nfs示例 2 开启对资源的监视
此示例将开启对名为 rs-nfs 的资源的监视。
# clresource monitor rs-nfs
开启对某个资源的监视后,在使用 clresource unmonitor 命令显式关闭监视之前,监视将一直保持开启状态。禁用和启用某个资源不影响其监视状态。
示例 3 启用资源此示例将启用资源组 rg-failover 和 rg-failover2 中的所有资源。
# clresource enable -g rg-failover,rg-failover2 +
此命令不会影响资源的监视状态。
示例 4 设置资源属性此示例会将 SUNW.nfs 资源类型的所有实例的 r_description 属性设置为 HA-NFS res。
# clresource set -t SUNW.nfs -p r_description="HA-NFS res" +示例 5 设置每节点资源属性
此示例将资源 rs-oracle 的每节点属性 oracle_sid 在不同节点上设置为不同的值,如下所述:
在节点 phys-schost-1 和节点 phys-schost-2 上,此属性设置为 myora1。
在节点 phys-schost-3 上,此属性设置为 myora2。
此示例假定大括号字符对于所用的 shell 具有特殊含义。因此,节点列表附加到的每个属性名称都包含在双引号中。
# clresource set -p "oracle_sid{phys-schost-1,phys-schost-2}"=myora1 \ -p "oracle_sid{phys-schost-3}"=myora2 rs-oracle示例 6 设置每节点资源依赖性
此示例设置 gds-rs 每个节点的资源依赖性,以便它依赖于两个不同的逻辑主机资源。
# clresource set -p resource_dependencies=node-3-rs@pnode1,node-4-rs@pnode2 gds-rs # clresource show -p resource_dependencies gds-rs Resource: gds-rs Standard Properties: Resource_dependencies: node-3-rs@pnode1,node-4-rs@pnode2示例 7 向字符串数组属性添加值
此示例将值 rs-oracle 添加到资源 rs-myapp 的字符串数组属性 resource_dependencies 中。此字符串数组属性中的现有值不变。
# clresource set -p resource_dependencies+=rs-oracle rs-myapp
# clresource show -p resource_dependencies rs-myapp Resource: rs-myapp Standard Properties: Resource_dependencies: rs-nfs rs-oracle示例 8 删除资源
此示例将删除名为 rs-nfs 的资源。
# clresource delete rs-nfs示例 9 更新整个群集配置
此示例将通过执行以下操作序列来更新整个群集配置:
使群集中的所有资源组脱机,删除所有资源,然后删除所有资源组
取消注册所有资源类型
创建配置文件 /net/server/export/mycluster.xml 中指定的所有资源,注册这些资源的资源类型,然后创建所有必需的资源组
# clresourcegroup delete --force + # clresourcetype unregister + # clresource -i /net/server/export/mycluster.xml -a +示例 10 列出资源
此示例将列出所有资源。
# clresource list logicalhost1 rs-nfs-1 rs-nfs-2 logicalhost2 rs-apache-1示例 11 列出资源及其组和类型
此示例将列出所有资源及其资源组和资源类型。
# clresource list -v Resource Name Resource Group Resource Type ------------- -------------- ------------- logicalhost1 rg-failover-1 SUNW.LogicalHostname rs-nfs-1 rg-failover-1 SUNW.nfs logicalhost2 rg-failover-2 SUNW.LogicalHostname rs-nfs-2 rg-failover-2 SUNW.nfs rs-apache-1 rg-failover-1 SUNW.apache示例 12 列出特定类型的资源
此示例将列出 nfs 资源类型的所有实例。
# clresource list -t nfs rs-nfs-1 rs-nfs-2示例 13 列出资源类型的扩展属性和描述
此示例将列出 nfs 资源类型的扩展属性以及每个扩展属性的描述。
# clresource list-props -t nfs -v Properties Descriptions ---------- ------------ Monitor_retry_count Number of PMF restarts allowed for the fault monitor Monitor_retry_interval Time window (minutes) for fault monitor restarts Rpcbind_nullrpc_timeout Timeout(seconds) to use when probing rpcbind Nfsd_nullrpc_timeout Timeout(seconds) to use when probing nfsd Mountd_nullrpc_timeout Timeout(seconds) to use when probing mountd Statd_nullrpc_timeout Timeout(seconds) to use when probing statd Lockd_nullrpc_timeout Timeout(seconds) to use when probing lockd Rpcbind_nullrpc_reboot Boolean to indicate if we should reboot system when null rpc call on rpcbind fails Nfsd_nullrpc_restart Boolean to indicate if we should restart nfsd when null rpc call fails Mountd_nullrpc_restart Boolean to indicate if we should restart mountd when null rpc call fails示例 14 通过禁用然后启用资源清除 Start_failed 资源状态Line breaks in the Descriptions column are added to enhance the readability of this example. Actual output from the command does not contain these line breaks.
Start_failed 资源状况指示 Start 或 Prenet_start 方法对某个资源失败或超时,但该资源的资源组仍已联机。即使该资源处于故障状况,可能不提供服务,其资源组仍然会联机。如果资源的 Failover_mode 属性设置为 None 或者设置为阻止资源组故障转移的另一个值,则可能会出现此状况。
与 Stop_failed 资源状况不同,Start_failed 资源状况不会阻止您或 Oracle Solaris Cluster 软件对资源组执行操作。无需发出 command clear 命令来清除 Start_failed 资源状况。只需执行一个可重新启动资源的命令。
以下命令通过禁用然后重新启用 resource-1 资源来清除该资源发生的 Start_failed 资源状态。
# clresource disable resource-1 # clresource enable resource-1
有关以下属性的描述,请参见 attributes(5):
|
Intro(1CL), clreslogicalhostname(1CL ), clresourcegroup(1CL), clresourcetype(1CL), clressharedaddress(1CL), cluster(1CL), scha_calls(3HA), clconfiguration(5CL), attributes(5), r_properties(5), rbac(5)
Oracle Solaris Cluster 数据服务规划和管理指南
超级用户可以运行此命令的所有格式。
任何用户都可以运行带有以下选项的此命令:
–? 选项
–V 选项
要运行带有子命令的此命令,超级用户以外的用户需要具有 RBAC 授权。请参见下表。
|