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

Métodos de acceso a RMAPI

La API proporciona funciones para acceder a las propiedades tanto de los recursos como del grupo y tipo de recursos, además de otra información del clúster. Estas funciones se suministran en forma de órdenes del shell y funciones de C, lo que permite que los suministradores de tipos de recursos implementen programas de control en forma de secuencias del shell o programas de C.

Órdenes del shell de RMAPI

Las órdenes del shell se usan en las implementaciones de las secuencias del shell de los métodos de rellamada para los tipos de recursos que representan los servicios controlados por RGM del clúster. Puede utilizar estas órdenes para:


Nota –

Esta sección proporciona descripciones breves de las órdenes del shell; las páginas de comando man individuales de la sección 1HA sirven de referencia definitiva para las órdenes del shell. Cada orden dispone de una página de comando man del mismo nombre salvo que se indique lo contrario.


Órdenes de los recursos de RMAPI

Estas órdenes permiten acceder a información sobre un recurso o establecer las propiedades Status y Status_msg de un recurso.

scha_resource_get

Accede a información sobre un recurso o tipo de recurso controlado por RGM. Proporciona la misma información que la función scha_resource_get().

scha_resource_setstatus

Establece las propiedades Status y Status_msg de un recurso controlado por RGM. El supervisor del recurso lo utiliza para indicar el estado del recurso, según lo percibe. Realiza la misma tarea que la función de C scha_resource_setstatus().


Nota –

scha_resource_setstatus() es especialmente útil para un supervisor de recursos, cualquier programa puede invocarlo.


Orden del tipo de recurso

Esta orden accede a información sobre un tipo de recurso registrado con RGM.

scha_resourcetype_get

Realiza la misma tarea que la función de C scha_resourcetype_get().

Órdenes del grupo de recursos

Estas órdenes permiten acceder a información acerca de un grupo de recursos o reiniciarlo.

scha_resourcegroup_get

Accede a información sobre un grupo de recursos controlado por RGM. Realiza la misma tarea que la función de C scha_resourcetype_get().

scha_control

Solicita el reinicio de un grupo de recursos controlado por RGM o su reubicación en un nodo diferente. Realiza la misma tarea que la función de C scha_control().

Orden del clúster

Esta orden permite acceder a información acerca de un clúster, como nombres de nodo, ID, estados, el nombre de clúster, grupos de recursos, etc.

scha_cluster_get

Esta orden proporciona la misma información que la función de C scha_cluster_get().

Funciones de C

Las funciones de C se deben usar en las implementaciones del programa de C de los métodos de rellamada para los tipos de recursos que representan servicios controlados por RGM del clúster. Puede utilizar estas funciones para:


Nota –

Esta sección proporciona descripciones breves de las funciones de C; las páginas de comando man individuales de (3HA) sirven de referencia definitiva para las funciones de C. Cada función tiene una página de comando man del mismo nombre, salvo que se indique lo contrario. Consulte la página de comando man de scha_calls(3HA) para obtener información sobre los argumentos de salida y códigos de retorno de las funciones de C.


Funciones de los recursos

Estas funciones permiten acceder a información sobre un recurso gestionado por RGM o indicar el estado del recurso, como lo percibe el supervisor.

scha_resource_open(), scha_resource_get () y scha_resource_close()

Estas funciones, juntas, permiten acceder a información sobre un recurso gestionado por RGM. La función scha_resource_open() inicializa el acceso a un recurso y devuelve un manejador para scha_resource_get(), que accede a la información del recurso. La función scha_resource_close() anula el manejador y libera la memoria asignada para los valores de retorno de scha_resource_get().

Un recurso puede cambiar, mediante una reconfiguración del clúster o una acción administrativa, después de que scha_resource_open() devuelva el manejador del recurso, en cuyo caso la información que obtiene scha_resource_get() a través del manejador puede no ser precisa. En el caso de una reconfiguración del clúster o una acción administrativa en un grupo de recursos, RGM devuelve el código de error scha_err_seqid a scha_resource_get() para indicar que la información acerca del recurso puede haber cambiado. Se trata de un mensaje de error de tipo no fatal; la función vuelve de forma satisfactoria. En consecuencia, puede ignorarlo y aceptar la información devuelta o cerrar el manejador actual y abrir uno nuevo para acceder a la información del recurso.

Una sola página de comando man describe estas tres funciones; es accesible a través de cualquiera de ellas, scha_resource_open(3HA), scha_resource_get(3HA) o scha_resource_close(3HA).

scha_resource_setstatus()

Establece las propiedades Status y Status_msg de un recurso controlado por RGM. El supervisor del recurso utiliza esta función para indicar el estado del recurso.


Nota –

scha_resource_setstatus() es especialmente útil para un supervisor de recursos, cualquier programa puede invocarlo.


