Os exemplos a seguir demonstram como é possível executar o utilitário na linha de comandos. Para a sintaxe do utilitário, consulte Referência do Utilitário agentupdate.
O comando a seguir usa a opção –preview. Com essa opção, o utilitário conecta aos computadores de destino e imprime os comandos que ele executará nesses destinos, sem realmente executar os comandos.
java -jar agentupdate.jar -preview -targets agent_deploy_config.xml -keyfile mykeyfile.txt
O próximo comando criptografa todas as senhas de texto não criptografado no arquivo XML de entrada. O comando não conecta a nenhum computador remoto.
java -jar agentupdate.jar -encrypt -targets agent_deploy_config.xml -keyfile mykeyfile.txt -logFile LogFile.txt
Esse comando atualiza ou instala agentes do IBM Rational Build Forge em computadores de destino. A opção –sourceDir indica que o diretório contém os instaladores do agente para todos os destinos. Se você não incluir essa opção quando executar o utilitário, inclua o parâmetro correspondente no arquivo XML. Se os instaladores estiverem em um diretório comum para todos os destinos no arquivo XML, especifique o parâmetro SourceDirectory no elemento <Globals> no arquivo XML. No entanto, se o diretório de origem de qualquer um dos destinos for diferente, defina o parâmetro SourceDirectory no elemento <Target> do computador. Para obter um exemplo, consulte Amostra 2 em Arquivos XML de Amostra.
java -jar agentupdate.jar -sourceDir .\resources –targets agent_deploy_config.xml -logFile LogFile.txt
O IBM Rational Build Forge fornece o projeto de amostra bfagentupdate.xml que demonstra como é possível usar o utilitário.
Para usar o projeto de amostra, importe o projeto usando o recurso de importação no Console de Gerenciamento ou usando o comando bfimport. Importe o projeto a partir de C:\Arquivos de Programas\IBM\Build Forge\samples\agentupdate\BFproject\ (Windows) ou /opt/buildforge/samples/agentupdate/BFproject/ (Linux).
Um projeto precisa de três etapas: visualização, criptografia e execução. As etapas de visualização e criptografia não estão incluídas no projeto de amostra.
Permite as etapas de acordo com seus requisitos e, em seguida, executa o projeto.