Especificando Sistemas de Destino em um Arquivo XML

Use um arquivo XML para especificar os sistemas de destino no qual atualizar ou instalar o agente.

Visão Geral do Arquivo XML

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>

Sintaxe do Arquivo XML

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.

Arquivos XML de Amostra

Estas amostras demonstram como você pode usar os arquivos XML.


Feedback