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 文件中定义扩展属性。