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

定义资源类型注册文件

本实例中的资源类型注册 (RTR) 文件中定义了 DNS 资源类型的静态配置。该类型的资源继承 RTR 文件中定义的属性。

资源组管理器 (RGM) 在群集管理员注册 HA-DNS 数据服务时读取 RTR 文件中的信息。

RTR 文件概述

RTR 文件采用定义好的格式。在文件中将依次定义资源类型属性、系统定义的资源属性和扩展属性。有关更多信息，请参见 rt_reg(4) 手册页和设置资源和资源类型属性。

以下各节介绍了样例 RTR 文件中的特定属性。其中列出了该文件的不同部分。有关样例 RTR 文件内容的完整列表，请参见资源类型注册文件列表。

RTR 文件样例中的资源类型属性

RTR 文件样例的开头部分是注释，其后跟有用来定义 HA-DNS 配置的资源类型属性，如下所示。

注 –

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

#
# Copyright (c) 1998-2005 by Sun Microsystems, Inc.
# All rights reserved.
#
# Registration information for Domain Name Service (DNS)
#

#pragma ident   “@(#)SUNW.sample   1.1   00/05/24 SMI”

Resource_type = “sample”;
Vendor_id = SUNW;
RT_description = “Domain Name Service on Sun Cluster”;

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

RT_basedir=/opt/SUNWsample/bin;
Pkglist = SUNWsample;

Start         =   dns_svc_start;
Stop          =   dns_svc_stop;

Validate      =   dns_validate;
Update        =   dns_update;

Monitor_start =   dns_monitor_start;
Monitor_stop  =   dns_monitor_stop;
Monitor_check =   dns_monitor_check;

提示 –

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

以下信息介绍了这些属性：

可以只通过 Resource_type 属性来指定资源类型名称 (sample)，或通过使用 vendor-id 作为前缀，后跟一个句点 (.)，后面加上资源类型属性来指定资源类型名称 (SUNW.sample)。

指定 vendor-id 时，使用用于定义资源类型的公司证券交易符号。在群集中资源类型的名称必须唯一。
RT_version 属性用于将数据服务样例的版本标识为供应商指定的版本。
API_version 属性用于标识 Sun Cluster 的版本。例如，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 表示数据服务无法在可以在多个节点上同时联机的资源组中运行。
RT_basedir 指向 /opt/SUNWsample/bin，将其作为完善相关路径（例如回调方法路径）的目录路径。
Start、Stop 和 Validate 提供了通过 RGM 运行的回调方法程序的相应路径。这些路径是 RT_basedir 所指定的目录的相对路径。
Pkglist 将 SUNWsample 标识为包含数据服务样例安装的软件包。

在此 RTR 文件中没有指定的资源类型属性（例如 Single_instance、Init_nodes 和 Installed_nodes 被设置为其默认值。资源类型属性包含资源类型属性（包括其默认值）的完整列表。

群集管理员不能更改 RTR 文件中资源类型属性的值。

RTR 文件样例中的资源属性

根据约定，在 RTR 文件中的资源类型属性之后声明资源属性。资源属性包括由 Sun Cluster 软件提供的系统定义的属性以及您定义的扩展属性。您可以为每一种类型指定许多属性的属性，它们由 Sun Cluster 软件提供，例如最小值、最大值和默认值。

RTR 文件中的系统定义的属性

以下列表显示了某个样例 RTR 文件中系统定义的属性。

# A list of bracketed resource property declarations follows the
# resource type declarations. The property-name declaration must be
# the first attribute after the open curly bracket of each entry.

# The <method>_timeout properties set the value in seconds after which
# the RGM concludes invocation of the method has failed.

# The MIN value for all method timeouts is set to 60 seconds. This
# prevents administrators from setting shorter timeouts, which do not
# improve switchover/failover performance, and can lead to undesired
# RGM actions (false failovers, node reboot, or moving the resource group
# to ERROR_STOP_FAILED state, requiring operator intervention). Setting
# too-short method timeouts leads to a *decrease* in overall availability
# of the data service.
{  
   PROPERTY = Start_timeout; 
   MIN=60; 
   DEFAULT=300;
}

