Sun Cluster: Guía del desarrollador de los servicios de datos del sistema operativo Solaris

Definición del archivo de registro del tipo de recurso

El archivo de registro del tipo de recurso (RTR) de este ejemplo define la configuración estática del tipo de recurso de DNS. Los recursos de este tipo heredan las propiedades definidas en el archivo RTR.

El Gestor de grupos de recursos (RGM) lee la información del archivo RTR cuando el administrador del clúster registra el servicio HA-DNS.

Información general sobre el archivo RTR

El archivo RTR sigue un formato bien definido. Las propiedades del recurso se definen primero en el archivo; después se definen las propiedades del recurso definidas por el sistema; finalmente, se definen las propiedades de extensión. Consulte la página de comando man rt_reg(4) y Establecimiento del recurso y las propiedades del tipo de recurso para obtener más información.

Las siguientes secciones describen las propiedades específicas del archivo RTR de ejemplo. Estas secciones proporcionan listados de las diferentes partes del archivo. Para obtener una lista completa del contenido del archivo RTR de ejemplo, consulte Listado del archivo de registro del tipo de recurso.

Propiedades de tipo en el archivo RTR de ejemplo

El archivo RTR de ejemplo empieza con comentarios, seguidos de las propiedades del tipo de recurso que definen la configuración de HA-DNS, como se muestra en la lista siguiente.


Nota –

Los nombres de los tipos de recursos, los recursos y los grupos de recursos no distinguen entre mayúsculas y minúsculas. Puede utilizar cualquier combinación de mayúsculas y minúsculas al especificar los nombres de las propiedades.


#
# 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;

Consejo –

Debe declarar la propiedad Resource_type como la primera entrada del archivo RTR, De lo contrario, fallará el registro del tipo de recurso.


La siguiente información describe estas propiedades:

Las propiedades del tipo de recurso que no se especifiquen en el archivo RTR como, por ejemplo, Single_instance, Init_nodes y Installed_nodes , se establecerán en sus valores predeterminados. Propiedades del tipo de recurso contiene una lista completa de las propiedades de tipos de recursos, incluidos sus valores predeterminados.

El administrador del clúster no puede cambiar los valores de las propiedades de tipos de recursos del archivo RTR.

Propiedades del recurso en el archivo RTR de ejemplo

Por convención, las propiedades del recurso se declaran de acuerdo con las del tipo de recurso del archivo RTR. Entre las propiedades del recurso, se incluyen las propiedades definidas por el sistema que proporciona Sun Cluster y las propiedades de extensión que defina. Para cada tipo, puede especificar una serie de atributos de propiedades proporcionadas por el software de Sun Cluster, como los valores mínimos, máximos y predeterminados

Propiedades definidas por el sistema en el archivo RTR

La siguiente lista muestra las propiedades definidas por el sistema en el archivo RTR de ejemplo.

# 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 = ““;
}

Aunque el software de Sun Cluster proporciona las propiedades definidas por el sistema, puede establecer diferentes valores predeterminados mediante el uso de los atributos de propiedades del recurso. Consulte Atributos de las propiedades de recursos para obtener una lista completa de los atributos disponibles que se pueden aplicar a las propiedades del recurso.

Tenga en cuenta los siguientes puntos sobre las propiedades de recursos definidas por el sistema en el archivo RTR de ejemplo:

Propiedades de extensión en el archivo RTR

Al final del archivo RTR de ejemplo, se encuentran las propiedades de extensión:

# 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)”;
}

El archivo RTR de ejemplo define dos propiedades de extensión, Confdir y Probe_timeout. La propiedad Confdir especifica la ruta al directorio de configuración de DNS, que contiene el archivo in.named, necesario para que DNS funcione satisfactoriamente. Los métodos Start y Validate del servicio de datos de ejemplo utilizan esta propiedad para comprobar que se puede acceder al directorio de configuración y el archivo in.named antes de iniciar DNS.

Cuando el servicio de datos está configurado, el método Validate verifica si el nuevo directorio es accesible.

El método PROBE del servicio de datos de ejemplo no es un método de rellamada de Sun Cluster, sino un método definido por el usuario. Por lo tanto, Sun Cluster no proporciona una propiedad Probe_timeout para éste. Debe definir una propiedad de extensión en el archivo RTR para permitir que el administrador del clúster configure el valor de Probe_timeout.