20.02.02: Patch 2 for TrueSight Capacity Optimization 20.02

This topic contains information about fixes and updates provided in this patch. It also provides instructions for downloading and applying the patch.  

Important

  • Before you install this patch, make sure that you have installed the base version (20.02) or Patch 1 (20.02.01) of the product. Patches are cumulative and contain all updates released after the base version.
  • Make sure that you have installed this Patch 2 (20.02.02) of the product to apply any cumulative hotfixes released after this patch (20.02.02).
  • Patch 2 (20.02.02) can be used with existing BMC Helix Continuous Optimization agents. We recommend that you use the latest version of agents with this patch. For details, see Support-for-BMC-Helix-Continuous-Optimization-agents-and-Gateway-Server.

For details on supported product versions, see Compatibility-matrix.

Related topics

Known-and-corrected-issues

Deprecated-and-dropped-features-and-components

Enhancements

This patch provides the following enhancements: 

Nonnegative percentile-shift linear trend algorithm in Time Forecasting Model

The Nonnegative percentile-shift linear trend algorithm is a variant of the Robust linear regression algorithm. In this algorithm, the predicted linear trend is constrained to have a nonnegative slope. Additionally, the prediction starts from a user-defined percentile level of the historical data.

Use this algorithm to prevent modeling the forecasted data that has a negative slope and to perform a conservative prediction. For details, see Time-forecasting-model-algorithms-for-detecting-monotonic-trends-in-data.

nonnegative-algo.png

Export and import ETL configuration by using APIs

Use the ETL configuration APIs to export the existing ETL configuration from an environment and to import it into another environment. You can also use these APIs to modify, delete, and stop the ETL configuration. For more details, see Exporting-and-importing-ETL-configuration-by-using-APIs.

 

Create a composite report based on a report template

In the Workspace, create a composite report for a parent domain by using a report template. The report is created by combining all the leaf domain reports that are generated at runtime. This runtime report generation saves time required to manually create a separate report for each leaf domain. For more information, see Creating-reports.

 

composite_report.png

Activity to create and edit data marts

All default roles required to create and edit data marts include the Enable creation of data marts activity. If you plan to use a custom role for data marts, make sure to include this activity. For details, see Default-users-and-user-groups.

 

Ignore past saturation for the Days to Saturation indicator

While configuring the Days to Saturation indicator, use the Ignore past saturation option to ignore all systems that are already saturated from the DTS alerts and display only upcoming saturations. Accordingly, these saturated systems are not listed in the Recommendations pages in the view. For more information, see Indicators.

 

Support for Oracle 19.18 and 19.16

The support for Oracle database versions 19.18.0.0 and 19.16.00 has been added to TrueSight Capacity Optimization. For details, see Database-requirements.

 

ETL module enhancements

ETL Module

Enhancements

Enhanced to collect the AWS RDS metrics

Enhanced to collect metrics from the guest virtual machines using the Azure Monitor agent.

Support for VMware vSphere 7.0 and 8.0

Downloading the patch

To access the EPD website, you must provide your BMC Support credentials. You must be licensed for the product to access the download page. You may be prompted to complete the Export Compliance Form.

Use the EPD links in the following sections to access the installation files on the EPD website. From the EPD page, download the installation files for your platform.

EPD link:TrueSight Capacity Optimization

Component details on the EPD page

Application Server and ETL Engine
Gateway Server

Before proceeding with the installation of the patch, make sure that the sha256 hash of the file you downloaded is matching with the corresponding hash in the preceding tables. If the hash is different, download the file again. 

Applying the patch

The patch is applicable for the following TrueSight Capacity Optimization components: Application Server, ETL Engine, and Gateway Server. 

Warning

Before applying this patch, ensure that you have an OS backup or a VM snapshot of servers on which the components are installed.

Applying the Patch consists of the following steps:

  1. Apply Patch to the Application Server and ETL Engine
  2. Apply Patch to the Gateway Server
  3. Reinstall the Capacity Optimization plugin

Step 1: Apply Patch to the Application Server and ETL Engine

No.

Task

Procedure

A

Apply the Patch to the Application Server.

 

  1. In the TrueSight Capacity Optimization console, navigate to Administration > System > Maintenance > Patches.
  2. In the Upload patch or additional package file section, click Choose File.
  3. Navigate to the directory where you downloaded the install files, select the TSCO_AppServer_ver20.02.02_AS.zip file, and click Upload to apply the patch to the Application Server.
  4. On the Step 1 of 2: Overview page, click Next.
  5. On the Step 2 of 2: Hosts selection page, select the required hosts to be updated.
  6. Click Proceed. 
    The patch file is deployed automatically.
    The TrueSight Capacity Optimization console is stopped and restarted during the update, which can take up to 15 minutes to complete.

B

Apply the Patch to the ETL Engine.

  1. In the TrueSight Capacity Optimization console, navigate to Administration > System > Maintenance > Patches.
  2. In the Upload patch or additional package file section, click Choose File.
  3. Navigate to the directory where you downloaded the install files, select the TSCO_AppServer_ver20.02.02_EE.zip  file, and click Upload to apply the patch to the ETL Engine.
  4. On the Step 1 of 2: Overview page, click Next.
  5. On the Step 2 of 2: Hosts selection page, select the required hosts to be updated.
  6. Click Proceed. 
    The patch file is deployed automatically.

C

Perform this task if Sentry or Moviri ETL modules and capacity views are already configured in your environment.

  1. Download the latest Sentry and Moviri packages from EPD. For more information, see Sentry and Moviri Integrators.

  2. In the TrueSight Capacity Optimization console, redeploy the Moviri and Sentry ETL modules. For details, see the Installing additional packages section in Performing-system-maintenance-tasks.
  3. Reinstall the Storage, Hadoop, and Network views. For more information, see Installing-capacity-views.

Step 2: Apply Patch to the Gateway Server

Task

Procedure

Apply the Patch to the Gateway Server.

  1. Log in to the system where the Gateway Server is installed.
  2. Navigate to the directory where you downloaded the installation files.
  3. Extract the files:
    • (Windows) Extract TSCO_GatewayServer_ver20.02.02_MSWindows.zip
    • (Linux) tar -xvf TSCO_GatewayServer_ver20.02.02_Linux_x86-64.tar
  4. Run the following command to apply the patch:
    • (Windows) BPAPatchTool.cmd
    • (Linux) ./BPAPatchTool.sh
  5. Select the package and follow the instructions.

Step 3: Reinstall the Capacity Optimization plugin

Task

Procedure

Reinstall the Capacity Optimization plugin

After you install this patch, you must reinstall the Capacity Optimization plugin to use the latest updates to the features that are available in the TrueSight console. For information on reinstalling the plugin, see Reinstalling-the-Capacity-Optimization-plugin.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*