建立 XML 檔之後,您可以在指令行上,或是透過提供的 BuildForgeAgentUpdateUtilityProject 來執行代理程式更新及部署公用程式。
下列範例將示範如何在指令行上執行公用程式。如需公用程式語法,請參閱 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) 匯入該專案。
專案需要三個步驟:預覽、加密及執行。專案範例不包含預覽和加密步驟。
請根據您的需求執行上述步驟,然後執行該專案。