Funciones de DSDL

Las siguientes subsecciones proporcionan una breve información general sobre cada una de las categorías de las funciones de DSDL. Sin embargo, las páginas de comando man de 3HA son la referencia definitiva para las funciones de DSDL.

Funciones de uso general

Las funciones de esta sección proporcionan una amplia gama de posibilidades; permiten:

• Inicializar el entorno de DSDL

• Recuperar recursos, tipos y nombres de grupos de recursos y valores de propiedades de extensión

• Recuperaciones de fallos y reiniciar un grupo de recursos y un recurso

• Convertir secuencias de errores en mensajes de error

• Ejecutar una orden tras un tiempo de espera

Las funciones siguientes inicializan el método de llamada.

• scds_initialize: asigna recursos e inicializa el entorno de DSDL.

• scds_close: libera recursos asignados por scds_initialize.

Las funciones siguientes recuperan información sobre recursos, tipos y grupos de recursos y propiedades de extensión.

• scds_get_resource_name: recupera el nombre del recurso para el programa de llamada.

• scds_get_resource_type_name: recupera el nombre del tipo de recurso para el programa de llamada.

• scds_get_resource_group_name: recupera el nombre del grupo de recursos para el programa de llamada.

• scds_get_ext_property: recupera el valor de la propiedad de extensión especificada.

• scds_free_ext_property: libera la memoria asignada por scds_get_ext_property.

La función siguiente recupera información de estado sobre SUNW. Recursos de HAStoragePlus usados por un recurso.

• scds_hasp_check: recupera información del estado de los recursos de SUNW.HAStoragePlus utilizados por un recurso. Esta información se obtiene del estado (en línea u otro) de todos los recursos SUNW.HAStoragePlus de los que depende el recurso usando propiedades del sistema Resource_dependencies o Resource_dependencies_weak definidas para el mismo.

  Consulte SUNW.HAStoragePlus(5) para obtener más información sobre SUNW.HAStoragePlus.

Las funciones siguientes realizan operaciones de recuperación de fallos o reinician un recurso o grupo de recursos.

• scds_failover_rg: realiza una operación de recuperación de fallos de un grupo de recursos.

• scds_restart_rg: reinicia un grupo de recursos.

• scds_restart_resource: reinicia un recurso.

Las dos siguientes funciones ejecutan una orden tras un tiempo de espera y convierten un código de error en un mensaje de error.

• scds_timerun: ejecuta una orden con un valor de tiempo de espera.

• scds_error_string: traduce un código de error en una secuencia de error.

Funciones de la propiedad

Estas funciones proporcionan API convenientes para acceder a las propiedades específicas del recurso, grupos y tipos de recursos, incluidas algunas propiedades de extensión utilizadas frecuentemente. DSDL proporciona la función scds_initialize para analizar los argumentos de la línea de órdenes. La biblioteca intercepta entonces las diversas propiedades del recurso, grupo de recursos y tipo de recursos.

Una sola página de comando man, scds_property_functions(3HA), describe todas estas funciones. Esta sección contiene las funciones siguientes

• scds_get_rs_nombre_propiedad

• scds_get_rg_nombre_propiedad

• scds_get_rt_nombre_propiedad

• scds_get_ext_nombre_propiedad

Funciones de acceso a los recursos de la red

Las funciones enumeradas en esta sección recuperan, imprimen y liberan recursos de red empleados por recursos y grupos de recursos. Las funciones scds_get_* de esta sección proporcionan una forma conveniente de recuperar recursos de red sin necesidad de consultar propiedades específicas, como Network_resources_used y Port_list con las funciones de RMAPI. Las funciones scds_print_nombre() imprimen valores de las estructuras de datos devueltas por las funciones scds_get_nombre(). Las funciones scds_free_nombre() liberan la memoria asignada por las funciones scds_get_nombre().

Las siguientes funciones están relacionadas con los nombres de sistema.

• scds_get_rg_hostnames: recupera una lista de nombres de sistema que usan los recursos de la red en un grupo de recursos.

