资源类型属性

以下信息介绍了由 Sun Cluster 软件定义的资源类型属性。属性值分为以下几类：

• 必需。此属性要求资源类型注册 (RTR) 文件中有明确的值。否则，将无法创建属性所属的对象。此值不能为空格或空字符串。

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

• 有条件的或显式。必须在 RTR 文件中声明此属性的明确值，此属性才存在。否则，RGM 不会创建该属性，并且该属性将不能用于管理实用程序。不允许使用空格或空字符串。

• 可选。可在 RTR 文件中声明此属性。如果未在 RTR 文件中声明属性，则 RGM 将创建属性并提供一个缺省值。如果在 RTR 文件中声明了属性但未指定值，则 RGM 将提供相同的默认值，就像没在 RTR 文件中声明该属性一样。

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

不能通过管理实用程序更新资源类型属性，Installed_nodes 和 RT_system 除外，这两个资源类型属性不能在 RTR 文件中声明并且必须由群集管理员设置。

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

资源类型属性名称（例如 API_version 和 Boot）不区分大小写。指定属性名称时可以使用大小写字母的任意组合。

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

3.1 8/05

6

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

---

注 –

如果不将此属性声明或设置为默认值 (2)，则可将数据服务安装到 Sun Cluster 3.0 以后的任何版本的 Sun Cluster 上。

---

类别：

可选

缺省值：

2

可调：

无

Boot (string)

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

类别：

有条件的/显式

缺省值：

无缺省值

可调：

无

Failover (boolean)

True 用于指明不能在可同时在多个节点上联机的任何组中配置此类资源。

下表显示了如何将此资源类型属性与 Scalable 资源属性结合使用。

Failover 资源类型的值	Scalable 资源的值	说明
TRUE	TRUE	请不要指定这个不合逻辑的组合。
TRUE	FALSE	可为故障转移服务指定此组合。
FALSE	TRUE	可为使用 SharedAddress 资源进行网络负载平衡的可伸缩服务指定此组合。 《Sun Cluster 概念指南（适用于 Solaris OS）》详细介绍了 SharedAddress。
FALSE	FALSE	虽然这不是常见组合，但您可以使用此组合选择不使用网络负载平衡的多主服务。

r_properties(5) 手册页中的对 Scalable 的说明和《Sun Cluster 概念指南（适用于 Solaris OS）》中的第 3  章 “适用于系统管理员和应用程序开发者的关键概念”包含附加信息。

类别：

可选

缺省值：

FALSE

可调：

无

Fini (string)

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

类别：

有条件的/显式

缺省值：

无缺省值

可调：

无

Init (string)

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

类别：

有条件的/显式

缺省值：

无缺省值

可调：

无

Init_nodes (enum)

指明 RGM 对哪些节点调用 Init、Fini、Boot 和 Validate 方法。值可为 RG_PRIMARIES（仅为可以控制资源的节点）或 RT_INSTALLED_NODES（安装了该资源类型的所有节点）。

类别：

可选

缺省值：

RG_PRIMARIES

可调：

无

Installed_nodes (string_array)

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

类别：

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

缺省值：

所有群集节点

可调：

ANYTIME

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)

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

类别：

有条件的/显式

缺省值：

无缺省值

可调：

无

Resource_list (string_array)

资源类型的所有资源的列表。群集管理员不直接设置此属性。而是当群集管理员在任何资源组中添加或删除此类资源时，由 RGM 更新此属性。

类别：

仅限于查询

缺省值：

空列表

可调：

无

Resource_type (string)

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

scrgadm -p

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

vendor-id.resource-type:rt-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)

如果资源类型的 RT_system 属性为 TRUE，则不能删除该资源类型 (scrgadm -r -t resource-type-name)。此属性用于防止意外删除资源资源类型，例如用于支持群集基础结构的 LogicalHostname。但是，您可以将 RT_system 属性应用于任何资源类型。

要删除 RT_system 属性设置为 TRUE 的资源类型，必须先将此属性设置为 FALSE。删除其资源支持群集服务的资源类型时需谨慎。

类别：

可选

缺省值：

FALSE

可调：

ANYTIME

RT_version (string)

从 Sun Cluster 3.1 开始，实施该资源类型必需版本字符串。RT_version 是完整资源类型名称的后缀部分。曾在 Sun Cluster 3.0 中为可选属性的 RT_version 属性在 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)

一种可选的回调方法：RGM 为检查此类资源的属性值所运行的程序的路径。

类别：

有条件的/显式

缺省值：

无缺省值

可调：

无

Vendor_ID (string)

请参见 Resource_type 属性。

类别：

有条件的

缺省值：

无缺省值

可调：

无