Configurando o Rational Build Agent no z/OS para Iniciar por meio de InetD

É possível configurar o Rational Build Agent para iniciar automaticamente quando o servidor for reiniciado utilizando o daemon de Internet (InetD).

Sobre Esta Tarefa

O Build System Toolkit é enviado com um script shell (startbfa.sh) para z/OS que pode ser customizado para iniciar o Rational Build Agent no z/OS UNIX System Services (USS). O script estabelece o ambiente do sistema necessário e, em seguida, inicia o agente como um daemon independente. Em vez de utilizar o script, é possível configurar o Rational Build Agent para iniciar automaticamente com o ambiente do sistema necessário quando o servidor for reiniciado. Conclua as seguintes etapas para incluir o agente de construção em sua configuração do InetD.

Procedimento

Atualize os arquivos de configuração do InetD

  1. Defina o serviço do Rational Build Agent (bfagent) em seu sistema USS incluindo a seguinte linha no arquivo /etc/services:
    bfagent       8888/tcp    #Rational Build Agent
  2. Substitua 8888 pelo número da porta definido na propriedade de portabfagent.conf. Essa linha mapeia o serviço nomeado bfagent para a porta especificada. Ao receber uma solicitação de serviço na porta especificada, o InetD ativará o serviço bfagent conforme definido no arquivo de configuração do InetD.
  3. Inclua a linha a seguir em /etc/inetd.conf para definir o serviço para o InetD:
    stream tcp nowait <user>   <agentPath>/bfagent bfagent -f <configPath>/bfagent.conf 
    Em que:
    1. <user> é o ID do usuário do RACF sob o qual o serviço deve ser executado
    2. <agentPath> é o caminho completo para o arquivo executável bfagent
    3. <configPath> é o caminho completo para o arquivo de configuração bfagent.conf
  4. Depois que o serviço foi definido, o daemon InetD deve ser forçado para reler a configuração. Há várias opções para forçar o daemon a reler a configuração; o método mais fácil é parar o daemon e reiniciá-lo utilizando o seguinte comando:
    kill `cat /etc/inetd.pid`
    /usr/sbin/inetd /etc/inetd.conf

Configurar o Ambiente de Construção

  1. Quando o Ant com construções do Enterprise Extensions estão em execução, o bfagent requer que diversas variáveis de ambiente sejam definidas. Essas variáveis geralmente são definidas pelo script startbfa.sh e exportadas antes de iniciar o daemon bfagent. Para executar construções quando você está executando o agente por meio de InetD, você deve definir as seguintes variáveis:
    • HOME
    • ZLANG
    • _TIMEOUT
    • _CMDSRV
    • _BASE_HOME
    • SCM_WORK
    • BLD_TOOLKIT
    • JAVA_HOME
    • JAZZ_USER
    • JAZZ_PASSWORD_FILE
    • STEPLIB
    • ANT_HOME
    Para localizar os valores esperados dessas variáveis e para determinar quais são necessários para seu ambiente, consulte os comentários no script startbfa.sh, que está localizado no seguinte diretório: @pathPrefix@/usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/startbfa/startbfa.sh.
    Nota: Algumas dessas variáveis podem não ser necessárias para sua configuração.
  2. Defina essas variáveis como propriedades de um mecanismo de construção em sua área do projeto. Para definir as variáveis:
    1. Defina um mecanismo de construção de tipo do Rational Build Agent. Para obter detalhes, consulte Usando o Ant com o Editor de Definção de Construção do Enterprise Extensions
    2. No editor de definição de construção, especifique a porta definida no arquivo /etc/services.
    3. Na guia Visão geral do editor do mecanismo de construção, na seção Propriedades, defina as variáveis listadas acima.

Feedback