Home
Managing change and releases
Learn how to manage change and release in the product.
Guide to building software on Linux and UNIX
Setting up a parallel build
Learn the process to set up and run builds that use several hosts in the local area network.
Setting up the client host
There are some issues in setting up the client host, so consider them.

Managing change and releases
Learn how to manage change and release in the product.
- Managing software projects
- Workflow for creating projects
- Workflow for making baselines
- Workflow for recommending baselines
- Guide to building software on Linux and UNIX
  - HCL VersionVault build concepts
    HCL VersionVault supports makefile based building of software systems and provides a software build environment closely resembling that of the make program.
  - Derived objects and configuration records
    Learn about derived objects and configuration records.
  - Pointers on using HCL VersionVault build tools
    Learn how to use VersionVault build tools.
  - Working with DOs and configuration records
    You can perform operations on derived objects and configuration records.
  - clearmake makefiles and BOS files
    The HCL VersionVault build program, clearmake can process makefiles.
  - Using clearmake compatibility modes
    clearmake is designed for compatibility with existing make programs, which minimizes the changes you need to make to your makefiles.
  - Using HCL VersionVault to build C++ programs
    Use clearmake effectively with C++ programs built with various compilers.
  - Using HCL VersionVault build tools with Java
    The build behavior of Java tools causes various problems for clearmake. Understand the problems and some possible solutions to resolve them.
  - Setting up a parallel build
    Learn the process to set up and run builds that use several hosts in the local area network.
    - Overview of parallel building
      HCL VersionVault can perform builds in which multiple processes execute in parallel the build scripts associated with the makefile targets.
    - Setting up the client host
      There are some issues in setting up the client host, so consider them.
      - Creating build hosts files
        The build hosts file is the client-side control file for parallel builds.
      - Load balancing
        The HCL VersionVault load-balancing algorithm controls the way in which build scripts are dispatched to hosts.
      - Include file facility
        Learn how a build hosts file can include contents of other build hosts files.
      - Including comments in a file
        You can include a comment on a line by itself or at the end of a hostname line.
      - Examples
        Read the examples of the build hosts file.
      - Setting up trust relationships
        For parallel building to work correctly, the client host must be trusted by the build hosts (that is, remote login from the client host to the build hosts must work without a password being needed).
    - Setting up server hosts
      Learn how to set up server hosts.
    - Starting a parallel build
      Follow the steps mentioned in this content to start a parallel build.
    - Preventing parallel builds of targets
      Follow the process mentioned in this content to prevent parallel builds of targets.
    - Preventing exponential invocations of abe
      Follow the process mentioned in this content to prevent exponential invocations of abe.
  - Building software for multiple platforms
    Learn how to address the challenge of using a single source tree to develop an application for a variety of hardware and software platforms.
  - Setting up a build on a non-VersionVault host
    There is a technique to create configuration records for a build that involves HCL VersionVault data, but is performed on a non-VersionVault host.
- Guide to building software on Windows

Setting up the client host

There are some issues in setting up the client host, so consider them.

When you set up client-side processing for parallel builds, consider the following three issues:

The number of parallel build processes to request. clearmake limits the number of concurrent target rebuilds to the value of the CCASE_CONC environment variable or the number that you specify with the -J command-line option. clearmake does not start more abe processes than specified.
The hosts to specify for builds. clearmake starts all abe processes on the local host unless you provide a build hosts file. You can specify a build hosts file with the -B command-line option or with the CCASE_HOST_TYPE environment variable.
The limitations and requirements for system loading on the build hosts. HCL VersionVault tries to keep the build machines from becoming overloaded by dispatching a build script to a host only if the host is sufficiently idle. The idleness threshold is specified in the build hosts file. If you do not specify an idleness threshold or do not use a build hosts file, clearmake submits as many build scripts as allowed by the -J or CCASE_CONC setting.