Esta sección describe cómo utilizar Agent Builder. Además, incluye tareas que deben completarse antes de utilizar Agent Builder. Esta sección también explica cómo usar este programa después de haber generado el código del tipo de recurso.
Se tratan los siguientes temas:
Uso de la variable $hostnames basada en shell Korn de Agent Builder
Utilización de la versión de línea de comandos de Agent Builder
Antes de utilizar Agent Builder, debe determinar si la aplicación que desea que ofrezca una alta disponibilidad o escalabilidad cumple los criterios necesarios. Agent Builder no puede realizar este análisis, que se basa únicamente en las características de tiempo de ejecución de la aplicación. Análisis de la validez de la aplicación proporciona más información sobre este tema.
Es posible que Agent Builder no pueda crear siempre un tipo de recurso completo para la aplicación. Sin embargo, en la mayoría de los casos, Agent Builder proporciona al menos una solución parcial. Por ejemplo, las aplicaciones más sofisticadas pueden requerir un código adicional que Agent Builder no genere de forma predeterminada. Entre los ejemplos de este código adicional, se incluye el código que agrega comprobaciones de validación de las propiedades adicionales o que ajusta las propiedades que no muestra Agent Builder. En esos casos, es necesario realizar cambios en el código fuente generado o el archivo RTR. Agent Builder está diseñado para ofrecer este tipo de flexibilidad.
Agent Builder incluye delimitadores en determinados puntos del código fuente generado en los que puede añadir su propio código del tipo de recurso. Después de hacer cambios en el código fuente, se puede usar el makefile generado por Agent Builder para recompilar el código fuente y volver a generar el paquete del tipo de recurso.
Aunque se escriba todo el código del tipo de recurso sin utilizar ningún código generado por Agent Builder, se puede aprovechar el makefile y la estructura que facilita Agent Builder para crear el paquete de Solaris para ese tipo de recurso.
Agent Builder no requiere ninguna instalación especial. Agent Builder se incluye en el paquete SUNWscdev, instalado de forma predeterminada durante la instalación del software de Sun Cluster. En Software Sun Cluster: Guía de instalación para el sistema operativo Solaris encontrará más información.
Antes de utilizar Agent Builder, compruebe los siguientes requisitos:
El entorno de tiempo de ejecución de Java se ha incluido en la variable $PATH. Agent Builder depende de, como mínimo, la versión 1.3.1 de Java Development Kit. Si esta herramienta no se incluye en la variable $PATH, el comando de Agent Builder (scdsbuilder) devuelve y muestra un mensaje de error.
Se ha instalado el grupo de software de Developer System Support, como mínimo, para la versión 8 del sistema operativo Solaris.
El compilador cc se ha incluido en la variable $PATH . Agent Builder utiliza la primera aparición de cc en la variable $PATH para identificar el compilador con el que se generará el código binario en C para el tipo de recurso. Si cc no está incluido en $PATH, Agent Builder inhabilita la opción para generar código en C. Consulte Uso de la pantalla de creación.
Puede utilizar un compilador diferente al compilador estándar cc con Agent Builder. Para ello, cree un vínculo simbólico en $PATH desde cc a un compilador diferente como, por ejemplo, gcc. O cambie la especificación del compilador en el makefile (actualmente, CC=cc) a la ruta completa de un compilador diferente. Por ejemplo, en el makefile que genera Agent Builder, cambie CC=cc por CC=pathname/gcc. En este caso, no puede ejecutar directamente Agent Builder. En su lugar, debe utilizar los comandos make y make pkg para generar el código del servicio de datos y del paquete.
Agent Builder es un asistente que consta de dos pasos con una pantalla para cada uno de ellos. Agent Builder proporciona las dos siguientes pantallas que sirven de guía durante el proceso de creación de un nuevo tipo de recurso:
Pantalla de creación En esta pantalla, se proporciona información básica sobre el tipo de recurso que se va a crear como, por ejemplo, el nombre y el directorio de trabajo de los archivos generados. El directorio de trabajo es donde se crea y se configura la plantilla del tipo de recurso. También puede especificar la siguiente información:
El tipo de recurso que se va a crear (escalable o de recuperación ante fallos).
Si la aplicación básica está habilitada para red (es decir, si usa la red para establecer comunicación con sus clientes).
El tipo de código que se va a generar (shell C o Korn (ksh), o GDS)
Para obtener información sobre GDS, consulte el Capítulo 10, Servicios genéricos de datos. Debe proporcionar toda la información solicitada en esta pantalla y seleccionar Create (Crear) para generar el resultado correspondiente. A continuación, puede acceder a la pantalla de configuración.
Pantalla de configuración. En esta pantalla, debe especificar toda la línea de comandos que se transferirá al shell UNIX para iniciar la aplicación básica. También puede proporcionar comandos para detener y analizar la aplicación. Si no especifica estos dos comandos, el resultado generado utiliza las señales para detener la aplicación y proporciona un mecanismo de análisis predeterminado. Consulte la descripción del comando de análisis en Utilización de la pantalla de configuración. La pantalla de configuración también permite cambiar los valores de tiempo de espera para cada uno de estos tres comandos: start, stop y probe.
Si no puede acceder a la versión de la GUI de Agent Builder, puede utilizar la interfaz de línea de comandos para acceder a esta herramienta. Consulte Utilización de la versión de línea de comandos de Agent Builder .
Si inicia Agent Builder desde el directorio de trabajo de un tipo de recurso existente, la herramienta inicializa las pantallas de creación y configuración con los valores de este tipo de recurso.
Escriba el siguiente comando para iniciar Agent Builder:
% /usr/cluster/bin/scdsbuilder |
Aparece la pantalla de creación.
Para introducir información en las pantallas de creación y configuración, realice las siguientes operaciones:
Escriba la información en un campo.
Desplácese a la estructura de directorios y seleccione un archivo o directorio.
Seleccione uno de los botones de opción que se excluyen mutuamente. Por ejemplo, Scalable (Escalable) o Failover (Recuperación ante fallos).
Seleccione la casilla de verificación Network Aware (Habilitada para red) para identificar que la aplicación básica está habilitada para red o déjela en blanco si no está habilitada para red.
Los botones de la parte inferior de cada pantalla permiten finalizar la tarea, pasar a la pantalla anterior o siguiente o salir de Agent Builder. Agent Builder resalta u oscurece estos botones según sea pertinente.
Por ejemplo, una vez cumplimentados los campos y seleccionadas las opciones deseadas en la pantalla de creación, haga clic en el botón Create (Crear) de la parte inferior de la pantalla. Los botones Previous (Anterior) y Next (Siguiente) se oscurecen, porque no hay ninguna pantalla anterior y aún no se puede ir al paso siguiente, pues no se ha finalizado el actual.
Agent Builder muestra mensajes de progreso en el área de registro de salida en la parte inferior de la pantalla. Cuando finaliza Agent Builder, se muestra un mensaje de advertencia o un mensaje que indica que se ha realizado con éxito el proceso. Siguiente aparece resaltado o, si es la última pantalla, sólo estará resaltado Cancelar.
En Agent Builder, puede hacer clic en Cancel (Cancelar) en cualquier momento.
Algunos campos de Agent Builder permiten la introducción de información. Otros campos le permiten hacer clic en Browse (Examinar) para examinar la estructura de directorios y seleccionar un archivo o directorio.
Al hacer clic en Browse (Examinar), aparece una pantalla similar a ésta:
Haga doble clic en una carpeta para abrirla. Al desplazar el cursor por un archivo, aparece su nombre en el campo File Name (Nombre de archivo). Haga clic en Seleccionar cuando haya localizado el archivo que desee y haya movido el curso hasta él.
Si está buscando un directorio, desplace el cursor al directorio que desee y haga clic en Abrir. Si el directorio no contiene ningún subdirectorio, Agent Builder cierra la ventana Browse (Examinar) y pone el nombre del directorio sobre el que ha desplazado el cursor en el campo correspondiente. Si el directorio tiene subdirectorios, haga clic en el botón Cerrar para cerrar la ventana Examinar y volver a la pantalla anterior. Agent Builder pone el nombre del directorio sobre el que ha desplazado el cursor en el campo correspondiente.
Los iconos de la esquina superior derecha de la pantalla Browse (Examinar) realizan las siguientes acciones:
Icono |
Función |
---|---|
Este icono sube un nivel en el árbol de directorios. |
|
Este icono vuelve a la carpeta de inicio. |
|
Este icono crea una carpeta nueva en la carpeta seleccionada actualmente. |
|
Ese icono, que sirve para cambiar entre las diferentes vistas, está reservado para usos futuros. |
Agent Builder proporciona los menús desplegables File (Archivo) y Edit (Editar).
El menú File (Archivo) tiene dos comandos:
Cargar tipo de recurso. Carga un tipo de recurso existente. Agent Builder proporciona una pantalla para examinar y seleccionar el directorio de trabajo para un tipo de recurso. Si hay un tipo de recurso en el directorio desde el que se inició Agent Builder, esta herramienta carga automáticamente este tipo de recurso. La función Load Resource Type (Cargar tipo de recurso) permite iniciar Agent Builder desde cualquier directorio y seleccionar un tipo de recurso existente para utilizarlo como plantilla en la creación de un nuevo tipo de recurso. Consulte Reutilización del código creado con Agent Builder .
Salir. Permite salir de Agent Builder. También puede salir haciendo clic en Cancelar en las pantallas de creación o configuración.
El menú Edit (Editar) tiene dos comandos:
Borrar registro de salida. Borra la información del registro de salida. Cada vez que se seleccione Crear o Configurar, Agent Builder introduce mensajes de estado en el registro de salida. Si realiza de forma habitual cambios en el código fuente y vuelve a generar el resultado en Agent Builder, y desea dividir los mensajes de estado, puede guardar y borrar el archivo de registro después de cada uso.
Guardar archivo de registro. Guarda el resultado del registro en un archivo. Agent Builder proporciona una pantalla de exploración que permite seleccionar el directorio y especificar un nombre de archivo.
El primer paso para crear un tipo de recurso consiste en completar la pantalla de creación que aparece al iniciar Agent Builder. La siguiente figura muestra la pantalla de creación una vez introducida la información en los campos.
La pantalla de creación contiene los campos, botones de selección y casillas de verificación siguientes:
Nombre del proveedor. Nombre que identifica al proveedor del tipo de recurso. Normalmente, debe especificar el símbolo de la compañía del proveedor. No obstante, cualquier nombre que identifique de forma exclusiva al proveedor es válido. Utilice únicamente caracteres alfanuméricos.
Nombre de la aplicación. Especifica el nombre del tipo de recurso. Utilice únicamente caracteres alfanuméricos.
El nombre de la aplicación y del proveedor, juntos, componen el nombre completo del tipo de recurso. A partir de la versión 9 del sistema operativo Solaris, la combinación de nombre del proveedor y de la aplicación puede superar los nueve caracteres. Sin embargo, si utiliza una versión anterior del sistema operativo Solaris, la combinación de estos dos nombres no puede superar los nueve caracteres.
Versión del tipo de recurso. Especifica la versión del tipo de recurso generado. La versión del tipo de recurso distingue entre varias versiones registradas o actualizaciones del mismo tipo de recurso base.
No se pueden utilizar los siguientes caracteres en el campo de versión del tipo de recurso.
Espacio
Ficha
Barra diagonal (/)
Barra diagonal inversa (\)
Asterisco (*)
Signo de interrogación (?)
Coma (,)
Punto y coma (;)
Corchete izquierdo ([)
Corchete derecho (])
Directorio de trabajo. El directorio en el cual Agent Builder crea una estructura de directorios para acoger todos los archivos que se creen para el tipo de recurso de destino. Sólo se puede crear un tipo de recurso por directorio de trabajo. Agent Builder establece de forma predeterminada este campo en la ruta del directorio en el que se inició Agent Builder. Sin embargo, puede escribir un nombre diferente o utilizar la función Browse (Examinar) para especificar un directorio distinto.
En el directorio de trabajo, Agent Builder crea un subdirectorio con el nombre del tipo de recurso. Por ejemplo, si SUNW es el nombre del proveedor y ftp, el de la aplicación, Agent Builder llamará al subdirectorio SUNWftp.
Agent Builder coloca todos los directorios y archivos del tipo de recurso de destino en este subdirectorio. Consulte Estructura de directorios creada por Agent Builder .
Escalable o Recuperación ante fallos. Especifique si el tipo de recurso de destino es de recuperación ante fallos o escalable.
Habilitado para red. Determina si la aplicación básica está habilitada para red, es decir, si usa la red para comunicarse con los clientes. Seleccione la casilla de verificación Network Aware (Habilitado para red) para especificar que se trata de una aplicación habilitada para red o déjela en blanco si no está habilitada para red.
C, ksh. Indica el lenguaje del código fuente generado. Aunque estas opciones se excluyen mutuamente, puede crear con Agent Builder un tipo de recurso generado mediante shell Korn y volver a utilizar la misma información para crear un código generado en C. Consulte Reutilización del código creado con Agent Builder .
GDS. Especifica que se trata de un servicio de datos genérico. El Capítulo 10, Servicios genéricos de datos contiene información más detallada sobre la creación y configuración de servicios de datos genéricos.
Si el compilador cc no se encuentra en la variable $PATH, Agent Builder oscurece el botón de opción de C y le permite seleccionar el botón de opción de ksh. Para especificar un compilador diferente, consulte la nota ubicada al final de Instalación y configuración de Agent Builder.
Una vez seleccionada la información necesaria, haga clic en Create (Crear). El área de registro de salida de la parte inferior de la pantalla muestra las acciones que realiza Agent Builder. Puede elegir Guardar registro de salida en el menú Editar para guardar la información en el registro de salida.
Cuando haya acabado, Agent Builder muestra un mensaje de advertencia o uno que informa del éxito de la operación.
Si Agent Builder no ha podido completar este paso, consulte el registro de salida para obtener más detalles.
Si, por el contrario, lo ha completado con éxito, haga clic en Next (Siguiente) para mostrar la pantalla de configuración. La pantalla de configuración permite finalizar el proceso de creación de un tipo de recurso.
Aunque la generación de un tipo de recurso completo es un proceso de dos pasos, es posible salir de Agent Builder después de terminar el primer paso (creación) sin perder la información especificada ni el trabajo que ha realizado Agent Builder. Consulte Reutilización del código creado con Agent Builder .
La pantalla de configuración (figura siguiente) aparece después de que Agent Builder haya terminado de crear el tipo de recurso y de que se haya hecho clic en el botón Next (Siguiente) en la pantalla de creación. No se puede acceder a la pantalla de configuración sin haber creado el tipo de recurso con anterioridad.
La pantalla de configuración contiene los campos siguientes:
Comando de inicio. La línea de comandos completa que se puede pasar a cualquier shell de UNIX para iniciar la aplicación básica. Debe especificar un comando de inicio. Puede escribir el comando en el campo suministrado o utilizar el botón Browse (Examinar) para localizar un archivo que contenga el comando para iniciar la aplicación.
La línea de comandos completa debe incluir todo lo necesario para iniciar la aplicación, como nombres de host, números de puerto, una ruta a los archivos de configuración, etc. También puede especificar las variables de propiedades descritas en Uso de las variables de propiedades. Si su aplicación basada en shell Korn requiere que se especifique un nombre de host en la línea de comandos, puede usar la variable $hostnames que define Agent Builder. Consulte Uso de la variable $hostnames basada en shell Korn de Agent Builder.
No ponga el comando entre comillas dobles (““).
Si la aplicación básica tiene muchos árboles de procesos independientes, cada uno de los cuales se inicia con su propia etiqueta, bajo el control de PMF, no será posible especificar un solo comando. En su lugar, debe crear un archivo de texto que contenga comandos individuales para iniciar cada árbol de procesos y, a continuación, especificar la ruta a este archivo en campo de texto Start Command (Comando de inicio). Consulte Antes de usar Agent Builder. Esta sección muestra las características especiales que necesita este archivo para funcionar correctamente.
Comando de parada. La línea de comandos completa que se puede pasar a cualquier shell de UNIX para detener la aplicación básica. Puede escribir el comando en el campo suministrado o utilizar el botón Browse (Examinar) para localizar un archivo que contenga el comando para detener la aplicación. También puede especificar las variables de propiedades descritas en Uso de las variables de propiedades. Si su aplicación basada en shell Korn requiere que se especifique un nombre de host en la línea de comandos, puede usar la variable $hostnames que define Agent Builder. Consulte Uso de la variable $hostnames basada en shell Korn de Agent Builder.
Este comando es opcional. Si no se especifica un comando de parada, el código generado emplea señales (en el método Stop) para detener la aplicación, como se muestra a continuación.
El método Stop envía SIGTERM para detener la aplicación y espera el 80% del valor de tiempo de espera excedido para que la aplicación salga.
Si la señal SIGTERM no resulta satisfactoria, el método Stop envía SIGKILL para detener la aplicación y espera el 15% del tiempo de espera excedido para que la aplicación salga.
Si SIGKILL no resulta satisfactoria, el método Stop no podrá salir. El 5 % restante del valor del tiempo de espera se considera transcurrido.
Asegúrese de que el comando de parada no retorne antes de que la aplicación se haya detenido por completo.
Comando de análisis. Comando que se puede ejecutar periódicamente para comprobar el estado de la aplicación y devolver un estado de salida adecuado entre 0 (éxito) y 100 (fallo total). Este comando es opcional. Puede escribir la ruta completa al comando o utilizar el botón Browse (Examinar) para localizar un archivo que contenga los comandos para analizar la aplicación.
Generalmente, se especifica un cliente simple de la aplicación básica. Si no se especifica un comando de análisis, el código generado simplemente se conecta al puerto utilizado por el recurso y se desconecta del mismo. Si la conexión y desconexión se realizan con éxito, el código declara que la aplicación funciona correctamente. También puede especificar las variables de propiedades descritas en Uso de las variables de propiedades. Si su aplicación basada en shell Korn requiere que se especifique un nombre de host en la línea de comandos de análisis, puede usar la variable $hostnames que define Agent Builder. Consulte Uso de la variable $hostnames basada en shell Korn de Agent Builder.
No ponga el comando entre comillas dobles (““).
Tiempo de espera. Un valor de tiempo de espera en segundos para cada comando. Puede especificar un nuevo valor o aceptar el valor predeterminado que proporciona Agent Builder. El valor predeterminado es de 300 para el inicio y la parada y de 30 segundos para el análisis.
En muchas aplicaciones, en concreto en aquéllas habilitadas para red, el nombre de host mediante el que la aplicación escucha y atiende las solicitudes de cliente debe pasarse a la aplicación en la línea de comandos. En la mayoría de los casos, el nombre de host es un argumento que se debe especificar para iniciar, detener y analizar comandos del tipo de recurso de destino en la pantalla de configuración. Sin embargo, el nombre de host mediante el que escucha la aplicación es específico para el clúster. El nombre de host se determina cuando el recurso se ejecuta en un clúster, y no puede determinarse cuando Agent Builder genera el código del tipo de recurso.
Para solucionar este problema, Agent Builder permite especificar la variable $hostnames en la línea de comandos para los comandos de inicio, parada y análisis.
La variable $hostnames se admite para usarla sólo con servicios basados en shell Korn. La variable $hostnames no se admite para usarla con servicios basados en C ni en GDS.
La variable $hostnames se especifica de la misma forma que se especificaría un nombre de host real, por ejemplo:
% /opt/network_aware/echo_server -p port-no -l $hostnames |
Cuando se ejecuta un recurso del tipo de recurso de destino en un clúster, el nombre de host LogicalHostname o SharedAddress configurado para ese recurso se sustituye por el valor de la variable $hostnames. El nombre de host se configura para ese recurso en la propiedad Network_resources_used del mismo.
Si configura la propiedad Network_resources_used con varios nombres de host, la variable $hostnames los incluye todos, separados por comas.
También puede recuperar los valores de las propiedades del tipo de recurso, recurso y grupo de recurso seleccionados de Sun Cluster desde la estructura RGM mediante las variables de propiedades. Agent Builder examina las cadenas de comandos de inicio, parada o análisis de las variables de propiedades y sustituye dichas variables por los valores antes de que esta herramienta ejecute el comando.
Las variables de propiedades no se admiten para usarlas con servicios basados en shells Korn.
Esta sección muestra las variables de propiedades que se pueden utilizar. Las propiedades del tipo de recurso, el recurso y el grupo de recursos de Sun Cluster se describen en Apéndice A, Propiedades estándar.
RS_CHEAP_PROBE_INTERVAL
RS_MONITOR_START_TIMEOUT
RS_MONITOR_STOP_TIMEOUT
RS_NAME
RS_NUM_RESTARTS
RS_RESOURCE_DEPENDENCIES
RS_RESOURCE_DEPENDENCIES_WEAK
RS_RETRY_COUNT
RS_RETRY_INTERVAL
RS_SCALABLE
RS_START_TIMEOUT
RS_STOP_TIMEOUT
RS_THOROUGH_PROBE_INTERVAL
SCHA_STATUS
RG_GLOBAL_RESOURCES_USED
RG_IMPLICIT_NETWORK_DEPENDENCIES
RG_MAXIMUM_PRIMARIES
RG_NAME
RG_NODELIST
RG_NUM_RESTARTS
RG_PATHPREFIX
RG_PINGPONG_INTERVAL
RG_RESOURCE_LIST
Puede incluir un símbolo de porcentaje (%) delante de un nombre de propiedad para indicar una variable de propiedad, como se muestra en este ejemplo:
/opt/network_aware/echo_server -t %RS_STOP_TIMEOUT -n %RG_NODELIST
Según el ejemplo anterior, es posible que Agent Builder interprete estas variables de propiedades e inicie la secuencia de comandos echo_server con los siguientes valores:
/opt/network_aware/echo_server -t 300 -n phys-node-1,phys-node-2,phys-node-3
Agent Builder interpreta los tipos de variables de propiedades de la siguiente forma:
Un entero se sustituye por su valor real (por ejemplo, 300).
Un valor booleano se sustituye por la cadena TRUE o FALSE.
Una cadena se sustituye por la cadena real (por ejemplo, phys-node-1 ).
Una lista de cadenas se sustituye por todos los miembros de la lista y se separa cada cadena mediante una coma (por ejemplo phys-node-1,phys-node-2,phys-node-3).
Una lista de enteros se sustituye por todos los miembros de la lista y se separa cada entero mediante una coma (por ejemplo, 1,2,3).
Un tipo enumerado se sustituye por su valor, en forma de cadena.
Agent Builder permite volver a utilizar el trabajo finalizado de varias formas:
Puede clonar un tipo de recurso existente creado con Agent Builder.
Puede editar el código fuente que genera Agent Builder y recompilarlo para crear un paquete nuevo.
Siga este procedimiento para clonar un tipo de recurso existente generado por Agent Builder.
Cargue un tipo de recurso existente en Agent Builder usando uno de estos métodos:
Inicie Agent Builder desde el directorio de trabajo para un tipo de recurso existente creado con esta herramienta. Asegúrese de que el directorio de trabajo contiene el archivo rtconfig. Agent Builder carga los valores para dicho tipo de recurso en las pantallas de creación y configuración.
Utilice la opción Load Resource Type (Cargar tipo de recurso) desde el menú desplegable File (Archivo).
Vaya al directorio de trabajo en la pantalla de creación.
Debe usar el comando Examinar para seleccionar un directorio. Escribir un nombre nuevo para el directorio no basta. Una vez seleccionado un directorio, Agent Builder vuelve a habilitar el botón Crear.
Realice los cambios que desee en el tipo de recurso existente.
Puede cambiar el tipo de código generado para el tipo de recurso. Por ejemplo, si crea una versión de un tipo de recurso con el shell Korn y, pasado el tiempo, descubre que necesita una versión C, realice lo siguiente:
Cargue el tipo de recurso de shell Korn existente.
Cambie el lenguaje de salida a C.
Haga clic en Create (Crear) para que Agent Builder genere una versión C del tipo de recurso.
Cree el tipo de recurso clonado.
Para simplificar el proceso de creación de un tipo de recurso, Agent Builder limita la cantidad de información que se puede especificar, lo que limita necesariamente el ámbito del tipo de recurso generado. Por lo tanto, para añadir funciones más sofisticadas, es nececesario modificar el código fuente generado o el archivo RTR. Entre los ejemplos de estas funciones adicionales, se incluye el código que agrega comprobaciones de validación de las propiedades adicionales o que ajusta las propiedades que no muestra Agent Builder.
Los archivos de origen se encuentran en el directorio install-directory/rt-name/src. Agent Builder incluye delimitadores en el código fuente para que pueda agregar el código adicional. Estos delimitadores son del tipo siguiente (para el código C):
/* User added code -- BEGIN vvvvvvvvvvvvvvv */ /* User added code -- END ^^^^^^^^^^^^^^^ */
Estos delimitadores son idénticos en el código fuente de shell Korn, a excepción de la marca del delimitador (#) que indica el comienzo del mismo.
Por ejemplo, rt-name.h declara todas las funciones de la utilidad que utilizan los diferentes programas. Al final de la lista de declaraciones se incluyen delimitadores que permiten declarar las funciones adicionales agregadas a cualquiera de los códigos.
Agent Builder también genera el makefile en el directorio install-directory/rt-name/src con los destinos correspondientes. Utilice el comando make para volver a compilar el código fuente. Utilice el comando make pkg para volver a generar el paquete del tipo de recurso.
El archivo RTR se encuentra en el directorio install-directory/rt-name/etc. El archivo RTR se puede editar con un editor de texto estándar. Consulte Establecimiento del recurso y las propiedades del tipo de recurso para obtener más información sobre el archivo RTR. Consulte Apéndice A, Propiedades estándar para obtener más información sobre las propiedades.
La versión de línea de comandos de Agent Builder sigue los mismos procedimientos básicos que la GUI. Sin embargo, en lugar de introducir la información en la interfaz gráfica de usuario, se pasan los argumentos a los comandos scdscreate y scdsconfig. Para obtener más información, consulte las páginas de comando man scdscreate(1HA) y scdsconfig(1HA).
Siga estos pasos para utilizar la versión de línea de comandos de Agent Builder.
Utilice scdscreate para crear una plantilla del tipo de recurso de Sun Cluster para hacer que una aplicación tenga una alta disponibilidad o escalabilidad.
Utilice scdsconfig para configurar la plantilla del tipo de recurso creada con scdscreate.
Puede especificar variables de propiedades. Las variables de propiedades se describen en Uso de las variables de propiedades.
Cambie los directorios al subdirectorio pkg del directorio de trabajo.
Use el comando pkgadd para instalar los paquetes que haya creado en scdscreate.
Si utiliza el sistema operativo Solaris 10 en un entorno de zonas, escriba el siguiente comando como administrador global en la zona global:
# pkgadd -G -d . package-name |
El paquete especificado se agrega a la zona global, siempre que el contenido del paquete no afecte a ningún área de la zona global compartida por una zona no global.
Si utiliza otra versión de Solaris o la versión 10 en un entorno que no sea de zonas, escriba el siguiente comando:
# pkgadd -d . package-name |
(Opcional) Edite el código fuente generado.
Ejecute la secuencia de inicio.