资源特性
表 A–2 说明了 Sun Cluster 定义的资源特性。 以下说明是为数据服务开发者准备的。 有关某个特定数据服务的详细信息，请参见该数据服务的手册页。 资源特性值分为以下几类。
-
必需的 — 管理员必须在使用管理公用程序创建资源时指定一个值。
-
可选的 — 如果管理员在创建资源组时未指定值，系统将提供一个缺省值。
-
条件的 — 只有在 RTR 文件中声明了特性时，RGM 才会创建该特性。 否则，该特性将不存在，系统管理员将不能使用该特性。 在 RTR 文件中声明的有条件特性是可选的还是必需的取决于是否在 RTR 文件中指定了缺省值。 有关详细信息，请参见对每个条件的特性的说明。
-
仅限于查询 — 不能通过管理工具直接进行设置。
表 A–2 还列出了资源特性是否可调以及何时可调，如下所示。
|
None 或 False |
从不 |
|
True 或 Anytime |
任何时候。 |
|
At_creation |
在将资源增加到群集时。 |
|
When_disabled |
在资源被禁用时。 |
表 A–2 资源特性
|
特性名称 |
说明 |
|---|---|
|
Affinity_timeout （整数） |
控制在客户机关闭其与粘性可伸缩服务的所有连接后 IP 关系所持续的秒数。 在此超时期期满之前，客户机的任何新连接都将被转发到同一个群集节点。 0 值表示只要客户机和可伸缩服务之间有连接，关系就将持续。 -1 值表示关系将持续到客户机绑定到的群集节点崩溃或重新引导时。 -1 值表示没有应用任何超时期。
此特性只适用于 Load_balancing_policy=LB_STICKY 或 LB_STICKYWILD 的资源。 种类：可选的 缺省值： 0 可调：任何时候 |
|
Cheap_probe_interval（整数） |
在两次资源故障快速探测的调用之间的秒数。 此特性仅由 RGM 创建，如果在 RTR 文件中声明了该特性，则管理员可以使用该特性。 如果在 RTR 文件中指定了缺省值，则此特性是可选的。 如果在资源类型文件中未指定 Tunable 属性，则此特性的 Tunable 值为 When_disabled。 如果在 RTR 文件的特性声明中未指定 Default 属性，则此特性是必需的。 种类：条件的 缺省值： 参见上述说明 可调：禁用时 |
|
扩展特性 |
当群集管理员使用 Sun Cluster 注册数据服务时，开发者在数据服务的初始配置中声明资源类型特性。 有关可以为扩展特性设置的各个属性的信息， 请参见表 A–4。 种类：条件的 缺省值： 无缺省值 可调：取决于特定的特性 |
|
Failover_mode（枚举） |
可能设置为 None、Soft 和 Hard。 控制 RGM 为响应对资源的 START 或 STOP 方法调用失败是重新定位资源组还是终止某个节点。 None 表示 RGM 只需在方法失败时设置资源状态并等待操作员的干预。 Soft 表示 START 方法的失败应导致 RGM 将资源组重新定位到另一个节点，而 STOP 方法的失败应导致 RGM 设置资源状态并等待操作员的干预。 Hard 表示 START 方法的失败应导致组的重新定位，而 STOP 方法的失败应导致通过终止群集节点强行停止资源。 种类：可选的 缺省值： 无缺省值 可调：任何时候 |
|
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。 更改该特性将仅改变新连接的分配。 种类：条件的/可选的 缺省值： 空字符串 可调：任何时候 |
|
每种回叫方法的 method_timeout（整数） |
以秒计算的时间段，这段时间过后，RGM 将认为对方法的调用已失败。 种类：条件的/可选的 缺省值： 3,600（一小时），如果在 RTR 文件中声明了该方法本身。 可调：任何时候 |
|
Monitored_switch（枚举） |
如果群集管理员使用管理公用程序启用或禁用监视器，则由 RGM 将此特性设置为 Enabled 或 Disabled。 如果设置为 Disabled，则在再次启用监视器之前，监视器的 START 方法不会被调用。 如果资源没有监视器回叫方法，则此特性不存在。 种类： 仅供查询 缺省值： Enabled 可调： 从不 |
|
Network_resources_used（字符串数组） |
一个用逗号分隔的由资源使用的逻辑主机名或共享地址网络资源的列表。 对于可缩放服务，此特性必须是指存在于单独资源组的共享地址资源。 对于失败转移服务，此特性是指存在于相同的资源组的逻辑主机名或共享地址资源。 如果在 RTR 文件中声明了 Scalable 特性，则 RGM 将自动创建此特性。 如果在 RTR 文件中没有声明 Scalable，Network_resources_used 将不可用，除非在 RTR 文件中明确声明。 如果在 RTR 文件中未指定 Tunable 属性，则此特性的 Tunable 值为 At_creation。 种类：条件的/必需的 缺省值： 无缺省值 可调：创建时 |
|
On_off_switch（枚举） |
如果群集管理员使用管理公用程序启用或禁用资源，则由 RGM 将此特性设置为 Enabled 或 Disabled。 如果被禁止，则在再次启用资源之前，资源的回叫不会被调用。 种类：仅供查询 缺省值： Disabled 可调：从不 |
|
Port_list（字符串数组） |
服务器正在侦听的端口号的列表（用逗号分隔）。 每个端口号后跟此端口使用的协议，例如 Port_list=80/tcp。 如果在 RTR 文件中声明了 Scalable 特性，RGM 会自动创建 Port_list；否则该特性不可用，除非在 RTR 文件中明确声明了该特性。 有关为 Apache 设置该特性的详细说明，请参见《用于 Apache 的 Sun Cluster 数据服务指南（适用于 Solaris OS）》。 种类：条件的/必需的 缺省值： 无缺省值 可调：创建时 |
|
R_description（字符串） |
资源的简单说明。 种类：可选的 缺省值： 空字符串 可调：任何时候 |
|
Resource_dependencies（字符串数组） |
一个用逗号分隔的位于同一组中的资源的列表，该组必须联机以使此资源联机。 如果列表中的任何资源启动失败，则不能启动此资源。 在使组脱机时，此资源将在列表中的其它资源之前停止。 除非先禁用此资源，否则不允许禁用列表中的资源。 种类：可选的 缺省值： 空列表 可调：任何时候 |
|
Resource_dependencies_ weak（字符串数组） |
同一组中的资源的列表，可确定组中方法调用的顺序。 RGM 在此资源的 START 方法之前调用此列表中其它资源的 START 方法，在列表中其它资源的 STOP 方法之前调用此资源的 STOP 方法。 如果列表中的其它资源启动失败或被禁用，此资源仍可以联机。 种类： 可选的 缺省值： 空列表 可调：任何时候 |
|
Resource_name（字符串） |
资源实例的名称。 在群集配置中必须唯一，并且在创建了资源之后不能更改。 种类：必需的 缺省值： 无缺省值 可调：从不 |
|
Resource_project_name（字符串) |
与资源关联的 Solaris 项目名称。 使用此特性可将 Solaris 资源管理功能（例如 CPU 共享和资源池）应用至群集数据服务。 当 RGM 使资源联机时，它将启动此项目名下的相关进程。 如果未指定此特性，将采用包含资源的资源组的 RG_project_name 特性中的项目名称。 如果也未指定此特性，RGM 将使用预定义的项目名称 default。 指定的项目名称必须存在于项目数据库中（请参见相应的 SRM 手册页），用户 root 必须配置为已命名项目的成员。 Solaris 9 以及更高的发行版支持此特性。 有关 Solaris 项目名称的详细信息，请参见 System Administration Guide: Resource Management and Network Services。
种类： 可选的 缺省值： 参见上述说明 可调： 任何时候 |
|
Resource_state： 在每个群集节点上（枚举） |
RGM 确定的每个群集节点上的资源的状态。 可能的状态包括： ONLINE 、OFFLINE、STOP_FAILED、START_FAILED、MONITOR_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_used、Port_list、Load_balancing_policy 和 Load_balancing_weights。 这些特性具有缺省值，除非在 RTR 文件中对它们进行了显式声明。 Scalable（如果在 RTR 文件中声明）的缺省值为 True。 当在 RTR 文件中声明此特性时，Tunable 属性必须设置为 At_creation，否则资源创建将失败。 如果未在 RTR 文件中声明此特性，则资源不可伸缩，群集管理员不能调整此特性，并且没有由 RGM 设置的可伸缩服务特性。 但是，必要时您可以在 RTR 文件中显式声明 Network_resources_used 和 Port_list 特性，因为它们在非可缩放服务中与在可缩放服务中都可能有用。 种类：可选的 缺省值： 参见上述说明 可调：创建时 |
|
Status： 在每个群集节点上（枚举） |
由资源监视器设置。 可能的值包括 OK、degraded、faulted、unknown 和 offline。 当资源联机时，RGM 将值设置为 unknown，当资源脱机时，RGM 将值设置为 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 可能会被更改为新值。 RT_Version 可用于从数据服务的一个版本升级到数据服务的另一个版本。 其可调性源自：
|
|
Udp_affinity （布尔值） |
如果值为 TRUE，则会按照与转发 TCP 连接相同的方式将给定客户机的 UDP 包转发到同一群集服务器节点。 如果客户机的 TCP 连接与某个服务器节点“粘附”，其 UDP 包也将发送到该节点。 如果值为 FALSE，则不会维持上述处理方式，给定客户机的 UDP 包可能会在与此客户机的 TCP 连接不同的节点上结束。 此特性只适用于 Load_balancing_policy=LB_STICKY 或 LB_STICKYWILD 的资源。 种类：可选的 缺省值： False 可调：禁用时 |
|
Weak_affinity （布尔值） |
为粘性可伸缩服务提供 IP 关系，在以下条件下中断的情况除外： (1) 当服务器侦听程序由于故障监视器重新启动、资源故障切换和切换等原因启动时，或节点在故障切换之后重新链接到群集时。 (2) 当可伸缩资源的 load_balancing_weights 由于某个管理操作而更改时。 根据内存消耗和处理器周期为 IP 关系的缺省格式提供低开销替换。 不使用关系超时值。 只要以上列出的中断不发生，Weak_affinity 就将持续。 此特性只适用于 Load_balancing_policy=LB_STICKY 或 LB_STICKYWILD 的资源。
种类： 可选的 缺省值： False 可调： 禁用时 |
- © 2010, Oracle Corporation and/or its affiliates