Page tree

Unsupported content


This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Skip to end of metadata
Go to start of metadata

After you are done with installing the product on the first machine, you may want to add additional machines to your deployment.


All additional machines used during the installation must use the same time zone.

Before you begin

Ensure that you have read through the Planning topic, and reviewed the Installation scenarios.

Installation options

The following options are available for installing additional machines to your existing deployment:

  • Install additional machines using the cpit user: Follow the steps described in Preparing a host for installation, then continue with Installing additional machines.

  • Install additional machines using the root user: Follow the steps in the task below. You can use an existing user or create a new user during installation.


    All steps marked with (tick) are available only if you run the installer using the root user.

Installing additional machines

To install additional machines to run BMC Capacity Optimization in an existing setup, reiterate the following task for each machine that you want to install:

  1. Unzip and extract the installation files: In the temporary directory that you created while Preparing a host for installation, unzip and extract the file.

    Unzip command with example

    gunzip Capacity_Optimization_<ProdVer>_<OSver>_<Arch>.tar.gz

    gunzip Capacity_Optimization_ver9.5_RHEL5_x86-64.tar.gz

    Extract command with example

    tar -xvf Capacity_Optimization_<ProdVer>_<OSver>_<Arch>.tar

    tar -xvf Capacity_Optimization_ver9.5_RHEL5_x86-64.tar

  2. Change the directory: After extracting the installation files, change the directory to: ./BCO/Disk1.

  3. Set the DISPLAY environment: Your DISPLAY environment must be set correctly to enable the Installer UI to launch.

    If the machine has a local graphical console: Set the DISPLAY environment variable to start the installer UI locally.
    DISPLAY=<Local IP Address>:0.0
    export DISPLAY

    If the machine does not have a local graphical console: Set the DISPLAY environment variable to export to an XServer on a different workstation.

    Note: On the other workstation, give access grants to every incoming X window. That is, if the workstation is a Linux machine, or running X over a bash shell for Windows, type the command xhost +

    export DISPLAY
  4. Open the installation program: At the shell prompt, type the following command and press Enter./

  5. Welcome screen and EULA: In the product installation Welcome screen, click Next, agree to the the End User License Agreement (EULA), and click Next again.

  6. Directory Selection: In the Directory Selection screen, type the installation directory (default: /opt/bmc/BCO) you want to install the product to, or click Browse to select a directory of your choice, then click Next.


    Avoid using the home directory of the user as the installation directory.

  7. (tick) Enter a username: In the BMC Capacity Optimization User screen, provide a username (new or existing user) for running the product after the installation, and click Next. The installer will not proceed with the default entry, root, in the username box.

  8. Select the installation step: In the Installation Step screen, select Install additional machines, and click Next. (To install the first machine, see Installing the first machine.)

  9. Select the type of installation: In the Select Install Setup Type screen, select any one of the following options and click Next.
    1. Typical Setup: Application Server: Install all Application Server components, including ETL engine for troubleshooting purposes. 
    2. Custom Setup: Select check-boxes for components you want to install, and clear for those you do not want to.

      Performing a typical setup

      Typical Setup: Application Server
      Connect with existing BMC
      Capacity Optimization Server
      Select any of the following options, enter the required information, and click Next.
      Direct connectionThe server you are installing connects to the existing application server over a direct connection. This machine can directly access the BMC Capacity Optimization database. Enter the following information:
      • Web Server Address: The address of the web server.
      • Custom Direct Connection: Enter the following information:
        • Protocol: Select HTTP or HTTPS.
        • Web Port: Default is 8000 for HTTP and 8443 for HTTPS.
      Remote ConnectionThe server you are installing connects to the existing application server over a remote connection. This machine is located on a remote network with an unstable or slow connection and has only HTTP visibility to the
      BMC Capacity Optimization Datahub. Enter the following information:
      • External Data API Server Name
      • Custom Remote Connection: Enter the following information:
        • Data API Protocol: Select http or https.
        • Data API Port: Default is 8000.
        • Control Port: Default is 61616
      Oracle Database InformationEnter information for connecting to the Oracle database and click Next.
      • Oracle Client Home: Address of your Oracle Client's Home directory.
      • Oracle Alias: Name of your Oracle Alias (TNS).

      To finish a Typical Install on an additional machine, go to Step 10.

      Performing a Custom setup

      Custom Setup
      Select the Components

      Select the components to install:
      BMC Capacity Optimization 9.5.00 InstallationSelects all components. If you select this option, the installation is similar to a Typical install.

      Install Database Schema 9.5.00

      Install and set up the database schema.

      Install Application Server 9.5.00

      If you install the Web Server before installing Datahub, an error is displayed on the web console home page. The Application Server machine will stay in a suspended state until the Datahub is installed and registered in the database.

      Install the following Application Server components:
      • Install Web Server 9.5.00: Install the web server.
      • Install Datahub 9.5.00: Install the BMC Capacity Optimization Datahub.
      • Install Primary Scheduler 9.5.00: Installs the Primary Scheduler.
      Install ETL Engine Server9.5.00Install the following ETL Engine Server components:
      • Install ETL Engine 9.5.00: Install the ETL Engine.
      • Install Data Accumulator (Deprecated) 9.5.00: Install the Data Accumulator.
      Connect with existing BMC
      Capacity Optimization Server
      The task from this screen onwards (including this screen) is the same as that for performing a Typical Setup for an additional machine.
  10. Installation PreviewIn the Installation Preview screen, verify all the installation settings, and click Install.
    The installation can take up to 15 minutes to complete.

    For information on installer related error codes, see Working with error codes.

  11. Installation Summary: The Installation Summary screen tells you whether or not your installation was completed successfully. To view the installation log, click View Log on this screen, else proceed with Step 12.
  12. Click Done to finish the installation and exit the installer.

Related topics

Installing silently

Installing the first machine