Oracle® Solaris Cluster 参考手册

退出打印视图

更新时间: 2014 年 7 月,E51743-01
 
 

clrslh (1CL )

名称

clreslogicalhostname, clrslh - 管理 Oracle Solaris Cluster 逻辑主机名的资源

用法概要

/usr/cluster/bin/clreslogicalhostname [subcommand] -?
/usr/cluster/bin/clreslogicalhostname -V
/usr/cluster/bin/clreslogicalhostname [subcommand [options]] -v 
     [lhresource]...
/usr/cluster/bin/clreslogicalhostname create -g resourcegroup 
     [-h lhost[,…]] [-N netif@node[,…]] [-p name=value] 
     [-Z {zoneclustername | global}] [-d] lhresource
/usr/cluster/bin/clreslogicalhostname create -i 
     {- | clconfiguration} [-a] [-g resourcegroup[,…]] [-p 
     name=value] [-d] {+ | lhresource...}
/usr/cluster/bin/clreslogicalhostname delete [-g resourcegroup[,…]]
     [-Z {zoneclustername | global}] [-F] {+ | lhresource...}
/usr/cluster/bin/clreslogicalhostname disable [-g resourcegroup[,…]] 
     [-R] [-n node[,…]] [-Z {zoneclustername | global}] 
     {+ | lhresource...}
/usr/cluster/bin/clreslogicalhostname enable [-g resourcegroup[,…]] 
     [-R] [-n node[,…]] [-Z {zoneclustername | global}] 
     {+ | lhresource...}
/usr/cluster/bin/clreslogicalhostname export [-o {- | configfile}] 
     [+ | lhresource...]
/usr/cluster/bin/clreslogicalhostname list [-s state[,…]] 
     [-g resourcegroup[,…]] [-Z {zoneclustername 
     [,...] | global | all}] [+ | lhresource...]
/usr/cluster/bin/clreslogicalhostname list-props [-l listtype] 
     [-p name[,…]] [-Z {zoneclustername [,...] | global | all}] 
     [+ | lhresource...]
/usr/cluster/bin/clreslogicalhostname monitor [-g resourcegroup[,…]] 
     [-Z zoneclustername | all | global] {+ | lhresource...}
/usr/cluster/bin/clreslogicalhostname reset [-f errorflag] [-g 
     resourcegroup[,…]] [-Z {zoneclustername | global}] 
     {+ | lhresource...}
/usr/cluster/bin/clreslogicalhostname set [-i 
     {- | clconfiguration}] [-g resourcegroup[,…]] [-p name
     [+|-]=value] [-Z {zoneclustername}] {+ | lhresource...}
/usr/cluster/bin/clreslogicalhostname show [-g resourcegroup[,…]] 
     [-p name[,…]] [-Z {zoneclustername [,...] | global | all}] 
     [+ | lhresource...]
/usr/cluster/bin/clreslogicalhostname status [-s state[,…]] 
     [-n node[,…]] [-g resourcegroup[,…]] [-Z 
     {zoneclustername [,...] | global | all}] [+ | lhresource...]
/usr/cluster/bin/clreslogicalhostname unmonitor [-g 
     resourcegroup[,…]] [-Z {zoneclustername | global}] 
     {+ | lhresource...}

描述

clreslogicalhostname 命令可管理 Oracle Solaris Cluster 逻辑主机名的资源。clrslh 命令是 clreslogicalhostname 命令的简短格式。clreslogicalhostname 命令和 clrslh 命令是相同的。您可以使用此命令的任一种格式。

clreslogicalhostname 命令包含一些用于方便地创建逻辑主机名资源的内置选项。clreslogicalhostname 命令还支持自动创建 Solaris IP 多路径 (IP multipathing, IPMP) 组。

clreslogicalhostname 命令的一些子命令可修改资源配置。

  • disable

  • enable

  • monitor

  • reset

  • set

  • unmonitor

clreslogicalhostname 命令的某些子命令只获取有关资源的信息。可以从全局群集或区域群集使用这些子命令:以下命令只获取有关资源的信息:

  • export

  • list

  • list-props

  • show

  • status