Funciones del tipo de recurso

Estas funciones, juntas, permiten acceder a información sobre un tipo de recurso registrado con RGM.

scha_resourcetype_open(), scha_resourcetype_get(), scha_resourcetype_close()

La función scha_resourcetype_open() inicializa el acceso a un recurso y devuelve un manejador para scha_resourcetype_get() que accede a la información de tipo de recurso. La función scha_resourcetype_close() invalida el manejador y libera la memoria asignada para los valores de retorno de scha_resourcetype_get().

Un tipo de recurso puede cambiar, mediante una reconfiguración de clúster o un acción administrativa, después de que scha_resourcetype_open() devuelva el manejador del tipo de recurso, en cuyo caso la información que obtiene scha_resourcetype_get () a través del manejador puede no ser precisa. En el caso de una reconfiguración del clúster o una acción administrativa en un tipo de recurso, RGM devuelve el código de error scha_err_seqid a scha_resourcetype_get() para indicar que la información acerca del tipo de recurso puede haber cambiado. Se trata de un mensaje de error de tipo no fatal; la función vuelve de forma satisfactoria. En consecuencia, puede ignorar el mensaje y aceptar la información que ha devuelto o cerrar el manejador actual y abrir uno nuevo para acceder a la información del tipo de recurso.

Una sola página de comando man describe estas tres funciones; es accesible a través de cualquiera de ellas, scha_resourcetype_open(3HA), scha_resourcetype_get(3HA) o scha_resourcetype_close(3HA).

Funciones del grupo de recursos

Estas funciones permiten acceder a información acerca del grupo de recursos o reiniciarlo.

scha_resourcegroup_open(3HA), scha_resourcegroup_get(3HA) y scha_resourcegroup_close(3HA)

Estas funciones, juntas, permiten acceder a información sobre un grupo de recursos gestionado por RGM. La función scha_resourcegroup_open() inicializa el acceso a un grupo de recursos y devuelve un manejador para scha_resourcegroup_get(), que accede a la información del grupo de recursos. La función scha_resourcegroup_close() invalida el manejador y libera la memoria asignada para los valores de retorno de scha_resourcegroup_get().

Un grupo de recursos puede cambiar, mediante una reconfiguración del clúster o una acción administrativa, después de que scha_resourcegroup_open() devuelva el manejador del grupo de recursos, en cuyo caso la información que obtiene scha_resourcegroup_get() a través del manejador puede no ser precisa. En el caso de una reconfiguración del clúster o una acción administrativa en un grupo de recursos, RGM devuelve el código de error scha_err_seqid a scha_resourcegroup_get() para indicar que la información acerca del grupo de recursos puede haber cambiado. Se trata de un mensaje de error de tipo no fatal; la función vuelve de forma satisfactoria. En consecuencia, puede ignorar el mensaje y aceptar la información que ha devuelto o cerrar el manejador actual y abrir uno nuevo para acceder a la información del grupo de recursos.

scha_control( 3HA)

Solicita el reinicio de un grupo de recursos controlado por RGM o su reubicación en un nodo diferente.

Funciones del clúster

Estas funciones permiten acceder a información sobre un clúster o la devuelven.

scha_cluster_open(3HA), scha_cluster_get(3HA), scha_cluster_close(3HA)

Estas funciones, juntas, permiten acceder a información sobre un clúster, como los nombres de nodos, ID, estados, nombre del clúster, grupos de recursos, etc.

Un clúster puede cambiar, mediante una reconfiguración o una acción administrativa, después de que scha_cluster_open() devuelva el manejador del clúster, en cuyo caso la información que obtiene scha_cluster_get() a través del manejador puede no ser precisa. En el caso de una reconfiguración del clúster o una acción administrativa en un grupo de recursos, RGM devuelve el código de error scha_err_seqid a scha_cluster_get() para indicar que la información acerca del clúster puede haber cambiado. Se trata de un mensaje de error de tipo no fatal; la función vuelve de forma satisfactoria. En consecuencia, puede ignorar el mensaje y aceptar la información que ha devuelto o cerrar el manejador actual y abrir uno nuevo para acceder a la información del clúster.

scha_cluster_getlogfacility(3HA)

Devuelve el número del recurso de registro del sistema que se está usando como registro del clúster. Utiliza el valor devuelto con la función syslog() de Solaris para registrar mensajes de estado y eventos en el registro del clúster.

scha_cluster_getnodename(3HA)

Devuelve el nombre del nodo del clúster en el que se invoca la función.

Función de utilidad

Esta función convierte un código de error en un mensaje de error.

scha_strerror(3HA)

Traduce un código de error, devuelto por una de las funciones scha_, al mensaje de error adecuado. Utilice esta función con logger para introducir los mensajes en el registro del sistema (syslog).