You install Build Catalyst on Linux® and Solaris
operating systems by using the Build Catalyst archive file.
About this task
To use Build Catalyst for a distributed build, install it
on all the computers that are used in the distributed build.
Procedure
- Download the Build Catalyst archive file from http://hostname/buildcatalyst,
where hostname is your Management Console host.
- Extract the archive file into any directory.
- Become superuser, by entering su,
if you are not the superuser.
- Go to the directory where you extracted the installer,
and then go to the new subdirectory that contains the install.sh file.
- Run ./install.sh in that directory.
- Specify an installation directory. (The default directory
is /opt/rational/buildforge/buildcatalyst.)
If an installation already exists (even if it is in
a location other than the one you provided), the installer warns that
the existing installation will be overwritten or rendered unusable
if you proceed with the installation. (An existing installation not
in the default directory can be rendered unusable because the current
installation process creates symbolic links from the default installation
directory to the newly specified installation directory.) The installer
then prompts for the installation directory again. After you provide
an installation location, the installation writes the files to the
provided location.
- Specify which rsh or ssh binary
file to use for distributed builds (The default program is rsh,
if found in the path.)
The Build Catalyst binary file is installed as rafmake in
the bin directory in the installation directory. The installation
creates the following items: - A symbolic link from /opt/rational/buildforge/buildcatalyst to
the installation directory.
- A symbolic link from etc/rafbe_starter in
the installation directory to the shell binary file. The shell binary
file is either rsh or ssh.
Results
You can now start
rafmake from your
IBM® Rational® Build
Forge® jobs
to build your C or C++ software. You can also start
rafmake independently
of your Rational Build Forge jobs.