为了避免此命令产生不可预测的结果,请从全局群集节点运行该命令的所有格式。

此命令的一般格式如下所示:

clreslogicalhostname [subcommand] [options] [operands]

仅当 options 指定了 –?–o– V–v 选项时,才能省略 subcommand

此命令的每个选项都有长格式和简短格式两种格式。在本手册页的“选项”部分给出了每个选项的两种格式,以及对该选项的描述。

在区域群集中的操作

在区域群集中,可以将 clreslogicalhostname 命令与所有子命令(export 除外)一起使用。

也可以将 –Z 选项与所有子命令(export 除外)一起使用来指定要将操作限制到的特定区域群集的名称。另外,还可以将区域群集名称附加到逻辑主机名资源 (zoneclustername : lhresource),以便将操作限制到特定的区域群集。

您可以从全局群集节点访问所有区域群集信息,但无法从特定区域群集访问其他区域群集信息。如果不将操作限制到特定区域群集,则所用的子命令仅会在当前群集中运行。

子命令

支持以下子命令:

create

创建指定为命令操作数的逻辑主机名资源。

create–i 选项一起使用以指定配置文件时,该子命令接受使用加号 (+) 作为操作数。使用 + 操作数时,将会创建配置文件中提供的尚不存在的所有资源。

使用 create 子命令之前,请确保 /etc/netmasks 文件具有所有逻辑主机名对应的 IP 地址子网和网络掩码条目。如有必要,请编辑 /etc/netmasks 文件以添加缺少的任何条目。

默认情况下,创建的资源处于启用状态,且启用了监视功能。但是,仅当资源的资源组联机后,该资源才会联机并受到监视。要在禁用状态下创建资源,请指定 –d 选项。

您可以在全局群集中或区域群集中使用该子命令。

要从全局群集在区域群集中创建逻辑主机名资源,请使用 –Z 选项指定该区域群集的名称。

超级用户以外的用户需要具有 solaris.cluster.modify 基于角色的访问控制 (Role-Based Access Control, RBAC) 授权才能使用该子命令。

另请参见 delete 子命令的描述。

delete

删除指定为命令操作数的逻辑主机名资源。此子命令接受使用加号 (+) 作为操作数来指定删除所有资源。

–g 选项可以过滤操作数列表,以限制删除的资源。–g 选项只会删除操作数列表内属于 resourcegrouplist 中资源组的成员的资源。

  • 默认情况下,仅当符合以下条件时,才会删除某个资源:

  • 已禁用该资源。

  • 已消除该资源的所有依赖性。

  • 要确保删除所有指定的资源,请指定 –F 选项。–F 选项的效果如下所示:

  • 删除所有指定的资源,即使是未禁用的资源。

  • 从其他资源的资源依赖性设置中删除所有指定的资源。

将按照满足资源间依赖性所需的顺序禁用资源,而不管资源在命令行上的指定顺序。

您可以在全局群集中或区域群集中使用该子命令。

要从全局群集删除区域群集中的逻辑主机名资源,请使用 –Z 选项指定区域群集名称。

超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。

另请参见 create 子命令的描述。

disable

禁用指定为命令操作数的逻辑主机名资源。此子命令接受使用加号 (+) 作为操作数来指定禁用所有资源。

–g 选项可以过滤操作数列表,以限制禁用的资源。–g 选项只会禁用操作数列表内属于 resourcegrouplist 中资源组的成员的资源。

要确保满足所有必需的资源依赖性,请指定 –R 选项。–R 选项将会禁用依赖于指定为命令操作数的资源的任何资源,即使这些资源未指定为命令操作数。–g 选项和 –t 选项不适用于仅为满足资源依赖性而禁用的资源。

将按照满足资源间依赖性所需的顺序禁用资源,而不管资源在命令行上的指定顺序。

您可以在全局群集中或区域群集中使用该子命令。

要从全局群集禁用在区域群集中注册的逻辑主机名资源,请使用 –Z 选项指定区域群集名称。

