Sun Cluster 3.1 10/03: Guía del desarrollador de los servicios de datos

Propiedades del tipo de recurso

La tabla siguiente describe las propiedades del tipo de recurso que define Sun Cluster. Los valores de propiedad están divididos en categorías como sigue (en la columna Categoría):

Necesario: la propiedad requiere un valor explícito en el archivo de registro del tipo de recurso (RTR); si no no será posible crear el objeto al que pertenece. No se admite un espacio en blanco ni una cadena vacía como valor.
Condicional; para que exista, la propiedad debe estar declarada en el archivo RTR; en caso contrario, RGM no la creará y no estará disponible para utilidades administrativas. Se permite un espacio en blanco o una cadena vacía. Si la propiedad está declarada en el archivo RTR, pero no se especifica ningún valor, RGM le proporciona un valor predeterminado.
Condicional/explícito: para que exista, la propiedad debe estar declarada en el archivo RTR con un valor explícito; en caso contrario, RGM no la creará y no estará disponible para utilidades administrativas. No se permite un espacio en blanco ni una cadena vacía.
Opcional: la propiedad se puede declarar en el archivo RTR. Si la propiedad no se declara, RGM la crea y le proporciona un valor predeterminado. Si la propiedad está declarada en el RTR pero no se le ha especificado ningún valor, RGM le proporciona el mismo valor predeterminado que si no se hubiera declarado.

Las propiedades del tipo de recurso no se pueden actualizar con utilidades administrativas, salvo Installed_nodes, que no se puede declarar en el archivo RTR y debe establecerla el administrador.

Tabla A–1 Propiedades del tipo de recurso

Nombre de propiedad

Descripción

¿Se puede actualizar?

Categoría

Allow_hosts (matriz de cadenas)

Controla el conjunto de clientes que están autorizados a registrarse con el daemon cl_apid para recibir eventos de reconfiguración de clúster. La forma general de esta propiedad es ipaddress/masklength, que define una subred desde la cual los clientes se pueden registrar. Por ejemplo, el valor 129.99.77.0/24 permite a los clientes de la subred 129.99.77 registrarse para recibir eventos. 192.9.84.231/32 sólo permite que el cliente 192.9.84.231 se registre para recibirlos. Esta propiedad aporta seguridad al CRNP. El daemon cl_apid se describe en SUNW.Event(5).

Además, se reconocen las siguientes palabras clave especiales. LOCAL se refiere a todos los clientes situados en subredes del clúster conectadas directamente. ALL permite que todos los clientes se registren. Tenga en cuenta que si un cliente coincide con una entrada en las propiedades Allow_hosts y Deny_hosts no podrá registrarse en la implementación.

El valor predeterminado es LOCAL.

Opcional

API_version (entero)

La versión de la API de gestión de recursos que utiliza la implementación de este tipo de recurso.

El valor predeterminado de SC 3.1 es 2.

Opcional

Boot (cadena)

Un método de rellamada opcional: la ruta al programa que el gestor de grupos de recursos invoca en un nodo, que se une o vuelve a unirse al clúster cuando un recurso de este tipo ya está gestionado. Este método debe inicializar recursos de este tipo, similares al método Init.

Condicional/ explícito

Client_retry_count (entero)

Controla el número de intentos que realiza el daemon cl_apid al comunicarse con clientes externos. Si un cliente no responde en un número de intentos Client_retry_count, se acaba el tiempo de espera del cliente. Entonces, éste se elimina de la lista de clientes registrados que pueden recibir eventos de reconfiguración de clúster. El cliente debe volver a registrarse para empezar a recibir eventos otra vez. Consulte la descripción de la propiedad Client_retry_interval para obtener información sobre la frecuencia con que realiza esos intentos la implementación. El daemon cl_apid se describe en SUNW.Event(5).

El valor predeterminado es 3.

Opcional

Client_retry_interval (entero)

