Page tree
Skip to end of metadata
Go to start of metadata

This topic describes how you can install BMC TrueSight Capacity Optimization on your machine.

Before you begin

Before you begin installing the product, ensure that you have read through Planning topic.

If you are performing the installation as a non-root user, ensure that you have completed all the procedures explained in Setting up the installation environment.

Installation scenarios

You can install BMC TrueSight Capacity Optimization on a single machine or install individual components on separate machines.

Single machine installation

Installing the Application Server and componentsInstall all components on the same machine

Multiple machine installation

Installing the Application Server and componentsMinimum components required
BMC TrueSight Capacity Optimization 10.3.00
Database Schema 10.3.00
Application Server - Web Server 10.3.00
Installing additional machinesInstall one or more 1 component per machine
Application Server - Datahub 10.3.00 2
Application Server - Primary Scheduler 10.3.00
ETL Engine Server 10.3.00

1 It is recommended that you install front-end components (such as Web Server) and back-end components (such as Datahub and Primary Scheduler) on separate machines. If required, you can install individual back-end components on separate machines.
If you install Application Server components on multiple machines, you must provide each of them with access to a shared content repository. For more information, see Sharing the Content Repository directory.

2 You can install only one instance of the Datahub. An error will be displayed, if you attempt to install multiple instances.

Installation options

The following options are available for installing the product:

  • Install using the root user: Follow the steps in the task below. You can use any existing user or create a new user for the product during installation. You can also enter the details required for setting up a shared repository.


    • If you are installing as a root user, the installer displays the option to set the name of the new user. If the user exists, that user is associated to a specific OS group (cpit - gid: 87654321). If this OS group does not exist, this OS group will be created. If the installer is executed by a user of the OS group, no changes will be applied to that user and associated groups.
    • BMC strongly recommends that you use the root user to install BMC TrueSight Capacity Optimization. Several steps in the installation process (marked with (tick) in the procedure below) are available only if you run the installer using the root user.
  • Install using the cpit user: Follow the steps described in Setting up the installation environment, then continue with Installing the Application Server and components. Some of the screens are available only when the installation is run using the root user.

Installing Application Server and components

Additional Information

A typical product install requires approximately 3 GB of available storage. The Data Warehouse aging configuration can be specified during installation and will impact the disk space required on the database server.

To install the first machine to run BMC TrueSight Capacity Optimization in a new setup, perform the following task:

  1. Unzip and extract the installation files: In the temporary directory that you created, unzip and extract the installation archive by using the following commands.

    Unzip command with example

    gunzip TSCO_AppServer_<ProdVer>_<OS>.tar.gz

    gunzip TSCO_AppServer_ver10.3.00_Linux.tar.gz

    Extract command with example

    tar -xvf TSCO_AppServer_<ProdVer>_<OS>.tar

    tar -xvf TSCO_AppServer_ver10.3.00_Linux.tar

    Ensure that the directory permissions are preserved during extraction. This avoids any folder permission related errors when you are installing from a read-only location.

    BMC recommends you to retain the installation archive if you plan on installing additional machines to your deployment.

  2. Change the directory: After extracting the installation files, change to the directory where you extracted the install files. For instance BCO/Disk1.

  3. Set the DISPLAY environment: Set the DISPLAY environment 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 workstation used to display the UI, provide access grants to every incoming X window. If the workstation is a Linux machine, or running X over a bash shell for Windows, type the command xhost +

    export DISPLAY
  4. Run the installation: At the shell prompt, type ./ and press Enter.


    You can start another session and type tail –f on the installation log (bco_install_log.txt) to view detailed messages during the installation that will help debug installation issues.

  5. Welcome screen and EULA: At the product installation Welcome screen, click Next. Agree to 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) to which you want to install the product, or click Browse to select a directory on your system, and click Next.

    Avoid using the home directory of the user as the installation directory.
  7. (tick) Enter a username: In the BMC TrueSight 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 the first machine and click Next. (To install an additional machine, see Installing additional machines.)

  9. Select the type of installation: In the Select Install Setup Type screen, select Typical Setup: Application Server or Custom Setup and click Next.
  10. Connect with existing BMC TrueSight Capacity Optimization Server: Select one of the options given below:

    Direct connectionThis machine is able to directly access the Database. Enter details for the Web Server Address, Protocol, Web Port.
    Remote connectionThis machine is located on a remote network with an unstable or slow connection, and only has HTTP visibility to the DataHub.

  11. Installation Preview: In 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.

  12. 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 to Step 13.
  13. Click Done to exit the installer.

After you install the Application Server and components

After you are done with installing, you may want to add additional machines to your deployment. For more information, see Installing additional machines.

Where to go from here

Before you can start using the product, you must verify the installation and configure BMC TrueSight Capacity Optimization.

Related topics

Verifying the installation

Installing additional machines

Installing silently

Working with installation error codes