超级用户以外的用户需要具有 solaris.cluster.admin RBAC 授权才能使用该子命令。

另请参见 enable 子命令的描述。

enable

启用指定为命令操作数的逻辑主机名资源。此子命令接受使用加号 (+) 作为操作数来指定启用所有资源。

–g 选项可以过滤操作数列表,以限制启用的资源。–g 选项仅启用操作数列表内属于 resourcegrouplist 中资源组的成员的资源。

要确保满足所有必需的资源依赖性,请指定 –R 选项。–R 选项将会启用依赖于指定为命令操作数的资源的任何资源,即使这些资源未指定为命令操作数。–g 选项不适用于仅为满足资源依赖性而启用的资源。

将按照满足资源间依赖性所需的顺序禁用资源,而不管资源在命令行上的指定顺序。

您可以在全局群集中或区域群集中使用该子命令。

要从全局群集启用在区域群集中注册的逻辑主机名资源,请使用 –Z 选项指定区域群集名称。

超级用户以外的用户需要具有 solaris.cluster.admin RBAC 授权才能使用该子命令。

另请参见 disable 子命令的描述。

export

clconfiguration(5CL) 手册页所述的格式导出逻辑主机名资源配置。

只能在全局群集中使用该子命令。

超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。

list

显示指定为命令操作数的逻辑主机名资源的列表。默认情况下,会显示所有资源。

–g 选项可以过滤操作数列表,以限制显示的资源。–g 选项只会显示操作数列表内属于 resourcegrouplist 中资源组的成员的资源。

此子命令接受使用加号 (+) 作为操作数来指定特定资源组中的所有资源,或者指定属于特定资源类型实例的所有资源。如果未提供操作数,则会显示指定资源组中的所有资源,或显示属于指定资源类型的实例的所有资源。

如果指定 –v 选项,还将显示列表中每个资源的资源组和资源类型。

您可以在全局群集中或区域群集中使用该子命令。

要从全局群集查看在区域群集中注册的逻辑主机名资源,请使用 –Z 选项指定区域群集名称。

超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。

list-props

显示指定为命令操作数的逻辑主机名资源的属性列表。默认情况下,会显示所有资源的扩展属性。

以下选项可以过滤操作数列表,以限制要显示其属性的资源:

–g resourcegrouplist

仅显示操作数列表内属于 resourcegrouplist 中资源组成员的逻辑主机名资源的属性。

–l 选项指定要显示的资源属性的类型:

–l all

指定显示标准属性和扩展属性。

–l extension

指定只显示扩展属性。默认情况下,只显示扩展属性。

–l standard

指定只显示标准属性。

如果未指定 –l 选项,将只显示扩展属性,除非使用 –p 选项或 –y 选项明确指定标准属性。

–p 选项用于限制要显示的资源属性集。–p 选项只显示 namelist 中指定的属性。您可以在 namelist 中指定标准属性和扩展属性。

如果指定 –v 选项,还将显示每个属性的描述。

此子命令接受使用加号 (+) 作为操作数来指定特定资源组中的所有资源,或者指定属于特定资源类型实例的所有资源。如果未提供操作数,则会显示指定资源组中所有资源的属性,或显示属于指定资源类型的实例的所有资源的属性。

您可以在全局群集中或区域群集中使用该子命令。

要查看区域群集中的逻辑主机名资源的属性列表,请使用 –Z 选项指定区域群集名称。

超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。

monitor

开启对指定为命令操作数的逻辑主机名资源的监视。此子命令接受使用加号 (+) 作为操作数来指定开启对所有资源的监视。

–g 选项可以过滤操作数列表,以限制监视的资源。–g 选项只会监视操作数列表内属于 resourcegrouplist 中资源组的成员的资源。

  • 开启对某个资源的监视后,仅当符合以下条件时,才会监视该资源:

  • 已启用该资源。

  • 包含该资源的资源组至少已在一个群集节点上联机。


注 -  开启对某个资源的监视不会启用该资源。

您可以在全局群集中或区域群集中使用该子命令。

