Utilización de Agent Builder

Esta sección explica cómo utilizar Agent Builder, incluidas las tareas que debe realizar 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:

• Análisis de la aplicación

• Instalación y configuración de Agent Builder

• Pantallas de Agent Builder

• Ejecución de Agent Builder

• Desplazamientos por Agent Builder

• Uso de la pantalla de creación

• Utilización de la pantalla de configuración

• Uso de la variable $hostnames basada en shell Korn de Agent Builder

• Variables de propiedades

• Clonación de un tipo de recurso existente

• Edición del código fuente generado

• Utilización de la versión de línea de comandos de Agent Builder

Análisis de la aplicación

Antes de usar Agent Builder debe determinar si la aplicación cumple los criterios para tener una alta disponibilidad y escalabilidad. 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. En Análisis de la validez de la aplicación puede obtener más información sobre este tema.

Es posible que Agent Builder no pueda crear siempre un tipo de recurso completo para una aplicación, aunque en la mayoría de los casos facilitará al menos una solución parcial. Por ejemplo, algunas aplicaciones más complejas pueden requerir un código adicional que Agent Builder no genera de forma predeterminada, como el código para agregar comprobaciones de validación de propiedades adicionales o para ajustar parámetros que Agent Builder no muestra. En esos casos, es necesario realizar cambios en el código fuente generado o el archivo RTR. Agent Builder está diseñado precisamente para permitir esta flexibilidad.

Agent Builder sitúa comentarios en determinados puntos del código fuente generado para que se pueda añadir código del tipo de recurso concreto. 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 aún aprovechar el makefile y la estructura que facilita Agent Builder para crear el paquete de Solaris para ese tipo de recurso.

Instalación y configuración de Agent Builder

Agent Builder no requiere ninguna instalación especial. Agent Builder se incluye en el paquete de SUNWscdev, que se instala de forma predeterminada como parte de una instalación estándar del software de Sun Cluster. En Sun Cluster Software Installation Guide for Solaris OS encontrará más información.

Antes de utilizar Agent Builder, compruebe los siguientes aspectos:

• El entorno de tiempo de ejecución de Java está incluido en la variable $PATH. Agent Builder depende de Java (Java Development Kit, como mínimo, la versión 1.3.1). Si el entorno Java no está incluido en $PATH , scdsbuilder devuelve un mensaje de error.

• Ha instalado el grupo de software de soporte del sistema del desarrollador de Solaris 8 o superior.

• El compilador cc está incluido en la variable $PATH. Agent Builder usa la primera aparición de cc en la variable $PATH para identificar el compilador con el que debe generar el código binario C para el tipo de recurso. Si cc no está incluido en $PATH, Agent Builder deshabilita la opción para generar el código C. Consulte Uso de la pantalla de creación.

Con Agent Builder puede usar un compilador diferente del compilador cc estándar. Para ello debe crear un vínculo simbólico en $PATH de cc a un compilador diferente, como gcc, o bien cambiar la especificación del compilador en el makefile (actualmente, CC=cc) por la ruta completa de un compilador diferente. Por ejemplo, en el makefile que genera Agent Builder, cambie CC=cc por CC=nombre_ruta/gcc. En este caso, no es posible ejecutar directamente Agent Builder. Utilice los comandos make y make pkg para generar un código de servicio de datos y un paquete.

Pantallas de Agent Builder

Agent Builder es un asistente que consta de dos pasos con una pantalla para cada uno de ellos. Agent Builder proporciona las dos pantallas siguientes que sirven de guía durante el proceso de creación de un nuevo tipo de recurso.

1. Crear. En esta pantalla se proporciona información básica acerca del tipo de recurso que se va a crear como, por ejemplo, el nombre y el directorio de trabajo para los archivos que se generen. El directorio de trabajo es donde se crea y se configura la plantilla del tipo de recurso. También se indica el tipo de recurso que se va a crear (escalable o a prueba de fallos), si la aplicación básica va a estar habilitada para la red (es decir, si utiliza la red para comunicarse con los clientes) y el tipo de código que se va a generar (shells C, Korn [ksh] o GDS). Para obtener información acerca de GDS, consulte Capítulo 10, Servicio de datos genérico. Debe proporcionar toda la información que se solicita en esta pantalla y seleccionar Crear para generar el resultado correspondiente. A continuación, puede acceder a la pantalla de configuración.

