Skip to content

Updates in the Appliance

What's required for updates?

  • An activation key for update channel registration.

  • Each node in the cluster must be in a ready state before you attempt to update.

Registering the appliance for software updates

To receive online updates, which reduce the overhead of managing security patches and bug fixes, first register the appliance.

Registration steps

  1. Log in to the Appliance Administration console using the root account at https://hostname:9443.

  2. Click Online Update.

  3. The Registration dialog should display. If not, click Register.

  4. Select Micro Focus Customer Center as the service type.

  5. Specify the following information about the account for this appliance:

    • Email address of the account in Customer Center.

    • Activation key. To obtain the key:

      a. Log in to Software Licenses and Downloads (SLD) portal.

      b. Click the Activations tab.

      c. Locate your product.

      d. Click Download <Appliance Update Channel Activation Key.txt>

      e. Open the file to view the activation key.

  6. Select an option to share information with Open Text:

    • Hardware profile
    • Optional information

  7. Click Register.

  8. Wait while the appliance registers with the service, then click OK.

    You can now view a list of the needed and installed updates. You can use manual or automatic options to update the appliance.

Manage appliance software updates

Software updates are delivered through two mechanisms in the appliance:

  • Online Update: Delivers regular security patches to the OS and installed products.

  • Upgrade: Delivers more significant upgrades to the OS and installed products.

Notes

  • To supervise system changes, we recommend manually updating your appliance and not using the automatic scheduling feature.
  • Both Online Updates and Upgrades occasionally require rebooting the appliance. A "Reboot Needed" option is displayed in the upper right corner of the Appliance Administration console when this is called for.
  • Some product updates involve an OS upgrade. This ensures the availability of OS security updates. In this case, both the Online Update and Upgrade tools are used when updating.

Preparing to update

  • Be prepared to supply the email address and activation key that were used during initial registration.

  • To ensure easy recovery in case of errors, take a snapshot of the current configuration before updating.

Caution

The cluster will be unavailable for end users during the update process. We recommend planning a maintenance window accordingly.

Installing updates and upgrades

To update your appliance, first ensure all nodes in the deployment are in a Ready state by clicking Cluster in the Appliance Administration console. Then perform these steps.

  1. On each node in the cluster, update one node at a time by repeating the following steps:

    a. In the Appliance Administration console, click Online Update.

    b. Click Update Now to install the updates.

    c. After the updates are installed, click Close.

    d. If the Upgrade button shows a badge indicating an Upgrade is available, click Upgrade.

    • Click Start. Then review the license.
    • Register using the same email address and activation key as used during initial registration.
    • Click OK on the Update Now dialog. Wait while the upgrade is performed.

    e. Click Reboot. After reboot finishes, in the Appliance Administration console click Cluster. Under Cluster Status, wait until the updated node shows a STATUS of Ready. It can take up to 15 minutes for the node to become Ready.

    • Throughout the cluster update process, it is normal to see warnings and errors in the lower sections of the Cluster view. These will clear once the entire update process is complete.

    f. Click Online Update again to check for and install any new updates that are available. If updates were installed and a reboot was required, wait for the node to show Ready again in the Cluster View.

    g. Move on to the next node in the cluster.

  2. Once all of the nodes in the cluster have been updated, enable SSH on any node in the cluster.

    a. In the Appliance Administration console, click System Services.

    b. Click SSH.

    c. Click Action > Start.

  3. On a node in the cluster that has SSH enabled, ssh into the appliance shell (command line interface) as the root user and run: cspctl cluster scale

  4. In the Appliance Administration console, click Cluster.

    Wait for the cluster to return to a healthy state with all nodes showing Ready. This process can take up to 15 minutes.

Back to top