要从全局群集监视区域群集中的资源,请使用 –Z 选项指定区域群集名称。

超级用户以外的用户需要具有 solaris.cluster.admin RBAC 授权才能使用该子命令。

另请参见 unmonitor 子命令的描述。

reset

清除与指定为命令操作数的逻辑主机名资源关联的错误标志。此子命令接受使用加号 (+) 作为操作数来指定清除所有资源的错误标志。

–g 选项可以过滤操作数列表,以限制重置的资源。–g 选项只会重置操作数列表内属于 resourcegrouplist 中资源组的成员的资源。

默认情况下,reset 子命令将会清除 STOP_FAILED 错误标志。要显式指定要清除的错误标志,请使用 –f 选项。– f 选项接受的唯一错误标志是 STOP_FAILED 错误标志。

您可以在全局群集中或区域群集中使用该子命令。

要从全局群集重置区域群集中的逻辑主机名资源,请使用 –Z 选项指定区域群集名称。

超级用户以外的用户需要具有 solaris.cluster.admin RBAC 授权才能使用该子命令。

set

修改指定为命令操作数的逻辑主机名资源的特定属性。此子命令接受使用加号 (+) 作为操作数来指定修改所有资源的特定属性。

–g 选项可以过滤操作数列表,以限制修改的资源。–g 选项只会修改操作数列表内属于 resourcegrouplist 中资源组的成员的资源。

您可以在全局群集中或区域群集中使用该子命令。

要从全局群集设置区域群集中逻辑主机名资源的属性,请使用 –Z 选项指定区域群集名称。

超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。

show

显示指定为命令操作数的逻辑主机名资源的配置。默认情况下,会显示所有资源的配置。

–g 选项可以过滤操作数列表,以限制要显示其配置的资源。–g 选项只会显示操作数列表内属于 resourcegrouplist 中资源组成员的资源的配置。

–p 选项用于限制要显示的资源属性集。–p 选项只显示 namelist 中指定的属性。您可以在 namelist 中指定标准属性和扩展属性。

此子命令接受使用加号 (+) 作为操作数来指定特定资源组中的所有资源,或者指定属于特定资源类型实例的所有资源。如果未提供操作数,则会显示指定资源组中所有资源的配置,或显示属于指定资源类型实例的所有资源的配置。

您可以在全局群集中或区域群集中使用该子命令。

要从全局群集查看区域群集中逻辑主机名资源的配置,请使用 –Z 选项指定区域群集名称。

超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。

status

显示指定为命令操作数的逻辑主机名资源的状态。默认情况下,会显示所有资源的状态。

以下选项可以过滤操作数列表,以限制要显示其状态的资源的列表:

–g resourcegrouplist

仅显示操作数列表内属于 resourcegrouplist 中资源组成员的资源的状态。

–n nodelist

仅显示操作数列表内承载在 nodelist 中节点上的资源的状态。

–s statelist

仅显示操作数列表内处于 statelist 中的状况的资源的状态。

此子命令接受使用加号 (+) 作为操作数来指定特定资源组中的所有资源,或者指定属于特定资源类型实例的所有资源。如果未提供操作数,则会显示指定资源组中所有资源的状态,或显示属于指定资源类型实例的所有资源的状态。

您可以在全局群集中或区域群集中使用该子命令。

要从全局群集查看区域群集中逻辑主机名资源的状态,请使用 –Z 选项指定区域群集名称。

超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。

unmonitor

关闭对指定为命令操作数的逻辑主机名资源的监视。此子命令接受使用加号 (+) 作为操作数来指定关闭对所有资源的监视。

如果关闭对某个被禁用资源的监视,该资源不会受到影响。该资源及其监视器已脱机。


注 -  关闭对某个资源的监视不会禁用该资源。但是,当您禁用某个资源时,不需要关闭对该资源的监视。禁用的资源及其监视器将保持脱机状态。

–g 选项可以过滤操作数列表,以限制要对其关闭监视的资源。–g 选项将对操作数列表内属于 resourcegrouplist 中资源组的成员的资源关闭监视。