2. Configurar. En esta pantalla debe especificar la línea de comandos completa que se puede pasar a cualquier shell UNIX® para iniciar su aplicación básica. También puede proporcionar comandos para detener y analizar la aplicación. Si no especifica estos comandos, el resultado generado usará señales para detener la aplicación y proporcionará un mecanismo de análisis predeterminado. Consulte la descripción del mecanismo de análisis en Utilización de la pantalla de configuración. Esta pantalla también permite cambiar los valores de tiempo de espera para los tres siguientes comandos.

Ejecución de Agent Builder

Si la versión de Agent Builder con interfaz gráfica no está accesible, podrá acceder a Agent Builder mediante una interfaz de línea de comandos. Consulte Utilización de la versión de línea de comandos de Agent Builder.

Si ejecuta Agent Builder desde el directorio de trabajo de un tipo de recurso, Agent Builder inicializa las pantallas de creación y configuración para incluir los valores del tipo de recurso.

Para ejecutar Agent Builder, escriba el comando siguiente:

% /usr/cluster/bin/scdsbuilder

Aparece la pantalla de creación.

Figura 9–1 Pantalla de creación

Desplazamientos por Agent Builder

La información acerca de las pantallas de creación y configuración se especifica llevando a cabo estas operaciones:

• Escribiendo la información en un campo.

• Examinando la estructura de directorios y seleccionando un archivo o un directorio.

• Seleccionando uno de los botones de opción que se excluyen mutuamente (por ejemplo, Escalable o Recuperación ante fallos).

• Haciendo clic para activar o desactivar un cuadro. Por ejemplo, al marcar Habilitado para red, se identifica la aplicación base como utilizable en red mientras que dejarlo sin marcar identifica una aplicación que no trabaja en red.

Las opciones 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 o atenúa las opciones según corresponda.

Por ejemplo, una vez cumplimentados los campos y seleccionadas las opciones que desee en la pantalla de creación, haga clic en el botón Crear de la parte inferior de la pantalla. Los botones Anterior y Siguiente se atenúan, 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 de la parte inferior de la pantalla. Cuando termina, Agent Builder muestra bien un mensaje que indica que la operación se ha realizado satisfactoriamente o bien una advertencia para que se mire el registro de salida. Siguiente aparece resaltado o, si es la última pantalla, sólo estará resaltado Cancelar.

Si lo desea, puede pulsar Cancelar en cualquier momento para salir de Agent Builder.

Buscar

Algunos campos de Agent Builder permiten escribir la información, aunque también puede hacer clic en el botón Examinar para recorrer la estructura de directorios y seleccionar un archivo o directorio.

Cuando se hace clic en Examinar, aparece una pantalla similar a ésta:

Haga doble clic en una carpeta para abrirla. Cuando desplaza el cursor a un archivo, el nombre del archivo en cuestión aparece en el cuadro 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 no hay subdirectorios, Agent Builder cierra la ventana Examinar y pone el nombre del directorio seleccionado 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 coloca el nombre del directorio al que ha movido el cursor en el campo correspondiente.

Los iconos de la esquina superior derecha de la pantalla hacen lo siguiente:

Menús

Agent Builder incluye menús desplegables "Archivo" y "Editar".

Menú Archivo

El menú Archivo tiene dos opciones:

• Cargar tipo de recurso. Permite cargar un tipo de recurso existente. Agent Builder proporciona una pantalla para examinar y seleccionar el directorio de trabajo para un tipo de recurso. Si éste existe en el directorio desde el cual se ejecuta Agent Builder, éste lo carga automáticamente. El comando Cargar tipo de recurso permite ejecutar Agent Builder desde cualquier directorio y seleccionar un tipo de recurso existente para usarlo como plantilla para crear un nuevo tipo de recurso. Consulte Clonación de un tipo de recurso existente.

• Salir. Permite salir de Agent Builder. También puede salir haciendo clic en Cancelar en las pantallas de creación o configuración.

Menú Editar

El menú Editar tiene las siguientes opciones:

• 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 está realizando un proceso iterativo, realizando cambios en el código fuente y regenerando la salida de Agent Builder y desea separar los mensajes de estado, puede guardar y borrar el archivo de registro antes de cada utilización.

• Guardar archivo de registro. Guarda la salida del registro en un archivo. Agent Builder proporciona una pantalla donde se puede elegir el directorio y especificar un nombre de archivo.

Uso de la pantalla de creación

Pantalla de creación

El primer paso para crear un tipo de recurso consiste en cumplimentar la pantalla de creación que aparece al ejecutar Agent Builder. La figura siguiente muestra la pantalla de creación después de haber introducido la información en los campos.

Figura 9–2 Pantalla de creación

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. Generalmente, se especifica el símbolo bursátil del proveedor, pero se puede utilizar cualquier nombre que lo identifique de forma única. Utilice únicamente caracteres alfanuméricos.

• Nombre de la aplicación. Especifica el nombre del tipo de recurso. Utilice únicamente caracteres alfanuméricos.

  ---

  Nota –

  El nombre de la aplicación y del proveedor, juntos, componen el nombre completo del tipo de recurso. El nombre completo 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.

  En el campo de la versión del tipo de recurso no se pueden usar los siguientes caracteres: espacios, tabulaciones, barra oblicua (/), barra inversa (\), asterisco (*), interrogación (?), coma (,), punto y coma (;), corchete de apertura ([) ni corchete de cierre (]).

• Directorio de trabajo.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 indica en este campo la ruta al directorio desde el que se ha ejecutado Agent Builder, aunque se puede escribir un nombre diferente o utilizar el botón Examinar para buscar un directorio diferente.

  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.

• Escalable o Recuperación ante fallos. Especifica si el tipo de recurso de destino será escalable o de recuperación ante fallos.

• Habilitado para red. Determina si la aplicación base está habilitada para red, es decir, si usa la red para comunicarse con los clientes. Seleccione esta casilla de verificación para indicar un sistema habilitado para red, en caso contrario, déjela sin seleccionar.

• C, ksh. Indica el lenguaje del código fuente generado. Aunque estas opciones se excluyen mutuamente, con Agent Builder puede crear un tipo de recurso con un código generado mediante Korn y reutilizar la misma información para crear un código generado en C. Consulte Clonación de un tipo de recurso existente.

• GDS. Especifica que se trata de un servicio de datos genérico. Consulte el Capítulo 10, Servicio de datos genérico para obtener información sobre la creación y configuración de un servicio de datos genérico.

Si el compilador cc no está incluido en $PATH, Agent Builder atenuará el botón de opción C y sólo le permitirá seleccionar el botón ksh. Para especificar un compilador diferente, consulte la nota al final de Instalación y configuración de Agent Builder.

Después de introducir la información solicitada, haga clic en el botón Crear. El registro de salida de la parte inferior de la pantalla muestra las acciones que puede realizar 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 puede completar este paso, consulte el registro de salida para obtener más detalles.

• Si Agent Builder concluye con éxito, haga clic en el botón Siguiente para que aparezca la pantalla de configuración que permitirá terminar de generar el 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 introducida ni el trabajo que ha realizado Agent Builder. Consulte Reutilización del trabajo terminado.

Utilización de la pantalla de configuración

Pantalla de configuración

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 seleccionado el botón 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.

Figura 9–3 Pantalla de configuración

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 Examinar para localizar un archivo que contenga el comando para detener la aplicación.

  La línea de comandos completa debe incluir todo lo necesario para iniciar la aplicación, como nombres de sistema, números de puerto, una ruta a los archivos de configuración, etc. También puede especificar variables de propiedades , que se describen en Variables de propiedades. Si su aplicación basada en shell Korn requiere que se especifique un nombre de sistema 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 (““).

  ---

  Nota –

  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, se debe crear un archivo de texto con comandos individuales para iniciar cada árbol de procesos y especificar la ruta a este archivo en el campo de texto Comando de inicio. Consulte Creación de tipos de recursos con varios árboles de proceso independientes, donde se enumeran algunas características especiales, necesarias para que el archivo funcione 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 Examinar para localizar un archivo que contenga el comando para detener la aplicación. También puede especificar variables de propiedades, que se describen en Variables de propiedades. Si su aplicación basada en shell Korn requiere que se especifique un nombre de sistema 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 se cierre.

  • Si SIGKILL no tiene éxito, el método Stop permite salir, aunque sea de forma no satisfactoria. El 5 % restante del valor del tiempo de espera se considera transcurrido.

  ---

  Precaución –

  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 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 se limita a conectarse y desconectarse del puerto que utiliza el recurso y, si funciona, declara que la aplicación funciona correctamente. También puede especificar variables de propiedades, que se describen en Variables de propiedades. Si su aplicación basada en shell Korn requiere que se especifique un nombre de sistema 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.

