test

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

资源类型特性

下表介绍了 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_hosts 和 Deny_hosts 特性中的项相匹配，则该实现将阻止客户机进行登记。

缺省值为 LOCAL。

N 

可选的 

API_version（整数）

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

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

N  

可选的 

Boot（字符串）

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

N 

有条件的/显式  

Client_retry_count（整数）

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

缺省值为 3。 

Y 

可选的 

Client_retry_interval（整数）

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

缺省值为 1800。 

Y 

可选的 

Client_timeout（整数）

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

缺省值为 60。  

Y  

可选的 

Deny_hosts（字符串数组）

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

缺省值为 NULL。

Y  

可选的 

Failover（布尔值）

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

N 

可选的 

Fini（字符串）

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

N 

有条件的/显式 

Init（字符串）

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

N 

有条件的/显式 

Init_nodes（枚举值）

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

缺省值为 RG_primaries。

N 

可选的 

Installed_nodes（字符串数组）

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

缺省值是所有群集节点。 

Y 

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

Max_clients（整数）

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

缺省值为 1000。 

Y 

可选的 

Monitor_check（字符串）

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

N  

有条件的/显式 

Monitor_start（字符串）

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

N 

有条件的/显式 

Monitor_stop（字符串）

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

N 

有条件的/显式 

每个群集节点上的 Num_resource_restarts（整数）

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

N 

仅限于查询 

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_id、Resource_type 和 RT_version。 scrgadm 命令将插入句点和冒号分界符。 资源类型名称中的 RT_version 后缀的值与 RT_version 特性的值相同。 为了确保 Vendor_id 的唯一性，建议使用创建该资源类型的公司的股票标志。 使用 Sun Cluster 3.1 以前的版本创建的资源类型名称将继续使用以下语法： 

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

N 

必需的 

RT_basedir（字符串）

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

N 

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

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。

N 

可选的 

Start（字符串）

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

N 

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

Stop（字符串）

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

N  

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

Update（字符串）

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

N 

有条件的/显式  

Validate（字符串）

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

N 

有条件的/显式  

Vendor_ID（字符串）

请参阅 Resource_type 特性。

N 

有条件的