附录 A 标准特性

本附录介绍资源类型、资源组和资源的标准特性。本附录还说明了可用于更改系统定义的特性以及创建扩展特性的资源特性属性。

本附录包括以下内容：

• 资源类型特性

• 资源特性

• 资源组特性

• 资源特性属性

资源类型特性

以下信息说明了由 Sun Cluster 所定义的资源类型特性。特性值分为以下几类（位于“类别”后）：

• 必需的 – 该特性要求资源类型注册 (RTR) 文件中有显式值。否则，将无法创建特性所属的对象。该值不能是空白或空字符串。

• 有条件的 – 特性必须在 RTR 文件中进行声明才能存在。否则，RGM 不会创建该特性，并且该特性将不能用于管理实用程序。允许使用空白或空字符串。如果在 RTR 文件中声明特性但未指定值，RGM 将提供缺省值。

• 有条件的/显式 – 必须在 RTR 文件中进行声明且具有一个显式值，特性才能存在。否则，RGM 不会创建该特性，并且该特性将不能用于管理实用程序。不允许使用空白或空字符串。

• 可选的 — 可以在 RTR 文件中声明特性。如果未在 RTR 文件中声明特性，则 RGM 将创建特性并提供一个缺省值。如果特性在 RTR 文件中进行了声明但未指定其值，则 RGM 所提供的缺省值与未在 RTR 文件中声明该特性时提供的缺省值相同。

不能通过管理实用程序更新资源类型特性，但 Installed_nodes 和 RT_system 除外，它们不能在 RTR 文件中进行声明并且必须由管理员进行设置。

首先显示特性名称，然后对其进行说明。

API_version (integer)

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

以下信息总结了每个版本的 Sun Cluster 所支持的最大 API_version。

3.1 版之前（包括 3.1 版）

2

3.1 10/03

3

3.1 4/04

3

3.1 9/04

5

在 RTR 文件中为 API_version 声明一个大于 2 的值可以阻止在支持较低的最大版本的 Sun Cluster 版本上安装资源类型。例如，如果您为某个资源类型声明了 API_version=5，该资源类型将不能安装在 3.1 9/04 之前发行的任何版本的 Sun Cluster 上。

类别：

可选

缺省值：

2

可调：

否

Boot (string)

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

类别：

有条件的/显式

缺省值：

无

可调：

否

Failover (boolean)

True 表明此类型的资源不能在一次可在多个节点上联机的组中进行配置。

类别：

可选

缺省值：

FALSE

可调：

否

Fini (string)

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

类别：

有条件的/显式

缺省值：

无

可调：

否

Init (string)

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

类别：

有条件的/显式

缺省值：

无

可调：

否

Init_nodes (enum)

该值可以是 RG_primaries（仅那些可以控制该资源的节点）或 RT_installed_nodes（安装该资源类型的所有节点）。表明 RGM 将对哪些节点调用 Init、Fini、Boot 和 Validate 方法。

类别：

可选

缺省值：

RG_primaries

可调：

否

Installed_nodes (string_array)

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

类别：

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

缺省值：

所有群集节点

可调：

是