• Tiempo de espera. Valor de tiempo de espera (en segundos) para cada comando. Se puede especificar un valor nuevo o aceptar el predeterminado de Agent Builder (300 segundos para inicio y parada y 30 para análisis).

Uso de la variable $hostnames basada en shell Korn de Agent Builder

Para muchas aplicaciones, en concreto las aplicaciones habilitadas para red, el nombre del sistema mediante el que la aplicación escucha y atiende las peticiones de los clientes debe pasarse a la aplicación en la línea de comandos. Por tanto, en muchos casos, el nombre del sistema es un parámetro 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 del sistema mediante el que escucha la aplicación es específico para el clúster. El nombre de sistema se determina cuando el recurso se ejecuta en un clúster y no se puede determinar cuando Agent Builder genera su código de tipo recurso.

Para solucionar este problema, Agent Builder proporciona la variable $hostnames que se puede especificar en la línea de comandos de 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 sistema real, por ejemplo:

% /opt/network_aware/echo_server -p port_no -l $hostnames

Cuando un recurso del tipo de recurso de destino se ejecuta en un clúster, los nombres de sistema LogicalHostname o SharedAddress configurados para ese recurso (en la propiedad de recurso Network_resources_used) se reemplazan por el valor de la variable $hostnames.

Si configura la propiedad Network_resources_used con múltiples nombres de sistemas, la variable $hostnames los incluye todos, separados por comas.

Variables de propiedades

Puede recuperar los valores de los recursos, los tipos de recursos y las propiedades de los tipos de recursos seleccionados de Sun Cluster desde el marco RGM usando variables de propiedades. Agent Builder analiza la secuencia de comandos de inicio, de análisis o de parada, estudia sus variables de propiedades y sustituye dichas variables por sus valores antes de que Agent Builder ejecute la secuencia de comandos.

Las variables de propiedades no se admiten para usarlas con servicios basados en shells Korn.

Lista de variables de propiedades

La siguiente lista incluye las variables de propiedades que puede usar con las secuencias de comandos. Las propiedades de los recursos de Sun Cluster, junto con las propiedades del tipo de recursos y las de los grupos de recursos se describen en Apéndice A, Propiedades estándar.

La siguiente lista incluye las variables de las propiedades de recursos:

• HOSTNAMES

• 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

La siguiente lista incluye las variables de las propiedades de los tipos de recursos:

• RT_API_VERSION

• RT_BASEDIR

• RT_FAILOVER

• RT_INSTALLED_NODES

• RT_NAME

• RT_RT_VERSION

• RT_SINGLE_INSTANCE

La siguiente lista incluye las variables de las propiedades de los grupos de recursos:

• RG_DESIRED_PRIMARIES

• 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

Sintaxis de las variables de propiedades

Un signo de porcentaje (%) se incluye antes de los nombres de propiedades para indicar que se trata de una variable de propiedad, tal y como se muestra en este ejemplo.

# /opt/network_aware/echo_server -t %RS_STOP_TIMEOUT -n %RG_NODELIST

En el caso del ejemplo anterior, Agent Builder puede interpretar estas variables de propiedades e iniciar 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

Sustitución que Agent Builder realiza de las variables de propiedades

La siguiente lista describe cómo Agent Builder interpreta los tipos de variables de propiedades:

• Un número entero se sustituye por su valor real ( 300, por ejemplo).

• Un valor booleano se sustituye por la cadena TRUE o FALSE.

• Una cadena se sustituye por la cadena real ( phys-node-1, por ejemplo).

• Una lista de cadenas se sustituye por todos los miembros de la lista, separados por comas (phys-node-1,phys-node-2,phys-node-3, por ejemplo).