您可以在全局群集中或区域群集中使用该子命令。

要从全局群集关闭对区域群集中逻辑主机名资源的监视,请使用 –Z 选项指定区域群集名称。

超级用户以外的用户需要具有 solaris.cluster.admin RBAC 授权才能使用该子命令。

另请参见 disable 子命令和 monitor 子命令的描述。

选项

支持以下选项:

–?
–-help

显示帮助信息。使用该选项时,不会执行任何其他处理。

指定此选项时,子命令可有可无。

如果仅指定此选项而不使用子命令,将会显示此命令的子命令列表。

如果使用子命令且指定此选项,将会显示该子命令的用法选项。

此选项与特定子命令一起使用的效果如下所示:

create

–g 选项一起指定时,此选项将会显示指定资源组的所有资源属性的帮助信息。

set

显示指定为命令操作数的资源的属性的帮助信息。

–a
–-automatic

当基于群集配置信息创建资源时,将自动执行以下附加操作:

  • 注册资源类型

  • 创建资源组

  • 创建操作数列表中指定的资源所依赖的资源

  • 群集配置信息包含的信息必须足以执行以下所有操作:

  • 启用要注册的资源类型

  • 启用要创建的资源组

  • 启用要创建的资源

此选项仅可以与 create 子命令一同指定。如果指定此选项,还必须指定 –i 选项并提供配置文件。

–d
–-disable

创建资源后禁用该资源。此选项仅可以与 create 子命令一同指定。默认情况下,资源在启用状态下创建。

启用某个资源并不保证该资源联机。仅当资源所在的资源组已在至少一个节点上联机后,该资源才会联机。

–f errorflag
–-flag errorflag

显式指定要通过 reset 子命令清除的错误标志。此选项仅可以与 reset 子命令一同指定。默认情况下,reset 子命令将会清除 STOP_FAILED 错误标志。

–f 选项接受的唯一错误标志是 STOP_FAILED 错误标志。

–F
–-force

强制删除未禁用的资源。此选项仅可以与 delete 子命令一同指定。

–g resourcegroup[,…]
–-resourcegroup resourcegroup[,…]

指定一个资源组或资源组列表。

对于除 create 以外的子命令,该命令仅对操作数列表内属于 –g 选项指定的资源组成员的资源起作用。

此选项与特定子命令一起使用的效果如下所示:

create

指定在特定资源组中创建资源。将 –gcreate 子命令一起使用时,只能指定一个资源组。

–h lhost[,…]
–-logicalhost lhost[,…]

指定此资源代表的逻辑主机名的列表。当有多个逻辑主机名要与新的逻辑主机名资源相关联,或者当逻辑主机名与资源本身不同名时,必须使用 –h 选项。列表中的所有逻辑主机名必须位于同一子网中。如果未指定 –h 选项,该资源将代表与资源本身同名的单个逻辑主机名。

您可以使用 –h,而无需使用 –p 来设置 HostnameList 属性。但是,不能在同一命令中使用 –h 并显式设置 HostnameList

–h 只能与 create 子命令一起使用。


注 -  对于区域群集,必须在区域群集配置中的全局范围内的网络属性中,指定所有逻辑主机名或相应的 IP 地址。否则,资源组创建将会失败。

有关全局范围网络属性的更多信息,请参阅 clzonecluster(1CL) 手册页。


–i {- | clconfiguration}
–-input {- | clconfiguration}

指定用于创建或修改逻辑主机名资源的配置信息。此信息必须符合 clconfiguration(5CL) 手册页中定义的格式。此信息可包含在文件中或者通过标准输入提供。要指定标准输入,请指定 - 而不是文件名。

仅会创建或修改作为命令操作数提供的资源。在命令中指定的选项将会覆盖配置信息中设置的任何选项。如果配置信息中缺少配置参数,则必须在命令行中指定这些参数。

此选项与特定子命令一起使用的效果如下所示:

create

