El ejemplo siguiente demuestra cómo se puede ejecutar el programa de utilidad en la línea de mandatos. Para conocer la sintaxis del programa de utilidad, consulte Referencia del programa de utilidad agentupdate.
El mandato siguiente utiliza la opción –preview. Con esta opción, el programa de utilidad se conecta a los sistemas de destino e imprime los mandatos que se ejecutarían en dichos sistemas, sin ejecutarlos realmente.
java -jar agentupdate.jar -preview -targets
agent_deploy_config.xml -keyfile mykeyfile.txt
El siguiente mandato cifra todas las contraseñas en texto sin cifrar del archivo XML de entrada. El mandato no se conecta a ningún sistema remoto.
java -jar agentupdate.jar -encrypt -targets agent_deploy_config.xml
-keyfile mykeyfile.txt -logFile LogFile.txt
Este mandato actualiza o instala los agentes de IBM Rational Build Forge en los sistemas de destino. La opción –sourceDir indica qué directorio contiene los instaladores de agente para todos los destinos. Si no incluye esta opción cuando ejecute el programa de utilidad, incluya el parámetro correspondiente en el archivo XML. Si los instaladores están en un directorio común para todos los destinos del archivo XML, especifique el parámetro SourceDirectory en el elemento <Globals> del archivo XML. Sin embargo, si el directorio de origen para cualquiera de los destinos es diferente, defina el parámetro SourceDirectory en el elemento <Target> de ese sistema. Consulte el Ejemplo 2 de Archivos XML de ejemplo.
java -jar agentupdate.jar -sourceDir .\resources
–targets agent_deploy_config.xml -logFile LogFile.txt
IBM Rational Build Forge proporciona el proyecto de muestra bfagentupdate.xml que demuestra cómo se puede utilizar el programa de utilidad.
Para utilizar el proyecto de muestra, importe el proyecto utilizando el recurso de importación de la Consola de gestión o mediante el mandato bfimport. Importe el proyecto desde C:\Archivos de programa\IBM\Build Forge\samples\agentupdate\BFproject\ (Windows) o /opt/buildforge/samples/agentupdate/BFproject/ (Linux).
Un proyecto necesita tres pasos: previsualización, cifrado y ejecución. Los pasos de previsualización y cifrado no se incluyen en el proyecto de muestra.
Habilite los pasos según sus requisitos, y a continuación ejecute el proyecto.