This topic describes how you can install BMC TrueSight Capacity Optimization on your machine.
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.
You can install BMC TrueSight Capacity Optimization on a single machine or install individual components on separate machines.
|Installing the Application Server and components||Install all components on the same machine|
|Installing the Application Server and components||Minimum components required|
|BMC TrueSight Capacity Optimization 10.0.00|
|Database Schema 10.0.00|
|Application Server - Web Server 10.0.00|
|Installing additional machines||Install one or more 1 component per machine|
|Application Server - Datahub 10.0.00 2|
|Application Server - Primary Scheduler 10.0.00|
|ETL Engine Server 10.0.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.
The following options are available for installing the product:
Install using the
cpit user: Follow the steps described in Setting up the installation environment, then continue with . Some of the screens are available only when the installation is run using the
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.
All steps marked with are available only if you run the installer using the
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:
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|
Extract command with example
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.
Change the directory: After extracting the installation files, change to the directory where you extracted the install files. For instance
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.|
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
Run the installation: At the shell prompt, type
./setup.sh and press Enter.
Welcome screen and EULA: At the product installation Welcome screen, click Next. Agree to the End User License Agreement (EULA), and click Next again.
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.
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.
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.)
Custom Setup: Select the check box corresponding to the components you want to install.
|Typical Setup: Application Server|
|Web Server Configuration||Select a protocol to be used by the BMC TrueSight Capacity Optimization console, and click Next.|
|Shared Repository Configuration||Select either of the configuration options, type the details as required, and click Next.|
|Database Information - Select Database type|
Select the Database you want to use for installation:
Click below to view the details required to use a PostgreSQL database for installing BMC TrueSight Capacity Optimization
If you want to use Oracle database as source for an ETL, ensure that you configure the Oracle database and follow Using Oracle database as source for an ETL.
|Database Information - Connection details|
Enter information for connecting to and configuring the database.
|Select Database connection properties OR Custom JDBC connection URL (Advanced) for advanced settings.|
|Database connection properties|
|Use SID (for Oracle only)||Select either of the options to use the system ID or service name. Specify the details for the database instance that your database administrator created.|
|Use Service Name (for Oracle only)|
|Database Host Name||Name of the database host where the database schema is stored.|
|Listener Port||Listener port number for the database. (Default: 1521)|
|Custom JDBC connection URL (Advanced)|
|JDBC URL||JDBC URL of the database through which it is referenced.|
Syntax for Oracle:
|From the Creation of database users and tablespaces section, select Installer shall create Database users and tablespaces OR Database users and tablespaces have already been created externally for advanced settings.|
|Installer shall create Database users and tablespaces|
|Privileged User Name||Name of the user setting up the database schema. This is either sys or another user that your database administrator has created for the purpose.|
|Privileged User Password||Password of the user that is setting up the database schema.|
|Tablespaces parent directory|
Path where the datafile is saved by your database administrator.
Some of the common ways to specify the datafile path are:
|Testing database connectivity|
|Database users and tablespaces have already been created externally|
|Select this option if have alreadyfor your database externally (manually).|
|Testing database connectivity|
|From the Names for database users and tablespaces section, select Use defaults OR Allow me to customize names for advanced settings.|
|Select this option if you want to use the (default) database user names and tablespace names provided by BMC TrueSight Capacity Optimization.|
|Allow me to customize names|
TNS Names File Location
|Location of tnsnames.ora, a configuration file that defines database addresses for establishing connections. It is normally located in |
|Catalog Tablespace||Name of the tablespace for the database Catalog.|
|Catalog Index||Name of the catalog index.|
|Name of the database tablespace where all the data is stored.|
|Name of the data index.|
|Name of the tablespace where all database views is stored.|
|Role of the database owner.|
|Name of the database owner.|
DB Owner Password
|Password of the database owner.|
|The database role used by the console for storing view configuration.|
Views User Name
|Name of the database user used by the console for storing view configuration.|
|Password of the database user used by the console for storing view configuration.|
|Name of the database role that the console uses to access data for Data Marts and Advanced Reporting public views.|
Reports User Name
|Name of the database user that console uses to access data for Data Marts and Advanced Reporting public views.|
|Password of the database user that console uses to access data for Data Marts and Advanced Reporting public views.|
|Data Warehouse Aging Configuration||Enter the following information and click Next.|
|Use default aging configuration||Use the default setting for aging configuration, which is approximately 280 GB space for the database considering 5000 systems. This configuration allows you to import historical data from the last two months.|
Modify default aging configuration
|Select the Components||Select any or all of the following components to install:|
|BMC TrueSight Capacity Optimization 10.0.00 Installation||Selects all components. If you select this option, the installation is similar to a Typical install.|
Install Database Schema 10.0.00
|Install and set up the database schema.|
Install Application Server 10.0.00
|Install the following Application Server components:|
|Install ETL Engine Server 10.0.00||Install the ETL Engine Server component:|
|Web Server Configuration||The task from this screen onwards (including this screen) is the same as that for performing a Typical Setup.|
Connect with existing BMC TrueSight Capacity Optimization Server: Select one of the options given below:
|Direct connection||This machine is able to directly access the Database. Enter details for the Web Server Address, Protocol, Web Port.|
|Remote connection||This machine is located on a remote network with an unstable or slow connection, and only has HTTP visibility to the DataHub.|
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.
After you are done with installing, you may want to add additional machines to your deployment. For more information, see Installing additional machines.
Before you can start using the product, you must and configure BMC TrueSight Capacity Optimization.