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

Propiedades de recurso

La Tabla A–2 describe las propiedades de recurso que define Sun Cluster. Los valores de propiedad están divididos en categorías como sigue (en la columna Categoría):

La Tabla A–2 indica también si es posible y, en su caso, cuándo se pueden actualizar las propiedades de recurso (en la columna ¿Se puede actualizar?), como sigue:

None o False

Nunca 

True o Anytime

En cualquier momento 

At_creation

Al agregar el recurso al clúster 

When_disabled

Al desactivar el recurso 

Tabla A–2 Propiedades de recurso

Nombre de propiedad 

Descripción 

¿Se puede actualizar? 

Categoría 

Affinity_timeout (entero)

Tiempo, en segundos, durante el cual las conexiones de una dirección IP de cliente determinado a cualquier servicio del recurso se enviarán al mismo nodo del servidor.  

Esta propiedad sólo es importante cuando Load_balancing_policy es Lb_sticky o Lb_sticky_wild. Además, Weak_affinity se debe establecer en false (el valor predeterminado).

Esta propiedad se utiliza solamente en servicios escalables.  

En cualquier momento 

Opcional 

Cheap_probe_interval (entero)

El número de segundos entre llamadas de un análisis rápido de fallos del recurso. Esta propiedad sólo la crea RGM y sólo está disponible para el administrador si se declara en el archivo RTR. 

Esta propiedad es opcional si se especifica un valor predeterminado en el archivo RTR. Si el atributo Tunable no se especifica en el archivo de tipo de recurso, el valor Tunable de la propiedad será When_disabled.

Esta propiedad es necesaria si el atributo Default no se especifica en la declaración de propiedades del archivo RTR.

Cuando está inhabilitado  

Condicional 

Propiedades de extensión 

Las propiedades de extensión, como se declaran en el archivo RTR del tipo de recurso. La implementación del tipo de recurso define estas propiedades. Para obtener información sobre los atributos individuales que se pueden fijar para las propiedades de extensión, consulte la Tabla A–4.

Depende de la propiedad en cuestión 

Condicional 

Failover_mode (enum.)

Los valores posibles son: None, Soft y Hard. Controla si RGM reubica un grupo de recursos o abandona un nodo en respuesta a un fallo de una llamada de los métodos Start, Stop o Monitor_stop en el recurso. None (ninguno) indica que RGM debe fijar el estado del recurso en un fallo de método y esperar la intervención del operador. Soft (dinámico) indica que el fallo de un método Start debería hacer que RGM reubicara el grupo de recursos en un nodo diferente, en tanto que el fallo de un método Stop o Monitor_stop debería hacer que RGM pusiera el recurso en el estado STOP_FAILED y el grupo de recursos en el estado ERROR_STOP_FAILED y que se esperara la intervención del operador. Para los fallos de Stop o Monitor_stop, los valores None y Soft son equivalentes. Hard (estático) indica que el fallo de un método Start debería provocar la reubicación del grupo y el fallo de un método Stop o Monitor_stop debería provocar la parada forzada del recurso, mediante la anulación del nodo del clúster.

La opción predeterminada es None.

En cualquier momento 

Opcional 

Load_balancing_policy (cadena)

Una cadena que define la política de equilibrio de cargas que se está utilizando. Esta propiedad sólo se usa para servicios escalables. RGM crea automáticamente esta propiedad si la propiedad Scalable está declarada en el archivo RTR. Load_balancing_policy puede tomar los valores siguientes:

Lb_weighted (el predeterminado). La carga se distribuye entre varios nodos, de acuerdo con los pesos fijados en la propiedad Load_balancing_weights. Lb_sticky. Un cliente determinado (identificado por la dirección IP de cliente) del servicio escalable se envía siempre al mismo nodo del clúster. Lb_sticky_wild. Un cliente determinado (identificado por la dirección IP de cliente) que se conecta a una dirección IP de un servicio adherente con comodín, siempre se envía al mismo nodo del clúster, independientemente del número de puerto al que llegue.

La opción predeterminada es Lb_weighted.

Al crearse  

Condicional/ opcional 

Load_balancing_weights (matriz de cadenas)

Sólo para recursos escalables. RGM crea automáticamente esta propiedad si la propiedad Scalable está declarada en el archivo RTR. El formato es peso@nodo,peso@nodo, donde peso es un número entero que refleja la parte relativa de la carga distribuida al nodo especificado. La fracción de carga distribuida a un nodo es el peso de este nodo dividido entre la suma de todos los pesos. Por ejemplo, 1@1,3@2 especifica que el nodo 1 recibe 1/4 de la carga y el nodo 2, 3/4. La cadena vacía (“”), la predeterminada, establece una distribución uniforme. Cualquier nodo que no tenga un peso asignado, recibe un peso predeterminado de 1.

Si el atributo Tunable no se especifica en el archivo de tipo de recurso, el valor Tunable de la propiedad es Anytime. Cualquier cambio en esta propiedad revisa sólo la distribución de nuevas conexiones

