Performing the upgrade

Note

This topic is applicable only for a TrueSight Automation Console (on-premises) deployment.

BMC Helix Automation Console (SaaS) is not available for on-premises installation. For details about subscribing to this service, see BMC Helix subscriber information.

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. 

VersionBuild number
20.02 Patch 1 (20.02.01)

20.02.00.481

20.02 20.02.00.305

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:<build_number>
    Example
    docker run -it --rm --network=host 127.0.0.1:5000/bmcsoftware/truesight-stack-manager:20.02.00.305

    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 the location where the previous version is installed. 
  3. Enter a username with root permissions and a password. 
    The Stack Manager tool is updated at the specified location. 

  4. Run the following command to verify whether the Stack Manager tool is updated. 

    ./stackmanager version

    This shows the services and their current version as shown in the example below.

    Service                     Version
    -------                     -------
    Catalog service             20.02.00.455
    Consul                      20.02.00.45
    Discovery OnPrem Connector  20.02.00.52
    ITIL Service                20.02.00.184
    Login service               20.02.00.543
    Nginx                       20.02.00.601
    Patch Manager portal        20.02.00.881
    Patch Manager service       20.02.00.756
    Policy service              20.02.00.706
    PostgreSQL                  11.2-alpine
    Redis                       20.02.00.72
    Redis-common                20.02.00.72
    Resource service            20.02.00.493
    TSO Connector               20.02.00.207
    TSSA Connector              20.02.00.441
    TSVM Data Refresh Manager   20.02.00.3345
    TSVM Data Refresh Worker    20.02.00.3345
    TSVM Portal					20.02.00.2241
    WorkManager                 20.02.00.429

    You can now continue with upgrading the application. 

    Tip

    To see the commands typically used during installation and other help, run this command:

    ./stackmanager --help

  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 details after successfully upgrading to version 20.02.01. 

    Name                        Container Name                                 Version        Status
    ----                        --------------                                 -------        ------
    Catalog service             truesight-app-catalog-service                  20.02.00.556   running
    Consul                      truesight-infra-ext-consul                     20.02.00.45    running
    Discovery OnPrem Connector  truesight-common-discovery-onprem-connector    20.02.00.52    running
    ITIL Service                truesight-common-itil                          20.02.00.184   running
    Login service               truesight-common-login                         20.02.00.607   running
    Nginx                       truesight-app-nginx                            20.02.00.631   running
    Patch Manager portal        truesight-app-patch-manager-portal             20.02.00.979   running
    Patch Manager service       truesight-app-patch-manager-core               20.02.00.886   running
    Policy service              truesight-app-policy-service                   20.02.00.808   running
    PostgreSQL																   11.2-alpine
    Redis                       truesight-infra-ext-redis                      20.02.00.72    running
    Redis-common                truesight-infra-ext-redis-common               20.02.00.72    running
    Resource service            truesight-common-resource-service              20.02.00.509   running
    TSO Connector               truesight-common-tso-connector                 20.02.00.207   running
    TSSA Connector              truesight-common-tssa-connector                20.02.00.441   running
    TSVM Data Refresh Manager   truesight-app-vulnerability-management-drm     20.02.00.3377  running
    TSVM Data Refresh Worker    truesight-app-vulnerability-management-drw     20.02.00.3377  running
    TSVM Portal																   20.02.00.2241  
    WorkManager                 truesight-common-workmanager                   20.02.00.429   running
    To verify the version
    ./stackmanager version

    The following figure shows the sample version. 

    Result
    Service                     Version
    -------                     -------
    Catalog service             20.02.00.455
    Consul                      20.02.00.45
    Discovery OnPrem Connector  20.02.00.52
    ITIL Service                20.02.00.184
    Login service               20.02.00.543
    Nginx                       20.02.00.601
    Patch Manager portal        20.02.00.881
    Patch Manager service       20.02.00.756
    Policy service              20.02.00.706
    PostgreSQL                  11.2-alpine
    Redis                       20.02.00.72
    Redis-common                20.02.00.72
    Resource service            20.02.00.493
    TSO Connector               20.02.00.207
    TSSA Connector              20.02.00.441
    TSVM Data Refresh Manager   20.02.00.3345
    TSVM Data Refresh Worker    20.02.00.3345
    WorkManager                 20.02.00.429

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 Configuring connectors

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

Comments