Installing the agent on UNIX and Linux systems

Follow the installation instructions for your platform:

AIX
1. Use the aix5-bfagent-<version>.tar.gz file or aix5np-bfagent-<version>.tar.gz file.
  The aix5np file does not contain support for PAM authentication.
  
  Important:
  If you install the aixnp agent to run as root, at runtime the agent will use an AIX authentication call to authenticate, using the Server Authentication credentials that you specify. If you do not install the agent to run as root, then you must also use the magic_login setting in the bfagent.conf file to restrict access to it.
2. Extract the file by entering this command:
```
gzip -d gzipfilename.gz
```
3. Extract the file by entering this command:
```
tar xvf tarfilename.tar
```
4. Install the agent by entering this command:
```
cd extracted-agent-directory
./install.sh
```
  Important: If an agent is compiled for AIX with the configure option -–without-pam, authentication for the agent is turned off.
  
  If it is then installed with root privilege, it allows people to connect as any valid user regardless of the password that they specify.
  
  If you must compile an agent to run on an AIX system that does not use PAM, be sure to use a dedicated account for the agent, install it to run as that user, and use the magic_login setting in the bfagent.conf file to restrict access to it.
HP-UX
1. Ensure the Rational^® Build Forge^® agent can locate all the operating system commands you specify in your projects. You can accomplish this task using either of the following options:
  - Edit the system's /etc/PATH file to include all the required directories.
  - Specify the nologonshell setting in the bfagent.conf file on the HP-UX system. This setting prevents Build Forge^® from processing /etc/profile. You must then specify a value for PATH and any other required settings from /etc/profile in a Build Forge^® environment that you apply to each project.
2. Get the hpux11-bfagent-<version>.tar.gz file from the installation media. Place it where you want the agent installed.
3. Extract the file.
```
gzip -d gzipfilename.gz
```
4. Extract from the tar file.
```
tar xvf tarfilename.tar
```
5. Install the agent.
```
cd extracted-agent-directory
./install.sh
```
6. Modify the following line in /etc/profile to enable the agent to run commands in a non-interactive login shell.
```
if [ ! $VUE]
```
  Change the line to the following:
```
if [ -z "$VUE" -a -n "$PS1" ]
```
Mac OS
1. Get the mac-bfagent-<version>.dmg file from the installation media and place it where you want it.
2. Double-click the file to extract its components.
Red Hat Linux
1. Get the rh9-bfagent-<version>.rpm (Red Hat Enterprise Linux 4) or rhel5-bfagent-<version>.rpm file (Red Hat Enterprise Linux 5) from the installation media
2. Enter this command:
```
rpm -iUvh rh9-bfagent-<version>.rpm
```
Solaris
1. Use the sol9-bfagent-<version>-sparc-opt.gz file for Solaris 9 or Solaris 10 on SPARC.
2. Extract the package:
```
gzip -d solN-bfagent-<version>-platform-opt.gz
```
3. At a command prompt, enter this command:
```
pkgadd -d ./unzipped-package
```
Other Platforms - Compiling from Source
If you need an agent for another platform, use the src-bfagent-<version>.tar.gz file to compile the agent from the source:
1. Extract the downloaded tar file.
2. Run the configure script located in the src directory.
  To configure for SSL, the option is:
```
./configure --with-ssl=/usr/include/openssl 
```
  To configure for both SSL and password encryption, the option is:
```
./configure --with-ssl=/usr/include/openssl --enable-bfcrypt-dll 
```
3. Run the make command in the src directory.
The source pack requires the GNU C compiler or the C compiler for your system. The source pack and prebuilt agents that do not include an installer for the local computer include an installer to install the agent in the system's inetd/xinetd configuration files of the computer.