El archivo ejecutable del agente de construcción se ha instalado en yourPathPrefix/usr/lpp/jazz/bfagent durante la
instalación de SMP/E.
Realice los siguientes pasos para finalizar la instalación e iniciar Rational Build Agent:
- Si las compilaciones de Antz no van a utilizarse, el agente de compilación puede iniciarse manualmente o a través de INETD. Para iniciar el agente de compilación a través de
INETD consulte el apartado "Consejos para la utilización de inetd o xinetd" que se muestra a continuación. Para iniciar el agente de compilación de forma manual, cambie a yourPathPrefix/usr/lpp/jazz/v2.1/bfagent, y utilice la opción -s:
bfagent -s -f /etc/jazz/bfagent.conf
El
agente se ejecuta como un daemon autónomo y utiliza el puerto del agente predeterminado
5555. Para cambiar el puerto predeterminado, utilice la configuración de puerto de bfagent.conf.
Consulte Referencia bfagent. Consulte también las sugerencias relativas a inetd
que figuran más abajo.
- Si tiene pensado utilizar extensiones, Rational Build Agent debe iniciarse desde un script de shell en el que se hayan establecido variables de entorno adicionales. Build System Toolkit for System
z incluye un script de shell de muestra que configura esas variables de entorno
e inicia el agente. Para obtener más información, consulte el apartado Configuración del script de shell de Rational Build Agent.
- Para probar el agente de compilación que se está ejecutando en el sistema z/OS, utilice el mandato telnet para probar la conexión. Consulte Prueba de la conexión.
Nota: El agente de compilación suele utilizar privilegios de administración, como root o admin, para conectarse al sistema operativo. Además, el agente de compilación ejecuta todos los mandatos utilizando los permisos del usuario que inició el agente, no el nombre de usuario que inició la sesión. Si el agente de compilación no se ejecuta como usuario root o administrador, podría recibir errores de autenticación cuando pruebe la conexión. Para ejecutar el agente desde un ID de usuario que no sea root o admin, configure el valor magic_login en bfagent.conf. Se trata de una alternativa a la autenticación de sistemas estándar.
Con esta configuración,
el sistema puede autenticar el inicio de sesión con un único nombre de usuario y
contraseña. Para ver los pasos necesarios para configurar
magic_login, consulte el apartado
Referencias de bfagent.conf.
Sugerencias relativas a la utilización de inetd o xinetd
Si el daemon TCP/IP
de UNIX® TCP/IP (inetd o xinetd)
está instalado y activo en el sistema z/OS,
puede configurar Rational Build
Agent para que se ejecute como un servicio y se inicie de forma automática. Para obtener más información acerca de la configuración de
inetd, consulte el Centro de información de z/OS V1R9 en
http://publib.boulder.ibm.com/infocenter/zos/v1r9/index.jsp?topic=/com.ibm.zos.r9.cs3/cs3.htm (o el centro de información correspondiente a su versión de z/OS). La configuración completa de inetd está fuera del
ámbito de este documento. En un ejemplo simple, podría:
- Modificar /etc/inetd.conf añadiendo esta línea:
bfagent stream tcp nowait userID /usr/lpp/jazz/v2.0/bfagent/bfagent -f /etc/jazz/bfagent.conf
- bfagent
- Nombre del servicio del daemon. El valor predeterminado es bfagent (minúsculas). El
nombre debe coincidir con el utilizado en /etc/services.
- stream tcp nowait
- Sentencias de configuración de inetd específicas (tipo de socket, protocolo,
distintivo de espera). No modificar.
- ID de usuario
- ID de usuario del proceso de daemon El valor predeterminado es OMVSKERN. Este
ID de usuario debe ser único y tener un segmento de seguridad OMVS, permiso BPX.DAEMON
y permiso READ y EXECUTE a la instalación y a los directorios
de configuración.
- /usr/lpp/jazz/v2.0/bfagent/bfagent
- Programa de servidor (ubicación absoluta de bfagent). El valor predeterminado es /usr/lpp/jazz/v2.0/bfagent/bfagent.
Los argumentos que siguen a este argumento inetd son argumentos de servidor.
- -f /etc/jazz/bfagent.conf
- Directorio de trabajo (ubicación del archivo de configuración de servidor Build Forge).
El valor predeterminado es /etc/jazz/bfagent.conf.
Importante: Copie los archivos de configuración de Rational Build Agent personalizados en un nuevo directorio (como /etc/jazz/) para evitar sobrescribirlos al aplicar el mantenimiento. El directorio de trabajo definido
aquí debe reflejar este cambio.
- Añada lo siguiente a /etc/services:
bfagent 5555/tcp #BUILD FORGE AGENT
- Actualice el puerto en el archivo bfagent.conf para correlacionarlo con la entrada de servicios:
port 5555
- Reinicie inetd.