Upgrading in a High Availability Environment

This section describes the procedure to upgrade appliances in high availability setup.

Before you beginThe following prerequisites must be met before starting the upgrade process on your HA appliances.
  • Both HA appliances must have the same hardware model and software version.
  • Ensure that you have read Upgrade Considerations and have performed all tasks mentioned in Preparing to Upgrade the Appliance on each appliance.
  • Ensure that your HA environment is synchronized, by viewing the cluster status on the build details on the top navigation bar. Ensure that there are no warning messages.

  • If currently enabled in your HA environment, disable the following features on the active appliance:
    • Archiving:

      Note down all the archive configuration settings to help you when you reenable the archiving feature.

    • Advanced Features:

      Must be disabled from the CLI. Disabling Advanced Features automatically disables the Monthly Index, Advanced Aggregation, and Monitoring Console features.

This HA upgrade procedure uses the following example appliance information:
Appliance Appliance type IP address
Appliance A HA active 19.0.2.44
Appliance B HA standby 19.0.2.45
Public HA public 19.0.2.46
Network mask 255.255.255.0
Network broadcast 19.0.2.255
Important Considerations

The process of upgrading an HA pair involves disabling HA on the standby appliance (appliance B) and then on the active appliance (appliance A). After upgrading the appliance software on each appliance, you enable HA on appliance B and then on appliance A. Thus, after upgrade, the active and standby appliances are interchanged.

  • Forcing failovers for the purpose of keeping one particular appliance “active” is not recommended, because it has no particular benefit and any failover event causes some loss of data - even if for a few seconds. To force a failover, you must wait until the postupgrade process is complete.
  • The log data collected on appliance A after disabling HA is ignored while setting up HA on appliance A during initialization and syncing.
Note: The terms "active" and "standby" might suggest that these appliances are not equivalent in every respect. In fact, they must have identical capabilities for High Availability pairing to work. Therefore, for clarity during the upgrade process below, the original active appliance is referred to as "appliance A" and the original standby appliance is referred to as "appliance B" (even though their roles reverse and then revert).
    Procedure
    Disable HA on appliance B (standby):
  1. From the CLI, disable the HA configuration:
    1. From a command prompt, log in as the root user, and type the password.
    2. Run the following command to disable HA: 
      set failover disable
    3. When the prompt displays the message CHANGES HAVE NOT BEEN SAVED!, type save and then press Enter.
  2. Install the correct version of LogLogic LSP.
  3. Perform the GUI upgrade steps.
  4. After the appliance reboots, run the postupgrade script as described in Running the Postupgrade Script.
    5. Disable HA on appliance A (active):
  5. From the CLI, disable the HA configuration:
    1. From a command prompt, log in as the root user, and type the password.
    2. Run the following command to disable HA: 
      set failover disable
    3. When the prompt displays the message CHANGES HAVE NOT BEEN SAVED!, type save and then press Enter.
    6. Configure appliance B as the active appliance:
  6. Set up HA configuration:
    1. From a command prompt, log in as the root user, and type the password.
    2. Run the following command to set up HA: 
      set failover configure
    3. Enter the IP addresses of the cluster: <HA_public_IP_address> <network_mask> <network_broadcast> bond0.
      For example: 
      19.0.2.46 255.255.255.0 19.0.2.255 bond0
    4. When prompted about this appliance being the destination of automatic migration:
      Enter N.

      Type the IP address of the peer appliance (appliance A): 19.0.2.44

    5. Follow the prompts. Ensure that you type save when prompted.
      Wait until done is displayed on the CLI, indicating that the HA setup is successful on the appliance.
    At this point, appliance B has become the active appliance. As appliance A is no longer part of the HA pair, it is reported as "out of cluster" by appliance B.
    7. Configure appliance A as the standby appliance:
  7. Install the correct version of LogLogic LSP.
  8. Perform the GUI upgrade steps.
  9. After the appliance reboots, run the postupgrade script as described in Running the Postupgrade Script.
  10. After the upgrade process completes successfully, set up the HA configuration:
    1. From a command prompt, log in as the root user, and type the password.
    2. Run the following command to set up HA: 
      set failover configure
    3. Enter the IP addresses of the cluster: <HA_public_IP_address> <network_mask> <network_broadcast> bond0.
      For example: 
      19.0.2.46 255.255.255.0 19.0.2.255 bond0
    4. When prompted about this appliance being the destination of automatic migration:
      Enter Y.

      Type the IP address of the peer appliance (appliance B):

      19.0.2.45
    5. Follow the prompts. Ensure that you type save when prompted.
      Wait until done is displayed on the CLI, indicating that the HA setup is successful on the appliance. Appliance A has become the standby appliance.
ResultThe upgrade is complete. Appliance B is active and appliance A is standby.
What to do next After upgrade is successful, perform the following tasks:
  • (Only for TIBCO LogLogic® LX1025 Appliance) Enable the swap file by performing the following steps:
    1. Log in to the appliance through SSH as toor user.
    2. Run the following command: 
      $ /loglogic/scripts/enable_12g_swap_file.sh
  • Reenable the following features if you had disabled them before starting the upgrade process:
    • Archiving
      Important: Do not change any settings in the archive configuration while re-enabling the archive feature.
    • Advanced Features

      After enabling Advanced Features, you can explicitly enable the Monthly Index, Advanced Aggregation, and Monitoring Console - as applicable. In an HA environment, you can enable the Advanced Features, Advanced Aggregation, and Monitoring Console only from the CLI on the active appliance.