rt_properties (5)

名称

描述

以下信息介绍了 Oracle Solaris Cluster 软件定义的资源类型属性。这些描述已针对数据服务开发者进行开发。有关特定数据服务的信息，请参见该数据服务的手册页。

资源类型属性值

必需

该属性需要在资源类型注册 (Resource Type Registration, RTR) 文件中有显式值。否则，将无法创建该属性所属的对象。该值不允许为空白或空字符串。

有条件的

必须在 RTR 文件中声明该属性，它才会存在。否则，RGM 不会创建该属性，且该属性不能用于管理实用程序。允许使用空白或空字符串。如果该属性在 RTR 文件中已声明但未指定值，RGM 将提供默认值。

有条件的/显式

必须在 RTR 文件中声明该属性且赋予其显式值，它才会存在。否则，RGM 不会创建该属性，且该属性不能用于管理实用程序。不允许使用空白或空字符串。

可选

可在 RTR 文件中声明该属性。如果未在 RTR 文件中声明该属性，RGM 会创建它并提供默认值。如果在 RTR 文件中已声明该属性但未指定值，RGM 会提供相同的默认值，就像未在 RTR 文件中声明该属性一样。

仅查询

该属性不能通过管理实用程序直接进行设置。该属性不是在 RTR 文件中进行设置的。提供该属性的值仅供参考。

资源类型属性和描述

资源类型是由资源类型注册文件定义的，该文件用于为资源类型指定标准属性值和扩展属性值。

API_version (integer)

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

以下信息汇总了每个 Oracle Solaris Cluster 软件发行版所支持的最高 API_version。

3.1 及 3.1 之前的版本

2

3.1 10/03

3

3.1 4/04

4

3.1 9/04

5

3.1 8/05

6

3.2

7

3.2 2/08

8

3.2 1/09

9

3.2 11/09

10

3.3

11

3.3 5/11

12

3.3 12/12

13

4.0

20

4.1

21

4.2

22

在 RTR 文件中为 API_version 声明一个大于 2 的值可防止该资源类型安装在支持较低最高版本的 Oracle Solaris Cluster 软件版本上。例如，如果您为某个资源类型声明 API_version=7，则该资源类型将不能安装在 Sun Cluster 3.2 发行版之前发行的任意版本的群集软件上。

类别

可选

默认值

2

可调

从不

Boot (string)

一种可选的回调方法：在发生以下情况时，RGM 对节点调用的程序的路径：

• 节点加入或重新加入群集。

• 包含此类资源的资源组处于受管状态。

预计该方法初始化此类资源的方式与 Init 方法相同。

类别

有条件的/显式

默认值

无

可调

从不

Failover (boolean)

如果将该属性设置为 TRUE，则此类型的资源将无法在可同时在多个节点上联机的任意组中配置。

可以按如下方式将该资源类型属性与 Scalable 资源属性结合使用：

Failover/Scalable 描述 TRUE/TRUE 请勿指定这个不合逻辑的组合。 TRUE/FALSE 可为故障转移服务指定此组合。 FALSE/TRUE 可为使用 SharedAddress 资源进行网络负载平衡的可伸缩服务指定此组合。 Oracle Solaris Cluster Concepts Guide 更详细地介绍了 SharedAddress。 FALSE/FALSE 使用此组合可选择不使用网络负载平衡的多主机服务。

r_properties(5) 中对 Scalable 的描述和Oracle Solaris Cluster Concepts Guide 中的第 3  章 Key Concepts for System Administrators and Application Developers介绍了相关的附加信息。

类别

可选

默认值

FALSE

可调

从不

Fini (string)

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

类别

有条件的/显式

默认值

无默认值

可调

从不

Global_zone (boolean)

如果将某个资源类型的该属性设置为 TRUE，在任何情况下，其方法均在全局区域中执行。如果将该属性设置为 TRUE，则即使在区域群集中配置了资源组，也会在全局区域中执行该方法。仅针对只能从全局区域管理的服务，如网络地址和文件系统，将该属性设置为 TRUE。

---

注意  -  不要注册 Global_zone 属性设置为 TRUE 的资源类型，除非该资源类型来自于已知的可信源。此属性设置为 TRUE 的资源类型会规避区域隔离并引起风险。 请勿在位于区域群集中的 RTR 文件中将 Global_zone 属性设置为 TRUE。该属性设置为 TRUE 的所有资源类型必须位于全局群集的全局区域中。

---

配置为在非全局区域中启动，并且其 Global_zone 属性设置为 TRUE 的资源的方法始终在全局区域中运行。此类资源配置在非全局区域中时，不会从 CPU 共享和专用处理器集配置中受益。即使将 RG_slm_type 属性设置为 AUTOMATED，该资源也不会受益。Oracle Solaris Cluster 软件将此类资源视为好像位于 RG_slm_type 属性设置为 MANUAL 的资源组中一样。

