×
$helper.renderConfluenceMacro('{bmc-global-announcement:$space.key}')
 
 
TrueSight Server Automation 20.02

Upgrading

TrueSight Server Automation provides a centralized upgrade UI for upgrading all TrueSight Server Automation components.

BMC recommends using the centralized UI in the unified product installer, but also provides the individual component installers for operating systems that are not supported by the unified product installer. For a centralized upgrade of multiple product components, you can also choose to run the unified product installer in unattended (silent) mode.

Note: About data warehouse upgrade

If your TrueSight Server Automation environment includes BMC Decision Support for Server Automation or TrueSight Smart Reporting for Server Automation, upgrade BMC Decision Support for Server Automation or TrueSight Smart Reporting for Server Automation before upgrading TrueSight Server Automation.

High-level steps for the upgrade

Click one of the following tabs:


    Item Description
    Complete preparatory tasks for upgrade

    Review the tasks to complete prior to upgrade in Preparing for a Windows upgrade using the unified product installer.
    Review requirements for Windows

    Review the key requirements for running the unified product installer on Windows.

      Click here to review.

    • During an upgrade, the unified product installer automatically installs an RSCD Agent on every Application Server machine that does not already have an agent installed. If you are not interested in having PsExec installed in your environment or if you are not interested in providing details of the required credentials, you can install an RSCD Agent manually on each of the detected machines.
    • If you have external PXE servers in your environment, copy the appserver installation script (for example, ..\installers/appserver_64\BSA<version>-WIN64.sh) to the C:\Windows path on Windows PXE Servers to use the Remote Site default option in Unified product installer before you start the upgrade.

    • NEW IN 8.9.02Ensure that Microsoft Visual C++ 2015 Redistributable Update 3 is installed on the server. For more information, see Installing an RSCD agent (Windows).
      Note:

      As a prerequisite to install Microsoft Visual C++ 2015 Redistributable Update 3 on Windows 2012 R2, you must have the following patches installed on your server:

      • KB2919442 (Required for 2919355)
      • KB2919355. This patch requires several other patches: clearcompressionflag.exe, KB2919355, KB2932046, KB2959977, KB2937592, KB2938439, and KB2934018. This are all available on the download page for KB2919355.

      For more information about the prerequisites for Microsoft Visual C++ 2015 Redistributable Update 3, refer to the Microsoft documentation here.


    • NSH must be present on each Application Server machine (that is NSH proxy server, Configuration server, Job server, or PXE server).
    • Unified installer should be run only from a node set up as a Configuration server (for more about this type of Application Server setup, see Application Server types).
    • During the upgrade, the installer checks the existing version of Perl. If the host computer on which you are installing the Network Shell has:
      • A supported version of Perl installed — The Network Shell installation automatically installs the Network Shell Perl module. For information about the Perl versions that TrueSight Server Automation supports, see Perl support.
      • An unsupported version of Perl installed — The installation copies files that allow you to install the Perl module after you have installed the supported version of Perl

    • On 64-bit Windows systems, confirm that the <WINDIR>\SysWOW64 directory contains a copy of the chcp.com file. The installer uses this file to set the code page of standard output (stdout). You can obtain the file from a 32-bit version of Windows.
    Review limitations

    Note the limitations when using the unified product installer for product upgrade.

      Click here to review.

    Category Description of support or limitation
    Multiple Application Server (MAS) environments The unified product installer only supports upgrade of an homogeneous MAS environment, that is, either all Application Servers run on Linux 64-bit operating systems or all run on Windows 64-bit operating systems.
    "Mixed" Application Server/database environments The unified product installer supports upgrade of "mixed" Application Server/database environments (for example, Linux Application Server + Microsoft SQL Server database). The UPI does not require the database or the file server operating system to match the operating system of the Application Servers.
    PXE servers

    For PXE servers to be upgraded by the unified product installer, they must be:

    • Up and running.
    • Running the same OS as the Application Server.

    If your environment includes hybrid PXE servers (that is, PXE servers not running Windows or Linux), you must perform a workaround for the upgrade

      Click here to see the workaround.
    1.  Stop the hybrid PXE server / TFTP server.
    2. Run the unified product installer. The installer ignores the PXE server, as it is in a stopped state. The installer upgrades the rest of the infrastructure, with the exception of the hybrid PXE server.
    3. Once the unified product installer has completed the upgrade, run the configurator utility on that PXE server. See Migrating the database and persisting configuration data to the database.
    4. Upgrade the PXE server according to the instructions in Upgrading the Provisioning System.
    5. Copy the global.property file from the Application Server to the /br/deployments/ directory on the PXe server.
    6. Restart the PXE server.
    Upgrade scenarios

    The unified product installer does not support the following upgrade scenarios:

    • 32-bit Windows or 32-bit Linux machines

    • Solaris SPARC machines

    • Upgrading the TrueSight Server Automation Console (RCP client). Uninstall the older version of the console and install the new version on a different host.
    • Application Servers installed with the -local flag, that is installed in a self-contained directory structure.

      
    Test the upgrade in a duplicate environment

    Prior to upgrading your production system, the best practice is to first test the upgrade using a copy of the production database in another environment.

    The steps in Testing the upgrade in a duplicated environment topic cover the high-level steps that you must perform; the specifics will likely vary, depending on the database in use, the operating systems involved, and the particular environment details.
    Upgrade the environment

    See: Walkthrough: Upgrading to the latest version for Microsoft Windows
    (Optional) Upgrade Live Reporting See: Upgrading Live Reporting
    (Optional) Get assistance through the AMIGO Upgrade Program To assist you in your upgrade, you might be interested in joining the AMIGO Upgrade Program, described in Knowledge Article ID: 000011572.


    Item Description
    Complete preparatory tasks for upgrade

    Complete the tasks prior to upgrade outlined in Preparing for a Linux or UNIX upgrade using the unified product installer.
    Review requirements for Linux

    Review the key requirements for running the unified product installer on Linux.

      Click here to review.

    • During an upgrade, the unified product installer automatically installs an RSCD Agent on every Application Server machine that does not already have an agent installed. If you are not interested in providing details of the required credentials, you can install an RSCD Agent manually on each of the detected machines.
    • If you have external PXE servers in your environment, copy the appserver installation script (for example, ../installers/appserver_64/BSA<version>-LIN64.sh) to the /tmp path on Linux PXE Servers to use the Remote Site default option in unified product installer before you start the upgrade.
    • NSH must be present on each Application Server machine (that is NSH proxy server, Configuration server, Job server, or PXE server).
    • Run the Unified installer only from an Application Server system that is set up as a Configuration server (for more about this type of Application Server setup, see Application Server types).
    • Run the installer from a computer where a Windows X server is installed.
    • If the host computer on which you are installing the Network Shell has:
      • A supported version of Perl installed — The Network Shell installation automatically installs the Network Shell Perl module. For information about the Perl versions that TrueSight Server Automation supports, see Perl support.
      • An unsupported version of Perl installed — The installation copies files that allow you to install the Perl module after you have installed the supported version of Perl
    • Ensure that the Bash shell is the default shell on all machines where TrueSight Server Automation is being upgrade.
    Review limitations

    Note the limitations when using the unified product installer for product upgrade.

      Click here to review.

    Category Description of support or limitation
    Multiple Application Server (MAS) environments The unified product installer only supports upgrade of an homogeneous MAS environment, that is, either all Application Servers run on Linux 64-bit operating systems or all run on Windows 64-bit operating systems.
    "Mixed" Application Server/database environments The unified product installer supports upgrade of "mixed" Application Server/database environments (for example, Linux Application Server + Microsoft SQL Server database). The UPI does not require the database or the file server operating system to match the operating system of the Application Servers.
    PXE servers

    For PXE servers to be upgraded by the unified product installer, they must be:

    • Up and running.
    • Running the same OS as the Application Server.

    If your environment includes hybrid PXE servers (that is, PXE servers not running Windows or Linux), you must perform a workaround for the upgrade

      Click here to see the workaround.
    1.  Stop the hybrid PXE server / TFTP server.
    2. Run the unified product installer. The installer ignores the PXE server, as it is in a stopped state. The installer upgrades the rest of the infrastructure, with the exception of the hybrid PXE server.
    3. Once the unified product installer has completed the upgrade, run the configurator utility on that PXE server. See Migrating the database and persisting configuration data to the database.
    4. Upgrade the PXE server according to the instructions in Upgrading the Provisioning System.
    5. Copy the global.property file from the Application Server to the /br/deployments/ directory on the PXe server.
    6. Restart the PXE server.
    Upgrade scenarios

    The unified product installer does not support the following upgrade scenarios:

    • 32-bit Windows or 32-bit Linux machines

    • Solaris SPARC machines

    • Upgrading the TrueSight Server Automation Console (RCP client). Uninstall the older version of the console and install the new version on a different host.
    • Application Servers installed with the -local flag, that is installed in a self-contained directory structure.

      
    Test the upgrade in a duplicate environment

    Prior to upgrading your production system, the best practice is to first test the upgrade using a copy of the production database in another environment.

    The steps in Testing the upgrade in a duplicated environment topic cover the high-level steps that you must perform; the specifics will likely vary, depending on the database in use, the operating systems involved, and the particular environment details.
    Upgrade the environment

    See: Walkthrough: Upgrading to the latest version for Linux
    (Optional) Upgrade Live Reporting See: Upgrading Live Reporting
    (Optional) Get assistance through the AMIGO Upgrade Program To assist you in your upgrade, you might be interested in joining the AMIGO Upgrade Program, described in Knowledge Article ID: 000011572.


    Item Description
    Complete preparatory tasks for upgrade

    Review the tasks to complete prior to upgrade:

    Preparing to upgrade individual components on Microsoft Windows or Preparing to upgrade individual components on UNIX and Linux
    Review requirements for upgrading individual components

    Review the basic requirements for upgrading using the individual component installers.

      Click here to review.
    • TrueSight Server Automation versions 8.6 and later require an RSCD agent installed on each Application Server. If you use the unified product installer, the RSCD agents are installed on Application Servers by the installer. However if you use the Individual component upgrade method, ensure that you have RSCD agents installed on each of the Application Servers to avoid potential errors in the upgrade process.
      If you end up installing the RSCD agent on the application server after the upgrade, you must use the -local option in the installation (as discussed in Installing components in non-default installation paths using the local flag).
    • Similarly, if you use the individual component upgrade method, ensure that Network Shell (NSH) and an RSCD agent are installed on the PXE server before performing the upgrade process.
    • If you use the individual component installer method, you must run the Configurator utility on all Application Servers and PXE servers before upgrading TrueSight Server Automation. The Configurator utility reads all existing configuration files and populates the database schema with configuration values present in the user environment. This configuration data is saved in the database for the proper function of TrueSight Server Automation. For more information, see Migrating the database and persisting configuration data to the database

    There are additional requirements for the individual installers, which are listed on each individual installer upgrade topic.
    Test the upgrade in a duplicate environment

    Prior to upgrading your production system, the best practice is to first test the upgrade using a copy of the production database in another environment.

    The steps in Testing the upgrade in a duplicated environment topic cover the high-level steps that you must perform; the specifics will likely vary, depending on the database in use, the operating systems involved, and the particular environment details.
    Upgrade the environment See Walkthrough: Upgrading using the configurator and individual component installers
    (Optional) Upgrade Live Reporting See: Upgrading Live Reporting
    (Optional) Get assistance through the AMIGO Upgrade Program To assist you in your upgrade, you might be interested in joining the AMIGO Upgrade Program, described in Knowledge Article ID: 000011572.

    You can continue to use the earlier versions of RSCD agents without upgrading them to the latest version. However, ensure that their version is 8.9.03 or later to use the patching capabilities in TrueSight Server Automation. For more information, see this flash notification.

    Additional upgrade information

    Which upgrade method should I use?

     Click here to expand a flowchart that can help you decide which upgrade method to use.

      upgrade_flowchart

    Artifacts installed when you upgrade with the unified product installer

    When you upgrade your TrueSight Server Automation environment using the unified product installer, the installer no longer installs or upgrades the following artifacts:

    • ZipKits
    • blcontent
    • SCAP compliance jobs creation
    • Quick start page

    If you want to install or upgrade these artifacts, see any of the following topics:

    Was this page helpful? Yes No Submitting... Thank you
    Last modified by Bipin Inamdar on Sep 13, 2020
    upgrade unified_product_installer

    Comments

    Configuring the Smart Hub and Smart Hub Gateway
    Supported upgrade paths
    © Copyright 1996-2020 BladeLogic, Inc. © Copyright 2014-2020 BMC Software, Inc.
    Legal notices

    Powered by Atlassian Confluence and Scroll Viewport

    © Copyright 2005-2021 BMC Software, Inc. Use of this site signifies your acceptance of BMC’s Terms of Use . BMC, the BMC logo, and other BMC marks are assets of BMC Software, Inc. These trademarks are registered and may be registered in the U.S. and in other countries.