Upgrading product components on Linux and UNIX

A component-level upgrade of the Application Server on Linux and UNIX also upgrades all components that were installed as part of the previous installation. These components can include the Network Shell, the RSCD agent, and the PXE server. Upgrading the Application Server does not upgrade the TrueSight Server Automation Console. You must upgrade the console separately.

Notes

  • You must upgrade the Application Server and TrueSight Server Automation Console to the same version, whether they are located on the same computer or different computers.
  • Upgrade the Application Server and NSH to the same version, so that the NSH proxy works properly. The NSH supports backward compatibility but not forward compatibility. For example, the 8.8 NSH can communicate with 8.7 RSCD agents but not with 8.9 agents. 
  • If the Application Server and the TrueSight Server Automation Console are on the same computer, you must upgrade the Application Server before upgrading the console.
  • As of version 8.9 of TrueSight Server Automation, you can choose not to upgrade certain consoles. For more information, see To enable communication with clients of an earlier version of TrueSight Server Automation.
  • 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. For more information, see Upgrading-components-using-the-local-option-on-UNIX-or-Linux.

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.

To perform a silent upgrade of an Application Server, see Using-silent-mode-to-upgrade-components-on-Linux-or-UNIX.

Prerequisite

Before upgrading the Application Server, ensure that the database configuration information on the deployments of the Application Server is up-to-date.

You can use the blasadmin utility to check the database- and file server-related information for each of the deployments (except _launcher). You can use the following blasadmin commands:

  • blasadmin -s <delpoyment name> show database all (for _pxe deployments use blasadmin -s _pxe show pxe all)
  • blasadmin -s <deployment name> show file all

If either of these commands return an error, you can use the blasadmin utility to correct the configuration information and proceed with the upgrade.

TrueSight Smart Reporting for Server Automation upgrade requirement

If your TrueSight Server Automation environment includes TrueSight Smart Reporting for Server Automation, upgrade TrueSight Smart Reporting for Server Automation before upgrading TrueSight Server Automation. For more information, see the online technical documentation for TrueSight Smart Reporting for Server Automation.

To upgrade the Application Server on Linux and UNIX

  1. Log on as root.
  2. Stop the Application Server.
  3. Navigate to the directory that contains Application Server installer files (which follow the naming convention: BSA<version>-<platform>). Run the installer file using the ./<BL_Installer_file.sh> command. The following message is displayed:
    A previous installation already exists.
    Do you wish to continue (y/n) ?
  4. Enter y.
     A message is displayed that lets you choose a language for the installation program.
  5. Enter the number corresponding to the language that you want to use.
    The following message is displayed:
    Welcome to the TrueSight Server Automation Release <versionNumber> installation script ...
    A previous installation has been detected. This installation will be upgraded to TrueSight Server Automation <versionNumber>.
    Do you wish to continue (y/n) ?
  6. Enter y.
    Licensing text is displayed and concludes with the following message:
    Do you agree to the terms of the license agreement (y for Yes) ?
  7. Enter y.
    A list displays the TrueSight Server Automation components to be upgraded and prompts you to continue.
  8. Enter y.
    A series of messages is displayed, and then the upgrade script is complete.

Where to go from here

Upgrade at least one TrueSight Server Automation Console. See Upgrading-the-TrueSight-Server-Automation-Console-on-Windows.