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

Performing the upgrade

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. 

Excerpt named build_numbers was not found in document xwiki:Automation-DevSecOps.Automation-Console.TrueSight-Automation-Console.tsac2102.Installing.Installing-in-the-interactive-mode.WebHome.

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:21.02.00.1415

    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. 

    <install_directory>/stackmanager install  --deployment tsac+
    <install_directory>/stackmanager install  --deployment=tsac+

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

    For 21.02
    [INFO] loading deployment registry from /opt/bmc/sm/registry/sm-deployment-registry.yml
    **************************************************
    TrueSight Stack Manager 21.02.00.<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>
    For 21.02.01
    [INFO] loading deployment registry from /opt/bmc/sm/registry/sm-deployment-registry.yml
    **************************************************
    TrueSight Stack Manager 21.02.01.<build_number>
    **************************************************

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

    [INFO] Start installation
    [INFO] Installing new components: tsna-connector
    [INFO] Upgrading existing components: redis, itil, redis-common, catalog-service, drw, patch-manager-core, patch-manager-portal, policy-service, tssp-nginx, configurations-service, connectors-service, discovery-onprem-connector, exceptions-service, identitymanagement-service, login, organization-service, platform-portal, resource-service, rsso-portal, tenant-onboarding-utility, tso-connector, users-service, workmanager-service, tssa-connector
    Press Enter to Read the License Agreement and enter the Appropriate Option

  6. Read, and type y to continue with the upgrade.
    If you are upgrading to 21.02.01, the following message appears: Do you want to configure TSNA Connector [You may choose No now & configure it post upgrade] ([y]es/[n]o) ?

    Do I need to configure the TSNA connector during the upgrade?

    No. You can choose to skip it and continue with the upgrade. If you want to integrate with TrueSight Network Automation, you can configure the connector by using the Automation Console UI later.

  7. (Optional) If you choose to configure the TrueSight Network Automation connector, type y and provide the values that match your environment:
    If you do not want to configure the connector, type n and skip to step number 8.

    Field

    Description

    Host name of TrueSight Network Automation

    Fully-qualified domain name or IP address of TrueSight Network Automation

    Port number of TrueSight Network Automation

    Port number

    Protocol of TrueSight Network Automation

    Default value: https

    Realm name of TrueSight Network Automation

    Specify the realm name

    Service Account user name of TrueSight Network Automation

    Specify the user name

    Password for the Service Account user of TrueSight Network Automation '<user name>'

    Specify the password that matches the user name

    Realm name for the Service Account user of TrueSight Network Automation <Realm Name>

    Specify the realm name of the service account user

  8. TrueSight Automation Console upgrade is complete and the following status message appears.

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


    <For 21.02.01, with TSNA connector>

    TrueSight Automation Console 21.02.01.<build_number> can be accessed
    at: https://<hostname>:<portnumber>/services/#/account/tsna/login

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

    To verify the status
    <install_directory>/stackmanager status  --deployment=application

    The updated services, container names, versions, and their status is displayed. 

    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                          21.02.01.903   running
    Connector Service                   truesight-connectors-service                           21.02.01.1380  running
    Data Refresh Worker                 truesight-app-drw                                      21.02.01.215   running
    Discovery OnPrem Connector          truesight-common-discovery-onprem-connector            21.02.01.137   running
    Exceptions-service                  truesight-common-exceptions-service                    21.02.01.472   running
    ITIL Service                        truesight-common-itil                                  21.02.01.378   running
    Identity Management Service         truesight-identitymanagement-service                   21.02.00.1005  running
    Login service                       truesight-common-login                                 21.02.01.865   running
    Nginx                               truesight-app-nginx                                    21.02.01.941   running
    Organization Service                truesight-organization-service                         21.02.01.289   running
    Patch Manager portal                truesight-app-patch-manager-portal                     21.02.01.9672  running
    Patch Manager service               truesight-app-patch-manager-core                       21.02.01.1380  running
    Platform Portal                     truesight-platform-portal                              21.02.01.1349  running
    Policy service                      truesight-app-policy-service                           21.02.01.1427  running
    Redis                               truesight-infra-ext-redis                              21.02.01.436   running
    Redis-common                        truesight-infra-ext-redis-common                       21.02.01.436   running
    Resource service                    truesight-common-resource-service                      21.02.01.675   running
    TSNA Connectortruesight-common-tsna-connector   21.02.01.385   running
    TSO Connector                       truesight-common-tso-connector                         21.02.01.289   running
    TSSA Connector                      truesight-common-tssa-connector                        21.02.01.564   running
    Tenant Onboarding Utility           truesight-common-tenant-onboarding-utility             21.02.01.183   running
    Users Service                       truesight-users-service                                21.02.01.353   running
    configurations-service              truesight-configurations-service                       21.02.01.67    running
    rsso-portal                         truesight-rsso-portal                                  21.02.01.143   running
    workmanager-service                 truesight-workmanager-service                          21.02.01.439   running    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                          21.02.00.872   running
    Connector Service                   truesight-connectors-service                           21.02.00.1345  running
    Data Refresh Worker                 truesight-app-drw                                      21.02.00.188   running
    Discovery OnPrem Connector          truesight-common-discovery-onprem-connector            21.02.00.113   running
    Exceptions-service                  truesight-common-exceptions-service                    21.02.00.445   running
    ITIL Service                        truesight-common-itil                                  21.02.00.326   running
    Identity Management Service         truesight-identitymanagement-service                   21.02.00.1005  running
    Login service                       truesight-common-login                                 21.02.00.817   running
    Nginx                               truesight-app-nginx                                    21.02.00.927   running
    Organization Service                truesight-organization-service                         21.02.00.265   running
    Patch Manager portal                truesight-app-patch-manager-portal                     21.02.00.9547  running
    Patch Manager service               truesight-app-patch-manager-core                       21.02.00.1319  running
    Platform Portal                     truesight-platform-portal                              21.02.00.1315  running
    Policy service                      truesight-app-policy-service                           21.02.00.1360  running
    Redis                               truesight-infra-ext-redis                              21.02.00.435   running
    Redis-common                        truesight-infra-ext-redis-common                       21.02.00.435   running
    Resource service                    truesight-common-resource-service                      21.02.00.648   running
    TSO Connector                       truesight-common-tso-connector                         21.02.00.233   running
    TSSA Connector                      truesight-common-tssa-connector                        21.02.00.551   running
    Tenant Onboarding Utility           truesight-common-tenant-onboarding-utility             21.02.00.155   running
    Users Service                       truesight-users-service                                21.02.00.336   running
    configurations-service              truesight-configurations-service                       21.02.00.49    running
    rsso-portal                         truesight-rsso-portal                                  21.02.00.132   running
    workmanager-service                 truesight-workmanager-service                          21.02.00.421   running

    To verify the version
    <install_directory>/stackmanager version

    The following figure shows the sample version. 

    Service                                  Version
    -------                                  -------
    Catalog service                        21.02.01.903
    Connector Service                      21.02.01.1380
    Data Refresh Worker                    21.02.01.215
    Discovery OnPrem Connector             21.02.01.137
    Exceptions-service                     21.02.01.472
    ITIL Service                           21.02.01.378
    Identity Management Service        21.02.01.1021
    Login service                          21.02.01.865
    Nginx                                  21.02.01.941
    Organization Service                   21.02.01.289
    Patch Manager portal                   21.02.01.9672
    Patch Manager service                  21.02.01.1380
    Platform Portal                        21.02.01.1349
    Policy service                         21.02.01.1427
    PostgreSQL                             12-alpine
    Redis                                  21.02.01.436
    Redis-common                           21.02.01.436
    Resource service                       21.02.01.675
    TSNA Connector                         21.02.01.385  
    TSO Connector                          21.02.01.289
    TSSA Connector                         21.02.01.564
    Tenant Onboarding Utility         21.02.01.183
    Users Service                          21.02.01.353
    configurations-service               21.02.01.67
    rsso-portal                            21.02.01.143
    workmanager-service               21.02.01.439    Service                                  Version
    -------                                  -------
    Catalog service                        21.02.00.872
    Connector Service                      21.02.00.1345
    Data Refresh Worker                    21.02.00.188
    Discovery OnPrem Connector             21.02.00.113
    Exceptions-service                     21.02.00.445
    ITIL Service                           21.02.00.326
    Identity Management Service            21.02.00.1005
    Login service                          21.02.00.817
    Nginx                                  21.02.00.927
    Organization Service                   21.02.00.265
    Patch Manager portal                   21.02.00.9547
    Patch Manager service                  21.02.00.1318
    Platform Portal                        21.02.00.1315
    Policy service                         21.02.00.1360
    PostgreSQL                             12-alpine
    Redis                                  21.02.00.435
    Redis-common                           21.02.00.435
    Resource service                       21.02.00.648
    TSO Connector                          21.02.00.233
    TSSA Connector                         21.02.00.551
    Tenant Onboarding Utility              21.02.00.155
    Users Service                          21.02.00.336
    configurations-service                 21.02.00.49
    rsso-portal                            21.02.00.132
    workmanager-service                    21.02.00.421

  10. (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.

      <install_directory>/stackmanager restart  --deployment=application

Where to go next?

After a successful upgrade, the previously installed connectors do not need any update. If you want to configure any of the new/optional connectors, see Managing-connectors. 

 

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