Sizing and scalability considerations for the ETL Engine server

ETL Engine servers can be scaled horizontally and vertically. The major sizing drivers for ETL Engine servers are:

  • The required data processing throughput in samples per day. This value is the number of managed entities, times the average number of samples collected for each entity in a day.
  • The number of connector instances (tasks) scheduled on the ETL Engine.

Follow these guidelines when sizing and scaling ETL Engine servers:

ETL Engine configuration

Disk space

No. of connectors

Samples per day

2 CPU cores @ 2GHz, 4 GB RAM

8 GB free

100 instances

10 million

4 CPU cores@ 2 GHz, 8 GB RAM

16 GB free

100 instances

20 million

For more information, refer to the following sections:

Guidelines for disk space

The default values above allow for ten days of temporary files and log files accumulated during the normal day-to-day population activity. The default period setting for the File System Cleaner system task is ten days. If you increase this period for any reason, adjust the above numbers accordingly.

You need additional disk space for special activities:

  • Bulk import of data, for example, for addition of new data sources with historical data.
  • Recovery import of data, i.e., when a data source stops for a day or two for any reason and has to be recovered.

For the above special activities, estimate additional capacity using the number of anticipated additional samples per day. Temporary files and logs from these samples will remain on the disk for ten days (or whatever the File System Cleaner system task period is set to).

General guidelines for connector scheduling on ETL Engines

Follow these guidelines when scheduling connectors to avoid congestion:

  • Do not configure a single connector instance to populate more than two million samples in each run. You can configure multiple connector instances to divide the work into smaller chunks, or you can configure multiple ETL Engine servers to manage the higher volume, when the data source can support it.
  • Schedule connectors so that no more than one connector instance is running on any CPU core at any given time. Take into account the amount of time required to execute each connector. For example, if an ETL Engine server is configured with two CPU cores, ensure that no more than two connectors are running at any given time.
  • If you are trying to scale up by increasing the size of the ETL Engine machine, then consider that certain types of connectors require significantly more memory than other connectors. For example, connectors written in Java might require twice as much memory, or more, than other types of connectors.
  • Avoid congestion at the warehousing engine. Do not import data in large volumes, such as when recovering historical data. Split this data into smaller chunks.


You can monitor and control the internal processing of collected data by viewing statistics such as processing throughput and time in the Administration section of the TrueSight Capacity Optimization Console. Data needs to be processed by the warehousing engine before it can be analyzed, modeled, and reported in the Console.

Guidelines for service connectors

The guidelines above are for scheduled connectors, which are periodically started by the scheduler as batch jobs and run as separate processes. For service connectors, which run continuously within the same process as the scheduler, there are stricter guidelines as follows.

  • A single ETL Engine machine can run no more than four service connectors.
  • Service connectors use heap memory in the scheduler process, so increase the heap size by 512 MB for each service connector. For example, if the default heap size is 1 GB, this means that running two service connectors will require the heap size to be increased to 2 GB.
  • The total heap size of the scheduler should remain within half the total memory of the ETL Engine machine. If you need to add more than two service connectors, use the larger 8 GB RAM size ETL Engine machine.

Modifying the heap size of the ETL Engine scheduler

  1. In the installation directory on the ETL Engine machine, open the file for editing.
  2. In the #SCHEDULER section, find the following statements:

  3. If the statements are preceded by a '#' character, remove it from both to uncomment them, and modify the number (1024m) to the new heap size.
  4. Restart the scheduler.

Guidelines for remote ETL Engines

Unlike local ETL Engines, which load data into the data warehouse by connecting directly to the Oracle database, remote ETL Engines use a different method to load data into the data warehouse. The sizing and scalability characteristics of TrueSight Capacity Optimization installations with data being loaded from remote ETL Engines are therefore different. In general, a remote ETL Engine uses additional resources on the Data hub machine. To decide when to use a remote ETL Engine, see Guidelines on using a remote ETL engine.

Remote ETL Engines use a two-step process to load data into the data warehouse:

  1. A store-and-forward messaging infrastructure transfers data to the Data hub machine (usually the same as the Application Server machine).
  2. The data is then loaded into the data warehouse by connecting to the Oracle database.

This two-step process involves use of the following resources:

  • Reads and writes to the disk on the Data hub machine.
  • Enough disk space on the Data hub machine to accumulate transferred data for one day.
  • CPU and memory on the Data hub machine to parse the transferred data and create data for loading into Oracle.
  • Database connection pools for the Data hub application.

Even if there are sufficient resources for all of the above, the overall process also takes longer to finish than for local ETL Engines.


If you have enough data being transferred from remote ETL Engines to require more than one remote ETL Engine, you should provide additional resources at the Data hub.

The following table provides some guidelines for the Data hub when you use remote ETL Engines:

Data hub resource



40 IOPS additional for each remote ETL Engine

Disk space

320 MB additional for each remote ETL Engine

CPU and memory

Memory 160 MB for each remote ETL Engine, up to a maximum of 8 GB.

See also Setting the Data hub JVM heap size.

Database connection pool

Add two connections for each remote ETL Engine, up to 60 total; see section on database connection pool below

Setting the Data hub JVM heap size


