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

Apéndice A Propiedades estándar

Este apéndice describe el tipo de recurso, grupo de recursos y propiedades de recurso estándar, así como los atributos de la propiedad de recurso disponibles para modificar las propiedades definidas por el sistema y crear las propiedades de extensión.

Este apéndice se divide en los siguientes apartados:

Propiedades del tipo de recurso

A continuación se describen las propiedades del tipo de recurso que define Sun Cluster. Los valores de propiedad están divididos en categorías como sigue (en Categoría):

Las propiedades de tipo de recursos no se pueden actualizar mediante utilidades administrativas, con excepción de Installed_nodes y RT_system , que no se pueden declarar en el archivo RTR y debe definirlas el administrador.

Los nombres de las propiedades aparecen primero, seguidos de la descripción correspondiente.

API_version (entero)

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

La siguiente información resume el valor máximo de API_version que admite cada versión de Sun Cluster.

Hasta 3.1

2

3.1 10/03

3

3.1 4/04

4

3.1 9/04

5

Si se establece un valor para API_version que sea superior a 2 en el archivo RTR, se impedirá que un tipo de recurso se instale en una versión de Sun Cluster que admita una versión máxima inferior. Por ejemplo, si establece API_version=5 para un tipo de recurso, dicho tipo de recurso no se podrá instalar en ninguna versión de Sun Cluster que saliera al mercado antes de la 3.1 9/04.

Categoría:

Opcional

Valor predeterminado:

2

Ajustable:

No

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 acciones para recursos de este tipo, similares a las del método Init.

Categoría:

Condicional/Explícito

Valor predeterminado:

Ninguno

Ajustable:

No

Failover (boolean)

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.

Categoría:

Opcional

Valor predeterminado:

FALSE

Ajustable:

No

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.

Categoría:

Condicional/Explícito

Valor predeterminado:

Ninguno

Ajustable:

No

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.

Categoría:

Condicional/Explícito

Valor predeterminado:

Ninguno

Ajustable:

No

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.

Categoría:

Opcional

Valor predeterminado:

RG_primaries

Ajustable:

No

Installed_nodes (string_array )

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 establecer el valor. No se puede declarar esta propiedad en el archivo RTR.

Categoría:

Puede configurarla el administrador del clúster

Valor predeterminado:

Todos los nodos del clúster

Ajustable:

