test

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

资源类型特性

以下内容介绍了 Sun Cluster 定义的资源类型特性。特性值分为以下几类（在“类别”后面给出）：

除 Installed_nodes 和 RT_system（此二者无法在 RTR 文件中声明并且必需由管理员设置）以外，其他资源类型特性均无法通过管理实用程序进行更新。

首先列出的是特性名称，后面是对该特性的说明。

API_version (integer)

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

以下内容概述了 Sun Cluster 的各个版本可支持的最高 API_version。

3.1 版或更低版本

2

3.1 10/03

3

3.1 4/04

4

3.1 9/04

5

如果在 RTR 文件中声明的 API_version 的值大于 2，将禁止在支持的最高版本比声明的值低的 Sun Cluster 版本上安装该资源类型。例如，如果您为某一资源类型声明 API_version=5，则无法在 3.1 9/04 之前发行的任何 Sun Cluster 版本上安装该资源类型。

类别：

可选

缺省值：

2

可调：

否

Boot（字符串）

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

类别：

有条件的/显式

缺省值：

无

可调：

否

Failover（布尔值）

TRUE 表明此类型的资源无法在同时可在多个节点上联机的任何组内进行配置。

类别：

可选

缺省值：

FALSE

可调：

否

Fini（字符串）

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

类别：

有条件的/显式

缺省值：

无

可调：

否

Init（字符串）

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

类别：

有条件的/显式

缺省值：

无

可调：

否

Init_nodes（枚举值）

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

类别：

可选

缺省值：

RG_primaries

可调：

否

Installed_nodes（字符串数组）

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

类别：

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

缺省值：

所有群集节点

可调：

是

Is_logical_hostname（布尔值）

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

类别：

仅限于查询

缺省值：

无缺省值

可调：

否

Is_shared_address（布尔值）

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

类别：

仅限于查询

缺省值：

无缺省值

可调：

否

Monitor_check（字符串）

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

类别：

有条件的/显式

缺省值：

无缺省值

可调：

否

Monitor_start（字符串）

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

类别：

有条件的/显式

缺省值：

无缺省值

可调：

否

Monitor_stop（字符串）

将 Monitor_start 设置为以下路径时是所需的一种回调方法：RGM 为停止此类型的资源的故障监视器而调用的程序的路径。

类别：

有条件的/显式

缺省值：

无缺省值

可调：

否

Pkglist（字符串数组）

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

类别：

有条件的/显式

缺省值：

无缺省值

可调：

否

Postnet_stop（字符串）

一种可选的回调方法：在调用了该类型资源所依赖的所有网络地址资源的 Stop 方法后，RGM 调用的程序的路径。配置网络接口使其关闭后，此方法必须执行 Stop 操作。

类别：

有条件的/显式

缺省值：

无缺省值

可调：

否

Prenet_start（字符串）

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

类别：

有条件的/显式

缺省值：

无缺省值

可调：

否

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

类别：

必需

缺省值：

空字符串

可调：

否

RT_basedir（字符串）

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

类别：

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

缺省值：

无缺省值

可调：

否

RT_description（字符串）

资源类型的简单说明。

类别：

有条件的

缺省值：

空字符串

可调：

否

RT_system（布尔值）

如果将某资源类型的该特性设置为 TRUE，将限制执行原来对该资源类型允许的 scrgadm( 1M) 操作。如果某种资源类型的 RT_system 的值设置为 TRUE，则称之为系统资源类型。不管 RT_system 当前为何值，编辑 RT_system 特性的操作都决不会受到限制。

类别：

可选

缺省值：

FALSE

可调：

是

RT_version（字符串）

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

类别：

可选/显式或必需的

缺省值：

无缺省值

可调：

否

Single_instance（布尔值）

如果将其设置为 TRUE，则表明在群集中只能存在一个此类型的资源。RGM 仅允许在整个群集中只能同时运行一个此类型的资源。

类别：

可选

缺省值：

FALSE

可调：

否

Start（字符串）

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

类别：

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

缺省值：

无缺省值

可调：

否

Stop（字符串）

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

类别：

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

缺省值：

无缺省值

可调：

否

Update（字符串）

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

类别：

有条件的/显式

缺省值：

无缺省值

可调：

否

Validate（字符串）

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

类别：

有条件的/显式

缺省值：

无缺省值

可调：

否

Vendor_ID（字符串）

请参见 Resource_type 特性。

类别：

有条件的

缺省值：

无缺省值

可调：

否