Define el periodo de tiempo (en segundos) que utiliza el daemon cl_apid al comunicarse con clientes externos que no responden. Hasta Client_retry_count intentos se realizan en este intervalo para ponerse en contacto con el cliente. El daemon cl_apid se describe en SUNW.Event(5).

El valor predeterminado es 1800.

Opcional

Client_timeout (entero)

El valor de tiempo de espera (en segundos) que emplea el daemon cl_apid al comunicarse con clientes externos. Sin embargo, el daemon cl_apid sigue intentando ponerse en contacto con el cliente durante un número de veces ajustable. Consulte las descripciones de las propiedades Client_retry_count y Client_retry_interval para obtener más información sobre cómo ajustar esta propiedad. El daemon cl_apid se describe en SUNW.Event(5).

El valor predeterminado es 60.

Opcional

Deny_hosts (matriz de cadenas)

Controla el conjunto de clientes que no pueden registrarse para recibir eventos de reconfiguración del clúster. Para determinar el acceso, la configuración de esta propiedad tiene preferencia sobre las de la lista Allow_hosts. El formato de esta propiedad es el mismo que el que se define en la propiedad Allow_hosts. Esta propiedad aporta seguridad al CRNP.

El valor predeterminado es NULL.

Opcional

Failover (Booleano)

True indica que los recursos de este tipo no se pueden configurar en ningún grupo que pueda estar en línea en varios nodos al mismo tiempo. El valor predeterminado es False.

Opcional

Fini (cadena)

Un método de rellamada opcional: la ruta al programa que invoca el gestor de grupos de recursos, cuando un recurso de este tipo se elimina del control del gestor de grupos de recursos.

Condicional/ explícito

Init (cadena)

Un método de rellamada opcional: la ruta al programa que invoca el gestor de grupos de recursos, cuando un recurso de este tipo entra bajo el control del gestor de grupos de recursos.

Condicional/ explícito

Init_nodes (enum.)

Los valores pueden ser RG_primaries (sólo los nodos que puede controlar el recurso) o RT_installed_nodes (todos los nodos en los que está instalado el tipo de recurso). Indica los nodos en los que el gestor de grupos de recursos llamará a los métodos Init, Fini, Boot y Validate.

El valor predeterminado es RG_primaries.

Opcional

Installed_nodes (matriz de cadenas)

Una lista de los nombres de nodo del clúster en los que se puede ejecutar el tipo de recurso. RGM crea automáticamente esta propiedad. El administrador del clúster puede fijar el valor. No se puede declarar esta propiedad en el archivo RTR.

El valor predeterminado es todos los nodos del clúster.

Puede configurarla el administrador del clúster

Max_clients (entero)

Controla el número máximo de clientes que se pueden registrar con el daemon cl_apid para recibir notificación de eventos del clúster. Los intentos de otros clientes de registrarse en eventos serán rechazados por la aplicación. Dado que cada registro de cliente utiliza recursos del clúster, ajustar esta propiedad permite a los usuarios controlar la utilización del recurso del clúster por parte de clientes externos. El daemon cl_apid se describe en SUNW.Event(5).

El valor predeterminado es 1000.

Opcional

Monitor_check (cadena)

Un método de rellamada opcional: la ruta al programa que invoca el Gestor de grupos de recursos antes de hacer una operación de recuperación de fallos solicitada por el supervisor de un recurso de este tipo.

Condicional/ explícito

Monitor_start (cadena)

Un método de rellamada opcional: la ruta al programa que invoca el Gestor de grupos de recursos para empezar un supervisor de fallos para un recurso de este tipo.

Condicional/ explícito

Monitor_stop (cadena)

Un método de rellamada necesario si se fija Monitor_start: la ruta al programa que invoca el Gestor de grupos de recursos para detener un recurso de este tipo.

Condicional/ explícito

Num_resource_restarts en cada nodo de clúster (entero)

Esta propiedad está establecida por el RGM en el número de llamadas de scha_control RESTART que se han realizado para este recurso en este nodo en los últimos n segundos, donde n es el valor de la propiedad Retry_interval del recurso. Si un tipo de recurso no declara la propiedad Retry_interval, la propiedad Num_resource_restarts no estará disponible para recursos de ese tipo.

