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

To access the Maintenance page, navigate to Administration >System > Maintenance. This page allows you to perform useful system tasks on BMC TrueSight Capacity Optimization, such as:

Collecting Logs

To collect logs from the Maintenance page, perform the following task:

  1. Navigate to Administration > System > Maintenance and click Collect Logs.
  2. Under the Collect Logs page, make the appropriate selections:
    1. Platform logs: Select yes for Collect all platforms logs? to tell BMC TrueSight Capacity Optimization to enable collection of platform logs. Select no, if you do not want BMC TrueSight Capacity Optimization to collect platform logs.
    2. ETL or System Task logs: Select yes for Collect ETL or System task logs? to tell BMC TrueSight Capacity Optimization to enable collection of ETL or System task logs. Select no, if you do not want BMC TrueSight Capacity Optimization to collect ETL or System task logs.
      1. yes: Select ETLs or System tasks from the All ETL/System tasks selection list and click  to move it to the ETL/System tasks to collect list .
      2. Collect the logs for the last: Select the number of days for which you want to collect the logs.
  3. Click Collect logs.
  4. In the Collect Logs details page, click Download all log files to download all log files at once, or click  under the Log files column of the List of log files being collected table to download individual logs.


If the log is stored in a multi-file archive, you must download all the files, and then open the first file to view and extract log files from the archive.

The following figure shows an example of the Collect Logs details page displaying the List of log files being collected table that is displayed after you click Collect Logs as described in Step 3 of the preceding task.

List of log files being collected table

Log Collection overview

The task log collection mechanism allows you to download all log files for a specific ETL/System task with a single click, and also includes hierarchy rule logs.

Collected logs include a variety of additional information, such as:

  • Application Version
  • Component and Host status
  • Warehouse status
  • List of installed patches and addons
  • Count of systems and business drivers by type
The execution of the logGrabber can be described as:
  • An ad-hoc workflow executes the logGrabber and waits for log collection results
  • It splits big log files in chunks and provides you with a Download all button
  • Collect logs link that is present in several pages allows you to seamlessly access logs from anywhere in the console. Note that this link is visible to administrators only.
  • You can select specific logs to collect.
  • The Error page collects logs related to the error displayed
  • The task log page in ETL and System tasks collects all the logs for the current task
  • Platform alerts collect all the logs related to all the errors displayed
  • Login page: If BMC TrueSight Capacity Optimization is not able to communicate with the database, the command-line logGrabber is executed on the Application Server.

Installing additional packages

The Additional Packages table lists all the available additional packages, like Views, integrations, extensions for distributed systems and so on, that can be installed on BMC TrueSight Capacity Optimization, including the following details:

  • Item: Name of the package.
  • Vendor: Name of the vendor that is providing the package.
  • Execution date (if available): The date on which the package was deployed.
  • Component version: The current version of the package that is available by the vendor.
  • Installed version (if applicable): The version currently deployed in BMC TrueSight Capacity Optimization.
  • Status: The current status of the package, for example, INSTALLED, ENDED, NOT INSTALLED.

To install a component, click  at the end of the corresponding package name row. If a component is already installed and a new version is available, click  to upgrade it.

To view the installation log (if available), click .

The Additional Packages table

Maintenance activities

The Maintenance Activities table provides access to tasks that can be useful when managing a BMC TrueSight Capacity Optimization installation. The table itself provides information on the tasks, including:

  • The name and description of the task
  • The date when the task was last executed
  • The status of the executed task

The Maintenance Activities table

You can run a task by clicking  at the end of the corresponding row, and view the task execution logs by clicking .

Running the domain extractor

The Domain Extractor option extracts data from another instance of BMC TrueSight Capacity Optimization, making a copy that you can use on your installation; for example, it can be used to move data from a demo environment to a production server.

