test

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 de acceso a las propiedades de tipo de recurso, recurso y grupo de recurso, y a otra información del clúster. Estas funciones se proporcionan en forma de comandos de shell y funciones de C, que permiten implementar programas de control como secuencias de shell o programas de C.

Comandos del shell de RMAPI

Los comandos de shell se utilizan en implementaciones de secuencias de shell de los métodos de rellamada para los tipos de recursos que representan los servicios controlados por el Gestor de grupos de recursos del clúster. Puede utilizar estos comandos para completar las siguientes tareas:

Nota –

Aunque esta sección proporciona breves descripciones de los comandos de shell, las páginas de comando man 1HA ofrecen una referencia completa de estos comandos. Se asocia una página de comando man con el mismo nombre a cada comando, a menos que se indique lo contrario.

Comandos de los recursos de RMAPI

Puede acceder a la información de un recurso o establecer las propiedad Status o Status_msg con estos comandos.

scha_resource_get

Accede a la información sobre un recurso o tipo de recurso que se encuentra bajo el control de RGM. Este comando proporciona la misma información que la función de C scha_resource_get(). Para obtener información, consulte la página de comando man scha_resource_get(1HA).

scha_resource_setstatus

Establece las propiedades Status y Status_msg de un recurso bajo el control de RGM. El supervisor del recurso utiliza este comando para indicar el estado del mismo, según su criterio. Este comando proporciona las mismas capacidades que la función de C scha_resource_setstatus(). Para obtener una descripción más detallada de este comando, consulte la página de comando man scha_resource_setstatus(1HA).

Nota –

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

Comando del tipo de recurso

scha_resourcetype_get

Accede a la información sobre el tipo de recurso registrada con RGM. Realiza la misma tarea que la función de C scha_resourcetype_get(). Para obtener una descripción más detallada de este comando, consulte la página de comando man scha_resourcetype_get(1HA).

Comandos del grupo de recursos

Puede acceder a la información sobre el grupo de recursos o reiniciar un grupo con estos comandos.

scha_resourcegroup_get

Accede a la información sobre un grupo de recursos que se encuentra bajo el control de RGM. Realiza la misma tarea que la función de C scha_resourcetype_get(). Para obtener una descripción más detallada de este comando, consulte la página de comando man scha_resourcegroup_get(1HA).

scha_control

Solicita el reinicio de un grupo de recursos bajo el control de RGM o su reubicación en un nodo diferente. Realiza la misma tarea que la función de C scha_control(). Este comando se describe de forma más detallada en la página de comando man scha_control(1HA).

Comando del clúster

scha_cluster_get

Accede a la información sobre el clúster como, por ejemplo, el nombre del clúster, los nombres de los nodos, los Id., los estados y los grupos de recursos. Este comando proporciona la misma información que la función de C scha_cluster_get(). Este comando se describe de forma más detallada en la página de comando man scha_cluster_get(1HA).

Funciones de C

Las funciones de C se utilizan en implementaciones de programas C de los métodos de rellamada para los tipos de recursos que resepresentan los servicios controlados por el Gestor de grupos de recursos del clúster. Puede utilizar estas funciones para completar las siguientes tareas:

Nota –

Aunque esta sección proporciona breves descripciones de las funciones de C, las páginas de comando man 3HA ofrecen una referencia completa de estas funciones. Se asocia una página de comando man con el mismo nombre a cada función, a menos que se indique lo contrario. Consulte la página de comando man scha_calls(3HA) para obtener información sobre los argumentos de salida y los códigos de devolución de las funciones de C.

Funciones de los recursos

Estas funciones acceden a la información sobre un recurso administrado por RGM o indican el estado del recurso proporcionado por el supervisor.

scha_resource_open(), scha_resource_get () y scha_resource_close()

Estas funciones acceden a la información de un recurso administrado por RGM. La función scha_resource_open() inicializa el acceso a un recurso y devuelve un controlador para scha_resource_get(), que accede a la información del recurso. La función scha_resource_close() invalida el controlador y libera la memoria asignada para los valores de devolución de scha_resource_get ().

Se puede cambiar un recurso, mediante una reconfiguración del clúster o una acción administrativa, después de que scha_resource_open() devuelva el controlador del recurso. Como resultado, es posible que la información obtenida por scha_resource_get() mediante el controlador no sea precisa. Si se realiza una reconfiguración del clúster o una acción administrativa en un recurso, RGM devuelve el código de error scha_err_seqid a scha_resource_get() para indicar que la información sobre el recurso puede haber cambiado. No se trata de un error grave. La función devuelve información de forma satisfactoria. Puede optar por ignorar el mensaje o aceptar la información devuelta. También puede cerrar el controlador actual y abrir uno nuevo para acceder a la información sobre el recurso.

