Instalação e Execução do Agente no z/OS

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:
  1. 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.
  2. 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.
  3. 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:
  1. 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.
  2. Inclua o seguinte em /etc/services:
    bfagent 5555/tcp #BUILD FORGE AGENT
  3. Atualize a porta em seu bfagent.conf para mapear em sua entrada de serviços:
    port 5555
  4. Reinicie inetd.

Feedback

Isto ajudou? Você pode fornecer feedback em Jazz.net (registro necessário): Comment in the forums ou submit a bug