To run the domain extractor:

  1. Run the domain extractor by clicking  in the corresponding row.
  2. Click Next.
  3. Provide the following details:
    1. Domain: Select the domain from which you want to extract data into the file that you want to use for a further upload to another BMC TrueSight Capacity Optimization instance.
    2. Extraction start time: Specify the extraction start time.
    3. Extraction end time: Specify the extraction end time.
    4. Resolution: Specify whether the data must be summarized hourly, daily, or monthly by selecting HourDay, or Month respectively. You can by selecting Detail if you want to summarize all the data currently available.
  4. Select the appropriate host and click Proceed.
  5. Click  to view the the deployment log.

Running the log grabber

The Log Grabber option retrieves the log files of all BMC TrueSight Capacity Optimization components and is useful for support purposes.

To run a log grabber:

  1. Run the log grabber by clicking  in the corresponding row.
  2. Click Next.
  3. Select the appropriate host for this operation and click Proceed.
  4. Click  to view the the deployment log.

Clearing the system cache

BMC TrueSight Capacity Optimization caches the content of the most frequently used database tables to improve speed and performances. If any database tables were modified by external components through direct database queries, it is necessary to run Clear cache to notify BMC TrueSight Capacity Optimization of the changes.

Clear cache clears cached data and reloads information from the database, allowing you to immediately see any changes, for example after applying a patch.

To clear the system cache, navigate to the Maintenance Activities tab under Administration > System > Maintenance and click the  (execute clear cache) button.

Managing patches

The Patches table lists all available patches, including:

  • The name of the patch
  • A description of the patch (if available)
  • The date when the patch was last executed
  • The patch version and currently installed version (if applicable)
  • The file name of the patch
  • The installation status of the patch

The Patches table

You can run a patch by clicking  at the end of the corresponding row, and view the deployment log by clicking . If a patch has already been applied, click the  button to execute the patch again.

In addition, you can rollback an installed patch by clicking . A Rollback: <patch name> page is displayed and lists all the hosts where rollback is possible. Select the appropriate hosts and click Rollback.

Viewing deployment logs

Click the  button, to view the Deployment logs table, a color-coded table that lists all deployment log messages for the selected task or patch, including:

  • Creation time: The execution date
  • Operation detail: Short description of the operation
  • Status: The final status of the operation, which can be one of the following:
    • ENDED: Successfully completed
    • WARNING: Partially completed due to errors (some of the required actions failed)
    • ERROR: Not completed due to errors (all the required actions failed)
    • RUNNING: Currently running

The  button at the end of each row allows you to download a detailed log for each operation. Logs may be requested by Customer Support for debugging, and can be useful to resolve issues.

Example of the Deployment Logs table

Click Back to return to the Maintenance page.

Re-installing Views

After you deploy a service pack or patch to your existing BMC TrueSight Capacity Optimization installation, you need to re-install (upgrade) all built-in views.

To do this, perform the following task:

  1. Navigate to the Additional packages tab under Administration > System > Maintenance.
  2. In the table that is displayed under Additional packages, click  (Upgrade view) for each built-in view to upgrade (and re-install) it to the current version of the product.

    At this point, the Maintenance page is refreshed, and the selected view is upgraded. Repeat this task for all built-in views. No further action is required.

Uploading a patch

The Upload patch file form lets you upload a deployment file to BMC TrueSight Capacity Optimization in an interactive way. To upload a file, follow these steps:

  1. Click Choose File to browse to the desired patch file and click Upload.


    The patch files usually contain an application server related .patch file and an ETL engine related .patch file. You must upload the application server related file before uploading the ETL engine related file.

  2. Select all schedulers that you wish to use.
  3. Click Save. The file is deployed automatically.
  4. Allow a short time for processing and reload the page to see the deployment log.

Selecting the schedulers

Running an ETL 

The ETL table lists all available ETL, including:

  • A name of the ETL
  • A description of the ETL(if available)
  • The date in which a ETL was last executed
  • The patch version and currently installed version (if applicable)
  • A installed version on which it is installed
  • The status of the ETL

You can run a ETL module by clicking  at the end of the corresponding row, and view the deployment log by clicking . If a ETL has already been applied, click the  button to execute the ETL again.







1 Comment

  1. It's worth mentioning that, in the license.xml file, the



    values are stored in 'epoch' format (see