Is_logical_hostname (boolean

TRUE 表明该资源类型是管理故障转移 Internet 协议 (IP) 地址的 LogicalHostname 资源类型的某个版本。

类别：

仅限于查询

缺省值：

无缺省值

可调：

否

Is_shared_address (boolean)

TRUE 表明该资源类型是管理故障转移 Internet 协议 (IP) 地址的 SharedAddress 资源类型的某个版本。

类别：

仅限于查询

缺省值：

无缺省值

可调：

否

Monitor_check (string)

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

类别：

有条件的/显式

缺省值：

无缺省值

可调：

否

Monitor_start (string)

一种可选的回调方法：RGM 为启动此类型的资源的故障监视器而调用的程序的路径。

类别：

有条件的/显式

缺省值：

无缺省值

可调：

否

Monitor_stop (string)

在设置了 Monitor_start 时所必需的回调方法。RGM 为停止此类型的资源的故障监视器而调用的程序的路径。

类别：

有条件的/显式

缺省值：

无缺省值

可调：

否

Pkglist (string_array)

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

类别：

有条件的/显式

缺省值：

无缺省值

可调：

否

Postnet_stop (string)

一种可选的回调方法：在调用此类型的资源所依赖的网络地址资源的 Stop 方法之后 RGM 所调用的程序的路径。将网络接口配置为断开之后，此方法必须执行 Stop 操作。

类别：

有条件的/显式

缺省值：

无缺省值

可调：

否

Prenet_start (string)

一种可选的回调方法：在调用此类型的资源所依赖的网络地址资源的 Start 方法之前 RGM 所调用的程序的路径。此方法应该执行 Start 操作，这些操作必须在配置网络接口之前执行。

类别：

有条件的/显式

缺省值：

无缺省值

可调：

否

Resource_type (string)

资源类型的名称。要查看当前已注册的资源类型的名称，请使用：

scrgadm -p

在 Sun Cluster 3.1 及更高版本中，资源类型名称必须包含版本：

vendor_id.resource_type:version

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

vendor_id.resource_type

类别：

必需的

缺省值：

空字符串

可调：

否

RT_basedir (string)

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

类别：

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

缺省值：

无缺省值

可调：

否

RT_description (string)

资源类型的简单说明。

类别：

有条件的

缺省值：

空字符串

可调：

否

RT_system (boolean)

表明当在某个资源类型上将此特性设置为 TRUE 时，该资源类型上所允许的 scrgadm(1M) 操作将受到限制。其 RT_system 值被设置为 TRUE 的资源类型称为系统资源类型。无论 RT_system 的当前值是什么，对 RT_system 特性本身进行编辑将始终不会受到限制。

类别：

可选

缺省值：

FALSE

可调：

是

RT_version (string)

从 Sun Cluster 3.1 开始，实施该资源类型必需版本字符串。RT_version 是完整资源类型名称的后缀部分。RT_version 特性，它在 Sun Cluster 3.0 中是可选的，而在 Sun Cluster 3.1 及更高版本中是必需的。

类别：

可选的/显示或必需的

缺省值：

无缺省值

可调：

否

Single_instance (boolean)

如果为 TRUE，则表明群集中只能存在一个此类型的资源。RGM 仅允许一次在群集中运行一个此类型的资源。

类别：

可选

缺省值：

FALSE

可调：

否

Start (string)

一种回调方法：RGM 所调用的用来启动此类型的资源的程序的路径。

类别：

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

缺省值：

无缺省值

可调：

否

Stop (string)

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

类别：

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

缺省值：

无缺省值

可调：

否

Update (string)

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

类别：

有条件的/显式

缺省值：

无缺省值

可调：

否

Validate (string)

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

类别：

有条件的/显式

缺省值：

无缺省值

可调：

否

Vendor_ID (string)

请参见 Resource_type 特性。

类别：

有条件的

缺省值：

无缺省值

可调：

否

资源特性

本节说明了由 Sun Cluster 所定义的资源特性。特性值分为以下几类（位于“类别”后）：

• 必需的 – 管理员在使用管理实用程序创建资源时必须指定一个值。

• 可选的 – 如果管理员在创建资源组时未指定值，系统将提供一个缺省值。

• 有条件的 – 仅当在 RTR 文件中声明特性之后，RGM 才会创建此特性，否则，该特性将不存在，系统管理员将不能使用该特性。在 RTR 文件中声明的有条件的特性是可选的还是必需的取决于是否在 RTR 文件中指定了缺省值。有关详细信息，请参见对每个条件的特性的说明。

• 仅限于查询 – 不能通过管理工具直接进行设置。

可调列表中列出了您是否可以以及何时可以更新资源特性，如下所示：

首先显示特性名称，然后对其进行说明。

Affinity_timeout (integer )

以秒为单位的时间长度，在这段时间内，来自资源中任何服务的给定客户机 IP 地址的连接将被发送到同一服务器节点。

仅当 Load_balancing_policy 的值为 Lb_sticky 或 Lb_sticky_wild 时，此特性才适用。此外，必须将 Weak_affinity 设置为 FALSE（缺省值）。

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

类别：

可选

缺省值：

无缺省值

可调：

ANYTIME

Cheap_probe_interval (integer)

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

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

如果在 RTR 文件中声明了此特性并且未指定 Default 属性，则此特性是必需的。

类别：

有条件的

缺省值：

无缺省值

可调：

WHEN_DISABLED

扩展特性

在资源类型的 RTR 文件中声明的扩展特性。资源类型的实现中定义了这些特性。资源特性属性中包含有关可以为扩展特性设置的各个属性的信息。

类别：

有条件的

缺省值：

无缺省值

可调：

取决于特定的特性

Failover_mode (enum)

当启动方法（Prenet_start 或 Start）失败时，NONE、SOFT 和 HARD 仅影响故障转移行为。但是，一旦资源已成功启动，NONE、SOFT 和 HARD 便不会对随后资源监视器用 scha_control(1HA) 或 scha_control(3HA) 发起的资源重新启动或移交行为产生任何影响。NONE（缺省值）表明 RGM 将在方法失败时设置资源状态并等待用户介入。SOFT 表明如果 Start 方法失败，RGM 会将资源组重新定位至其他节点。如果 Stop 或 Monitor_stop 方法失败，RGM 会将资源设置为 Stop_failed 状态，并将资源组设置为 Error_stop_failed 状态。然后，RGM 将等待用户介入。对于 Stop 或 Monitor_stop 故障，NONE 和 SOFT 是相同的。HARD 表明如果 Start 方法失败，RGM 将重新定位该组。如果 Stop 或 Monitor_stop 方法失败，RGM 将通过异常终止群集节点来停止资源。在 Start 或 Prenet_start 方法失败时，HARD、NONE 和 SOFT 将影响故障转移行为。

与 NONE、SOFT 和 HARD 不同，RESTART_ONLY 和 LOG_ONLY 将影响所有故障转移行为，包括监视器运行 scha_control 发起的资源和资源组的重新启动，以及资源监视器运行 scha_control 发起的移交行为。RESTART_ONLY 表明监视器可以运行 scha_control 来重新启动资源，但接下来尝试使用 scha_control 来执行资源组的重新启动或移交行为将失败。RGM 允许在 Retry_interval 内重新启动 Retry_count 次。如果超过 Retry_count，将不允许任何资源重新启动。如果 Failover_mode 被设置为 LOG_ONLY，将不允许任何资源重新启动或移交。将 Failover_mode 设置为 LOG_ONLY 与将 Failover_mode 设置为 RESTART_ONLY 且将 Retry_count 设置为零作用相同。如果启动方法失败，则 RESTART_ONLY 和 LOG_ONLY 与 NONE 相同：不发生故障转移，资源将转至 Start_failed 状态。

类别：

可选

缺省值：

无缺省值

可调：

ANYTIME

Load_balancing_policy (string)

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

Lb_weighted（缺省值）。根据在 Load_balancing_weights 特性中设置的权重在不同的节点间分配负载。

Lb_sticky。可伸缩服务的给定客户机（由客户机的 IP 地址标识）总是发送到同一群集节点。

Lb_sticky_wild。连接至通配符粘连服务的 IP 地址的给定客户机的 IP 地址通常会被发送至同一个群集节点，而与 IP 地址连接的端口号无关。

类别：

有条件的/可选的

缺省值：

Lb_weighted

可调：

AT_CREATION

Load_balancing_weights (string_array)

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

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

类别：

有条件的/可选的

缺省值：

空字符串 (“”)

可调：

ANYTIME

类型中每个回调方法的 method_timeout (integer)

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

类别：

有条件的/可选的

缺省值：

3600（一小时），如果在 RTR 文件中声明了此方法本身。

可调：

ANYTIME

Monitored_switch (enum)

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

类别：

仅限于查询

缺省值：

无缺省值

可调：

永不

Network_resources_used (string_array)

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

如果未在资源类型文件中指定 Tunable 属性，则此特性的 Tunable 值为 AT_CREATION。

---

注意 –

SUNW.Event(5) 手册页说明了如何为 CRNP 设置此特性。

---

类别：

有条件的/必需的

缺省值：

无缺省值

可调：

AT_CREATION

每个群集节点上的 Num_resource_restarts (integer)

您不能直接设置此特性，而是要由 RGM 将其设置为在过去的 n 秒内，已为此节点上的此资源执行 scha_control、Resource_restart 或 Resource_is_restarted 调用的次数。n 为此资源的 Retry_interval 特性的值。一旦此资源执行 scha_control 移交行为，则无论此移交尝试成功还是失败，RGM 均会将资源重新启动计数器复位为零。

如果资源类型未声明 Retry_interval 特性，则 Num_resource_restarts 特性将不能用于该类型的资源。

类别：

仅限于查询

缺省值：

无缺省值

可调：

否

每个群集节点上的 Num_rg_restarts (integer)

您不能直接设置此特性，而是要由 RGM 将其设置为在过去的 n 秒内，此资源已为此节点上包含它的资源组执行 scha_control Restart 调用的次数，其中 n 为此资源的 Retry_interval 特性的值。如果资源类型未声明 Retry_interval 特性，则 Num_rg_restarts 特性将不能用于该类型的资源。

类别：

请参见说明

缺省值：

无缺省值

可调：

否

On_off_switch (enum)

如果群集管理员通过管理实用程序启用或禁用资源，则 RGM 会将此特性设置为 Enabled 或 Disabled。如果资源被禁用，则在重新启用之前，它将处于脱机状态并且不调用回调。

类别：

仅限于查询

缺省值：

无缺省值

可调：

永不

Port_list (string_array)

端口（服务器在其上进行侦听）号列表。每个端口号附加了一个斜杠 (/) ，斜杠后面是该端口所使用的协议，例如，Port_list=80/tcp 或 Port_list=80/tcp6,40/udp6。您可以指定以下协议值：

• tcp，用于 TCP IPv4

• tcp6，用于 TCP IPv6

• udp，用于 UDP IPv4

• udp6，用于 UDP IPv6

如果在 RTR 文件中声明了 Scalable 特性，则 RGM 将自动创建 Port_list。否则，此特性将不可用，除非在 RTR 文件中显式声明。

《Sun Cluster Data Service for Apache Guide for Solaris OS》中介绍了为 Apache 设置此特性的信息。

类别：

有条件的/必需的

缺省值：

无缺省值

可调：

AT_CREATION

R_description (string)

资源的简单说明。

类别：

可选

缺省值：

空字符串

可调：

ANYTIME

Resource_dependencies (string_array)

相同或不同组中此资源对其具有强依赖性的资源列表。如果列表中有任一资源未联机，则该资源将无法启动。如果该资源和列表中的其中一个资源同时启动，则 RGM 将等待列表中的资源启动之后才启动该资源。如果该资源的 Resource_dependencies 列表中的资源未启动，则该资源也将保持脱机状态。此资源的列表中的资源有可能无法启动是因为列表中资源的资源组仍保持脱机状态，或是因为列表中的资源处于 Start_failed 状态。如果此资源因依赖于另一不同资源组中未能启动的资源而仍处于脱机状态，则此资源所属的组将进入 Pending_online_blocked 状态。

如果使此资源与列表中的那些资源同时脱机，则该资源将在列表中的资源停止之前停止。但是，即使此资源仍处于联机状态或无法停止，该列表中属于另一不同资源组的资源照样也会停止。除非先禁用此资源，否则无法禁用列表中的资源。

缺省情况下，在资源组中，应用程序资源对网络地址资源具有隐含的强资源依赖性。资源组特性中的 Implicit_network_dependencies 包含更多信息。

在资源组中，Prenet_start 方法按依赖性顺序在 Start 方法之前运行。Postnet_stop 方法按依赖性顺序在 Stop 方法之后运行。在不同的资源组中，具有依赖性的资源将等待它所依赖的资源完成 Prenet_start 和 Start 之后才运行 Prenet_start。而被依赖的资源将等待依赖它的资源完成 Stop 和 Postnet_stop 之后才运行 Stop。

类别：

可选

缺省值：

空列表

可调：

ANYTIME

Resource_dependencies_restart (string_array)

相同或不同组中此资源对其具有重新启动依赖性的资源列表。

此特性的工作原理与 Resource_dependencies 的工作原理相同，唯一区别在于：如果重新启动依赖性列表中的任何资源重新启动，该资源也将重新启动。该资源将在列表中的资源恢复联机之后重新启动。

类别：

可选

缺省值：

空列表

可调：

ANYTIME

Resource_dependencies_weak (string_array)

相同或不同组中此资源对其具有弱依赖性的资源列表。弱依赖性可以确定方法调用的顺序。RGM 会在调用该资源的 Start 方法之前调用此列表中的资源的 Start 方法。RGM 会在调用列表中的资源的 Stop 方法之前调用该资源的 Stop 方法。如果列表中的资源启动失败或保持脱机状态，该资源将仍然可以启动。

如果该资源和其 Resource_dependencies_weak 列表中的某个资源同时启动，则 RGM 将等待列表中的资源启动后才启动该资源。如果列表中的资源未启动（例如，如果列表中资源的资源组仍处于脱机状态或者列表中的资源处于 Start_failed 状态），此资源将会启动。当此资源的 Resource_dependencies_weak 列表中的资源启动时，此资源的资源组可能会暂时进入 Pending_online_blocked 状态。当列表中的所有资源均已启动或启动失败时，此资源将启动并且其组将重新进入 Pending_online 状态。

如果将该资源与列表中的资源同时脱机，则该资源将在列表中的资源停止之前停止。如果该资源保持联机或无法停止，列表中的资源仍会停止。您不能禁用列表中的资源，除非先禁用该资源。

在资源组中，Prenet_start 方法按依赖性顺序在 Start 方法之前运行。Postnet_stop 方法按依赖性顺序在 Stop 方法之后运行。在不同的资源组中，具有依赖性的资源将等待它所依赖的资源完成 Prenet_start 和 Start 之后才运行 Prenet_start。而被依赖的资源将等待依赖它的资源完成 Stop 和 Postnet_stop 之后才运行 Stop。

类别：

可选

缺省值：

空列表

可调：

ANYTIME

Resource_name (string)

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

类别：

必需的

缺省值：

无缺省值

可调：

永不

Resource_project_name (string)

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

---

注意 –

对此特性的更改将在下次启动该资源时生效。

---

类别：

可选

缺省值：

空

可调：

ANYTIME

每个群集节点上的 Resource_state (enum)

每个群集节点上由 RGM 确定的资源状态。可能的状态包括 Online、Offline、Start_failed、Stop_failed、Monitor_failed、Online_not_monitored、Starting 和 Stopping。

不能配置该特性。

类别：

仅限于查询

缺省值：

无缺省值

可调：

永不

Retry_count (integer)

如果资源失败，监视器尝试重新启动该资源的次数。此特性由 RGM 创建，并且仅当在 RTR 文件中声明此特性后，管理员才可以使用此特性。如果在 RTR 文件中指定了缺省值，则 Retry_count 是可选的。

如果未在资源类型文件中指定 Tunable 属性，则此特性的 Tunable 值为 WHEN_DISABLED。

如果在 RTR 文件中声明了此特性并且未指定 Default 属性，则此特性是必需的。

类别：

有条件的

缺省值：

无缺省值

可调：

WHEN_DISABLED

Retry_interval (integer)

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

如果未在资源类型文件中指定 Tunable 属性，则此特性的 Tunable 值为 WHEN_DISABLED。

如果在 RTR 文件中声明了此特性并且未指定 Default 属性，则此特性是必需的。

类别：

有条件的

缺省值：

无缺省值

可调：

WHEN_DISABLED

Scalable (boolean)

表明资源是否可伸缩，即，资源是否使用 Sun Cluster 的联网负载平衡功能。

如果在 RTR 文件中声明了此特性，则 RGM 将为该类型的资源自动创建以下可缩放服务特性： Affinity_timeout、Load_balancing_policy、Load_balancing_weights、Network_resources_used、Port_list、UDP_affinity 和 Weak_affinity。这些特性具有缺省值，除非在 RTR 文件中对它们进行了显式声明。Scalable 的缺省值为 TRUE（如果已在 RTR 文件中声明）。

如果已在 RTR 文件中声明此特性，则必须将其 Tunable 属性指定为 AT_CREATION。

如果未在 RTR 文件中声明此特性，该资源将不具有可伸缩性，您不能调节此特性，并且 RGM 也不会设置任何可伸缩服务特性。但是，您可以在 RTR 文件中显式声明 Network_resources_used 和 Port_list 特性，因为这些特性在非可伸缩服务和可伸缩服务中都会有用。

您可以将此资源特性与 Failover 资源类型特性结合使用，如下所示：

r_properties(5) 中详细介绍了将此资源特性与 Failover 资源类型特性结合使用的信息。

类别：

可选

缺省值：

无缺省值

可调：

AT_CREATION

每个群集节点上的 Status (enum)

由资源监视器使用 scha_resource_setstatus(1HA) 或 scha_resource_setstatus(3HA) 进行设置。可能的值包括 OK、degraded、faulted、unknown 和 offline。当某个资源联机或脱机后，如果该资源的监视器或方法未设置 Status 值，RGM 会自动设置 Status 值。

类别：

仅限于查询

缺省值：

无缺省值

可调：

永不

每个群集节点上的 Status_msg (string)

由资源监视器在设置 Status 特性的同时进行设置。当某个资源联机或脱机时，如果该资源的方法未设置此特性，RGM 会自动将此特性复位为空字符串。

类别：

仅限于查询

缺省值：

无缺省值

可调：

永不

Thorough_probe_interval (integer)

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

如果未在资源类型文件中指定 Tunable 属性，则此特性的 Tunable 值为 WHEN_DISABLED。

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

类别：

有条件的

缺省值：

无缺省值

可调：

WHEN_DISABLED

Type (string)

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

类别：

必需的

缺省值：

无缺省值

可调：

永不

Type_version (string)

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

此特性的可调性源自以下来源：

• 资源类型的当前版本

• RTR 文件中的 #$upgrade_from 指令

类别：

请参见说明

缺省值：

无缺省值

可调：

请参见说明

UDP_affinity (boolean)

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

仅当 Load_balancing_policy 的值为 Lb_sticky 或 Lb_sticky_wild 时，此特性才适用。此外，必须将 Weak_affinity 设置为 FALSE（缺省值）。

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

类别：

可选

缺省值：

无缺省值

可调：

WHEN_DISABLED

Weak_affinity (boolean)

如果为 true，则启用较弱的客户机关联。较弱形式的客户机关联允许将来自给定客户机的连接发送到同一个服务器节点，以下情况除外：

• 例如，服务器侦听器启动以响应故障监视器的重新启动、资源的故障转移或切换转移，或者节点在失败后重新加入群集

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

就内存消耗和处理器周期而言，采用弱关联都比采用缺省形式的系统开销要低。

仅当 Load_balancing_policy 的值为 Lb_sticky 或 Lb_sticky_wild 时，此特性才适用。

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

类别：

可选

缺省值：

无缺省值

可调：

WHEN_DISABLED

资源组特性

以下信息说明了由 Sun Cluster 所定义的资源组特性。特性值分为以下几类（位于“类别”后）：

• 必需的 — 管理员在使用管理实用程序创建资源时必须指定一个值。

• 可选的 – 如果管理员在创建资源组时未指定值，系统将提供一个缺省值。

• 仅限于查询 – 不能通过管理工具直接进行设置。

每个说明均表明了特性在进行初始设置后是否可以更新：Yes 表示可以，No 表示不可以。

首先显示特性名称，然后对其进行说明。

Auto_start_on_new_cluster (boolean)

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

如果将其设置为 TRUE，则资源组管理器会在重新引导群集时尝试自动启动资源组，以实现 Desired_primaries。如果设置为 FALSE，则重新引导群集时资源组将不会自动启动。

类别：

可选

缺省值：

TRUE

可调：

是

Desired_primaries (integer)

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

如果 RG_mode 特性为 Failover，则此特性的值不能大于 1。如果 RG_mode 特性为 Scalable，则允许此特性的值大于 1。

类别：

可选

缺省值：

1

可调：

是

Failback (boolean)

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

类别：

可选

缺省值：

FALSE

可调：

是

Global_resources_used (string_array)

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

类别：

可选

缺省值：

所有全局资源

可调：

是

Implicit_network_dependencies (boolean)

一个布尔值，如果为 TRUE，则表明 RGM 应在组内强制执行非网络地址资源对网络地址资源的隐含强依赖性。网络地址资源包括逻辑主机名和共享地址资源类型。

在可缩放的资源组内，此特性不起作用，这是因为可缩放的资源组中不包含任何网络地址资源。

类别：

可选

缺省值：

TRUE

可调：

是

Maximum_primaries (integer)

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

如果 RG_mode 特性为 Failover，则此特性的值不能大于 1。如果 RG_mode 特性为 Scalable，则允许此特性的值大于 1。

类别：

可选

缺省值：

1

可调：

是

Nodelist (string_array)

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

类别：

可选

缺省值：

所有群集节点的列表

可调：

是

Pathprefix (string)

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

类别：

可选

缺省值：

空字符串

可调：

是

Pingpong_interval (integer)

一个非负整数值（以秒为单位），由 RGM 用来确定使资源组联机的位置。在以下情况下可能需要此特性：

• 如果发生重新配置

• 已执行 scha_control -O GIVEOVER 命令或带有 SCHA_GIVEOVER 参数的 scha_control() 函数

如果发生重新配置，并且资源组在过去的 Pingpong_interval 秒内在某个特定节点上多次联机失败，将认为该节点不是该资源组的合格主机，RGM 将寻找其他主机。资源组联机失败是因为该资源的 Start 或 Prenet_start 方法在非零状态下退出或超时。

如果调用资源的 scha_control 命令或函数导致资源组在过去的 Pingpong_interval 秒内在某个特定节点上脱机，则该节点会因随后对 scha_control() 的调用源自另一个节点而不能成为该资源组的合格主机。

类别：

可选

缺省值：

3600（一小时）

可调：

是

Resource_list (string_array)

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

类别：

仅限于查询

缺省值：

无缺省值

可调：

否

RG_affinities (string)

RGM 将尝试在作为另一个给定资源组的当前主机的节点上定位资源组（正关联），或在不是给定资源组的当前主机的节点上定位资源组（负关联）。

您可以将 RG_affinities 设置为以下字符串：

• ++，即强正关联

• +，即弱正关联

• -，即弱负关联

• --，即强负关联

• +++，即包含故障转移委托的强正关联

例如，RG_affinities=+RG2,--RG3 表示此资源组与 RG2 具有弱正关联，与 RG3 具有强负关联。

《Sun Cluster 数据服务规划和管理指南（适用于 Solaris OS）》的“管理数据服务资源”中介绍了使用 RG_affinities 的信息。

类别：

可选

缺省值：

空字符串

可调：

是

RG_dependencies (string_array)

资源组的可选列表，指示使其他组在同一节点上联机或脱机的首选排列顺序。由所有强 RG_affinities（正或负）以及 RG_dependencies 共同组成的图中不允许包含循环。

例如，假设资源组 RG1 的 RG_dependencies 列表中列出了资源组 RG2，也就是说，假设 RG1 对 RG2 有资源组依赖性。以下列表总结了此资源组依赖性的影响：

• 当某个节点加入群集时，必须等该节点上的所有 Boot 方法在 RG2 中的资源上运行完之后，才能在 RG1 中的资源上运行该节点的 Boot 方法。

• 如果 RG1 和 RG2 在同一个节点上同时处于 Pending_online 状态，则必须在 RG2 中的所有资源完成它们的启动方法之后，才会在 RG1 中的资源上运行启动方法（Prenet_start 或 Start）。

• 如果 RG1 和 RG2 在同一个节点上同时处于 Pending_offline 状态，则必须在 RG1 中的所有资源完成它们的停止方法之后，才会在 RG2 中的资源上运行停止方法（Stop 或 Postnet_stop）。

• 如果切换 RG1 或 RG2 的主节点导致 RG1 在任一节点上联机而 RG2 在所有节点上脱机，则此切换尝试将失败。scswitch(1M) 和 scsetup(1M) 中包含更多信息。

• 如果在 RG2 上将 Desired_primaries 特性设置为零，则不允许在 RG1 上将 Desired_primaries 特性设置为大于零的值。

• 如果在 RG2 上将 Auto_start_on_new_cluster 特性设置为 FALSE，则不允许在 RG1 上将 Auto_start_on_new_cluster 特性设置为 TRUE。

类别：

可选

缺省值：

空列表

可调：

是

RG_description (string)

资源组的简单说明。

类别：

可选

缺省值：

空字符串

可调：

是

RG_is_frozen (boolean)

一个布尔值，指示是否正在切换转移资源组所依赖的全局设备。如果将此特性设置为 TRUE，则表明正在切换转移全局设备。如果将此特性设置为 FALSE，则表明没有切换转移全局设备。资源组依赖于其 Global_resources_used 特性中指定的全局设备。

您不能直接设置 RG_is_frozen 特性。当全局设备的状态更改时，RGM 将更新 RG_is_frozen 特性。

类别：

可选

缺省值：

无缺省值

可调：

否

RG_mode (enum)

表明资源组是故障转移组还是可缩放组。如果值为 Failover，RGM 将把该组的 Maximum_primaries 特性设置为 1 并将资源组限制为由单个节点控制。

如果此特性的值为 Scalable，RGM 将允许 Maximum_primaries 特性的值大于 1，从而使该组可由多个节点同时控制。RGM 不允许将 Failover 特性值为 TRUE 的资源添加到 RG_mode 值为 Scalable 的资源组中。

如果 Maximum_primaries 的值为 1，则缺省值为 Failover。如果 Maximum_primaries 的值大于 1，则缺省值为 Scalable。

类别：

可选

缺省值：

取决于 Maximum_primaries 的值。

可调：

否

RG_name (string)

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

类别：

必需的

缺省值：

无缺省值

可调：

否

RG_project_name (string)

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

仅在 Solaris 9 及更高版本的 Solaris 中支持此特性。

---

注意 –

对此特性的更改将在下次启动该资源时生效。

---

类别：

可选

缺省值：

文本字符串 "default"

可调：

ANYTIME

每个群集节点上的 RG_state (enum)

由 RGM 将其设置为 Unmanaged、Online、Offline、Pending_online、Pending_offline、Pending_online_blocked、Error_stop_failed、Online_faulted 或 Pending_online_blocked 以说明每个群集节点上的组的状态。

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

类别：

仅限于查询

缺省值：

无缺省值

可调：

否

RG_system (boolean)

如果某个资源组的 RG_system 特性为 TRUE，则针对该资源组以及该资源组所包含的资源的特定操作将受到限制。此限制有助于避免意外修改或删除重要的资源组和资源。此特性仅影响 scrgadm(1M) 和 scswitch(1M) 命令，它不会影响 scha_control(1HA) 和 scha_control(3HA) 的操作。

在资源组（或资源组的资源）上执行受限制的操作之前，您必须先将该资源组的 RG_system 特性设置为 FALSE。在修改或删除支持群集服务的资源组时，或者修改或删除此类资源组包含的资源时，请小心操作。

其 RG_system 值被设置为 TRUE 的资源组称为系统资源组。无论 RG_system 的当前值是什么，对 RG_system 特性本身进行编辑将始终不会受到限制。rg_properties(5) 手册页中详细介绍了这些限制。

类别：

可选

缺省值：

FALSE

可调：

是

资源特性属性

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

您不能将 Null 或空字符串 (“”) 指定为 boolean、enum 或 int 类型的缺省值。

首先显示特性名称，然后显示说明。

Array_maxsize

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

Array_minsize

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

Default

表明特性的缺省值。

Description

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

Enumlist

对于 enum 类型，它是允许用于此特性的一组字符串值。

Extension

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

Max

对于 int 类型，它是允许用于此特性的最大值。

Maxlength

对于 string 和 stringarray 类型，它是允许的最大字符串长度。

Min

对于 int 类型，它是允许用于此特性的最小值。

Minlength

对于 string 和 stringarray 类型，它是允许的最小字符串长度。

Property

资源特性的名称。

Tunable

表明群集管理员何时可以设置某个资源中的此特性值。可以将它设置为 NONE 或 FALSE 以防止管理员设置此特性。允许管理员调整的值包括 TRUE 或 ANYTIME（任何时候）、AT_CREATION（仅在创建资源时）或 WHEN_DISABLED（在资源脱机时）。要建立其他可调性条件（例如，“禁用监视时”或“脱机时”），请将此属性设置为 ANYTIME 并通过 Validate 方法验证资源的状态。

缺省设置根据每个标准资源特性的不同而有所差异，如以下章节所示。除非在 RTR 文件中另行指定，否则调整扩展特性的缺省设置为 TRUE (ANYTIME)。

特性的类型

允许的类型为：string、boolean、int、enum 和 stringarray。对于系统定义的特性，您不能在 RTR 文件条目中设置类型属性。类型决定了可接受的特性值和在 RTR 文件条目中允许的特定于类型的属性。enum 类型是一组字符串值。