$helper.renderConfluenceMacro('{bmc-global-announcement:$space.key}')
 
 
BMC Server Automation 8.7 ... Upgrading Upgrading using individual component installers

Migrating the database and persisting configuration data to the database

BMC 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 BMC 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 BMC 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, spawner, or PXE server that is running on this machine.

  • 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 machine. See RSCD Agent Troubleshooting, to resolve any issues with the RSCD agent.

  • 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 certs - 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.

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 BBSA<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 BMC BladeLogic 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 BMC BladeLogic 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 BBSA<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 BMC BladeLogic 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 BMC BladeLogic 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 BBSA<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 BMC BladeLogic 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 BMC BladeLogic 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 BBSA<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 BMC BladeLogic 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 BMC BladeLogic Server Automation components.

Where to go next

Upgrading using individual component installers

Was this page helpful? Yes No Submitting... Thank you
Last modified by John Stamps on Jan 27, 2017
upgrade 8_8

Comments

  1. N A
    About "For Linux and UNIX, BMC recommends that you execute the installation as a root user":

    I think "recommends" it not accurate as this is not a "recommendation" but a "must" (as the next sentence clearifies).
    Nov 08, 2016 06:58
    1. John Stamps

      Hi Reinhard,

      Thank you for your review comments.

      I'll start cleaning these up.

      Sincerely,

      John 

      Nov 08, 2016 05:38
  2. N A
    To use the configuration utility without using the unified installer, is the program to execute also "setup.bin"? There's not evidence about this.
    Nov 08, 2016 07:04
    1. John Stamps

      Hi Reinhard,

      OK, I found you some hard evidence. I ran the setup.bin command in my 8.8 environment precisely per the documentation and the stateless configuration started to work!

      ./setup.bin -J STATELESS_ONLY=true

      Here's the screenshot.

       

       

      Admittedly, the migration then almost immediately failed due to a different issue that I don't quite understand. But this is Proof of Concept.

      What do you think?

      Sincerely,

      John

      PS Here's the error that killed the migration.

       

      Nov 10, 2016 04:43
  3. N A
    In Step 3. we have "Follow the instructions in the installation wizard to persist the configuration data to the database".

    What if I use the silent installation? Are there any steps I could/should enter into the options file? Would be great to have these options here in place.

    Is there any way other than the silent installation to run the configuration utility on a Linux-server not running a GUI (as nearly every standard Linux-server - at least every standard Linux-server I know)? If not, this should be mentioned under "Limitations".
    Nov 08, 2016 07:15
    1. N A
      This whole upgrade-process is way to "unified-installer"-centric. To run the "configuration utility" I have to copy and unzip the complete 3.8GB-package to each and every application server host.

      For upgrading I could separate the Linux-x64-installer-package but to use the configuration utility, there are some dependencies not mentioned, that prevent using this tool by just copying setup.bin and setup.jar. That's annoying.
      Nov 08, 2016 08:01
    1. John Stamps

      Reinhard,

      I think part of the problem is the silent installation steps are buried in a bullet point.  

      I broke out the 2 sets of steps - the GUI interactive installation versus silent install.

      That should make the steps easier to read.

      We'll publish the public version on Monday. 

      John

      Nov 11, 2016 04:11
    1. John Stamps

      Hi Reinhard,

      Last comment today. (wink)

      Do you want me to create an RFE for these last 3 implementation issues you raise? I'd be delighted to. They aren't really documentation issues per se.

      Make sense?  

      John

      Nov 11, 2016 04:44
  4. N A
    And a final one for today:

    The "configuration-utility" still needs the unpacked RSCD-binary-package. For NO reason...
    Nov 08, 2016 08:14
    1. N A
      ok - this one seems to be fixed. It was a side effect from not having all other files in place.

      So these seem to be needed:
      setup.bin
      setup.jar
      files/jre
      files/sql
      files/_template
      files/_launcher
      Nov 08, 2016 08:33
Walkthrough: Upgrading using the configurator and individual component installers
Upgrading product components on Linux and UNIX
© Copyright 2017 BMC Software, Inc. © Copyright 2017 BladeLogic, Inc.
Legal notices

Powered by Atlassian Confluence and Scroll Viewport

© Copyright 2005-2020 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.