Be careful when modifying the heap size of the JVM. Wrong settings may cause unpredictable and hard-to-diagnose failures.

  1. Open the file for editing.
  2. Remove the character preceding the following statements to uncomment them, and replace 1024m before restarting the Data hub service.


Increasing the database connection pool size


When modifying the database connection pool size, verify that the Oracle database also has corresponding sizes for concurrent sessions.

  1. Open the caplan-ds.xml file for editing.
  2. Look for the <jndi-name>CaplanDHDS</jndi-name> element.
  3. Replace the pool size value in the <max-pool-size>40</max-pool-size> element with a new value, and Save the caplan-ds.xml file.


Ensure that you are edit the setting only for the CaplanDHDS data source.

Guidelines for using a remote ETL Engine

The TrueSight Capacity Optimization ETL Engine is a server that runs connectors that populate data from external data sources to the Data Warehouse database.

An ETL Engine can be configured in two ways:

  • Local: Directly populates the database (default).
  • Remote: Populates the database via the Application Server's message service. You can select this option during installation.

The same connectors can run in both types of ETL Engine. The choice between local and remote is purely a deployment choice. Selection criteria explains how to choose the appropriate configuration for a TrueSight Capacity Optimization ETL Engine.

For more information, refer to the following sections:

Selection criteria

In most cases, a local ETL Engine is recommended because it offers a higher throughput connection to TrueSight Capacity Optimization, to load high volumes of data.

A remote ETL Engine provides two advantages to connectors running in it:

  1. It is able to populate data via HTTPS.
  2. It uses a store-and-forward infrastructure to manage with unreliable network links.

However, a remote ETL Engine introduces overhead for robust transmission, thus reducing the total throughput obtained.

The remote ETL Engine option should be adopted only in the following cases:

  1. A limited bandwidth or unstable connection is present between data sources and the TrueSight Capacity Optimization central installation, for example a low capacity WAN link. In this case, a connector trying to populate data through this link could experience repeated failures. Running the connector in a remote ETL Engine ensures that data extraction occurs reliably close to the datasource, and the load phase occurs through the low capacity WAN link using a store-and-forward messaging infrastructure in TrueSight Capacity Optimization.
  2. It is not possible to expose the needed TCP ports on the TrueSight Capacity Optimization database machine or the TrueSight Capacity Optimization Application Server machine. In this case, a connector trying to populate data through this link would be unable to make database updates. Running the connector in a remote ETL Engine allows data population to occur via HTTP or HTTPS ports on the TrueSight Capacity Optimization Application Server machine.


A remote ETL Engine is not needed just because the data source is remote. The name "local" in a local ETL Engine does not imply that it must be on the same LAN as the TrueSight Capacity Optimization database. As long as the ETL Engine can reach the TrueSight Capacity Optimization LAN to populate the data (see details below), a local ETL Engine can be used.

You can always use multiple local ETL Engines over different LAN segments to drive higher volumes.

Network visibility details

A local ETL Engine requires TCP visibility of the TrueSight Capacity Optimization database server and application server from the ETL Engine machine; specifically TCP port 1521 for the database (default Oracle installations) and TCP port 8280 (default Data hub port) for the TrueSight Capacity Optimization Application Server.

A remote ETL Engine can be configured to use either:

  • Direct HTTP connection to the TrueSight Capacity Optimization Application Server, that exposes both HTTP on TCP and JMS over HTTP on port 8280 (default; port should be open for communications).
  • An HTTPS front-end based on Apache Web Server that exposes the above ports (optional).

How to configure a Remote ETL Engine

To install a remote ETL Engine, you must forward a port on your external firewall to your TrueSight Capacity Optimization Data hub external communication port, to expose it to the remote ETL.

You will be asked to provide external Data hub and port parameters during the configuration procedure. Configure both firewall and Data hub if you plan to have a remote ETL installation.

Was this page helpful? Yes No Submitting... Thank you


  1. Tushar Vedak

    Stated "caplan-ds.xml" file on this page to increase the database connection pool size is actually doesn't exist with TSCOs 10* & 11 version.

    We were using this file till to BCO 9.5 version, it was part of the J-boss application server and we have removed the J-boss application server dependency from TSCO 10.0 version.

    I found caplan-ds.xml file only on BCO9.5SP2 AS and EE server installed node under below path... /opt/bmc/BCO/datahub/jboss/server/default/deploy/caplan-ds.xml

    In TSCO 10* & 11 version we need to modify the below files to increase the TSCO components database connection pool size,

    For Data-Hub Component:

    folder {BCO_HOME}/datahub/conf/ - - - -

    Edit above files and change the value of the property maxActive from 40 to 60 And, restart the datahub service.

    For Scheduler Component: ----------------------------------------- Folder {BCO_HOME}/scheduler/conf - -

    Edit above files and change the value of the property maxActive from 40 to 60 And, restart the scheduler service.

    I am not sure about web component, please confirm with development.

    Folder {BCO_HOME}/web/conf - - - -

    Before updating the all TSCO document (TSCO 10, 10.3,10.5,10.7 and 11 doc) Kindly reconfirm with TSCO development team on this section.

    May 23, 2018 08:19