Installing Build Catalyst on Linux and Solaris operating systems

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

  1. Download the Build Catalyst archive file from http://hostname/buildcatalyst, where hostname is your Management Console host.
  2. Extract the archive file into any directory.
  3. Become superuser, by entering su, if you are not the superuser.
  4. Go to the directory where you extracted the installer, and then go to the new subdirectory that contains the install.sh file.
  5. Run ./install.sh in that directory.
    1. 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.

    2. 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.

Feedback