Migrating the database and persisting configuration data to the database

TrueSight Server Automation requires all configuration data to be copied on the database. This step is performed automatically by the unified product installer. However, if you use the individual component installers for upgrade, you will have to perform this step by running the configurator utility. 

The configurator performs a database migration and then persists configuration data into the database. You must run the configurator on all Application Servers and PXE servers in your TrueSight Server Automation environment before you upgrade the servers using the individual component installers.  

Note

In the case of a Multiple Application Server (MAS) environment, perform this task on at least one Application Server if the MAS setup is on a platform other than Windows 64-bit and Linux 64-bit, so that the database migration/upgrade is successful.

Perform this task first on an Application Server (preferably an Application Server configured as a configuration server), and then on the PXE servers.

Before you begin

Before running the configurator utility on an Application server or a PXE server, to migrate configuration data to the database, ensure the following:

  • The configurator utility must be run by a super user, that is, a local Administrator or Administrator-equivalent local user.
  • If you have a high security level enabled in your TrueSight Server Automation installation, the configurator utility cannot copy the configuration data through the RSCD Agent on the remote host computers. Before upgrading, you must temporarily adjust the security level on the machines where you want to upgrade the Application Servers. After the upgrade, remember to re-adjust your security settings, based on your unique needs and the IT security policies at your organization. For more information on defining the security level, see Security-planning.
  • Stop any application server, or PXE server that is running on this server.
  • Ensure that NSH is installed on all the PXE servers on which you intend to run the configurator utility. 
  • Ensure that the RSCD agent service is running on this server. 
  • You must disable the use of client-side certificates that secure access between Application Servers and agents or repeaters before you upgrade using the unified product installer. For more information, see TLS-with-client-side-certificates-Discontinuing-use-of-client-side-certificates.
  • If you have installed the Application Server on Linux using the -local option, you must set the NSHDIR environment variable before running the configurator utility. For more information, see Installing-components-in-non-default-installation-paths-using-the-local-flag.
    Use the following command to set the NSHDIR variable:
    export NSHDIR=<AppserverInstallationPath>/NSH
    where, <AppserverInstallationPath> is the path where the Application Server has been installed using the -local option.
    For example, export NSHDIR=/opt/bmc/bladelogic/NSH

Limitations

Note that the configurator will not run successfully in either of the following cases:

  • RSCD agent is running an expired license.

  • Network Shell is configured to run in proxy mode and communicates only with the NSH proxy server.

    Note

    If NSH proxy is enabled, while manually migrating the database and persisting configuration data to the database an incorrect error message is displayed, as follows:
    RSCD agent is not installed or the service is not running. Please ensure that the RSCD agent is running on this host compute.
    To resolve this error you will have to disable the NSH proxy server and re-run the configurator. To disable the NSH proxy server remove the corresponding entry from the secure file.

To run the Windows configurator utility

To run the configurator utility, you must use the unified product installer package for Windows and perform the following steps. Ensure that you have shut down all Application Servers and PXE servers before you proceed with the following steps. Perform these steps on each and every Application Server and PXE server to copy the data from blasadmin into the database.

Using interactive installation with the GUI

  1. Download and extract the Windows installation package for the operating system level and hardware platform in a <temporary directory> on the Application Server or PXE server. The package follows the naming convention BSA<version>-<platform>.zip, and contains the unified product installation program files.
  2. Navigate to the <temporary location> directory containing installation files.
  3. Run the setup.exe installation file with the STATELESS option. The –J STATELESS_ONLY=true option is necessary only for a 64-bit platform. It is not necessary for a 32-bit platform. 
    For example: setup.exe -J STATELESS_ONLY=true

  4. Follow the instructions in the installation wizard to persist the configuration data to the database. After this process completes, you can upgrade TrueSight Server Automation using the individual component installer. For more information, see Upgrading-using-individual-component-installers.

    Note

    Start the Application Servers and PXE Servers only after you have upgraded the individual TrueSight Server Automation components.

Using silent installation

  1. Download and extract the Windows installation package for the operating system level and hardware platform in a <temporary directory> on the Application Server or PXE server. The package follows the naming convention BSA<version>-<platform>.zip, and contains the unified product installation program files. 
  2. Navigate to the <temporary location> directory containing installation files.
  3. Run the setup.exe installation file in silent mode with the STATELESS option. The –J STATELESS_ONLY=true option is necessary only for a 64-bit platform. It is not necessary for a 32-bit platform. 
    1. In a text editor, create an options.txt file that contains the following line:
      –J STATELESS_ONLY=true
    2. Run the following command from the <temporary location> directory that contains the installation files:
      setup.exe -i silent -DOPTIONS_FILE=<full path to options file>

  4. After this process completes, you can upgrade TrueSight Server Automation using the silent mode. For more information, see Upgrading-silently-using-the-unified-product-installer.

    Note

    Start the Application Servers and PXE Servers only after you have upgraded the individual TrueSight Server Automation components.

To run the Linux configurator utility

To run the configurator utility, you must use the unified product installer package for Linux and perform the following steps. Ensure that you have shut down all Application Servers and PXE servers before you proceed with the following steps. Perform these steps on each and every Application Server and PXE server to copy the data from blasadmin into the database.

Using interactive installation with the GUI

  1. Download and extract the Linux installation package for the operating system level and hardware platform in a <temporary directory> on the Application Server or PXE server. The package follows the naming convention BSA<version>-<platform>.zip, and contains the unified product installation program files.
    On a Linux or UNIX machine, you must assign executable permissions to the installation files that you unzipped, by entering the following command.
    chmod +x -R <temporary directory>


  2. Navigate to the <temporary location> directory containing installation files.

    Note

    For Linux and UNIX, you must execute the installation as a root user. Do not execute the installation file from a non-root account.

  3. Run the setup.bin installation file with the STATELESS option. The –J STATELESS_ONLY=true option is necessary only for a 64-bit platform. It is not necessary for a 32-bit platform. 
    For example:
    ./setup.bin -J STATELESS_ONLY=true

  4. Follow the instructions in the installation wizard to persist the configuration data to the database. After this process completes, you can upgrade TrueSight Server Automation using the individual component installer. For more information, see Upgrading-using-individual-component-installers.

    Note

    Start the Application Servers and PXE Servers only after you have upgraded the individual TrueSight Server Automation components.

Using silent installation

  1. Download and extract the Linux installation package for the operating system level and hardware platform in a <temporary directory> on the Application Server or PXE server. The package follows the naming convention BSA<version>-<platform>.zip, and contains the unified product installation program files.
    On a Linux or UNIX machine, you must assign executable permissions to the installation files that you unzipped, by entering the following command.
    chmod +x -R <temporary directory>


  2. Navigate to the <temporary location> directory containing installation files.

    Note

    For Linux and UNIX, you must execute the installation as a root user. Do not execute the installation file from a non-root account.

  3. Run the setup.bin installation file in silent mode with the STATELESS option. The –J STATELESS_ONLY=true option is necessary only for a 64-bit platform. It is not necessary for a 32-bit platform. 
    1. In a text editor, create an options.txt file that contains the following line:
      –J STATELESS_ONLY=true
    2. Run the following command from the <temporary location> directory that contains the installation files:.
      /setup.bin -i silent -DOPTIONS_FILE=<full path to options file>

  4. After this process completes, you can upgrade TrueSight Server Automation using the silent mode. For more information, see Upgrading-silently-using-the-unified-product-installer.

    Note

    Start the Application Servers and PXE Servers only after you have upgraded the individual TrueSight Server Automation components.

Where to go next

Upgrading-using-individual-component-installers

 

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