–a 选项一起指定时,此选项将注册所有必需的资源类型,并创建所有必需的资源组。您必须提供注册和配置所需的全部信息。所有其他配置数据将被忽略。

–l listtype
–-listtype listtype

指定要通过 list-props 子命令显示的资源属性的类型。此选项仅可以与 list-props 子命令一同指定。

必须根据以下列表为 listtype 指定一个值:

all

指定显示标准属性和扩展属性。

extension

指定只显示扩展属性。默认情况下,只显示扩展属性。

standard

指定只显示标准属性。

如果未指定 –l 选项,则只显示扩展属性,除非使用 –p 选项明确指定标准属性。

–n node[,…]
–-node node[,…]

指定目标全局群集或区域群集中的一个节点或一系列节点。可以使用节点名称或节点 ID 指定每个节点。如果指定 –Z 选项,则仅可以使用 –n 选项指定区域群集主机名,而不能指定全局群集主机名。如果未指定 –Z 选项,则仅可以使用 –n 选项指定全局群集主机名。

可以与此选项一起指定的子命令如下所述:

disable

只禁用操作数列表中承载在指定节点上的资源。

enable

只启用操作数列表中承载在指定节点上的资源。

status

仅报告操作数列表中承载在指定节点上的资源的状态。

–N netif@node[,…]
–-netiflist netif@node[,…]

指定一个资源属性。通过 –N 选项,可以设置 NetIfList 属性,而不必使用 –p 选项来指定该属性。如果未指定 –Nclreslogicalhostname 命令将尝试根据可用 IPMP 组或公共适配器以及与 HostnameList 属性关联的子网来设置 NetIfList 属性。

可以采用 ipmpgroup@node[,…] 或 publicNIC@node[,…] 格式指定 NetIfList 属性。如果未使用 –N,或者将该选项与 publicNIC@node 一起使用,则 clreslogicalhostname 命令将尝试创建必要的 IPMP 组。系统将会创建包含基本默认值的单适配器 IPMP 组,以后,用户可以使用标准的 Solaris IPMP 接口修改这些组。只会在全局群集节点中自动创建 IPMP 组。

您可以使用 –N,而无需使用 –p 直接设置 NetIfList 属性。但是,不能在同一命令中使用 –N 并显式设置 NetIfList

–N 只能与 create 子命令一起使用。

–o {- | clconfiguration}
–-output {- | clconfiguration}

指定要将资源配置信息写入到的位置。此位置可以是文件,也可以是标准输出。要指定标准输出,请指定 - 而不是文件名。如果指定标准输出,将会抑制该命令的其他所有标准输出。此选项仅可以与 export 子命令一同指定。

只会写入作为命令操作数提供的资源的配置信息。信息是采用 clconfiguration(5CL) 手册页中定义的格式写入的。

–p name=value
–p name+=array-values
–p name-=array-values
–-property name=value
–-property name+=value-values
–-property name-=value-values

设置资源的标准属性和扩展属性。此选项仅可以与 create 子命令和 set 子命令一同指定。

有关标准属性的描述,请参见 r_properties(5) 手册页。

有关某个资源类型的扩展属性的描述,请参见该资源类型的文档。

与此选项一起使用的运算符如下所述:

=

将属性设置为指定值。create 子命令和 set 子命令接受此运算符。

+=

将一个或多个值添加到某个字符串数组值。只有 set 子命令接受此运算符。只能为字符串数组值指定此运算符。

-=

从某个字符串数组值中删除一个或多个值。只有 set 子命令接受此运算符。只能为字符串数组值指定此运算符。

如果只需在群集节点的子集上设置每节点属性,请通过在属性名称后面附加节点列表(用大括号括住)来指定要设置该属性的节点,如下所示:

name{nodelist}

nodelist 是以逗号分隔的节点名称或节点 ID 的列表。有关每节点属性的更多信息,请参见 rt_properties(5) 手册页。

–p name[,…]
–-property name[,…]

list-props 子命令和 show 子命令指定属性列表。

可将此选项用于资源的标准属性和扩展属性。

有关标准属性的描述,请参见 r_properties(5) 手册页。

