Configuración de Rational Build Agent en z/OS para su inicio a través de InetD

Puede configurar Rational Build Agent para iniciarlo automáticamente cuando se reinicia el servidor utilizando el daemon de Internet (InetD).

Acerca de esta tarea

Build System Toolkit se entrega con un script de shell (startbfa.sh) para z/OS que se puede personalizar para que inicie Rational Build Agent en z/OS UNIX System Services (USS). El script establece el entorno del sistema necesario y, a continuación, inicia el agente como daemon autónomo. En lugar de utilizar el script, puede configurar Rational Build Agent para que se inicie manualmente con el entorno del sistema necesario cuando se reinicie el servidor. Complete los pasos siguientes para añadir el agente de compilación a la configuración InetD.

Procedimiento

Actualización de archivos de configuración de InetD

  1. Defina el servicio de Rational Build Agent (bfagent) en el sistema de USS añadiendo la línea siguiente al archivo /etc/services:
    bfagent       8888/tcp    #Rational Build Agent
  2. Sustituya 8888 por el número de puerto definido en la propiedad de puerto bfagent.conf. Esta línea correlaciona el servicio denominado bfagent al puerto especificado. Cuando InetD recibe una solicitud de servicio en el puerto especificado, lanzará el servicio bfagent tal como se define en el archivo de configuración InetD.
  3. Añada la línea siguiente a /etc/inetd.conf para definir el servicio para InetD:
    stream tcp nowait <usuario>   <agentPath>/bfagent bfagent -f <configPath>/bfagent.conf 
    Donde:
    1. <usuario> es el ID de usuario de RACF en el que se debería ejecutar el servicio
    2. <agentPath> es la vía de acceso completa al archivo ejecutable bfagent
    3. <configPath> es la vía de acceso completa al archivo de configuración bfagent.conf
  4. Una vez definido el servicio, el daemon InetD tiene que volver a leer la configuración. Existen varias opciones para forzar el daemon a volver a leer la configuración, el método más sencillo es detener el daemon y reiniciarlo utilizando el mandato siguiente:
    kill `cat /etc/inetd.pid`
    /usr/sbin/inetd /etc/inetd.conf

Configuración del entorno de compilación

  1. Cuando se están ejecutando las compilaciones de Ant con Enterprise Extensions, el bfagent requiere que se definan varias variables de entorno. Estas variables normalmente las define el script startbfa.sh y se exportan antes de iniciar el daemon bfagent. Para ejecutar compilaciones cuando está ejecutando el agente a través de InetD, debe definir las variables siguientes:
    • HOME
    • ZLANG
    • _TIMEOUT
    • _CMDSRV
    • _BASE_HOME
    • SCM_WORK
    • BLD_TOOLKIT
    • JAVA_HOME
    • JAZZ_USER
    • JAZZ_PASSWORD_FILE
    • STEPLIB
    • ANT_HOME
    Para buscar los valores previstos de estas variables y determinar cuáles son necesarios para el entorno, consulte los comentarios del script startbfa.sh, que se halla en el directorio siguiente: @pathPrefix@/usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/startbfa/startbfa.sh.
    Nota: Algunas de estas variables puede que no sean necesarias para su configuración.
  2. Defina estas variables como propiedades de un motor de compilación en su área de proyecto. Para definir las variables:
    1. Defina un motor de compilación de tipo Rational Build Agent. Para obtener detalles, consulte Utilización del editor de definición de compilación de Ant con Enterprise Extensions
    2. En el editor de definiciones de compilación, especifique el puerto definido en el archivo /etc/services.
    3. En la pestaña Visión general del editor de motor de compilación, en la sección Propiedades, defina las variables listadas más arriba.

Comentarios