• scds_get_rs_hostnames: recupera una lista de nombres de sistema empleados por el recurso.

• scds_print_net_list: imprime los contenidos de la lista de nombres de sistema que devuelven scds_get_rg_hostnames o scds_get_rs_hostnames.

• scds_free_net_list: libera la memoria asignada por scds_get_rg_hostnames o scds_get_rs_hostnames.

Las funciones siguientes están relacionadas con listas de puertos.

• scds_get_port_list: recupera una lista de pares puerto-protocolo empleados por un recurso.

• scds_print_port_list: imprime el contenido de la lista de pares puerto-protocolo que devuelve scds_get_port_list.

• scds_free_port_list: libera la memoria asignada por scds_get_port_list.

Las funciones siguientes están relacionadas con las direcciones de red.

• scds_get_netaddr_list: recupera una lista de las direcciones de red empleadas por un recurso.

• scds_print_netaddr_list: imprime el contenido de la lista de direcciones de red devuelta por scds_get_netaddr_list.

• scds_free_netaddr_list: libera la memoria asignada por scds_get_netaddr_list.

Supervisión de los fallos con las conexiones de TCP

Las funciones de esta sección habilitan la supervisión basada en TCP. Generalmente, un supervisor de fallos emplea estas funciones para establecer una conexión de zócalo sencilla con un servicio, leer y escribir datos en éste para asegurarse de su estado y desconectarse después de él.

Esta sección contiene las funciones siguientes.

• scds_tcp_connect: establece una conexión TCP con un proceso.

• scds_tcp_read: utiliza una conexión TCP para leer los datos del proceso que se está supervisando.

• scds_tcp_write: utiliza una conexión TCP para escribir datos en un proceso que se está supervisando.

• scds_simple_probe: analiza un proceso, mediante el establecimiento y la finalización de una conexión TCP con el proceso.

• scds_tcp_disconnect: finaliza la conexión con un proceso que se está supervisando.

Funciones de PMF

Estas funciones encapsulan la función de PMF. El modelo de DSDL de supervisión a través de PMF crea y emplea valores implícitos de etiqueta para pmfadm(1M). El recurso PMF también emplea valores implícitos para Restart_interval, Retry_count y action_script (las opciones -t, -n y -a en pmfadm). Es más, DSDL vincula el historial de terminación del proceso, como lo encuentra PMF, con el historial de fallos de la aplicación, como lo ha detectado el supervisor de fallos, para calcular la decisión de reinicio o recuperación de fallos.

Esta sección contiene las funciones siguientes.

• scds_pmf_get_status: determina si la instancia especificada está siendo supervisada bajo el control de PMF.

• scds_pmf_restart_fm: reinicia el supervisor de fallos con PMF.

• scds_pmf_signal: envía la señal especificada a un árbol de procesos que se ejecuta bajo el control de PMF.

• scds_pmf_start: ejecuta un programa especificado (incluido un supervisor de fallos) bajo el control de PMF.

• scds_pmf_stop: termina un proceso que se está ejecutando bajo el control de PMF.

• scds_stop_monitoring: detiene la supervisión de un proceso que se está ejecutando bajo el control de PMF.

Funciones del supervisor de fallos

Las funciones de esta sección proporcionan un modelo predeterminado de supervisión de fallos, mediante el mantenimiento del historial de fallos y su evaluación en combinación con las propiedades Retry_count y Retry_interval.

Esta sección contiene las funciones siguientes.

• scds_fm_sleep: espera un mensaje en un zócalo de control del supervisor de fallos.

• scds_fm_action: actúa tras finalizar un análisis.

• scds_fm_print_probes: escribe información del estado del análisis en el registro del sistema.

Funciones útiles

Las funciones de esta sección permiten escribir mensajes y depurar mensajes del registro del sistema. Esta sección incluye las dos funciones siguientes.

• scds_syslog: escribe mensajes en el registro cronológico del sistema.

• scds_syslog_debug: escribe un mensaje de depuración en el registro del sistema.