Administer > Content utilities > Install the cbt command

Install the cbt command

The cbt command comes installed and ready to use on your SA core servers.

If you want to use the cbt command on any other Unix server, you need to install it manually, as described in this section. Cbt can also be installed on any Unix-based managed server automatically by creating a software policy.

The cbt command can be run on any Unix computer with network access to an SA mesh. Although the cbt command is not supported on the Windows platform, it does support import and export of Windows content.

To install the cbt command on a Unix server other than the SA Core:

  1. Log on as root to the Unix server where you want to install the cbt command. The server must have access to an SA mesh.
  2. You can obtain the cbt archive, cbt-<version>.zip, via the SA installation media or on the SA Core:
    1. On the SA Core, find the cbt archive in the SA Library under: Opsware/Tools/CBT
    2. On the HPE Server Automationinstallation media, find the cbt-<version>.zip file in the packages subdirectory.
  3. Copy the cbt archive to the directory where you want to install it.
  4. Unzip the archive.
  5. Configure your Java Runtime Environment (JRE):
    1. If you do not already have them, download JRE 1.4.x or JDK 1.8.x or later either from www.oracle.com or from http://www.azul.com/downloads/zulu/zulu-linux/, and install it on the server where you have logged in.
    2. Set your JAVA_HOME environment variable to point to your Java installation. For example, in csh you would issue the following command:
      % setenv JAVA_HOME <java installation>
    3. Optionally, you can set the PATH environment variable to include the cbt install directory: <cbt_install_directory>/bin.
  6. To verify that you can run the cbt command, enter the following commands:
    % cd <cbt_install_directory>/bin
    % ./cbt -v


    The -v option displays the command’s version string.

    On some servers, the cbt command displays the following error:
    Error occurred during initialization of VM
    Could not reserve enough space for object heap


    If this error occurs, edit the cbt script, changing the value of the -Xmx option in jargs to a lower value, for example: -Xmx512m.