有关某个资源类型的扩展属性的描述,请参见该资源类型的文档。

如果未指定此选项,list-props 子命令和 show 子命令将会列出所有资源属性或大多数资源属性,具体取决于是否同时指定了 –v 选项。

–R
–-recursive

以递归方式启用或禁用资源,以确保满足所有必需的依赖性。此选项仅可以与 disable 子命令和 enable 子命令一同指定。

此选项与这些子命令一起使用的效果如下所示:

disable

禁用依赖于指定为命令操作数的资源的任何资源,即使这些资源未指定为命令操作数。

enable

启用指定为命令操作数的资源所依赖的任何资源,即使这些资源未指定为命令操作数。

–s state[,…]
–-state state[,…]

list 子命令和 status 子命令指定状况列表。

此选项将会限制输出,以便只包括在节点列表中的一个或多个节点上处于指定状况之一的资源。

可能的状况如下:

  • degraded

  • detached

  • faulted

  • monitor_failed

  • not_online-指定除 onlineonline_not_monitored 以外的任何状况

  • offline

  • online

  • online_not_monitored

  • start_failed

  • stop_failed

  • unknown

  • unmonitored

  • wait

–V
–-version

显示该命令的版本。

指定此选项时,不要将其与子命令、操作数或其他选项结合使用。子命令、操作数或其他选项将被忽略。–V 选项只显示命令的版本。不会执行任何其他操作。

–v
–-verbose

将详细消息显示到标准输出。

可以在任何格式的此命令中指定该选项。

请不要同时指定 –v 选项和 –o - 选项。否则 –v 选项将被忽略。–o - 选项会抑制其他所有标准输出。

–Z {zoneclustername | global | all}
–-zoneclustername={zoneclustername | global | all}
–-zoneclustername {zoneclustername | global | all}

指定一个或多个存在资源且您要对其执行操作的群集。

export 子命令以外的所有子命令均支持此选项。

如果指定此选项,还必须指定以下列表中的参数之一:

zoneclustername

指定使用此选项的命令仅对名为 zoneclustername 的区域群集中的所有指定资源起作用。

global

指定使用此选项的命令仅对全局群集中的所有指定资源进行操作。

all

如果在全局群集中使用此参数,则会指定使用此参数的命令对所有群集(包括全局群集和所有区域群集)中的所有指定资源起作用。

如果在某区域群集中使用此参数,则会指定使用此参数的命令仅对该区域群集中的所有指定资源起作用。

操作数

支持以下操作数:

resource

指定应接受 Oracle Solaris Cluster 资源名称作为操作数。如果子命令接受多个资源,则可以使用加号 (+) 指定所有逻辑主机名资源。

退出状态

如果命令对于所有指定的操作数均成功执行,则返回零 (CL_NOERR)。如果某个操作数出错,命令会继续处理操作数列表中的下一个操作数。返回的退出代码始终反映最先发生的错误。

此命令返回下列退出状态代码:

0 CL_NOERR

没有错误

您发出的命令已成功完成。

1 CL_ENOMEM

交换空间不足

某个群集节点耗尽了交换内存或其他操作系统资源。

3 CL_EINVAL

参数无效

您键入的命令不正确,或者使用 –i 选项提供的群集配置信息语法不正确。

6 CL_EACCESS

权限被拒绝

指定的对象不可访问。要发出命令,可能需要拥有超级用户或 RBAC 访问权限。有关更多信息,请参见 su(1M)rbac(5) 手册页。

9 CL_ESTATE

对象处于错误状况

您尝试修改一个在特定时间无法修改,或任何时候均无法修改的属性、资源组或其他对象。

10 CL_EMETHOD

资源方法失败

资源方法失败。方法因以下某个原因而失败:

  • 尝试创建资源或修改资源属性时,validate 方法失败。

  • 尝试启用、禁用或删除资源时,validate 以外的其他方法失败。

15 CL_EPROP

属性无效

您使用 –p–y–x 选项指定的属性或值不存在或不被允许。

35 CL_EIO

