Sun Cluster 数据服务开发者指南(适用于 Solaris OS)

附录 A 标准特性

本附录介绍资源类型、资源组和资源的标准特性。 此外,本附录还介绍可用来更改系统定义的特性和用来创建扩展特性的资源特性属性。

本附录包含以下几个主要部分:


注意:

特性值(例如 TrueFalse区分大小写。


资源类型特性

下表介绍了 Sun Cluster 定义的资源类型特性。 特性值分为以下几类(在“类别”列中):

资源类型特性无法通过管理公用程序进行更新。不过 Installed_nodes 除外,该特性无法在 RTR 文件中进行声明,而是必须由管理员设置。

表 A–1 资源类型特性

特性名称 

说明 

是否可以更新? 

类别 

Allow_hosts(字符串数组)

用于控制一组客户机,允许这些客户机通过 cl_apid 守护程序进行登记以接收群集重新配置事件。 该特性的格式一般为 ipaddress/masklength,其中定义了允许其上包含的客户机进行登记的子网。 例如,设置 129.99.77.0/24 允许位于 129.99.77 子网上的客户机登记事件。 这里还有另外一个例子,192.9.84.231/32 仅允许客户机 192.9.84.231 登记事件。 此特性可以为 CRNP 提供保护。 cl_apid 守护程序在 SUNW.Event( 5) 中介绍。

此外,还可以识别以下特殊关键字。 LOCAL 指的是直接连接的群集子网中的所有客户机。 ALL 允许所有客户机进行登记。 注意,如果某个客户机同时与 Allow_hostsDeny_hosts 特性中的项相匹配,则该实现将阻止客户机进行登记。

缺省值为 LOCAL

可选的 

API_version(整数)

此资源类型实现所使用的资源管理 API 的版本。  

Sun Cluster 3.1 4/04 中,该特性的缺省值为 2。  

N  

可选的 

Boot(字符串)

一种可选的回叫方法: 节点连接或重新连接群集时,RGM 将对此节点调用的程序的路径(此类型的资源处于被管理状态时)。 与 Init 方法相似,此方法将对此类型的资源执行初始化操作。

有条件的/显式  

Client_retry_count(整数)

控制 cl_apid 守护程序在与外部客户机进行通信的期间进行尝试的次数。 如果经过 Client_retry_count 次尝试后客户机仍无响应,则该客户机超时。 随后将从有资格接收群集重新配置事件的已登记客户机列表中删除该客户机。 要想重新开始接收事件,必须重新登记该客户机。 要了解有关该实现的重试频率,请参阅 Client_retry_interval 特性的描述。 SUNW.Event(5) 中介绍了 cl_apid 守护程序。

缺省值为 3。 

可选的 

Client_retry_interval(整数)

定义 cl_apid 守护程序在与未响应的外部客户机进行通信时所用的时间期限(以秒计算)。 在此间隔内最多可以进行 Client_retry_count 次尝试来连接该客户机。 cl_apid 守护程序在 SUNW.Event( 5) 中进行说明。

缺省值为 1800。 

可选的 

Client_timeout(整数)

在与外部客户机通信时 cl_apid 守护程序使用的超时值(以秒计算)。 但是,cl_apid 守护程序连续尝试连接该客户机的次数可变。 要了解更多关于可用于调节该特性的方法,请参阅 Client_retry_countClient_retry_interval 特性。 cl_apid 守护程序在 SUNW.Event( 5) 中进行说明。

缺省值为 60。  

Y  

可选的 

Deny_hosts(字符串数组)

控制一组客户机,不允许该组客户进行登记来接收群集重新配置事件。 确定权限时,该特性的设置优先于 Allow_hosts 列表中的其它特性的设置。 此特性的格式与 Allow_hosts 特性中定义的格式相同。 此特性可以为 CRNP 提供保护。

缺省值为 NULL

Y  

可选的 

Failover(布尔值)

True 表示在可以在多个节点上联机的任何组内无法配置此类型资源 。 缺省值为 False

可选的 

Fini(字符串)

一种可选的回叫方法: 从 RGM 管理中删除此类型的资源时,RGM 所调用的程序的路径。 

有条件的/显式 

Init(字符串)

一种可选的回叫方法: 当此类型的资源开始处于 RGM 的管理之下时,RGM 所调用的程序的路径。 

有条件的/显式 

Init_nodes(枚举值)

值可以是 RG_primaries(仅适用于可以控制资源的节点)或 RT_installed_nodes(适用于安装了此资源类型的所有节点)。 表明 RGM 对哪些节点调用 InitFiniBootValidate 方法。

缺省值为 RG_primaries

可选的 

Installed_nodes(字符串数组)

可以在其上运行该资源类型的群集节点的名称列表。 RGM 将自动创建此特性。 群集管理员可以设置此值。 不能在 RTR 文件中声明该特性。  

缺省值是所有群集节点。 

可以由群集管理员进行配置 

Max_clients(整数)

控制客户机的最大数量,这些客户机可以通过 cl_apid 守护程序进行登记,以接收群集事件通知。 其它客户机为接收事件而进行的登记尝试将被您的应用程序拒绝。 由于每个客户机登记中都使用群集上的资源,则调节此特性使用户可以控制外部客户机对群集上的资源的使用。 cl_apid 守护程序在 SUNW.Event( 5) 中进行说明。

缺省值为 1000。 

可选的 

Monitor_check(字符串)

一种可选的回叫方法: 在对此类型的资源执行监视器所请求的失效转移之前,RGM 调用的程序的路径。  

N  

有条件的/显式 

Monitor_start(字符串)

一种可选的回叫方法: 为启动该类型资源的缺省监视器,RGM 调用的程序的路径。 

有条件的/显式 

Monitor_stop(字符串)

设置 Monitor_start 后需要的一种回叫方法: 为停止该类型资源的缺省监视器,RGM 调用的程序的路径。

有条件的/显式 

每个群集节点上的 Num_resource_restarts(整数)

RGM 将此特性设置为:在过去的 n 秒内在此节点上对该资源调用 scha_control RESTART 命令的次数,其中 n 是资源的 Retry_interval 特性的值。 如果某个资源类型没有声明 Retry_interval 特性,则 Num_resource_restarts 特性不可用于此类型资源。

仅限于查询 

Pkglist(字符串数组)

包含在资源类型安装中的软件包的可选列表。  

N  

有条件的/显式 

Postnet_stop(字符串)

一种可选的回叫方法: 在调用该类型资源所依赖的任何网络地址资源 (Network_resources_used) 的 Stop 方法后,RGM 调用的程序的路径。 此方法应该执行 STOP 操作,在将网络接口配置为关闭之后必须执行该操作。

N  

有条件的/显式 

Prenet_start(字符串)

一种可选的回叫方法: 在调用该类型资源所依赖的任何网络地址资源 (Network_resources_used) 的 Start 方法前,RGM 调用的程序的路径。 此方法应该执行 START 操作,在将网络接口配置为启用之前必须执行该操作。

N  

有条件的/显式 

Resource_type(字符串)

资源类型的名称。 要查看当前已登记的资源类型的名称,请使用:


scrgadm -p
在 Sun Cluster 3.1 及更高版本中,资源类型名称必须包含版本:

vendor_id.resource_type:version
资源类型名称的三个组成部分是 RTR 文件中指定的以下特性:Vendor_idResource_typeRT_versionscrgadm 命令将插入句点和冒号分界符。 资源类型名称中的 RT_version 后缀的值与 RT_version 特性的值相同。 为了确保 Vendor_id 的唯一性,建议使用创建该资源类型的公司的股票标志。 使用 Sun Cluster 3.1 以前的版本创建的资源类型名称将继续使用以下语法:

vendor_id.resource_type
缺省值为空字符串。

必需的 

RT_basedir(字符串)

用于完成回叫方法的相对路径的目录路径。 此路径将设置为安装资源类型软件包的位置。 它必须是完整的路径,即,必须以正斜杠 (/) 开始。 如果所有的方法路径名称都是绝对路径,则此特性不是必需的。

必需的,除非所有方法路径名称均为绝对路径 

RT_description(字符串)

资源类型的简单说明。  

缺省值为空字符串。 

N  

有条件的 

RT_version(字符串)

从 Sun Cluster 3.1 开始,实施该资源类型必需版本字符串。 RT_version 是完整资源类型名称的后缀部分。 从 Sun Cluster 3.1 开始,RT_version 特性已成为必需的特性(在 Sun Cluster 3.0 中为可选特性)。

N  

有条件的/显式 

Single_instance(布尔值)

True 表示在群集中只存在一个此类型的资源。 RGM 仅允许在群集中一次只运行此类型的一个资源。

缺省值为 False

可选的 

Start(字符串)

一种回叫方法: 为启动此类型的资源,RGM 调用的程序的路径。 

必需的(除非在 RTR 文件中声明了 Prenet_start 方法)

Stop(字符串)

一种回叫方法: 为停止此类型的资源,RGM 调用的程序的路径。  

N  

必需的(除非在 RTR 文件中声明了 Postnet_stop 方法)

Update(字符串)

一种可选的回叫方法: 当更改此类型的运行资源的特性时,RGM 所调用的程序的路径。 

有条件的/显式  

Validate(字符串)

一种可选的回叫方法: 为检查此类型的资源的特性值而调用的程序的路径。 

有条件的/显式  

Vendor_ID(字符串)

请参阅 Resource_type 特性。

有条件的 

资源特性

表 A–2 中介绍了 Sun Cluster 定义的资源特性。 特性值分为以下几类(在“类别”列中):

表 A–2 还列出了是否以及何时您可以更新资源类型(在“是否可以更新?”列中), 如下所示:

NoneFalse

从不 

TrueAnytime

任何时候 

At_creation

在将资源添加到群集时 

When_disabled

当资源被禁止时 

表 A–2 资源特性

特性名称 

说明 

是否可以更新?  

类别 

Affinity_timeout (整数)

以秒计算的时间长度,在这段时间从给定客户机 IP 地址指向资源中的任意服务的连接将发送到同一服务器节点。  

仅当 Load_balancing_policy 的值为 Lb_stickyLb_sticky_wild 时,此特性才适用。 此外,Weak_affinity 必须设置成 false(缺省值)。

此特性只用于可伸缩服务。  

任何时候 

可选的 

Cheap_probe_interval(整数)

在两次资源故障快速探测的调用之间的秒数。 此特性仅可由 RGM 创建,在 RTR 文件中声明后,管理员可以使用该特性。 

如果在 RTR 文件中指定了缺省值,则此特性是可选的。 如果未在资源类型文件中指定 Tunable 属性,则该特性的 Tunable 值为 When_disabled

如果未在 RTR 文件的特性声明中指定 Default 属性,则此特性为必需的。

禁用时  

有条件的 

扩展特性 

在资源类型的 RTR 文件中声明的扩展特性。 资源类型的实现中定义了这些特性。 有关可为扩展特性设置的各个属性的信息,请参阅表 A–4

取决于特定的特性 

有条件的 

Failover_mode(枚举值)

可能的设置为 NONESOFTHARD。 控制 RGM 是重新定位资源组还是中断节点来响应对资源调用 StartStopMonitor_stop 方法时发生的失败。 NONE 表示 RGM 在方法失败时只需设置资源状态并等待操作员的干预。 SOFT 表示 Start 方法的失败可能导致 RGM 将资源的组重新定位到另一个节点,而 StopMonitor_stop 方法的失败可能导致 RGM 将资源设置成 STOP_FAILED 状态,同时将资源组设置成 ERROR_STOP_FAILED 状态,并等待操作人员的干涉。 对于 StopMonitor_stop 失败,NONESOFT 设置等效。 HARD 表示 Start 方法的失败可能导致组的重新定位,通过中断群集节点来响应 StopMonitor_stop 方法的失败可能导致资源被强制停止。

缺省值为 NONE

任何时候  

可选的 

Load_balancing_policy(字符串)

定义所使用的负载平衡策略的字符串。 此特性仅用于可伸缩服务。 如果在 RTR 文件中声明了 Scalable 特性,则 RGM 自动创建此特性。 Load_balancing_policy 可以采用以下值:

Lb_weighted(缺省值)。 根据在 Load_balancing_weights 特性中设置的权重在不同的节点间分配负载。 Lb_sticky。 可伸缩服务的给定客户机(由客户机的 IP 地址标识)总是发送到同一群集节点。 Lb_sticky_wild。 连接到通配符粘滞服务的 IP 地址的给定客户机(由客户机的 IP 地址标识)总是发送到同一群集节点,而不管它来自哪个端口号。

缺省值为 Lb_weighted

创建时  

有条件的/可选的 

Load_balancing_weights(字符串数组)

只用于可伸缩资源。 如果在 RTR 文件中声明了 Scalable 特性,则 RGM 将自动创建此特性。 其格式为 weight@node,weight@node,其中 weight 是一个反映分配到指定 node 的相对负载部分的整数。 分配到某个节点的负载部分是此节点的权重除以所有权重的和。 例如,1@1,3@2 表示节点 1 接收负载的 1/4,节点 2 接收 3/4。空字符串 (“”)(缺省值)表示均匀分布。 未指定显式权重的节点将接收到缺省权重 1。

如果未在资源类型文件中指定 Tunable 属性,则特性的 Tunable 值为 Anytime。 更改该特性将仅改变新连接的分配。

缺省值是空字符串 (“”)。 

任何时候  

有条件的/可选的 

Type(整数)中每个回叫方法的 method_timeout

以秒计算的时间段,这段时间过后,RGM 将认为对方法的调用已失败。  

如果在 RTR 文件中声明了该方法本身,则缺省值为 3,600(一个小时)。 

任何时候 

有条件的/ 

可选的 

Monitored_switch(枚举值)

如果群集管理员通过管理公用程序启用或禁止监视器,则 RGM 将把此特性设置为 EnabledDisabled。 如果设置为 Disabled,则在再次启用该监视器之前,不会调用监视器的 Start 方法。 如果资源没有监视器回叫方法,则此特性不存在。

缺省值为 Enabled

从不 

仅限于查询 

Network_resources_used(字符串数组)

资源所使用的逻辑主机名或共享地址网络资源的列表。 对于可伸缩服务,此特性必须是指存在于单独资源组的共享地址资源。 对于失败转移服务,此特性是指存在于相同的资源组的逻辑主机名或共享地址资源。 如果在 RTR 文件中声明了 Scalable 特性,则 RGM 将自动创建此特性。 如果在 RTR 文件中未声明 ScalableNetwork_resources_used 将不可用,除非在 RTR 文件中显式声明。

如果未在资源类型文件中指定 Tunable 属性,则该特性的 Tunable 值为 At_creation

创建时  

有条件的/必需的 

On_off_switch(枚举值)

如果群集管理员通过管理公用程序启用或禁止资源,则 RGM 将把此特性设置成 EnabledDisabled。 如果被禁止,则在再次启用资源之前,资源的回叫不会被调用。

缺省值为 Disabled

从不  

仅限于查询 

Port_list(字符串数组)

端口(服务器在其上进行侦听)号列表。 每个端口号后接此端口使用的协议,例如,Port_list=80/tcp。 如果在 RTR 文件中声明了 Scalable 特性,则 RGM 将自动创建 Port_list 。 否则,此特性将不可用,除非在 RTR 文件中显式声明。

用于 Apache 的 Sun Cluster 数据服务指南(适用于 Solaris OS)中介绍了为 Apache 设置此特性的信息。

创建时  

有条件的/ 

必需的 

R_description(字符串)

资源的简单说明。 

缺省值为空字符串。 

任何时候 

可选的 

Resource_name(字符串)

资源实例的名称。 在群集配置中此名称必须唯一,并且在资源创建后该名称无法进行更改。  

从不  

必需的 

Resource_project_name (字符串)

与资源关联的 Solaris 项目名称。 使用此特性可将 Solaris 资源管理功能(例如 CPU 共享和资源池)应用至群集数据服务。 当 RGM 使资源联机时,它将启动此项目名下的相关进程。 如果未指定此特性,将从包含该资源的资源组的 RG_project_name 特性获取项目名称(请参阅 rg_properties [5])。 如果也未指定此特性,RGM 将使用预定义的项目名称 default。 指定的项目名称必须存在于项目数据库中,并且用户 root 必须配置为已命名项目的成员。 仅从 Solaris 9 开始支持此特性。


注意:

对此特性的更改将在资源重新启动后生效。


缺省值为 null。 

任何时候  

可选的 

每个群集节点上的 Resource_state(枚举值)

每个群集节点上由 RGM 确定的资源状态。 可能的状态包括 OnlineOfflineStop_failedStart_failedMonitor_failed 以及 Online_not_monitored

用户不能配置此特性。 

从不 

仅限于查询 

Retry_count(整数)

当资源发生故障时,监视器试图重新启动资源的次数。 此特性仅可由 RGM 创建,在 RTR 文件中声明后,管理员可以使用该特性。 如果在 RTR 文件中指定了缺省值,则此特性是可选的。 

如果在资源类型文件中未指定 Tunable 属性,此属性的 Tunable 值为 When_disabled

如果未在 RTR 文件的特性声明中指定 Default 属性,则此特性为必需的。

禁用时 

有条件的  

Retry_interval(整数)

尝试重新启动失败的资源前计算的秒数。 资源监视器将此特性与 Retry_count 一起使用。 此特性仅可由 RGM 创建,在 RTR 文件中声明后,管理员可以使用该特性。 如果在 RTR 文件中指定了缺省值,则此特性是可选的。

如果在资源类型文件中未指定 Tunable 属性,此属性的 Tunable 值为 When_disabled

如果未在 RTR 文件的特性声明中指定 Default 属性,则此特性为必需的。

禁用时  

有条件的 

Scalable(布尔值)

表明资源是否可伸缩。 如果在 RTR 文件中声明了此特性,则 RGM 将为该类型的资源自动创建以下可伸缩服务特性: Network_resources_usedPort_listLoad_balancing_policyLoad_balancing_weights。 这些特性具有缺省值,除非在 RTR 文件中对它们进行了显式声明。 Scalable 的缺省值(在 RTR 文件中声明时)为 True

在 RTR 文件中声明此特性时,Tunable 属性必须设置为 At_creation,否则资源创建将失败。

如果在 RTR 文件中未声明此特性,则资源不可伸缩,群集管理员无法调整此特性并且 RGM 无法设置可伸缩服务特性。 但是,必要时您可以在 RTR 文件中显式声明 Network_resources_usedPort_list 特性,因为它们在非可伸缩服务中与在可伸缩服务中都可能有用。

创建时  

可选的 

每个群集节点上的 Status(枚举值)

由资源监视器设置。 值可能为: OKdegradedfaultedunknownoffline。 当使资源联机时,RGM 将把值设置成 unknown;使资源脱机时,将把值设置成 Offline

从不 

仅限于查询 

每个群集节点上的 Status_msg(字符串)

由资源监视器在设置 Status 特性的同时进行设置。 可以为每个资源每个节点都设置此特性。 使资源脱机时,RGM 将把它设置成空字符串。

从不 

仅限于查询 

Thorough_probe_interval(整数)

在两次资源高开销故障探测的调用之间的秒数。 此特性仅可由 RGM 创建,在 RTR 文件中声明后,管理员可以使用该特性。 如果在 RTR 文件中指定了缺省值,则此特性是可选的。 

如果未在资源类型文件中指定 Tunable 属性,则该特性的 Tunable 值为 When_disabled

如果未在 RTR 文件的特性声明中指定 Default 属性,则此特性为必需的。

禁用时  

有条件的 

Type(字符串)

资源类型,此资源是该资源类型的一个实例。 

从不 

必需的 

Type_version (字符串)

指定当前与此资源关联的资源类型的版本。 RGM 将自动创建此特性,该特性不能在 RTR 文件中声明。 此特性的值与资源类型的 RT_version 特性一样。 创建资源时,不明确指定 Type_version 特性,尽管它可能作为资源类型名称的后缀出现。 编辑资源时,可以将 Type_version 更改为新值。

其可调性源自:

  • 资源类型的当前版本

  • RTR 文件中的 #$upgrade_from 指令

请参阅说明 

请参阅说明  

UDP_affinity (布尔值)

如果为 true,则来自给定客户机的所有 UDP 通信都将发送至当前处理该客户机的所有 TCP 通信的同一服务器节点。 

仅当 Load_balancing_policy 的值是 Lb_stickyLb_sticky_wild 时,此特性才适用。 此外,Weak_affinity 必须设置为 False(缺省值)。

此特性只用于可伸缩服务。 

禁用时 

可选的 

Weak_affinity(布尔值)

如果为 true,则启用较弱的客户机亲合性。 这可以将来自给定客户机的连接发送到同一服务器节点,但以下情况例外: 

  • 由于种种原因(例如,重新启动故障监视器、资源的故障切换和切换或者节点在失败后重新连接群集)而启动服务器侦听程序。

  • 由于管理操作而导致可伸缩资源的 Load_balancing_weights 更改。

就内存消耗和处理器周期而言,不采用缺省形式而启用较弱的亲合性所使用的系统开销较低。  

仅当 Load_balancing_policy 的值为 Lb_stickyLb_sticky_wild 时,此特性才适用。

此特性只用于可伸缩服务。  

禁用时  

可选的 

资源组特性

下表介绍了 Sun Cluster 定义的资源组特性。 特性值分为以下几类(在“类别”列中):

“是否可以更新?” 列中说明了特性在进行初始设置后是否可以更新。“Y”表示是,“N”表示否。

表 A–3 资源组特性

特性名称 

说明 

是否可以更新? 

类别 

Auto_start_on_new_cluster (布尔值)

在新的群集形成时,此特性不允许自动启动资源组。 

 

缺省值为 TRUE。 如果将其设置为 TRUE,则资源组管理器会在重新引导群集时尝试自动启动资源组,以实现 Desired_primaries。 如果设置为 FALSE,当群集节点重新启动时,资源组无法自动启动。

可选的 

Desired_primaries(整数)

希望使组同时在其上处于联机状态的节点数量。  

缺省值为 1。如果 RG_mode 特性为 Failover,则此特性的值必须不大于 1。如果 RG_mode 特性为 Scalable,则允许值大于 1。

可选的 

Failback(布尔值)

一个布尔值,表明当群集成员资格更改时,是否重新计算组联机的节点集。 重新计算将造成资源组管理器使组在优先级较低的节点上脱机,并在优先级较高的节点上联机。 

缺省值为 False

Y  

可选的 

Global_resources_used(字符串数组)

表明群集文件系统是否由此资源组中的任何资源使用。 管理员可以指定的合法值为表示所有全局资源的星号 (*) 和表示非全局资源的空字符串 (“”)。  

缺省值为所有全局资源。  

Y  

可选的 

Implicit_network_dependencies(布尔值)

一个布尔值,如果为 True,则表明 RGM 将把非网络地址资源固有的强大依赖性强加到组内的网络地址资源上。 网络地址资源包括逻辑主机名和共享地址资源类型。

在可伸缩资源组中,此特性不会产生影响,因为可伸缩资源组不包含任何网络地址资源。 

缺省值为 True

可选的 

Maximum_primaries(整数)

组一次可以联机的最大节点数。  

缺省值为 1。如果 RG_mode 特性为 Failover,则此特性的值必须不大于 1。如果 RG_mode 特性为 Scalable,则允许值大于 1。

可选的 

Nodelist(字符串数组)

群集节点列表,在这些节点上可以按优先顺序使组联机。 这些节点被称为资源组的潜在主节点或主控节点。 

缺省值为所有群集节点的列表。  

Y  

可选的 

Pathprefix(字符串)

群集文件系统的一个目录,在此目录中组内的资源可以写基本的管理文件。 某些资源可能需要此特性。 使 Pathprefix 对每个资源组都是唯一的。

缺省值为空字符串。 

可选的 

Pingpong_interval(整数)

RGM 使用非负整数(以秒计算)确定:如果重新配置,或者执行 scha_control -O GIVEOVER 命令或执行带有 SCHA_GIVEOVER 参数的 scha_control() 函数,何时将资源组联机。

重新配置时,如果资源组在过去的 Pingpong_interval 秒内无法在某个特定节点上联机(因为资源的 StartPrenet_start 方法以非零状态退出或超时),则认为此节点不是使用该资源组的合法节点,RGM 将寻找其它主节点。

如果调用资源的 scha_control 命令或 scha_control() 函数导致资源组在过去的 Pingpong_interval 秒内在某个特定节点脱机,由于后来调用另一个节点发生的 scha_control(),此节点不是使用该资源组的合法节点。

缺省值为 3,600(一个小时)。 

可选的 

Resource_list(字符串数组)

此组中包含的资源的列表。 管理员不会直接设置该特性。 而是当管理员向/从资源组中添加/删除资源组时,由 RGM 更新此特性。  

缺省值为空列表。 

仅限于查询 

RG_description (字符串)

资源组的简单说明。 

缺省值为空字符串。 

可选的 

RG_mode(枚举值)

表明资源组是故障切换组还是可伸缩组。 如果值为 Failover,RGM 将组的 Maximum_primaries 特性设置为 1,并将资源组限制成由单一节点控制。

如果此特性的值为 Scalable,则 RGM 将允许 Maximum_primaries 特性的值大于 1,意味着该组可由多个节点同时控制。 RGM 不允许将其 Failover 特性的值为 True 的资源添加到其 RG_mode 的值为 Scalable 的资源组中。

如果 Maximum_primaries 的值是 1,则缺省值是 Failover;如果 Maximum_primaries 的值大于 1,则缺省值是 Scalable

可选的 

RG_name(字符串)

资源组的名称。 该名称在群集内必须是唯一的。  

N  

必需的 

RG_project_name (字符串)

与资源组关联的 Solaris 项目名称。 使用此特性可将 Solaris 资源管理功能(例如 CPU 共享和资源池)应用至群集数据服务。 当 RGM 使资源组联机时,它将为没有设置 Resource_project_name 特性的资源启动此项目名称下的相关进程。 指定的项目名称必须存在于项目数据库中,而且必须将用户 root 配置为已命名项目的成员。

仅从 Solaris 9 开始支持此特性。  


注意:

对此特性的更改将在资源重新启动后生效。


任何时候 

必需的 

每个群集节点上的 RG_state(枚举值)

由 RGM 设置为 OnlineOfflinePending_onlinePending_offlinePending_online_blockedError_stop_failedOnline_faulted,用于描述组在每一个群集节点上的状态。

用户不能配置此特性。 但是您可以通过调用 scswitch(1M)(或通过使用等效的 scsetup( 1M) 或 SunPlex Manager 命令)来间接设置此特性。

仅限于查询 

资源特性属性

下表说明了可用来更改系统定义的特性或用来创建扩展特性的资源特性属性。


小心:小心:

您不能将 NULL 或空字符串 (“”) 指定为 booleanenumint 类型的缺省值。


表 A–4 资源特性属性

特性 

说明 

Property

资源特性的名称。 

Extension

如果使用,则表明 RTR 文件项声明了一个由资源类型的实现定义的扩展特性, 否则,此项为系统定义的特性。  

Description

一个字符串注释,用于对特性作简单说明。 对于系统定义的特性,不能在 RTR 文件中设置说明属性。 

特性的类型 

允许的类型为: stringbooleanintenumstringarray。 对于系统定义的特性,您不能在 RTR 文件项中设置类型属性。 类型决定了可接受的特性值和在 RTR 文件项中允许的特定于类型的属性。 enum 类型是一组字符串值。

Default

表示此特性的缺省值。 

Tunable

表示群集管理员何时可以设置资源中此特性的值。 可以设置为 NoneFalse,以防止管理员设置此特性。 允许管理员调节的值: TrueAnytime(任何时候)、At_creation(仅在创建资源的时)或 When_disabled(当资源脱机时)。

缺省值是 True (Anytime)。

Enumlist

对于 enum 类型,为该特性所允许的一组字符串值。

Min

对于 int 类型,为该特性所允许的最小值。

Max

对于 int 类型,为此特性所允许的最大值。

Minlength

对于 stringstringarray 类型,为允许的最小字符串长度。

Maxlength

对于 stringstringarray 类型,为允许的最大字符串长度。

Array_minsize

对于 stringarray 类型,为允许的最小数组元素数。

Array_maxsize

对于 stringarray 类型,为允许的最大数组元素数。