다음 예제에서는 명령행에서 유틸리티를 실행할 수 있는 방법을 설명합니다. 유틸리티 구문은 agentupdate 유틸리티 참조의 내용을 참조하십시오.
다음 명령은 –preview 옵션을 사용합니다. 이 옵션을 사용하여 유틸리티를 대상 컴퓨터에 연결하고 실제로 명령을 실행하지 않고 해당 대상에서 실행하는 명령을 인쇄합니다.
java -jar agentupdate.jar -preview -targets agent_deploy_config.xml -keyfile mykeyfile.txt
다음 명령은 입력 XML 파일의 모든 일반 텍스트 비밀번호를 암호화합니다. 명령은 원격 컴퓨터에 연결하지 않습니다.
java -jar agentupdate.jar -encrypt -targets agent_deploy_config.xml -keyfile mykeyfile.txt -logFile LogFile.txt
이 명령은 대상 컴퓨터에 IBM Rational Build Forge 에이전트를 설치하거나 업데이트합니다. –sourceDir 옵션은 모든 대상의 에이전트 설치 프로그램을 포함하는 디렉토리를 표시합니다. 유틸리티를 실행할 때 이 옵션을 포함시키지 않는 경우 XML 파일에 해당 매개변수를 포함시키십시오. 설치 프로그램이 XML 파일에서 모든 대상의 공통 디렉토리에 있는 경우 XML 파일에 있는 <Globals> 요소에 SourceDirectory 매개변수를 지정하십시오. 그러나 대상 중 하나의 소스 디렉토리가 다른 경우 해당 컴퓨터의 <Target> 요소에서 SourceDirectory 매개변수를 정의하십시오. 예제는 샘플 XML 파일의 샘플 2를 참조하십시오.
java -jar agentupdate.jar -sourceDir .\resources –targets agent_deploy_config.xml -logFile LogFile.txt
IBM Rational Build Forge는 유틸리티를 사용할 수 있는 방법을 설명하는 bfagentupdate.xml 샘플 프로젝트를 제공합니다.
샘플 프로젝트를 사용하려면 관리 콘솔에서 가져오기 기능을 사용하거나 bfimport 명령을 사용하여 프로젝트를 가져오십시오. C:\Program Files\IBM\Build Forge\samples\agentupdate\BFproject\(Windows) 또는 /opt/buildforge/samples/agentupdate/BFproject/(Linux)에서 프로젝트를 가져오십시오.
이 프로젝트에는 미리보기, 암호화 및 실행의 세 단계가 필요합니다. 샘플 프로젝트에는 미리보기 및 암호화 단계가 포함되지 않습니다.
사용자의 요구사항에 따라 단계를 사용하도록 설정하고 프로젝트를 실행하십시오.