Important

   

This space contains documentation for TrueSight Server Automation 8.9.03 and the later service packs for 8.9. For earlier releases, see BMC Server Automation 8.9.

Upgrading using individual component installers

The topics in this section provide information and instructions for upgrading the individual components of the TrueSight Server Automation system. You can alternatively upgrade the product using the unified product installer

Note

TrueSight Server Automation version 8.6 and later requires an RSCD agent installed on each Application Server. Therefore, ensure that you have RSCD agents installed on each of the Application Servers to avoid potential errors in the upgrade process. Similarly, ensure that Network Shell (NSH) and an RSCD agent are installed on the PXE server before performing the upgrade process.

The following table provides a high-level description of the process for upgrading components of the TrueSight Server Automation system and includes links to topics with detailed instructions.

Tip

Prior to upgrading your production environment, it is best practice to test the upgrade in a duplicated environment.

 StepDescriptionSupporting topic
1Prepare the environment for upgrade

Review the supported upgrade paths and upgrade considerations and perform the preliminary upgrade steps, such as shutting down the TrueSight Server Automation environment and backing up the installation directories for all Application Servers and PXE servers. In addition, prepare your database for the upgrade.

If your id.pem certificate was created with a key size of 1024 bits (or less), you will need to regenerate it with a higher key size (2048 or higher). This is due to a change in the FIPS requirement for minimum key length (now 2048 bits).

Preparing to upgrade individual components on UNIX and Linux

Preparing to upgrade individual components on Microsoft Windows

2Migrate the database schema to the new version and persist blasadmin configuration data to the database

Run the configurator utility to perform the following tasks:

  • Migrate the database. You are no longer required to manually migrate the database as the configurator performs this task for you.

  • Populate the database schema with configuration data from the application servers that is necessary for the proper function of TrueSight Server Automation after the upgrade.
Migrating the database and persisting configuration data to the database
3

Upgrade at least one Application Server

Do not start the the Application Server upgrade until you complete the database migration and the operation to copy the application server configuration data (blasadmin) on all application and pxe servers in the environment to the database. Additional upgrades that occur at this point depend on where the Application Server resides:

  • On a Microsoft Windows computer, an upgrade of the Application Server also upgrades the Network Shell. 
  • On a Linux or UNIX computer, an upgrade of the Application Server also upgrades all components that were installed as part of the earlier installation of the Application Server. These components can include the Network Shell, the RSCD agent, and the PXE server.
  • On a Linux and UNIX computer (installed using the -local option)
    If the Application Server was installed with the -local option, on a Linux or UNIX computer, the Application Server must be upgraded using the -local option. Several environment variables must be set before starting the upgrade process.

Upgrading the Application Server on Windows

Upgrading product components on Linux and UNIX

4Post-upgrade updates

Run the postmigration (.exe or .sh) file to update BLPackages that refer to old Group Policy Object (GPO) assets.

Performing post-migration updates 
5Upgrade TrueSight Server Automation Console

Upgrade at least one TrueSight Server Automation Console.

Note

As of version 8.9 of TrueSight Server Automation, you can choose not to upgrade certain consoles. Specifically, version 8.9 of the TrueSight Server Automation Application Server supports communication with TrueSight Server Automation Consoles of version 8.8. To enable this backward support for any specific Application Server, you must use the blasadmin command versioncompabilitycheck to turn off the version compatibility check that occurs whenever you access a Console. For more information, see To enable communication with clients of an earlier version of TrueSight Server Automation

Upgrading the TrueSight Server Automation Console
6Upgrade the TrueSight Server Automation provisioning systemIf you have upgraded the provisioning server (the Application Server enabled for provisioning), upgrade the components that TrueSight Server Automation uses in provisioning operating systems to bare metal machines.

Upgrading the Provisioning System

Upgrading a PXE server on Windows

Upgrading a PXE server on Linux or UNIX

7

Upgrade additional components

 

Upgrade the other TrueSight Server Automation Application Servers, consoles, RSCD agents, and other components in your enterprise (including on any file servers or virtual servers). 

Note

If the TrueSight Server Automation file server resides on a different computer from the Application Server, upgrade the RSCD agent on the computer on which file server resides. The file server and the database must be at the same version before you run TrueSight Server Automation.

Upgrading the file server 

Upgrading RSCD agents on Windows

Upgrading the Network Shell on Windows

Upgrading the RSCD agent on Linux and UNIX

Upgrading the Network Shell on Linux and UNIX

8Upgrade custom configuration objects

Upgrade any custom configuration objects that you have created and distributed.

Upgrading to a new release can potentially create mismatches between the version of a custom configuration object, an agent, and any model objects that reference custom configuration objects. For more information, see Upgrading custom configuration objects.
Upgrading custom configuration objects
9Upgrade Compliance ContentPerform an over-the-top installation of the new Compliance Content add-ons.Installing and configuring Compliance Content add-ons
10Import out-of-box content and enable the quick start page and dashboards

Import optional out-of-box content into TrueSight Server Automation to support common tasks and use cases, and enable the quick start page and Health and Value Dashboards, optional user interfaces. These objects and user interfaces are installed or activated automatically by the unified product installer, but not by the individual component installers.

Importing out-of-box content and enabling the dashboards and quick start page 
11Perform a sanity check of the upgradeConfirm that the upgrade was successful by performing a few tests, such as confirming that the file server agent is running. 
Was this page helpful? Yes No Submitting... Thank you

Comments