• Una lista de números enteros se sustituye por todos los miembros de la lista, separados por comas (1,2,3, por ejemplo).

• Un tipo enumerado se sustituye por su valor, en forma de cadena.

Reutilización del trabajo terminado

Agent Builder permite aprovechar el trabajo finalizado de las siguientes formas.

• Se puede clonar un tipo de recurso creado con Agent Builder.

• Se puede editar el código fuente que genera Agent Builder y recompilarlo para crear un paquete nuevo.

Clonación de un tipo de recurso existente

Siga este procedimiento para clonar un tipo de recurso, generado por Agent Builder.

1. Cargue un tipo de recurso existente en Agent Builder usando uno de estos métodos:

   • Ejecute Agent Builder desde el directorio de trabajo (que contiene el archivo rtconfig) para un tipo de recurso existente (creado con Agent Builder). Agent Builder carga los valores para dicho tipo de recurso en las pantallas de creación y configuración.

   • Use la opción que permite cargar el tipo de recurso en el menú desplegable Archivo.

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

3. Realice los cambios.

   Este procedimiento se puede utilizar para cambiar el tipo de código generado para el tipo de recurso. Por ejemplo, si inicialmente ha creado una versión de un shell Korn de un tipo de recurso, pero más tarde se da cuenta de que necesita una versión en C, puede cargar el tipo de recurso shell Korn existente, cambiar el lenguaje de salida a C y hacer que Agent Builder cree una versión en C del tipo de recurso.

4. Cree el tipo de recurso clonado.

   Seleccione Crear para crear el tipo de recurso. Haga clic en Siguiente para mostrar la pantalla de configuración. Haga clic en Configurar para configurar el tipo de recurso y, después, haga clic en Cancelar.

Edición del código fuente generado

Para simplificar el proceso de creación de un tipo de recurso, Agent Builder limita el número de entradas, lo que reduce el alcance del tipo de recurso generado. Por tanto, para poder agregar funciones más avanzadas, como las comprobaciones de validación para las propiedades adicionales, o para ajustar parámetros que no muestra Agent Builder, es necesario modificar el código fuente generado o el archivo RTR.

Los archivos de origen están en el directorio directorio_instalación/nombre_tr/src. Agent Builder integra comentarios en el código fuente en los lugares donde se puede agregar código que son del tipo siguiente (para el código C):

/* Código agregado por el usuario -- INICIO vvvvvvvvvvvvvvv */
 /* Código agregado por el usuario -- FIN ^^^^^^^^^^^^^^^ */

Estos comentarios son idénticos en el código fuente del shell Korn, con excepción del signo #, que indica el inicio de un comentario.

Por ejemplo, nombre_tr.h declara todas las rutinas de utilidades que emplean los diferentes programas. Al final de la lista de declaraciones se incluyen comentarios que permiten declarar las rutinas adicionales agregadas a cualquiera de los códigos.

Agent Builder genera también el makefile en el directorio directorio_instalación/nombre_rt/src con los destinos correspondientes. Use los comandos make para recompilar el código fuente y make pkg para regenerar el paquete del tipo de recurso.

El archivo RTR, que se encuentra en el directorio directorio_instalación/nombre_tr/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 y Apéndice A, Propiedades estándar para obtener información acerca de las propiedades.

Utilización de la versión de línea de comandos de Agent Builder

La versión de línea de comandos de Agent Builder sigue el mismo proceso básico que la versión de interfaz gráfica de usuario, No obstante, en lugar de especificar información en la interfaz gráfica de usuario, los parámetros se pasan a los comandos scdscreate y scdsconfig. Consulte las páginas de comando man de scdscreate(1HA) y scdsconfig(1HA).

Siga estos pasos para utilizar la versión de línea de comandos de Agent Builder:

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

2. Utilice scdsconfig para configurar la plantilla del tipo de recurso creada con scdscreate.

   Puede especificar variables de propiedad. Las variables de propiedad se describen en Variables de propiedades.

3. Cambie los directorios al subdirectorio pkg del directorio de trabajo.

4. Use el comando pkgadd para instalar los paquetes que haya creado en scdscreate.

5. Si lo desea, edite el código fuente generado.

6. Ejecute la secuencia de inicio.