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. The filename for the installation program is win-bfagent-version.exe.
   Tip: 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 overwrite it. Click OK. Default: OK.
3. After the Welcome message opens, click Next.
4. If you agree to the terms of license agreement, click I Agree.
5. In the Choose Install Location window, set the Destination Folder, and then click Next. Use the default location C:\Program Files\IBM\Build Forge\Agent so that the file can be easily located.
6. In the Configuration window, choose the Agent Options that you want, and then click Install.
7. Select one of the following installation methods:
   • Install as a service
   • Install User Mode Agent

     Select a user mode agent only if the agent must be able to run a GUI application.

   Note: When the Build Forge agent is installed on Windows 7 and you select the User Mode, a reboot is required.
8. Optional: Click Enable Cygwin Support
   Tip: If you use the Cygwin Linux ^® emulation environment, you can choose to install Cygwin support when you install the agent. If you install Cygwin support, do the following steps.
   1. During Cygwin installation, choose DOS/text line endings.
   2. 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.
9. Specify the Port that the agent uses to communicate with the Management Console. The default port is 5555.
10. At the Completing Setup panel, click Finish.