BuildForge Help

Installing the Agent on Windows Platforms

To install the agent on Windows platforms:

  1. Locate and start the agent installation program in the installation media, win-bfagent-version.exe.
    Note: The Launch Pad starts this installation process when you choose Rational Build Forge Agent Installation.
  2. If the installer detects an existing version of the agent, it prompts you to confirm to install over it. Click OK. Default: OK.
  3. At the Welcome panel, click Next.
  4. At the License Agreement panel, click I Agree.
  5. At the Choose Install Location panel, set the Destination Folder you want, then click Next. The default location is recommended: C:\Program Files\IBM\Build Forge\Agent.
  6. At the Configuration panel, choose the Agent Options you want, then click Install:
    • Choose one of: Install as a service (the default) or Install User Mode Agent. A user mode agent is necessary only if the agent must be able to run a GUI application.
    • Enable Cygwin Support
      Default: No. If you use the Cygwin Linux® emulation environment, you can choose to install Cygwin support when you install the agent. Doing so causes the agent to use the Cygwin bash shell as the default console. If you install Cygwin support, be sure to do the following:
      • During Cygwin installation, choose DOS/text line endings.
      • In projects, use UNIX®-style syntax for commands.
        Important: Cygwin works only with US ASCII. It does not support UTF-8, so it cannot be used with any other systems.
    • Port: The port the agent uses to communicate with the Management Console. 5555 is the default.
  7. At the Completing Setup panel, click Finish.