{
   PROPERTY = Stop_timeout; 
   MIN=60; 
   DEFAULT=300;
}
{
   PROPERTY = Validate_timeout;
   MIN=60;
   DEFAULT=300;
}
{
   PROPERTY = Update_timeout;
   MIN=60;
   DEFAULT=300;
}
{
   PROPERTY = Monitor_Start_timeout;
   MIN=60;
   DEFAULT=300;
}
{
   PROPERTY = Monitor_Stop_timeout;
   MIN=60;
   DEFAULT=300;
}
{
   PROPERTY = Thorough_Probe_Interval;
   MIN=1;
   MAX=3600;
   DEFAULT=60;
   TUNABLE = ANYTIME;
}

# The number of retries to be done within a certain period before concluding 
# that the application cannot be successfully started on this node.
{
   PROPERTY = Retry_count;
   MIN=0;
   MAX=10;
   DEFAULT=2;
   TUNABLE = ANYTIME; 
}

# Set Retry_interval as a multiple of 60 since it is converted from seconds
# to minutes, rounding up. For example, a value of 50 (seconds)
# is converted to 1 minute. Use this property to time the number of 
# retries (Retry_count).
{
   PROPERTY = Retry_interval;
   MIN=60;
   MAX=3600;
   DEFAULT=300;
   TUNABLE = ANYTIME;
}

{
   PROPERTY = Network_resources_used;
   TUNABLE = AT_CREATION;
   DEFAULT = ““;
}

尽管 Sun Cluster 软件提供了系统定义的属性，您也可以使用资源属性的属性设置不同的默认值。有关您可用来应用到资源属性中的属性的完整列表，请参见资源特性属性。

有关样例 RTR 文件中系统定义的资源属性，请注意以下几点：

对于所有超时，Sun Cluster 给出了最小值（1 秒钟）和默认值（3600 秒，或 1 小时）。样例 RTR 文件将最小超时值更改为 60 秒，将默认值更改为 300 秒。群集管理员可以接受此默认值，或将超时值更改为其他值，60 秒或更大值。Sun Cluster 没有最大值上限。
属性 Thorough_probe_interval、Retry_count 和 Retry_interval 的 TUNABLE 属性被设置为 ANYTIME。这些设置表示群集管理员可以更改这些属性的值，即使数据服务正在运行。这些属性由通过数据服务样例实现的故障监视器使用。数据服务样例将实现 Update 方法，以在通过管理操作更改这些或其它资源属性后停止和重启故障监视器。请参见Update 方法的工作方式。
资源属性按以下分类：
- 必需。创建资源时，群集管理员必须指定一个值。
- 可选。如果群集管理员没有指定值，系统将提供默认值。
- 条件。只有在 RTR 文件中声明后，RGM 才能创建属性。
数据服务样例的故障监视器使用 Thorough_probe_interval、Retry_count、Retry_interval 和 Network_resources_used 条件属性，因此需要在 RTR 文件中对它们进行声明。有关如何给属性分类的信息，请参见 r_properties(5) 手册页或资源属性。

RTR 文件中的扩展属性

样例 RTR 文件的结尾处是扩展属性，如该列表所示。

# Extension Properties

# The cluster administrator must set the value of this property to point to the
# directory that contains the configuration files used by the application.
# For this application, DNS, specify the path of the DNS configuration file on
# PXFS (typically named.conf).
{
   PROPERTY = Confdir;
   EXTENSION;
   STRING;
   TUNABLE = AT_CREATION;
   DESCRIPTION = “The Configuration Directory Path”;
}

# Time out value in seconds before declaring the probe as failed.
{
   PROPERTY = Probe_timeout;
   EXTENSION;
   INT;
   DEFAULT = 120;
   TUNABLE = ANYTIME;
   DESCRIPTION = “Time out value for the probe (seconds)”;
}

样例 RTR 文件定义两种扩展属性，Confdir 和 Probe_timeout。Confdir 属性指定 DNS 配置目录的路径。该目录包含 DNS 正常操作所需的 in.named 文件。数据服务样例的 Start 和 Validate 方法使用该属性验证启动 DNS 之前配置目录和 in.named 文件是否可访问。

配置数据服务之后，Validate 方法将检验新目录是否可以访问。

数据服务样例的 PROBE 方法不是 Sun Cluster 回调方法，而是用户定义的方法。因此，Sun Cluster 没有为其提供 Probe_timeout 属性。要使群集管理员可以配置 Probe_timeout 值，需要在 RTR 文件中定义扩展属性。