Agent update and deployment utility

The agent update and deployment utility, agentupdate, simplifies installing and updating the IBM Rational Build Forge agent on multiple computers.

Rational Build Forge agents are required on all computers where Rational Build Forge automates tasks. Installing or updating the agent on numerous computers can be time-intensive. This utility can install or update the agent on all target computers at the same time. You can start the utility on the command line or through a project that Rational Build Forge provides. The utility uses an XML file that you provide to determine the target computers, login credentials for those computers, connection methods, and related information.

Important: The tool supports a one-way installation or upgrade operation.

When you start the utility, it completes actions for each target computer:

  1. Logs in to the computer
  2. Determines the operating system
  3. Stops any running agent

    You can use a customized command you have for stopping Rational Build Forge agents by using the StopCommand parameter in the XML file that you use with the utility.

  4. Determines whether the computer has enough available temporary space
  5. Copies the agent installer for the operating system to the target computer
  6. Runs the installer to update or install the agent on the computer

    This process preserves your BFAgent.conf file if the agent is in the default location. The process also preserves the file if the agent is in another location that you specify by using the ExistingAgentPath parameter in the XML file that you use with the utility.

  7. Removes the installer from the temporary space
Note: The utility also creates a log file to capture a history of its operations. This log file is stored on the computer where the utility runs.

Feedback