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

声明资源类型属性

群集管理员无法配置您在 RTR 文件中声明的资源类型属性。这些属性将成为永久资源类型配置中的一部分。


注 –

资源类型属性 Installed_nodes 只能由群集管理员进行配置。您无法在 RTR 文件中声明 Installed_nodes


资源类型声明的语法如下所示:

property-name = value;

注 –

资源组、资源和资源类型的属性名称区分大小写。在指定属性名称时,您可以使用大小写字母的任意组合。


以下是 RTR 文件中用于样例 (smpl) 数据服务的资源类型声明:

# Sun Cluster Data Services Builder template version 1.0
# Registration information and resources for smpl
#
#NOTE: Keywords are case insensitive, i.e., you can use
#any capitalization style you prefer.
#
Resource_type = "smpl";
Vendor_id = SUNW;
RT_description = "Sample Service on Sun Cluster";

RT_version ="1.0"; 
API_version = 2;
Failover = TRUE;

Init_nodes = RG_PRIMARIES;

RT_basedir=/opt/SUNWsmpl/bin;

Start           =    smpl_svc_start;
Stop            =    smpl_svc_stop;

Validate        =    smpl_validate;
Update          =    smpl_update;

Monitor_start   =    smpl_monitor_start;
Monitor_stop    =    smpl_monitor_stop;
Monitor_check   =    smpl_monitor_check;

提示 –

您必须将 Resource_type 属性声明为 RTR 文件中的第一项。否则,资源类型注册将失败。


第一组资源类型声明提供了有关资源类型的基本信息。

Resource_typeVendor_id

提供资源类型的名称。您可以仅使用 Resource_type 属性指定资源类型名称 (smpl),或使用 Vendor_id 属性作为前缀,并用“.”将该属性与资源类型分隔开 (SUNW.smpl),如样例中所示。如果您使用 Vendor_id,请使其成为公司用于定义资源类型的股市符号。在群集中资源类型的名称必须唯一。


注 –

按照约定,资源类型名称 (vendoridApplicationname) 用作软件包名称。从 Solaris 9 操作系统开始,供应商 ID 和应用程序名称的组合可以超过九个字符。但是,如果您使用的是 Solaris 操作系统的早期版本,则供应商 ID 和应用程序名称的组合不能超过九个字符(尽管 RGM 并没有强制此限制)。

另外,在所有情况下,Agent Builder 都明确地根据资源类型名称生成软件包名称,因此它将强制执行九个字符的限制。


RT_description

简要地介绍资源类型。

RT_version

用于标识数据服务样例的版本。

API_version

用于标识 API 的版本。例如,API_version = 2 表明数据服务可以安装在从 Sun Cluster 3.0 开始的 Sun Cluster 的所有版本上;API_version = 5 表明数据服务可以安装在从 Sun Cluster 3.1 9/04 开始的 Sun Cluster 的所有版本上。但是,API_version = 5 还表明数据服务无法安装在 Sun Cluster 3.1 9/04 发行之前的 Sun Cluster 的所有版本上。有关该属性的详细信息,请参见资源类型属性中有关 API_version 条目下的内容。

Failover = TRUE

表明数据服务无法在可同时在多个节点上联机的资源组中运行。换句话说,该声明指定了一个故障转移数据服务。有关该属性的详细信息,请参见资源类型属性中有关 Failover 条目下的内容。

StartStopValidate

提供由 RGM 调用的各个回调方法程序的路径。这些路径是 RT_basedir 所指定的目录的相对路径。

其余的资源类型声明提供了配置信息。

Init_nodes = RG_PRIMARIES

指定 RGM 仅在可以主控数据服务的节点上调用 InitBootFiniValidate 方法。RG_PRIMARIES 所指定的节点是安装有数据服务的所有节点的一个子集。将值设置为 RT_INSTALLED_NODES 可指定 RGM 在安装有数据服务的所有节点上调用这些方法。

RT_basedir

指向 /opt/SUNWsample/bin,作为指向完整相对路径(例如回调方法路径)的目录路径。

StartStop Validate

提供指向由 RGM 调用的各个回调方法程序的路径。这些路径是 RT_basedir 所指定的目录的相对路径。