Estas tres funciones se describen en una página de comando man. Puede acceder a ella mediante cualquier de las tres funciones individuales 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 bajo el control de 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 acceden a la información sobre el tipo de recurso registrado con RGM.

scha_resourcetype_open(), scha_resourcetype_get () y scha_resourcetype_close()

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

Se puede cambiar un tipo de recurso, mediante una reconfiguración del clúster o una acción administrativa, después de que scha_resourcetype_open() devuelva el controlador del tipo de recurso. Como resultado, es posible que la información obtenida por scha_resourcetype_get() mediante el controlador no sea precisa. Si se realiza 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 sobre el tipo de recurso puede haber cambiado. No se trata de un error grave. La función devuelve información de forma satisfactoria. Puede optar por ignorar el mensaje o aceptar la información devuelta. También puede cerrar el controlador actual y abrir uno nuevo para acceder a la información sobre el tipo de recurso.

Estas tres funciones se describen en una página de comando man. Puede acceder a ella mediante cualquiera de las funciones individuales scha_resourcetype_open(3HA), scha_resourcetype_get(3HA) o scha_resourcetype_close(3HA).

Funciones del grupo de recursos

Puede acceder a la información sobre un grupo de recursos o reiniciar un grupo con estas funciones.

scha_resourcegroup_open(), scha_resourcegroup_get () y scha_resourcegroup_close()

Estas funciones acceden a la información de un grupo de recursos administrado por RGM. La función scha_resourcegroup_open() inicializa el acceso a un grupo de recursos y devuelve un controlador para scha_resourcegroup_get(), que accede a la información del grupo de recursos. La función scha_resourcegroup_close() invalida el controlador y libera la memoria asignada para los valores de devolución de scha_resourcegroup_get ().

Se puede cambiar un grupo de recursos, mediante una reconfiguración del clúster o una acción administrativa, después de que scha_resourcegroup_open() devuelva el controlador del grupo. Como resultado, es posible que la información obtenida por scha_resourcegroup_get() mediante el controlador no sea precisa. Si se realiza 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 sobre el grupo puede haber cambiado. No se trata de un error grave. La función devuelve información de forma satisfactoria. Puede optar por ignorar el mensaje o aceptar la información devuelta. También puede cerrar el controlador actual y abrir uno nuevo para acceder a la información sobre el grupo de recursos.

Estas tres funciones se describen en una página de comando man. Puede acceder a ella mediante cualquiera de las funciones individuales scha_resourcegroup_open(3HA), scha_resourcegroup_get(3HA) y scha_resourcegroup_close(3HA).

scha_control()

Solicita el reinicio de un grupo de recursos bajo el control de RGM o su reubicación en un nodo diferente. Esta función se describe de forma más detallada en la página de comando man scha_control(3HA).

Funciones del clúster

Estas funciones devuelven información sobre el clúster o acceden a ella.

scha_cluster_open(), scha_cluster_get () y scha_cluster_close()

Estas funciones acceden a la información sobre el clúster como, por ejemplo, el nombre del clúster, los nombres de los nodos, los Id., los estados y los grupos de recursos.

Se puede cambiar un clúster, mediante una reconfiguración o una acción administrativa, después de que scha_cluster_open() devuelva el controlador del clúster. Como resultado, es posible que la información obtenida por scha_cluster_get() mediante el controlador no sea precisa. Si se realiza una reconfiguración o una acción administrativa en un clúster, RGM devuelve el código de error scha_err_seqid a scha_cluster_get() para indicar que la información sobre el cluster puede haber cambiado. No se trata de un error grave. La función devuelve información de forma satisfactoria. Puede optar por ignorar el mensaje o aceptar la información devuelta. También puede cerrar el controlador actual y abrir uno nuevo para acceder a la información sobre el clúster.

Estas tres funciones se describen en una página de comando man. Puede acceder a ella mediante cualquiera de las funciones individuales scha_cluster_open(3HA), scha_cluster_get(3HA) y scha_cluster_close(3HA).

scha_cluster_getlogfacility()

Devuelve el número de la utilidad de registro del sistema que se está utilizando como registro del clúster. Utiliza el valor devuelto con la función syslog() de Solaris para registrar eventos y mensajes de estado en el registro del clúster. Esta función se describe de forma más detallada en la página de comando man scha_cluster_getlogfacility(3HA).

scha_cluster_getnodename()

Devuelve el nombre del nodo del clúster en el que se invoca la función. Esta función se describe de forma más detallada en la página de comando man scha_cluster_getnodename(3HA).

Función de utilidades

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

scha_strerror()

Convierte un código de error devuelto por una de las funciones scha_ en el mensaje de error correspondiente. Utilice esta función con el comando logger para almacenar mensajes en el registro del sistema de Solaris (syslog). Esta función se describe de forma más detallada en la página de comando man scha_strerror(3HA).