Is_logical_hostname (boolean

TRUE indica que este tipo de recurso es alguna versión del tipo de recurso LogicalHostname que administra direcciones (IP) protocolo de Internet de recuperación de fallos.

Categoría:

Sólo consulta

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

Is_shared_address (boolean)

TRUE indica que este tipo de recurso es alguna versión del tipo de recurso SharedAddress que administra direcciones IP (protocolo de Internet) de recuperación de fallos.

Categoría:

Sólo consulta

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

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.

Categoría:

Condicional/Explícito

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

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.

Categoría:

Condicional/Explícito

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

Monitor_stop (cadena)

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

Categoría:

Condicional/Explícito

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

Pkglist (string_array)

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

Categoría:

Condicional/Explícito

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

Postnet_stop (cadena)

Un método de rellamada opcional: la ruta al programa que invoca RGM después de llamar al método Stop de cualquier recurso de dirección de red del que depende un recurso de este tipo. Después de configurar interfaces de red, este método debe realizar acciones Stop.

Categoría:

Condicional/Explícito

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

Prenet_start (cadena)

Un método de rellamada opcional: la ruta al programa que invoca RGM antes de llamar al método Stop de cualquier recurso de dirección de red del que depende un recurso de este tipo. Este método debe realizar acciones de Start que deben completarse antes de configurar las interfaces de red.

Categoría:

Condicional/Explícito

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

Resource_type (cadena)

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

scrgadm -p

En Sun Cluster 3.1 y posteriores, los nombres de los tipos de recursos incluyen la versión, que es obligatoria:

vendor_id.resource_type:version

Los tres componentes del nombre de un tipo de recurso son propieades especificadas en el archivo RTR como, por ejemplo, ID_proveedor, Tipo_recurso y Versión_RT. El comando scrgadm permite insertar delimitadores tales como el punto (.) y los dos puntos (:). El sufijo RT_version del nombre del tipo de recurso es el mismo valor que la propiedad RT_version. Para garantizar que el ID_fabricante sea único, se recomienda utilizar el símbolo bursátil de la empresa que crea el tipo de recurso. Los nombres del tipo de recursos creados antes de Sun Cluster 3.1 siguen usando el formato:

vendor_id.resource_type

Categoría:

Necesaria

Valor predeterminado:

Cadena vacía

Ajustable:

No

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 oblicua (/). Esta propiedad no es necesaria si todos los nombres de ruta de métodos son absolutos.

Categoría:

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

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

RT_description (cadena)

Una descripción breve del tipo de recurso.

Categoría:

Condicional

Valor predeterminado:

Cadena vacía

Ajustable:

No

RT_system (boolean)

Cuando se establece en TRUE en un tipo de recurso, indica que las operaciones permitidas scrgadm( 1M) en dicho tipo de recurso están restringidas. Un tipo de recurso cuyo valor RT_system está definido en TRUE se denomina tipo de recurso de sistema. La edición de la propiedad RT_system en sí misma no está nunca restringida, con independencia del valor actual de RT_system.

Categoría:

Opcional

Valor predeterminado:

FALSE

Ajustable:

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. La propiedad RT_version, que era opcional en Sun Cluster 3.0, es obligatoria en Sun Cluster 3.1 y en las versiones posteriores.

Categoría:

Opcional/Explícita o Requerida

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

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.

Categoría:

Opcional

Valor predeterminado:

FALSE

Ajustable:

No

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.

Categoría:

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

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

Stop (cadena)

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

Categoría:

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

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

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.

Categoría:

Condicional/Explícito

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

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.

Categoría:

Condicional/Explícito

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

Vendor_ID (cadena)

Consulte la propiedad Resource_type.

Categoría:

Condicional

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

Propiedades de recurso

Esta sección describe las propiedades de recurso que define Sun Cluster. Los valores de propiedad están divididos en categorías como sigue (en Categoría):

Ajustable especifica si las propiedades de los recursos se pueden actualizar, de la siguiente forma:

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 

Los nombres de las propiedades aparecen primero, seguidos de la descripción correspondiente.

Affinity_timeout (entero )

Tiempo, en segundos, durante el cual las conexiones de una dirección IP de un cliente 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.

Categoría:

Opcional

Valor predeterminado:

Valor no predeterminado

Ajustable:

ANYTIME

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.

Categoría:

Condicional

Valor predeterminado:

Valor no predeterminado

Ajustable:

WHEN_DISABLED

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. Atributos de las propiedades de recursos contiene información acerca de los atributos individuales que se pueden definir para las propiedades de extensión.

Categoría:

Condicional

Valor predeterminado:

Valor no predeterminado

Ajustable:

Depende de la propiedad en cuestión

Failover_mode (enum.)

NONE, SOFT y HARD afectan sólo al comportamiento a prueba de fallos cuando falla el método Start ( Prenet_start o Start). Sin embargo, una vez que los recursos se han iniciado correctamente, NONE, SOFT y HARD no tienen efecto en los siguientes reinicios de los recursos ni en la conducta de conmutación que el supervisor de recursos inicia con scha_control(1HA) o scha_control(3HA). NONE (valor predeterminado) indica que RGM se utiliza para definir el estado del recurso en el fallo del método y espera a que intervenga el usuario. SOFT indica que, si falla el método Start, RGM debe reubicar el grupo de recursos en un nodo diferente. Si falla el método Stop o Monitor_stop, RGM establece el recurso en el estado Stop_failed y el grupo de recursos en el estado Error_stop_failed. RGM espera entonces la intervención del usuario. En el caso de que se produzcan fallos en Stop o Monitor_stop, NONE y SOFT son iguales. HARD indica que, si falla el método Start, RGM debe reubicar el grupo. Si falla el método Stop o el método Monitor_stop, RGM debe detener el recurso anulando el nodo del clúster. HARD, NONE y SOFT afectan a la conducta de recuperación ante fallos en caso de que los métodos Start o Prenet_start fallen.

A diferencia de NONE, SOFT y HARD, RESTART_ONLY y LOG_ONLY afectan a toda la conducta de recuperación ante fallos, incluidos aspectos como los reinicios de recursos y de grupos de recursos (scha_control ) iniciados mediante el supervisor y las conmutaciones iniciadas por el supervisor de recursos (scha_control). RESTART_ONLY indica que el supervisor puede ejecutar scha_control para reiniciar un recurso, pero los intentos por llevar a cabo un reinicio del grupo de recursos o una conmutación con scha_control fallan uno tras otro. RGM permite realizar reinicios Retry_count en Retry_interval . Si se supera Retry_count, no se permitirá ningún reinicio de recursos. Si Failover_mode se establece en LOG_ONLY , no se permitirá ningún reinicio ni ninguna conmutación de recursos. Establecer Failover_mode en LOG_ONLY tiene el mismo efecto que definir Failover_mode en RESTART_ONLY con Retry_count establecido en cero. Si el método Start falla, RESTART_ONLY y LOG_ONLY son iguales que NONE: no se produce ninguna recuperación ante fallos y el recurso pasa al estado Start_failed.

Categoría:

Opcional

Valor predeterminado:

Valor no predeterminado

Ajustable:

ANYTIME

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 adoptar los siguientes valores:

Lb_weighted (el predeterminado). La carga se distribuye entre varios nodos, de acuerdo con los pesos establecidos 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. Una dirección IP concreta de un cliente que conecta con 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 de la dirección IP a la que llegue.

Categoría:

Condicional/Opcional

Valor predeterminado:

Lb_weighted

Ajustable:

AT_CREATION

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

Categoría:

Condicional/Opcional

Valor predeterminado:

La cadena vacía (“”)

Ajustable:

ANYTIME

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.

Categoría:

Condicional/Opcional

Valor predeterminado:

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

Ajustable:

ANYTIME

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á.

Categoría:

Sólo consulta

Valor predeterminado:

Valor no predeterminado

Ajustable:

Nunca

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 la propiedad 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.


Nota –

En la página del comando man de SUNW.Event(5) se describe cómo se configura esta propiedad para CRNP.


Categoría:

Condicional/Necesario

Valor predeterminado:

Valor no predeterminado

Ajustable:

AT_CREATION

Num_resource_restarts en cada nodo de clúster (entero)

Esta propiedad no se puede definir directamente, ya que la establece RGM según el número de llamadas scha_control , Resource_restart o Resource_is_restarted que se hayan efectuado para este recurso en este nodo en los últimos n segundos. n es el valor de la propiedad Retry_interval del recurso. El contador de reinicios del recurso lo restablece RGM en cero RGM cada vez que este recurso realiza una conmutación scha_control, independientemente de si la conmutación tiene éxito o falla.

Si un tipo de recurso no declara la propiedad Retry_interval, entonces la propiedad Num_resource_restarts no está disponible para recursos de ese tipo.

Categoría:

Sólo consulta

Valor predeterminado:

Valor no predeterminado

Ajustable:

No

Num_rg_restarts en cada nodo del clúster (entero)

No se puede establecer directamente esta propiedad, ya que la ajusta RGM según el número de llamadas de scha_control Restart que haya efectuado este recurso para el grupo de recursos que contiene este nodo en los últimos n segundos. n hace referencia al valor de la propiedad Retry_interval del recurso. Si un tipo de recurso no declara la propiedad Retry_interval, entonces, la propiedad Num_rg_restarts no estará disponible para los recursos de este tipo.

Categoría:

Consulte la descripción

Valor predeterminado:

Valor no predeterminado

Ajustable:

No

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 se inhabilita, el recurso pasa a estar fuera de línea y no se producirán rellamadas hasta que se habilite de nuevo.

Categoría:

Sólo consulta

Valor predeterminado:

Valor no predeterminado

Ajustable:

Nunca

Port_list (matriz de cadenas)

Una lista de números de puerto en los que recibe el servidor. Cada número de puerto cuenta con una barra oblicua (/) seguida del protocolo que se usa para dicho puerto, por ejemplo, Port_list=80/tcp o Port_list=80/tcp6,40/udp6. Se pueden especificar los siguientes valores de protocolo:

  • tcp, para TCP IPv4

  • tcp6, para TCP IPv6

  • udp, para UDP IPv4

  • udp6, para UDP IPv6

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 Data Service for Apache Guide for Solaris OS.

Categoría:

Condicional/Necesario

Valor predeterminado:

Valor no predeterminado

Ajustable:

AT_CREATION

R_description (cadena)

Una descripción breve del recurso.

Categoría:

Opcional

Valor predeterminado:

La cadena vacía

Ajustable:

ANYTIME

Resource_dependencies (matriz de cadenas)

Una lista de los recursos en el mismo grupo o en uno diferente con respecto al cual el recurso tiene una dependencia fuerte. Este recurso no se puede iniciar si alguno de los recursos de la lista no está en línea. Si este recurso y alguno de los recursos de la lista se inician al mismo tiempo, RGM espera hasta que el recurso de la lista se inicie, antes de que RGM inicie este recurso. Si el recurso de esta lista Resource_dependencies del recurso no se inicia, este recurso permanecerá también fuera de línea. El recurso de esta lista de recursos puede que no se inicie porque el grupo de recursos del recurso de la lista permanezca fuera de línea o porque el recurso de la lista esté en estado Start_failed . Si este recurso permanece fuera de línea debido a que existe una dependencia de otro recurso de un grupo de recursos diferente que falla al iniciarse, este grupo de recursos pasará al estado Pending_online_blocked.

Si este recurso pasa a estar fuera de línea al mismo tiempo que los recursos de la lista, dicho recurso se detiene antes que los de la lista. Sin embargo, si este recurso permanece en línea o falla al detenerse, un recurso de la lista que esté en un grupo de recursos diferente se detendrá de todos modos. Los recursos de la lista no se pueden inhabilitar a menos que este recurso se inhabilite en primer lugar.

Por defecto, en un grupo de recursos, los recursos de aplicaciones tienen una dependencia fuerte implícita con respecto a los recursos de las direcciones de red. Implicit_network_dependencies en Propiedades del grupo de recursos contiene más información.

En un grupo de recursos, los métodos Prenet_start se ejecutan en orden de dependencia antes que los métodos Start. Los métodos Postnet_stop se ejecutan en orden de dependencia después de los métodos Stop. En diferentes grupos de recursos, el elemento dependiente espera a que el recurso del que depende finalice Prenet_start y Start antes de ejecutar Prenet_start. El recurso del que depende el otro elemento espera a que el recurso dependiente finalice Stop y Postnet_stop antes de ejecutar Stop.

Categoría:

Opcional

Valor predeterminado:

La lista vacía

Ajustable:

ANYTIME

Resource_dependencies_restart ( matriz de cadenas)

Una lista de los recursos en el mismo grupo o en uno diferente con respecto al cual el recurso tiene una dependencia de inicio.

Esta propiedad actúa al igual que Resource_dependencies, exceptuando que, si se reinicia algún recurso de la lista de dependencias de reinicio, el recurso en cuestión se reiniciará también. El reinicio de este recurso se produce después de que el recurso de la lista vuelva a estar en línea.

Categoría:

Opcional

Valor predeterminado:

La lista vacía

Ajustable:

ANYTIME

Resource_dependencies_weak (matriz de cadenas)

Una lista de los recursos en el mismo grupo o en uno diferente con respecto al cual el recurso tiene una dependencia débil. Una dependencia débil determina el orden de las llamadas de los métodos. RGM ejecuta los métodos Start de los recursos de esta lista antes que el método Start de este recurso. RGM ejecuta los métodos Stop de este recurso antes que los métodos Stop de los recursos de la lista. El recurso tiene opciones de iniciarse si los de la lista fallan al iniciarse o permanecen fuera de línea.

Si este recurso y otro de la lista Resource_dependencies_weak se inician simultáneamente, RGM espera a que el recurso de la lista se inicie antes de que RGM inicie este recurso. Si el recurso de la lista no se inicia —por ejemplo, si el grupo de recursos del recurso de la lista permanece fuera de línea o si el recurso de la lista está en estado Start_failed — se iniciará este recurso. El grupo de recursos de este recurso puede pasar al estado Pending_online_blocked temporalmente a medida que se inician los recursos de esta lista Resource_dependencies_weak del recurso. Cuando todos los recursos de la lista se hayan iniciado (o no se hayan iniciado correctamente), este recurso se iniciará y su grupo entrará en el estado Pending_online.

Si este recurso pasa a estar fuera de línea al mismo tiempo que los recursos de la lista, dicho recurso se detiene antes que los de la lista. Si este recurso permanece en línea o no se detiene correctamente, un recurso de la lista se detendrá de todos modos. No es posible inhabilitar los recursos de la lista a menos que este recurso se inhabilite primero.

En un grupo de recursos, los métodos Prenet_start se ejecutan en orden de dependencia antes que los métodos Start. Los métodos Postnet_stop se ejecutan en orden de dependencia después de los métodos Stop. En diferentes grupos de recursos, el elemento dependiente espera a que el recurso del que depende finalice Prenet_start y Start antes de ejecutar Prenet_start. El recurso del que depende el otro elemento espera a que el recurso dependiente finalice Stop y Postnet_stop antes de ejecutar Stop.

Categoría:

Opcional

Valor predeterminado:

La lista vacía

Ajustable:

ANYTIME

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.

Categoría:

Necesaria

Valor predeterminado:

Valor no predeterminado

Ajustable:

Nunca

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 se admite sólo en Solaris 9 y en versiones posteriores de Solaris.


Nota –

Los cambios que se efectúen en esta propiedad surten efecto la próxima vez que se inicie el recurso.


Categoría:

Opcional

Valor predeterminado:

Nulo

Ajustable:

ANYTIME

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, Start_failed, Stop_failed, Monitor_failed, Online_not_monitored, Starting y Stopping.

Esta propiedad no se puede configurar.

Categoría:

Sólo consulta

Valor predeterminado:

Valor no predeterminado

Ajustable:

Nunca

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. Retry_count es optativo 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 es WHEN_DISABLED.

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

Categoría:

Condicional

Valor predeterminado:

Valor no predeterminado

Ajustable:

WHEN_DISABLED

Retry_interval (entero)

Los segundos que transcurren entre cada intento de reiniciar un recurso que ha fallado. El supervisor de recursos utiliza esta propiedad junto 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. Retry_interval es optativo 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 es WHEN_DISABLED.

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

Categoría:

Condicional

Valor predeterminado:

Valor no predeterminado

Ajustable:

WHEN_DISABLED

Scalable (booleano)

Indica si el recurso es escalable, es decir, si el recurso utiliza funciones de equilibrado de carga de Sun Cluster.

Si esta propiedad se declara en el archivo RTR, RGM crea automáticamente las siguientes propiedades de servicio escalables para recursos de ese tipo: Affinity_timeout, Load_balancing_policy, Load_balancing_weights, Network_resources_used, Port_list, UDP_affinity y Weak_affinity . 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.

Si esta propiedad se declara en el archivo RTR, no se permite que se le asigne un valor Tunable distinto de AT_CREATION.

Si esta propiedad no se declara en el archivo RTR, el recurso no será escalable, no será posible ajustar esta propiedad 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.

Esta propiedad se utiliza junto con la propiedad de tipo de recurso Failover , de la siguiente manera:

El uso de esta propiedad de recurso junto con la propiedad de tipo de recurso Failover se describe detalladamente en r_properties (5).

Categoría:

Opcional

Valor predeterminado:

Valor no predeterminado

Ajustable:

AT_CREATION

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

La define el supervisor de recursos con scha_resource_setstatus(1HA) o scha_resource_setstatus(3HA). Los valores posibles son OK, degraded, faulted, unknown y offline. Cuando un recurso se pone en línea o fuera de línea, RGM define automáticamente el valor Status en caso de que el valor Status no haya sido definido por el supervisor del recurso o los métodos.

Categoría:

Sólo consulta

Valor predeterminado:

Valor no predeterminado

Ajustable:

Nunca

Status_msg en cada nodo del clúster ( string)

Establecido por el supervisor de recursos al mismo tiempo que la propiedad Status. Cuando un recurso se pone en línea o fuera de línea, RGM restablece automáticamente esta propiedad a una cadena vacía, en caso de que esta propiedad no haya sido definida por los métodos del recurso.

Categoría:

Sólo consulta

Valor predeterminado:

Valor no predeterminado

Ajustable:

Nunca

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. Thorough_probe_interval es optativo 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 es WHEN_DISABLED.

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

Categoría:

Condicional

Valor predeterminado:

Valor no predeterminado

Ajustable:

WHEN_DISABLED

Type (cadena)

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

Categoría:

Necesaria

Valor predeterminado:

Valor no predeterminado

Ajustable:

Nunca

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 puede parecer como un sufijo del nombre del tipo de recurso. Cuando se edita un recurso, Type_version puede cambiar a un valor nuevo.

La posibilidad de ajustar esta propiedad se deriva de las siguientes fuentes:

  • La versión actual del tipo de recurso

  • La directiva #$upgrade_from del archivo RTR

Categoría:

Consulte la descripción

Valor predeterminado:

Valor no predeterminado

Ajustable:

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.

Categoría:

Opcional

Valor predeterminado:

Valor no predeterminado

Ajustable:

WHEN_DISABLED

Weak_affinity (booleano)

En caso de ser true, habilita la forma débil de afinidad del cliente. La forma débil de la afinidad del cliente permite que las conexiones procedentes de un cliente determinado se envíen al mismo nodo del servidor, excepto cuando se producen las siguientes condiciones:

  • Se inicia una escucha del servidor como respuesta, por ejemplo, a un reinicio no satisfactorio del supervisor, a un fallo de conmutación de un recurso o a la unión de un nodo con un clúster después de que se haya producido un fallo.

  • 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.

Categoría:

Opcional

Valor predeterminado:

Valor no predeterminado

Ajustable:

WHEN_DISABLED

Propiedades del grupo de recursos

A continuación se describen las propiedades del grupo de recursos que define Sun Cluster. Los valores de propiedad están divididos en categorías como sigue (en Categoría):

Cada descripción muestra si la propiedad se puede actualizar (Sí) o no (No) después de configurarla inicialmente.

Los nombres de las propiedades aparecen primero, seguidos de la descripción correspondiente.

Auto_start_on_new_cluster ( booleano)

Esta propiedad impide el inicio automático del grupo de recursos cuando se está formando un clúster nuevo.

Si se establece en TRUE, el Gestor de grupos de recursos intentará iniciar automáticamente el grupo de recursos para lograr Desired_primaries cuando se rearranque el clúster. Si se establece en FALSE, el grupo de recursos no se iniciará automáticamente al rearrancar el clúster.

Categoría:

Opcional

Valor predeterminado:

TRUE

Ajustable:

Desired_primaries (entero)

El número de nodos en los que se desea que el grupo esté en línea simultáneamente.

Si la propiedad RG_mode es Failover, el valor de esta propiedad no debe ser mayor que 1. Si la propiedad RG_mode es Scalable, se permite un valor mayor que 1.

Categoría:

Opcional

Valor predeterminado:

1

Ajustable:

Failback (booleano)

Un valor booleano que indica si se debe recalcular el conjunto de nodos en los que el grupo está en línea cuando cambian los miembros del clúster. Un cálculo nuevo puede hacer que RGM ponga el grupo fuera de línea en nodos no prioritarios y en línea en los más prioritarios.

Categoría:

Opcional

Valor predeterminado:

FALSE

Ajustable:

Global_resources_used (matriz de cadenas)

Indica si algún recurso del grupo utiliza o no los sistemas de archivos del clúster. Los valores legítimos que puede especificar el administrador son un asterisco (*) para indicar todos los recursos globales o una cadena vacía (“”) que indica que no hay ningún recurso global.

Categoría:

Opcional

Valor predeterminado:

Todos los recursos globales

Ajustable:

Implicit_network_dependencies ( booleano)

Un valor booleano que indica, cuando es TRUE, que RGM debería imponer dependencias fuertes implícitas de recursos de dirección no de red a los recursos de dirección de red del grupo. Ejemplos de servicios de red-dirección incluyen el nombre lógico de sistema y los tipos de recursos de dirección compartida.

En un grupo de recursos escalable, esta propiedad no tiene ningún efecto, porque un grupo escalable no tiene recursos de red-dirección.

Categoría:

Opcional

Valor predeterminado:

TRUE

Ajustable:

Maximum_primaries (entero)

El número máximo de nodos en los que el grupo puede estar en línea simultáneamente.

Si la propiedad RG_mode es Failover, el valor de esta propiedad no debe ser mayor que 1. Si la propiedad RG_mode es Scalable, se permite un valor mayor que 1.

Categoría:

Opcional

Valor predeterminado:

1

Ajustable:

Nodelist (matriz de cadenas)

Una lista de nodos de clúster en los que el grupo se puede poner en línea en orden de preferencia. Estos nodos se denominan los primarios potenciales o los maestros del grupo de recursos.

Categoría:

Opcional

Valor predeterminado:

La lista de todos los nodos del clúster

Ajustable:

Pathprefix (cadena)

Un directorio del sistema de archivos del clúster en el que los recursos del grupo pueden escribir los archivos administrativos esenciales. Esta propiedad puede ser imprescindible para algunos recursos. Pathprefix debe ser único para cada grupo de recursos.

Categoría:

Opcional

Valor predeterminado:

La cadena vacía

Ajustable:

Pingpong_interval (entero)

Un valor entero que no sea negativo (en segundos) que usa RGM para determinar dónde se debe poner en línea el grupo de recursos. Las circunstancias en las que esta propiedad puede ser necesaria son las siguientes:

  • Si se produce una reconfiguración

  • Se ejecuta un comando scha_control -O GIVEOVER o una función scha_control() con el argumento SCHA_GIVEOVER

Si se produce una reconfiguración, si el grupo de recursos falla para ponerse en línea más de una vez en los últimos segundos especificados por el valor de Pingpong_interval en un nodo concreto, dicho nodo se considera no apto para elegirlo como sistema que aloje al grupo de recursos y RGM busca otro sistema maestro. El recurso falla a la hora de ponerse en línea porque el método Start o Prenet_start del recurso salió con un valor que no era cero o porque el tiempo de espera se agotó.

Si una llamada a un comando o a una función scha_control de un recurso provoca que el grupo de recursos se ponga fuera de línea en un nodo concreto en los últimos Pingpong_interval segundos, ese nodo no podrá alojar el grupo de recursos, como resultado de una llamada posterior a scha_control() procedente de otro nodo.

Categoría:

Opcional

Valor predeterminado:

3600 (una hora)

Ajustable:

Resource_list (matriz de cadenas)

La lista de recursos que un grupo contiene. El administrador no puede configurar esta propiedad directamente. En su lugar, RGM la actualiza cuando el administrador agregue o elimine recursos del grupo de recursos.

Categoría:

Sólo consulta

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

RG_affinities (cadena)

RGM intenta localizar un grupo de recursos en un nodo que sea el maestro actual de otro grupo de recursos determinado (afinidad positiva) o intenta localizar un grupo de recursos en un nodo que no sea actualmente el maestro de un grupo de recursos concreto (afinidad negativa).

Puede definir RG_affinities para las siguientes cadenas:

  • ++, o afinidad positiva fuerte

  • +, o afinidad positiva débil

  • -, o afinidad negativa débil

  • --, o afinidad negativa fuerte

  • +++, o afinidad positiva fuerte con delegación de recuperación de fallos

Por ejemplo, RG_affinities=+RG2,--RG3 indica que este grupo de recursos tiene una afinidad positiva débil para RG2 y una afinidad negativa fuerte para RG3.

El uso de RG_affinities se describe en “Administering Data Service Resources ” en Sun Cluster Data Services Planning and Administration Guide for Solaris OS.

Categoría:

Opcional

Valor predeterminado:

La cadena vacía

Ajustable:

RG_dependencies (matriz de cadenas )

Lista opcional de recursos que indica un orden de preferencia para poner en línea o fuera de línea a otros grupos del mismo nodo. El gráfico de todas las afinidades fuertes RG_affinities (positivas y negativas) junto con RG_dependencies no puede contener ciclos.

Por ejemplo, suponga que el grupo de recursos RG2 aparece en la lista RG_dependencies del grupo de recursos RG1. Es decir, suponga que RG1 tiene una dependencia de grupo de recursos con respecto a RG2. La siguiente lista resume los efectos de esta dependencia del grupo de recursos:

  • Cuando un nodo se una al clúster, los métodos Boot de dicho nodo no se ejecutan en los recursos de RG1 hasta que todos los métodos Boot de este nodo se hayan completado en los recursos de RG2.

  • Si RG1 y RG2 están ambos en el estado Pending_online en el mismo nodo y al mismo tiempo, los métodos de inicio (Prenet_start o Start) no se ejecutan en ningún recurso en RG1 hasta que todos los recursos de RG2 hayan completado sus métodos de inicio.

  • Si RG1 y RG2 están ambos en el estado Pending_offline en el mismo nodo y al mismo tiempo, los métodos de parada (Stop o Postnet_stop) no se ejecutan en ningún recurso en RG2 hasta que todos los recursos de RG1 hayan completado sus métodos de parada.

  • El intento por cambiar los primarios de RG1 o RG2 no surte ningún efecto si dicho cambio supone que RG1 se queda en línea en algún nodo y que RG2 se queda fuera de línea en todos los nodos. scswitch(1M) y scsetup(1M) contienen más información.

  • La configuración de la propiedad Desired_primaries en un valor que sea superior a cero en RG1 no está permitido si Desired_primaries está establecido en cero en RG2.

  • La definición de la propiedad Auto_start_on_new_cluster en TRUE en RG1 no está permitida si Auto_start_on_new_cluster está definido en FALSE en RG2.

Categoría:

Opcional

Valor predeterminado:

La lista vacía

Ajustable:

RG_description (cadena)

Descripción breve del grupo de recursos.

Categoría:

Opcional

Valor predeterminado:

La cadena vacía

Ajustable:

RG_is_frozen (booleano)

Un valor booleano que indica si un dispositivo global del que depende un grupo de recursos se está cambiando. Si esta propiedad está establecida en TRUE, significa que el dispositivo global se está cambiando. Si esta propiedad está establecida en FALSE, significa que no se está cambiando ningún dispositivo global. Un grupo de recursos depende o no de dispositivos globales según lo especifique su propiedad Global_resources_used correspondiente.

La propiedad RG_is_frozen no se define directamente. RGM actualiza la propiedad RG_is_frozen cuando cambia el estado de los dispositivos globales.

Categoría:

Opcional

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

RG_mode (enum.)

Indica si el grupo de recursos es a prueba de fallos o escalable. Si el valor es Failover, RGM establece la propiedad Maximum_primaries del grupo en 1 y limita el grupo de recursos para que lo controle un solo nodo.

Si el valor de esta propiedad es Scalable, RGM permite que la propiedad Maximum_primaries tenga un valor superior a 1, lo que quiere decir que el grupo puede tener varios nodos maestros simultáneamente. RGM no permite que un recurso con una propiedad Failover establecida en TRUE se agregue a un grupo de recursos cuyo RG_mode sea Scalable.

Si Maximum_primaries es 1, el valor predeterminado es Failover. Si Maximum_primaries es mayor que 1, el valor predeterminado será Scalable.

Categoría:

Opcional

Valor predeterminado:

Depende del valor de Maximum_primaries

Ajustable:

No

RG_name (cadena)

El nombre del grupo de recursos. Debe ser un nombre exclusivo en el clúster.

Categoría:

Necesaria

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

RG_project_name (cadena)

El nombre de proyecto Solaris asociado al grupo de recursos. 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 los grupos de recursos en línea, inicia los procesos relacionados bajo este nombre de proyecto para los recursos que no tienen establecida la propiedad Resource_project_name. 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 se admite sólo en Solaris 9 y en las versiones posteriores.


Nota –

Los cambios que se efectúan en esta propiedad surten efecto la próxima vez que se inicie el recurso.


Categoría:

Opcional

Valor predeterminado:

La cadena de texto “default

Ajustable:

ANYTIME

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

Definido por RGM en Unmanaged , Online, Offline, Pending_online, Pending_offline, Pending_online_blocked , Error_stop_failed, Online_faulted o Pending_online_blocked para describir el estado del grupo en cada nodo del clúster.

Esta propiedad no se puede configurar. Sin embargo, es posible establecerla indirectamente, invocando scswitch( 1M) (o utilizando el equivalente scsetup (1M) o bien comandos de SunPlex Manager).

Categoría:

Sólo consulta

Valor predeterminado:

Sin valor predeterminado

Ajustable:

No

RG_system (booleano)

Si la propiedad RG_system es TRUE para un grupo de recursos, entonces las operaciones concretas están restringidas para el grupo de recursos y para los recursos que contiene el grupo de recursos en sí. El cometido de esta restricción es evitar la modificación o eliminación accidental de grupos de recursos o de recursos fundamentales. Sólo los comandos scrgadm (1M) y scswitch(1M) se ven afectados por esta propiedad. A las operaciones para scha_control (1HA) y scha_control(3HA) no les afecta.

Antes de realizar una operación restringida en un grupo de recursos (o en los recursos de un grupo), debe, en primer lugar, definir la propiedad RG_system del grupo de recursos en FALSE. Tenga precaución al modificar o eliminar un grupo de recursos que proporcione soporte a servicios del clúster o cuando modifique o elimine los recursos que pueda contener un grupo de recursos.

Un grupo de recursos cuyo valor RG_system esté definido en TRUE se denomina grupo de recursos de sistema. La edición de la propiedad RG_system en sí misma no está nunca restringida, con independencia del valor actual de RG_system. La página de comando man de rg_properties (5) describe detalladamente estas restricciones.

Categoría:

Opcional

Valor predeterminado:

FALSE

Ajustable:

Atributos de las propiedades de recursos

La siguiente información describe los atributos de las propiedades de recursos que se pueden usar para cambiar las propiedades definidas por el sistema o crear propiedades de extensión.


Precaución – Precaución –

No puede especificar NULL o la cadena vacía (“”) como valor predeterminado para los tipos boolean, enum o int.


Los nombres de las propiedades aparecen primero, seguidos de la descripción correspondiente.

Array_maxsize

Para el tipo stringarray, el número máximo de elementos de matriz permitido.

Array_minsize

Para el tipo stringarray, el número mínimo de elementos de matriz permitido.

Default

Indica un valor de propiedad predeterminado.

Description

Una anotación de cadena que constituye una descripción breve de la propiedad. El atributo Description no se puede configurar en el archivo RTR para las propiedades definidas por el sistema defina.

Enumlist

Para un tipo enum, conjunto de valores de cadena permitido para la propiedad.

Extension

Si se utiliza, indica que la entrada del archivo RTR declara una propiedad de extensión definida por la implementación del tipo de recurso. En caso contrario, la entrada será una propiedad definida por el sistema.

Max

Para un tipo int, el valor máximo permitido para la propiedad.

Maxlength

Para los tipos string y stringarray, la longitud de cadena máxima permitida.

Min

Para un tipo int, el valor mínimo permitido para la propiedad.

Minlength

Para los tipos string y stringarray, la longitud de cadena mínima permitida.

Property

El nombre de la propiedad de recurso.

Tunable

Indica si el administrador del clúster puede configurar el valor de esta propiedad en un recurso. Se puede establecer en NONE o FALSE para evitar que el administrador establezca la propiedad. Los valores que puede usar el administrador para esta propiedad son TRUE o ANYTIME (en cualquier momento), AT_CREATION (sólo al crear el recurso) o WHEN_DISABLED (cuando el recurso esté fuera de línea). Para establecer otros ajustes, como, por ejemplo, “cuando la supervisión esté deshabilitada” o “cuando esté fuera de línea”, establezca este atributo en ANYTIME y valide el estado del recurso con el método Validate.

El valor predeterminado es distinto para cada propiedad de recurso estándar, tal y como se muestra en la siguiente sección. El valor predeterminado para ajustar una propiedad de extensión, si no se especifica otra cosa en el archivo RTR, es TRUE ( ANYTIME).

Tipo de la propiedad

Los tipos permitidos son: string, boolean, int, enum y stringarray. El atributo de tipo no se puede configurar en el archivo RTR para las propiedades que el sistema defina. El tipo determina los valores aceptables de la propiedad y los atributos específicos del tipo permitidos en la entrada del archivo RTR. Un tipo enum es un conjunto de valores de cadena.