O arquivo executável do agente de construção foi instalado no yourPathPrefix/usr/lpp/jazz/bfagent durante a instalação do SMP/E.
Conclua estas etapas para finalizar a instalação e iniciar o Rational Build Agent:
- Se construções Antz não forem ser usadas, o agente de construção poderá ser iniciado manualmente ou por meio de INETD. Para iniciar o agente de construção por meio de INETD, consulte "Dicas para usar inetd ou xinetd" a seguir. Para iniciar o agente de construção manualmente, altere para yourPathPrefix/usr/lpp/jazz/v2.1/bfagent e use a opção -s:
bfagent -s -f /etc/jazz/bfagent.conf
O agente executa como um daemon independente e usa a porta do agente padrão 5555. Para mudar a porta padrão, use a definição da porta em bfagent.conf.
Consulte o referência bfagent. Consulte também as dicas sobre inetd a seguir.
- Se planejar usar extensões de construção Antz, o Rational Build Agent, deve ser iniciado a partir de um shell script que tenha variáveis de ambiente adicionais configuradas. O Build System Toolkit para System z contém um shell script de amostra que configura essas variáveis de ambiente e inicia o agente. Para obter informações adicionais, consulte Configurando o shell script do Rational Build Agent.
- Para testar o agente de construção em execução no sistema z/OS, use o comando telnet
para testar a conexão. Consulte o Teste da Conexão.
Nota: O agente de construção normalmente usa privilégios administrativos, como raiz ou admin para efetuar logon no sistema operacional. Além disso, o agente de construção executa todos os comandos usando as permissões do usuário que iniciou o agente, não o nome de usuário usado para efetuar login. Se o agente de construção não for executado como o usuário raiz ou admin, você pode receber erros de autenticação ao testar a conexão. Para executar o agente de um ID do usuário não raiz ou não admin, defina a configuração magic_login no bfagent.conf. Essa é uma alternativa para a autenticação do sistema padrão.
Com esta definição, o sistema pode autenticar seu login com um único nome de usuário e senha. Para ver as etapas necessárias para configurar o magic_login, consulte
Referência do bfagent.conf.
Dicas para Uso de inetd ou xinetd
Se o daemon TCP/IP do UNIX® (inetd ou xinetd)
estiver instalado e ativo no sistema z/OS,
você poderá configurar o Rational Build
Agent para execução como um serviço e iniciar automaticamente. Para obter informações adicionais
sobre como configurar inetd, consulte o Centro de Informações do z/OS V1R9 em
http://publib.boulder.ibm.com/infocenter/zos/v1r9/index.jsp?topic=/com.ibm.zos.r9.cs3/cs3.htm (ou o centro de informações apropriado
para sua versão do z/OS). A configuração integral de inetd está além do escopo deste documento.
Em um exemplo simples, você poderia:
- Modificar /etc/inetd.conf incluindo esta linha:
bfagent stream tcp nowait userID /usr/lpp/jazz/v2.0/bfagent/bfagent -f /etc/jazz/bfagent.conf
- bfagent
- Nome do serviço do daemon. O padrão é bfagent (letras minúsculas). O nome deve corresponder ao nome usado em /etc/services.
- stream tcp nowait
- Instruções específicas de configuração inetd (tipo de soquete, protocolo, sinalizador de espera). Não modificar.
- ID do usuário
- ID de usuário para o processo do daemon. O padrão é OMVSKERN. Este ID de usuário deve ser um ID de usuário com um segmento de segurança OMVS válido, permissão BPX.DAEMON e permissão READ e EXECUTE para os diretórios de instalação e configuração.
- /usr/lpp/jazz/v2.0/bfagent/bfagent
- Programa do servidor (local absoluto de bfagent). O padrão é /usr/lpp/jazz/v2.0/bfagent/bfagent.
Os argumentos após este argumento inetd são os argumentos do servidor.
- -f /etc/jazz/bfagent.conf
- Diretório de trabalho (local do arquivo de configuração do servidor do Build Forge ).
O padrão é /etc/jazz/bfagent.conf.
Importante: Copie os arquivos de configuração customizados do Rational
Build Agent para um novo diretório (como /etc/jazz/) para evitar sobrescrevê-los ao aplicar manutenção. O diretório de trabalho definido aqui deve refletir esta alteração.
- Inclua o seguinte em /etc/services:
bfagent 5555/tcp #BUILD FORGE AGENT
- Atualize a porta em seu bfagent.conf para mapear em sua entrada de serviços:
port 5555
- Reinicie inetd.