O utilitário de atualização e implementação do agente requer que um arquivo XML determine os computadores no qual atualizar ou instalar agentes. Esse arquivo também deve especificar as credenciais de login e outros itens que o utilitário precisa.
O arquivo tem os seguintes requisitos:
O exemplo a seguir mostra um elemento <Target> único e um elemento <Globals>. O elemento <Globals> não é útil se for usado apenas com um único elemento <Target>. O elemento <Globals> pode ser útil quando você possui diversos elementos <Target>.
<?xml version="1.0" encoding="UTF-8"?>
<AgentDeploymentAndUpdate>
<Target id="9.184.112.152">
<Parameter Name="ConnectionType" Value="ssh"/>
<Parameter Name="UserName" Value="root"/>
<Parameter Name="Password" Value="passWord"/>
<Parameter Name="ExistingAgentPath" Value="/usr/local/bin/bfagent"/>
<Parameter Name="GZIPPath" Value="/usr/contrib/bin/"/>
</Target>
<Globals>
<Parameter Name="KeyFile" Value="..\test\keyfile.txt"/>
</Globals>
</AgentDeploymentAndUpdate>
Cada elemento <Parameter> é válido nos elementos <Target> e <Globals>. Com essa flexibilidade, se os parâmetros se aplicarem a todos os computadores de destino, você poderá usar os elementos <Target> para especificar apenas os atributos do id e inserir cada elemento <Parameter> no elemento <Globals>.
Especificar um parâmetro com Value="" é igual a não especificar o parâmetro.
Estas tabelas descrevem a sintaxe do arquivo.
Atributo de destino | Valor |
---|---|
id | O nome ou endereço IP de um computador de destino. |
Parâmetro | Valor |
---|---|
AgentInstallLocation | Para sistemas IBM AIX, HP-UX e Windows apenas - não há efeito em outras plataformas Local para inserir o novo agente. Se não estiver especificado, o diretório temporário padrão do sistema será usado. |
BFAgentPort | Para sistemas IBM AIX e HP-UX apenas A porta do agente a ser usado. Usado ao gerar arquivos de resposta. |
BFASolarisAdminFile | Para sistemas Solaris apenas Local no sistema de destino no qual armazenar arquivos de resposta para instalação silenciosa. Se não estiver especificado, o diretório temporário padrão do sistema será usado. |
BFASolarisResponseFile | Para sistemas Solaris apenas Local no sistema de destino no qual armazenar arquivos de resposta. Se não estiver especificado, o diretório temporário padrão do sistema será usado. |
ConnectionType | UNIX ou Linux: SSH ou RSH Windows: SSH, RSH, SMB ou CIFS (RSH é o shell remoto. SMB é Server Message Block. CIFS é Common Internet File System.) |
ConnectionPort | (Opcional) Número de porta a ser usado para o tipo de conexão especificada (com o parâmetro ConnectionType) se o destino não usar a porta padrão. Se o destino usar a porta padrão, você não precisará especificar esse parâmetro. |
ExistingAgentPath | Necessário para sistemas IBM AIX, HP-UX e Windows. Local do agente existente no computador de destino. O utilitário cria um backup do arquivo BFAgent.conf no local especificado e restaura-o após a conclusão da instalação ou do upgrade. Para outros sistemas, o local padrão da instalação do sistema é usado. |
GZIPPath | Sistemas IBM AIX, HP-UX e Solaris. O diretório onde o instalador do agente pode localizar o comando gzip (que extrai o instalador). |
IsSudoEnabled | Configure como sim se sudo estiver ativado nos sistemas de destino e você pretender usá-lo. ConfigureSudoPassword como a senha correta de sudo. Se não estiver configurada, o utilitário tentará usar Password para o login de sudo. |
KeyFile | O arquivo que está no computador em que você executa o utilitário que armazena as chaves usadas para criptografia e decriptografia de senhas. |
LocalTempLocation | Para IBM AIX, HP-UX e Windows. Local no sistema de destino no qual armazenar arquivos de resposta. Se não estiver especificado, o diretório temporário padrão do sistema será usado. Para sistemas Solaris, use BFASolarisResponseFile ou BFASolarisAdminFile. |
ManagedScriptsDir | Configure como o diretório em que o utilitário é executado. Esse diretório está no computador em que você executa o utilitário agentupdate. |
SourceDirectory | Diretório que armazena os instaladores (nos formatos .exe, .rpm e .gz) para os computadores de destino. Esse diretório está no computador em que você executa o utilitário agentupdate. |
StartCommand | (Opcional) O comando customizado que você tem para iniciar agentes do Rational Build Forge no computador de destino. Assegure-se de que o comando esteja incluído na variável PATH/path ou forneça o caminho completo no arquivo XML. |
StopCommand | (Opcional) O comando customizado que você tem para parar agentes do Rational Build Forge no computador de destino. Assegure-se de que o comando esteja incluído na variável PATH/path ou forneça o caminho completo no arquivo XML. |
SudoPassword | A senha a ser usada para sudo. Consulte IsSudoEnabled. |
Password | A senha a ser usada para UserName ao efetuar logon no computador de destino. Importante: Você define inicialmente o parâmetro Password no texto não criptografado no arquivo XML. Criptografe a senha usando a opção da linha de comandos –encrypt conforme demonstrado em Executando o Utilitário agentupdate.
|
TemporaryLocation | Local no computador de destino no qual armazenar o instalador antes de você executar o utilitário. |
UseManagedScripts | Configure como sim ou não. Se configurar como sim, o utilitário tentará localizar StartCommand e StopCommand no diretório ManagedScriptsDir. |
UserName | O nome de usuário a ser usado ao efetuar logon no computador de destino. |
Estas amostras demonstram como você pode usar os arquivos XML.
Essa amostra tem apenas um destino. O endereço IP de destino é 9.164.259.143. O elemento <Target> não inclui os parâmetros opcionais SourceDirectory ou TemporaryLocation. No entanto, o elemento <Globals> tem um parâmetro SourceDirectory. O utilitário usa esse valor de parâmetro para o destino.
<?xml version="1.0" encoding="UTF-8"?>
<AgentDeploymentAndUpdate>
<Globals>
<Parameter Name="SourceDirectory" Value="..\test"/>
<Parameter Name="KeyFile" Value="..\test\keyfile.txt"/>
</Globals>
<Target id="9.164.259.143">
<Parameter Name="ConnectionType" Value="ssh"/>
<Parameter Name="UserName" Value="root"/>
<Parameter Name="Password" Value="toor"/>
<Parameter Name="ExistingAgentPath" Value="/usr/local/bin/bfagent"/>
<Parameter Name="AgentInstallLocation" Value="/usr/local/bin/bfagent"/>
</Target>
</AgentDeploymentAndUpdate>
Essa amostra tem quatro destinos. No entanto, nenhum dos destinos requer parâmetros específicos para ele. Portanto, todos os parâmetros são especificados na seção <Globals>, incluindo UserName, Password e ConnectionType.
<?xml version="1.0" encoding="UTF-8"?>
<AgentDeploymentAndUpdate>
<Globals>
<Parameter Name="SourceDirectory" Value="..\test"/>
<Parameter Name="ConnectionType" Value="ssh"/>
<Parameter Name="UserName" Value="root"/>
<Parameter Name="Password" Value="toor"/>
<Parameter Name="TemporaryLocation" Value="/tmp"/>
<Parameter Name="ExistingAgentPath" Value="/usr/local/bin/bfagent"/>
<Parameter Name="AgentInstallLocation" Value="/usr/local/bin/bfagent"/>
<Parameter Name="KeyFile" Value="..\test\keyfile.txt"/>
</Globals>
<Target id="9.164.259.143">
</Target>
<Target id="9.164.102.169">
</Target>
<Target id="9.164.102.196">
</Target>
<Target id="9.106.189.157">
</Target>
</AgentDeploymentAndUpdate>
É possível especificar um intervalo de endereços IP para os sistemas de destino. O exemplo a seguir trabalha nos endereços IP 9.184.112.152 a 9.184.112.160 que usam as mesmas credenciais de login em cada sistema: login root, senha password.
<?xml version="1.0" encoding="UTF-8"?>
<AgentDeploymentAndUpdate>
<Target id=”9.184.112.152-160”>
<Parameter Name="ConnectionType" Value="ssh">
<Parameter Name="ConnectionPort" Value=""/>
<Parameter Name="UserName" Value="root">
<Parameter Name="Password" Value="passWord">
</Target>
</AgentDeploymentAndUpdate>
Se todos os destinos tiverem as mesmas propriedades (tipo de conexão, porta de conexão, nome de usuário, senha), então essas propriedades podem ser especificadas na seção Globals do arquivo.
<?xml version="1.0" encoding="UTF-8"?>
<AgentDeploymentAndUpdate>
<Globals>
<Parameter Name="ConnectionType" Value="ssh">
<Parameter Name="ConnectionPort" Value="">
<Parameter Name="UserName" Value="root">
<Parameter Name="Password" Value="passWord">
</Globals>
<Target id=”9.184.112.152-160”>
</Target>
<Target id=”9.184.80.12-16”>
</Target>
</AgentDeploymentAndUpdate>