Follow the installation instructions for your platform:
- AIX
- 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.
- Extract the file by entering this command:
gzip -d gzipfilename.gz
- Extract the file by entering this command:
tar xvf tarfilename.tar
- 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 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
- 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.
- Get the hpux11-bfagent-<version>.tar.gz file
from the installation media. Place it where you want the agent installed.
- Extract the file.
gzip -d gzipfilename.gz
- Extract from the tar file.
tar xvf tarfilename.tar
- Install the agent.
cd extracted-agent-directory
./install.sh
- 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" ]
- Red Hat Linux and SuSE Linux
- Get the rh9-bfagent-<version>.rpm (Red Hat Enterprise
Linux 4 or SuSE Linux 10) or rhel5-bfagent-<version>.rpm
file (Red Hat Enterprise Linux 5) from the installation media
- Use the RPM utility to install the files.
rpm -iUvh rh9-bfagent-version.rpm
- Solaris
- Use the sol9-bfagent-<version>-sparc-opt.gz file for
Solaris 9 or Solaris 10 on SPARC.
- Extract the package:
gzip -d solN-bfagent-<version>-platform-opt.gz
- 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:
- Extract the downloaded tar file.
- Run the configure script located in the src directory.
To
configure for SSL, use the following the option:
./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
- 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.