La opción predeterminada es la cadena vacía (“”). 

En cualquier momento  

Condicional/ opcional 

método_timeout para cada método de rellamada en el tipo (entero)

Un margen de tiempo, en segundos, pasado el cual RGM concluye que la invocación del método ha fallado.  

El valor predeterminado es 3.600 (una hora) si el método en sí está declarado en el archivo RTR. 

En cualquier momento 

Condicional/ 

Opcional 

Monitored_switch (enum.)

RGM lo establece en Enabled o Disabled si el administrador del clúster habilita o inhabilita el supervisor con una utilidad administrativa. Si es Disabled, no se invoca el método Start del supervisor hasta que se vuelva a habilitar. Si el recurso no tiene un método de rellamada del supervisor, la propiedad no existirá.

El valor predeterminado es Enabled.

Nunca 

Sólo consulta 

Network_resources_used (matriz de cadenas)

Una lista de recursos de red de nombre lógico de servidor o dirección compartida que utiliza el recurso. Para los servicios escalables, esta propiedad se debe referir a recursos de dirección compartida existentes en un grupo de recursos aparte. En el caso de servicios a prueba de fallos, esta propiedad se refiere a recursos de nombre lógico de servidor o dirección compartida existentes en el mismo grupo de recursos. RGM crea automáticamente esta propiedad si la propiedad Scalable está declarada en el archivo RTR. Si Scalable no está declarada en el archivo RTR, Network_resources_used no estará disponible, salvo que se declare específicamente en el archivo RTR.

Si el atributo Tunable no se especifica en el archivo de tipo de recurso, el valor Tunable de la propiedad será At_creation.

Al crearse 

Condicional/ necesario 

On_off_switch (enum.)

RGM lo establece en Enabled o Disabled si el administrador del clúster habilita o inhabilita el recurso con una utilidad administrativa. Si está inhabilitado, no se invocan rellamadas del recurso hasta que se vuelva a habilitar.

El valor predeterminado es Disabled.

Nunca 

Sólo consulta 

Port_list (matriz de cadenas)

Una lista de números de puerto en los que recibe el servidor. Anexo a cada número de puerto está el protocolo que utiliza dicho puerto, por ejemplo Port_list=80/tcp. Si la propiedad Scalable está declarada en el archivo RTR, RGM crea automáticamente Port_list. En caso contrario, esta propiedad no estará disponible salvo que se declare explícitamente en el archivo RTR.

La configuración de esta propiedad para Apache se detalla en Sun Cluster 3.1 Data Service for Apache Guide.

Al crearse 

Condicional/ 

Necesaria 

R_description (cadena)

Una descripción breve del recurso. 

El valor predeterminado es la cadena vacía. 

En cualquier momento 

Opcional 

Resource_name (cadena)

El nombre de la instancia del recurso. Este nombre debe ser único en la configuración del clúster y no se puede cambiar después de su creación. 

Nunca 

Necesaria 

Resource_project_name (cadena)

El nombre de proyecto Solaris asociado al recurso. Esta propiedad permite que los servicios de datos del clúster accedan al uso de las características de gestión de recursos de Solaris, como la CPU y la agrupación de recursos. Cuando RGM pone en línea los recursos, inicia los procesos relacionados bajo este nombre de proyecto. Si la propiedad no está especificada, el nombre del proyecto se obtendrá de la propiedad RG_project_name del grupo de recursos que contiene el recurso (consulte rg_properties (5)). Si no se especifica ninguna propiedad, RGM utilizará el nombre de proyecto predefinido default. El nombre de proyecto especificado debe existir en la base de datos de proyectos y el usuario root se debe configurar como miembro del proyecto nombrado. Esta propiedad sólo se admite a partir de Solaris 9.


Nota –

Los cambios a esta propiedad surten efecto después de reiniciar el recurso.


La opción predeterminada es null. 

En cualquier momento 

Opcional 

Resource_state en cada nodo del clúster (enum.)

El estado determinado por RGM del recurso en cada nodo del clúster. Los estados posibles son Online, Offline, Stop_failed, Start_failed, Monitor_failed y Online_not_monitored.

El usuario no puede configurar esta propiedad.  

Nunca 

Sólo consulta 

Retry_count (entero)

Las veces que el monitor intenta reiniciar un recurso si éste falla. Esta propiedad sólo la crea RGM y sólo está disponible para el administrador si se declara en el archivo RTR. Esta propiedad es opcional si se especifica un valor predeterminado en el archivo RTR.  

Si el atributo Tunable no se especifica en el archivo de tipo de recurso, el valor Tunable de la propiedad será When_disabled.

Esta propiedad es necesaria si el atributo Default no se especifica en la declaración de propiedades del archivo RTR.

Cuando está inhabilitado  

Condicional  

Retry_interval (entero)