I/O 错误

发生了物理输入/输出错误。

36 CL_ENOENT

没有这样的对象

由于以下某个原因,找不到您所指定的对象:

  • 该对象不存在。

  • 您尝试使用 –o 选项创建的配置文件路径中的某个目录不存在。

  • 您尝试使用 –i 选项访问的配置文件包含错误。

39 CL_EEXIST

对象已存在

您所指定的设备、设备组、群集互连组件、节点、群集、资源、资源类型、资源组或专用字符串已存在。

这些退出值与 scha_calls(3HA) 手册页中描述的返回码兼容。

示例

示例 1 创建逻辑主机名资源

此命令将在名为 rg-failover 的资源组内创建名为 logicalhost1 的资源。创建的资源处于启用状况,并启用了监视功能。

# clreslogicalhostname create -g rg-failover logicalhost1

以下两个命令中的任何一个都将在区域群集 ZC 中创建一个名为 logicalhost1 的资源。可以从全局群集节点或区域群集 ZC 执行这些命令。如果从区域群集执行命令,则使用区域群集名称显式定义资源范围的操作是可选的。

# clreslogicalhostname create -g rg-failover -Z ZC logicalhost1
# clreslogicalhostname create -g rg-failover ZC:logicalhost1
示例 2 使用不同的逻辑主机名创建逻辑主机名资源

此命令将在名为 rg-failover 的资源组中创建一个名为 rs-logicalhost1 的资源。

逻辑主机名与资源名称不相同,但逻辑主机的名称和 IP 地址保持相同。

# clreslogicalhostname create -g rg-failover \
-h logicalhost1 rs-logicalhost1
示例 3 为逻辑主机名资源指定 IPMP 组

此命令将为 logicalhost1 资源设置 IPMP 组。

# clreslogicalhostname create -g rg-failover \
-N ipmp0@black,ipmp0@white logicalhost1
示例 4 删除逻辑主机名资源

此命令可删除名为 logicalhost1 的资源。

# clreslogicalhostname delete logicalhost1
示例 5 列出逻辑主机名资源

此命令将列出所有逻辑主机名资源。

# clreslogicalhostname list
logicalhost1
logicalhost2
示例 6 列出逻辑主机名资源及其资源组和资源类型

此命令将列出所有逻辑主机名资源及其资源组和资源类型。

# clreslogicalhostname list -v
Resources    Resource Groups Resource Types
---------    --------------- --------------
logicalhost1 rg-failover-1   SUNW.LogicalHostname
logicalhost2 rg-failover-2   SUNW.LogicalHostname
示例 7 列出逻辑主机名资源的扩展属性

此命令将列出所有逻辑主机名资源的扩展属性。

# clreslogicalhostname list-props -v
Properties       Descriptions
----------       ------------
NetIfList        List of IPMP groups on each node
HostnameList     List of hostnames this resource manages
CheckNameService Name service check flag

属性

有关以下属性的描述,请参见 attributes(5)

属性类型
属性值
可用性
ha-cluster/system/core
接口稳定性
Evolving(发展中)

另请参见

Intro(1CL)cluster(1CL)clresource(1CL)clressharedaddress(1CL)clresourcegroup(1CL)clresourcetype(1CL)scha_calls(3HA)clconfiguration(5CL)rbac(5)r_properties(5)

附注

超级用户可以运行此命令的所有格式。

任何用户都可以运行带有以下选项的此命令:

  • –? 选项

  • –V 选项

要运行带有子命令的此命令,超级用户以外的用户需要具有 RBAC 授权。请参见下表。

子命令
RBAC 授权
create
solaris.cluster.modify
delete
solaris.cluster.modify
disable
solaris.cluster.admin
enable
solaris.cluster.admin
export
solaris.cluster.read
list
solaris.cluster.read
list-props
solaris.cluster.read
monitor
solaris.cluster.admin
reset
solaris.cluster.admin
set
solaris.cluster.modify
show
solaris.cluster.read
status
solaris.cluster.read
unmonitor
solaris.cluster.admin