Sólo consulta

Pkglist (matriz de cadenas)

Una lista opcional de paquetes que están incluidos en la instalación del tipo de recursos.

Condicional/ explícito

Postnet_stop (cadena)

Un método de rellamada opcional: la ruta al programa que el Gestor de grupos de recursos invoca después de llamar al método Stop de cualquier recurso de dirección de red (Network_resources_used) del que depende un recurso de este tipo. Este método debe realizar acciones de STOP que deben completarse después de que se hayan configurado las interfaces de red para desconectarse.

Condicional/ explícito

Prenet_start (cadena)

Un método de rellamada opcional: la ruta al programa que el Gestor de grupos de recursos invoca después de llamar al método Start de cualquier recurso de dirección de red (Network_resources_used) del que depende un recurso de este tipo. Este método debe realizar acciones de START que deben completarse después de que se hayan configurado las interfaces de red para desconectarse.

Condicional/ explícito

Resource_type (cadena)

El nombre del tipo de recurso. Para ver los nombres de los tipos de recursos registrados actualmente, utilice:

scrgadm -p

Desde Sun Cluster 3.1, el formato de un nombre de tipo de recurso es:

id_fabricante.tipo_recurso:versión

Los tres componentes del nombre del tipo de recurso son propiedades que se especifican en el archivo RTR como ID_fabricante, tipo_recurso y versión_TR. El comando scrgadm introduce los separadores de punto y punto y coma. El sufijo RT_version del nombre del tipo de recurso es el mismo valor que la propiedad RT_version. Para garantizar que la propiedad ID_fabricante sea única, se recomienda utilizar el símbolo bursátil de la empresa que crea el tipo de recurso. Los nombres de tipo de recurso creados antes de Sun Cluster 3.1 siguen teniendo el formato:

ID_fabricante.tipo_recurso

El valor predeterminado es la cadena vacía.

Necesaria

RT_basedir (cadena)

La ruta de directorio que se usa para completar las rutas relativas de los métodos de rellamada. Esta ruta se debe establecer en el punto de instalación de los paquetes de tipos de recursos. Debe ser una ruta completa, es decir, tiene que empezar con una barra inclinada (/). Esta propiedad no es necesaria si todos los nombres de ruta de métodos son absolutos.

Necesario salvo que todos los nombres de rutas de métodos sean absolutos

RT_description (cadena)

Una descripción breve del tipo de recurso.

El valor predeterminado es la cadena vacía.

Condicional

RT_version (cadena)

A partir de Sun Cluster 3.1, una cadena de versión obligatoria para esta implementación del tipo de recurso, RT_version es el componente de sufijo del nombre del tipo de recurso completo.

Condicional/ explícito

Single_instance (Booleano)

Si es True, indica que sólo puede existir un recurso de este tipo en el clúster. RGM sólo permite que se ejecute un recurso de este tipo en todo el clúster en cada momento.

El valor predeterminado es False.

Opcional

Start (cadena)

Un método de rellamada: la ruta al programa que invoca el Gestor de grupos de recursos para empezar un recurso de este tipo.

Necesario salvo que el archivo RTR declare un método Prenet_start

Stop (cadena)

Un método de rellamada: la ruta al programa que invoca el Gestor de grupos de recursos para detener un recurso de este tipo.

Necesario salvo que el archivo RTR declare un método Postnet_stop

Update (cadena)

Un método de rellamada opcional: la ruta al programa que invoca el Gestor de grupos de recursos cuando se cambian las propiedades de un recurso de este tipo en ejecución.

Condicional/ explícito

Validate (cadena)

Un método de rellamada opcional: la ruta al programa que se invoca para comprobar los valores de las propiedades de los recursos de este tipo.

Condicional/ explícito

Vendor_ID (cadena)

Consulte la propiedad Resource_type.

Condicional