因为 Global_zone 属性设置为 TRUE 的资源类型的方法在全局区域中运行，所以当非全局区域停止时，RGM 不会立即将这些资源类型视为脱机。实际上，RGM 对这些资源类型（包括 LogicalHostname、SharedAddress 和 HAStoragePlus）运行 Monitor_stop、Stop 和 Postnet_stop 等方法。但是，当非全局区域停止时，RGM 将 Global_zone 属性设置为 FALSE 的资源视为脱机。RGM 无法对此类资源运行停止方法，因为这些方法必须在非全局区域中运行。

对于声明 Global_zone=TRUE 的资源类型，可能还需要声明 Global_zone_override 资源属性。在这种情况下，Global_zone_override 属性的值将代替该资源的 Global_zone 属性值。有关 Global_zone_override 属性的更多信息，请参见 r_properties(5) 手册页。

类别

可选

默认值

FALSE

可调

从不

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 文件中声明该属性。

类别

可由群集管理员进行配置

默认值

所有群集节点

可调

随时

Is_logical_hostname (boolean )

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

类别

仅查询

默认值

无默认值

可调

从不

Is_shared_address (boolean )

TRUE 表明该资源类型是管理共享 IP（Internet Protocol，Internet 协议）地址的 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 操作。

类别

有条件的/显式

默认值

无默认值

可调

从不

Proxy (boolean)

指示此类资源是否为代理资源。

代理资源是一种 Oracle Solaris Cluster 资源，用于从其他群集框架（如 Oracle Clusterware）导入某个资源的状态。Oracle Clusterware 是一组适用于群集环境的不依赖于平台的系统服务。

代理资源类型使用 Prenet_start 方法启动用于监视外部（代理）资源状态的守护进程。Postnet_stop 方法停止正在进行监视的守护进程。正在进行监视的守护进程发出带有 CHANGE_STATE_ONLINE 或 CHANGE_STATE_OFFLINE 标记的 scha_control 命令，从而将代理资源的状态相应地设置为 Online 或 Offline。同样，scha_control() 函数也使用 SCHA_CHANGE_STATE_ONLINE 和 SCHA_CHANGE_STATE_OFFLINE 标记。

如果将该属性设置为 TRUE，资源将为代理资源。

类别

可选

默认值

FALSE

可调

从不

Resource_list (string_array )

该资源类型的所有资源的列表。管理员不直接设置该属性。相反，在管理员向任意资源组添加或从中删除此类资源时，RGM 会更新该属性。

类别

仅查询

默认值

空列表

可调

从不

Resource_type (string)

资源类型的名称 要查看当前已注册的资源类型的名称，请键入：

clresourcetype list

资源类型名称包括版本，这是强制性的：

vendor_id.resource_type:version

资源类型名称的三个组成部分是在 RTR 文件中指定为 vendor-id、resource-type 和 RT-version 的属性。clresourcetype 命令用于插入句点 (.) 和冒号 (:) 分界符。资源类型名称的 RT_version 后缀的值与 RT_version 属性的值相同。要确保 vendor-id 唯一，建议的方法是使用要创建资源类型的公司的股票代码。

类别

必需

默认值

空字符串

可调

从不

RT_basedir (string)

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

类别

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

默认值

无默认值

可调

从不

RT_description (string)

资源类型的简要描述。

类别

有条件的

默认值

空字符串

可调

从不

RT_system (boolean)

如果将某个资源类型的该属性设置为 TRUE，则无法删除该资源类型 (clresourcetype unregister resource-type-name)。该属性旨在帮助防止意外删除用于支持群集基础结构的资源类型，例如 LogicalHostname。但是，您可以将 RT_system 属性应用于任意资源类型。

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

类别

可选

默认值

FALSE

可调

随时

RT_version (string)

用于标识该资源类型实现的强制性版本字符串。RT_version 是完整资源类型名称的后缀部分。

类别

有条件的/显式或必需的

默认值

无默认值

可调

从不

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 属性。

类别

有条件的

默认值

无默认值

可调

从不

另请参见

clresource(1CL)、clresourcegroup(1CL)、clresourcetype(1CL)、rt_reg(4)、SUNW.HAStoragePlus(5)、property_attributes(5)、r_properties(5)、rg_properties(5)、scha_control(1HA)、scha_control(3HA)。

Oracle Solaris Cluster Concepts Guide 、Oracle Solaris Cluster Data Services Developer’s Guide 、Oracle Solaris Cluster 数据服务规划和管理指南