Los segundos que transcurren entre cada intento de reiniciar un recurso que ha fallado. El supervisor de recursos utiliza esta propiedad con Retry_count. Esta propiedad sólo la crea RGM y sólo está disponible para el administrador si se declara en el archivo RTR. Esta propiedad es opcional si se especifica un valor predeterminado en el archivo RTR.

Si el atributo Tunable no se especifica en el archivo de tipo de recurso, el valor Tunable de la propiedad será When_disabled.

Esta propiedad es necesaria si el atributo Default no se especifica en la declaración de propiedades del archivo RTR.

Cuando está inhabilitado  

Condicional 

Scalable (Booleano)

Indica si el recurso es escalable. Si esta propiedad se declara en el archivo RTR, RGM crea automáticamente las siguientes propiedades de servicio escalables para recursos de ese tipo: Network_resources_used, Port_list, Load_balancing_policy y Load_balancing_weights. Estas propiedades tienen valores predeterminados si no se declaran explícitamente en el archivo RTR. El valor predeterminado de Scalable (cuando se declara en el archivo RTR) es True.

Cuando esta propiedad se declara en el archivo RTR, el atributo Tunable se debe establecer en At_creation o la creación del recurso fallará.

Si esta propiedad no se declara en el archivo RTR, el recurso no será escalable, el administrador no podrá ajustarla y RGM no establecerá ninguna propiedad de servicio escalable. Sin embargo, se pueden declarar explícitamente las propiedades Network_resources_used y Port_list en el archivo RTR, si se desea, porque pueden ser útiles en servicios no escalables y escalables.

Al crearse 

Opcional 

Status en cada nodo de clúster (enum.)

Configurado por el monitor de recursos. Los valores posibles son: OK, degraded, faulted, unknown y offline. RGM establece el valor en unknown cuando el recurso se pone en línea y en Offline cuando se pone fuera de línea.

Nunca 

Sólo consulta 

Status_msg en cada nodo del clúster (cadena)

Establecido por el supervisor de recursos al mismo tiempo que la propiedad Status. Esta propiedad se puede establecer por recurso o por nodo. RGM la establece en la cadena vacía cuando el recurso se pone fuera de línea.

Nunca 

Sólo consulta 

Thorough_probe_interval (entero)

Los segundos que transcurren entre las invocaciones a una sonda de fallos de alta sobrecarga del recurso. Esta propiedad sólo la crea RGM y sólo está disponible para el administrador si se declara en el archivo RTR. Esta propiedad es opcional si se especifica un valor predeterminado en el archivo RTR.  

Si el atributo Tunable no se especifica en el archivo de tipo de recurso, el valor Tunable de la propiedad será When_disabled.

Esta propiedad es necesaria si el atributo Default no se especifica en la declaración de propiedades del archivo RTR.

Cuando está inhabilitado  

Condicional 

Type (cadena)

El tipo de recurso del cual este recurso es una instancia. 

Nunca 

Necesaria 

Type_version (cadena)

Indica la versión del tipo de recurso actualmente asociada al recurso. RGM crea automáticamente esta propiedad, que no se puede declarar en el archivo RTR. El valor de esta propiedad es el mismo que el de la propiedad RT_version del tipo de recurso. Cuando se crea un recurso, la propiedad Type_version no se especifica explícitamente, aunque pueda parecer como un sufijo del nombre del tipo de recurso. Cuando se edita un recurso, Type_version puede cambiar a un valor nuevo.

Las posibilidades de configuración se derivan de:

  • La versión actual del tipo de recurso

  • La directiva #$upgrade_from del archivo RTR

Consulte la descripción 

Consulte la descripción  

UDP_affinity (Booleano)

Si es verdadero, todo el tráfico de UDP de un cliente determinado se envía al mismo nodo de servidor que gestiona actualmente todo el tráfico de TCP del cliente. 

Esta propiedad sólo es importante cuando Load_balancing_policy es Lb_sticky o Lb_sticky_wild. Además, Weak_affinity se debe establecer en false (el valor predeterminado).

Esta propiedad se utiliza solamente en servicios escalables.  

Cuando está inhabilitado  

Opcional 

Weak_affinity (Booleano)

En caso de ser true, habilita la forma débil de afinidad del cliente. Esto permite las conexiones de un determinado cliente a un mismo nodo de servidor excepto: 

  • Si el oyente del servidor se inicia, por ejemplo, debido a arranques erróneos del monitor, una recuperación de fallos del recurso, una conmutación o un nodo que se vuelve a unir al clúster después de fallar.

  • Cuando Load_balancing_weights del recurso escalable cambia debido a una acción administrativa.

La afinidad débil proporciona una alternativa de baja sobrecarga a la forma predeterminada, tanto en consumo de memoria como en ciclos de procesador.  

Esta propiedad sólo es importante cuando Load_balancing_policy es Lb_sticky o Lb_sticky_wild.

Esta propiedad se utiliza solamente en servicios escalables.  

Cuando está inhabilitado  

Opcional