Documentation update To provide a better user experience, we have now created a separate documentation space for Helix Vulnerability Management. Users of Helix Vulnerability Management (includes BMC Helix Automation Console) can find the latest documentation at BMC Helix Vulnerability Management.

Performing the upgrade

This topic provides the instructions to upgrade TrueSight Automation Console to the current version. During an upgrade, you only upgrade the application, which also upgrade the underlying database schema. 

Build numbers

You must provide the build number depending on the version that you want to upgrade to. 

Version

Build number

Details

20.08

865

The TrueSight Automation Console installer

20.08.01

1121

The TrueSight Automation Console installer

20.08

1905

The TrueSight Automation Console installer that contains Log4j fixes

20.08.01

1909

The TrueSight Automation Console installer that contains Log4j fixes

To upgrade TrueSight Automation Console

  1. Open a terminal and SSH into the host where you have set up the local registry, and run the following command to update the Stack Manager tool. 

    docker run -it --rm --network=host <hostname>:<port>/bmcsoftware/truesight-stack-manager:<version_number>.<build_number>
    Example
    docker run -it --rm --network=host 127.0.0.1:5000/bmcsoftware/truesight-stack-manager:20.08.00.865

    Here, 127.0.0.1:5000 is the host:port of the local registry that contains the BMC Helix Automation Console images.  
    You are prompted to specify a location to install the product.  

  2. Enter a username with root permissions and a password. 
    The Stack Manager tool is updated at the specified location. 
  3. Enter the location where the previous version is installed. 
    The following message is displayed: Stack Manager Launcher is already installed, do you want to overwrite it?y/(n)
  4. Enter y.
    The Stack Manager tool is updated. 

  5. On the host where the Stack Manager tool is installed, run any of the following commands to start upgrading the application.

    This command also upgrades the database schema. 

    ./stackmanager install  --deployment tsac+
    ./stackmanager install  --deployment=tsac+

    The existing installation and the END USER LICENSE AGREEMENT  is displayed. 

    [INFO] loading deployment registry from /opt/bmc/sm/registry/sm-deployment-registry.yml
    **************************************************
    TrueSight Stack Manager <build_number>
    **************************************************

    The following services are already installed:
    Deployment   Location
    ----------   --------
    application  /opt/bmc/truesight/application
    database     /opt/bmc/truesight/database

    [INFO] Start installation
    Press Enter to Read the License Agreement and enter the Appropriate Option
    END USER LICENSE AGREEMENT
    <Agreement Text>

  6. Read, and type y to continue with the upgrade.
    TrueSight Automation Console upgrade is complete and the following status is displayed.

    TrueSight Automation Console <build_number> can be accessed at: <URL>
    Installation is completed successfully. 

  7. To verify whether the upgrade is successful, run the following command: 

    To verify the status
    ./stackmanager status  --deployment=application

    The updated services, container names, versions, and their status is displayed. The following figure shows the details after successfully upgrading to version 20.08 Patch 1. 

    Name        Container Name               Version    Status
    ----        --------------               -------    ------
    PostgreSQL  database-infra-ext-postgres  12-alpine  running

    Components status for application:

    Name                         Container Name                               Version        Status
    ----                         --------------                               -------        ------
    Catalog service              truesight-app-catalog-service                20.08.00.748   running
    Connector Service            truesight-connectors-service                 20.08.00.1300  running
    Data Refresh Worker          truesight-app-drw                            20.08.00.120   running
    Discovery OnPrem Connector   truesight-common-discovery-onprem-connector  20.08.00.107   running
    Exceptions-service           truesight-common-exceptions-service          20.08.00.410   running
    ITIL Service                 truesight-common-itil                        20.08.00.240   running
    Identity Management Service  truesight-identitymanagement-service         20.08.00.1001  running
    Login service                truesight-common-login                       20.08.00.757   running
    Nginx                        truesight-app-nginx                          20.08.00.882   running
    Organization Service         truesight-organization-service               20.08.00.256   running
    Patch Manager portal         truesight-app-patch-manager-portal           20.08.00.9304  running
    Patch Manager service        truesight-app-patch-manager-core             20.08.00.1192  running
    Platform Portal              truesight-platform-portal                    20.08.00.1213  running
    Policy service               truesight-app-policy-service                 20.08.00.1218  running
    Redis                        truesight-infra-ext-redis                    20.08.00.92    running
    Redis-common                 truesight-infra-ext-redis-common             20.08.00.92    running
    Resource service             truesight-common-resource-service            20.08.00.1301  running
    TSO Connector                truesight-common-tso-connector               20.08.00.233   running
    TSSA Connector               truesight-common-tssa-connector              20.02.00.502   running
    Tenant Onboarding Utility    truesight-common-tenant-onboarding-utility   20.08.00.131   running
    Users Service                truesight-users-service                      20.08.00.328   running
    configurations-service       truesight-configurations-service             20.08.00.40    running
    rsso-portal                  truesight-rsso-portal                        20.08.00.120   running
    workmanager-service          truesight-workmanager-service                20.08.00.417   running

    The following figure shows the details after successfully upgrading to version 20.08.

    Name        Container Name               Version    Status
    ----        --------------               -------    ------
    PostgreSQL  database-infra-ext-postgres  12-alpine  running

    Components status for application:


    Name                          Container Name                                 Version            Status
    ----                          --------------                                 -------            ------
    Catalog service              truesight-app-catalog-service                   20.08.00.748       running
    Connector Service            truesight-connectors-service                    20.08.00.1300      running
    Data Refresh Worker          truesight-app-drw                               20.08.00.120       running
    Discovery OnPrem Connector   truesight-common-discovery-onprem-connector     20.08.00.88        running
    Exceptions-service           truesight-common-exceptions-service             20.08.00.384       running
    ITIL Service                 truesight-common-itil                           20.08.00.240       running
    Identity Management Service  truesight-identitymanagement-service            20.08.00.969       running
    Login service                truesight-common-login                          20.08.00.729       running
    Nginx                        truesight-app-nginx                             20.08.00.792       running
    Organization Service         truesight-organization-service                  20.08.00.256       running
    Patch Manager portal         truesight-app-patch-manager-portal              20.08.00.9304      running
    Patch Manager service        truesight-app-patch-manager-core                20.08.00.1144      running
    Platform Portal              truesight-platform-portal                       20.08.00.1213      running
    Policy service               truesight-app-policy-service                    20.08.00.1133      running
    Redis                        truesight-infra-ext-redis                       20.08.00.92        running
    Redis-common                 truesight-infra-ext-redis-common                20.08.00.92        running
    Resource service             truesight-common-resource-service               20.08.00.597       running
    TSO Connector                truesight-common-tso-connector                  20.08.00.233       running
    TSSA Connector               truesight-common-tssa-connector                 20.02.00.502       running
    Tenant Onboarding Utility    truesight-common-tenant-onboarding-utility      20.08.00.96        running
    Users Service                truesight-users-service                         20.08.00.328       running
    workmanager-service          truesight-workmanager-service                   20.08.00.417       running
    To verify the version
    ./stackmanager version

    The following figure shows a sample version. 

    Example
    Service                      Version
    -------                      -------
    Catalog service              20.08.00.748
    Connector Service            20.08.00.1300
    Data Refresh Worker          20.08.00.120
    Discovery OnPrem Connector   20.08.00.88
    Exceptions-service           20.08.00.384
    ITIL Service                 20.08.00.240
    Identity Management Service  20.08.00.969
    Login service                20.08.00.729
    Nginx                        20.08.00.792
    Organization Service         20.08.00.256
    Patch Manager portal         20.08.00.9304
    Patch Manager service        20.08.00.1144
    Platform Portal              20.08.00.1213
    Policy service               20.08.00.1133
    PostgreSQL                   12-alpine
    Redis                        20.08.00.92
    Redis-common                 20.08.00.92
    Resource service             20.08.00.597
    TSO Connector                20.08.00.233
    TSSA Connector               20.02.00.502
    Tenant Onboarding Utility    20.08.00.96
    Users Service                20.08.00.328
    workmanager-service          20.08.00.417
  8. (Optional) If you are using custom certificates, ensure that you have backed up the certificate files before the upgrade. After a successful upgrade, do these steps:

    1. Run the following command to replace the new certificates (created during the upgrade) with the custom certificates copied earlier. 

      cp /opt/<backup_directory>/tsvmSslCertificate.crt <install_dir>/application/common/certs/
      cp /opt/<backup_directory>/tsvmSslCertificate.key <install_dir>/application/common/certs/

    2. Restart the application.

      ./stackmanager restart  --deployment=application

Where to go next?

After a successful upgrade, the TrueSight Server Automation connector does not need any configuration. If you had configured the optional TrueSight Orchestration and Discovery connectors before the upgrade, no change is required. If you had not configured the optional connectors, you can choose to configure them based on your requirements. For details, see Managing-connectors. 

 

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