5.4 Upgrading the Appliance

You can upgrade the Sentinel Log Manager appliance either by using the WebYaST or by using SMT.

5.4.1 Upgrading the Appliance through WebYast

NOTE:If you are upgrading Sentinel Log Manager appliance that is on a operating system prior to SLES 11 SP3, you must upgrade the appliance by using the zypper command line utility because user interaction is required to complete the upgrade. WebYaST is not capable of facilitating the required user interaction. For information about using zypper to upgrade the appliance, see Section 5.4.2, Upgrading the Appliance by Using Zypper

  1. Specify the URL of the Sentinel Log Manager using the port 4984 to launch WebYaST.

  2. Log in to WebYast using the appliance credentials.

  3. Make a backup of your configuration, then create an ESM export.

    For more information on backing up data, see Backing Up and Restoring Data.

  4. (Conditional) If you have not already registered the appliance for automatic updates, register it.

    For more information, see Section 4.10, Registering for Updates.

    If the appliance is not registered, a yellow warning is displayed in WebYast, indicating that the appliance is not registered.

  5. To check if there are any updates, click Updates.

    The available updates are displayed.

  6. Select and apply the updates.

    The updates might take a few minutes to complete. After the update is successful, the WebYaST login page is displayed.

    Before upgrading the appliance, WebYaST automatically stops the Sentinel Log Manager service. You must manually restart this service after the upgrade is complete.

  7. Restart the Sentinel Log Manager server by using the Web UI.

    For more information, see Section 4.9, Stopping and Starting the Appliance by Using Web UI.

5.4.2 Upgrading the Appliance by Using Zypper

To upgrade the appliance by using the zypper patch:

  1. Make a backup of your configuration, then create an ESM export.

    For more information on backing up data, see Backing Up and Restoring Data.

  2. (Conditional) If you have not already registered the appliance for automatic updates, register it.

    For more information, see Section 4.10, Registering for Updates.

    If the appliance is not registered, a yellow warning is displayed in WebYast, indicating that the appliance is not registered.

  3. Log in to the appliance console as the root user.

  4. Run the following command:

    usr/bin/zypper patch
    
  5. (Conditional) If you are upgrading Sentinel Log Manager prior to version 1.2, a message is displayed indicating a squashfs version conflict. Enter 1 to upgrade squashfs version 4.0-1.2.10 and to accept the vendor change.

    Sentinel Log Manager 1.1. versions use squashfs version 3.4, but Sentinel Log Manager 1.2 and later use squashfs version 4.0. Also, the vendor for squashfs yast2-live-installer has changed from OpenSUSE to SLES. To proceed with the upgrade, you must first upgrade squashfs and accept the vendor change.

  6. Enter Y to proceed.

  7. (Conditional) If you are upgrading Sentinel Log Manager prior to version 1.2, the end user license agreement for Sentinel Log Manager is displayed. Enter yes to accept the license.

    The license agreement for Sentinel Log Manager 1.2 and later is different from the license agreement for Sentinel Log Manager 1.1. You must accept the new license agreement to upgrade Sentinel Log Manager 1.1 and later to 1.2 and later.

  8. (Conditional) If you are upgrading Sentinel Log Manager appliance that is on a operating system prior to SLES 11 SP3, the end user license agreement is displayed. Enter yes to accept the license.

    The Sentinel Log Manager appliance upgrades successfully.

  9. (Conditional) If you are upgrading Sentinel Log Manager prior to version 1.2, after the upgrade is complete, a deprecation warning is displayed.

    This is because Sentinel Log Manager 1.2.0.1 uses WebYaST 1.1, but Sentinel Log Manager 1.1 versions use WebYaST 1.0. During the upgrade, the WebYaST 1.0 language module is deprecated in WebYaST 1.1. However, this warning does not affect the upgrade.

  10. Restart the Sentinel Log Manager appliance.

5.4.3 Upgrading the Appliance by Using SMT

In secured environments where the appliance must run without direct internet access, you must configure the appliance with Subscription Management Tool (SMT), which enables you to upgrade the appliance to the latest available versions.

  1. Ensure that the appliance is configured with SMT.

    For more information, see Section 4.8, Configuring the Appliance with SMT.

  2. Log in to the appliance console as the root user.

  3. Refresh the repository for upgrade:

    zypper ref -s
    
  4. Check whether the appliance is enabled for upgrade:

    zypper lr
    
  5. (Optional) Check the available updates for the appliance:

    zypper lu
    
  6. (Optional) Check the packages that include the available updates for the appliance:

    zypper lp -r SMT-http_<smt_server_ipaddress>:SLM-1.1.0.0-ISO
    
  7. Update the appliance:

    zypper up -t patch -r SMT-http_<smt_server_ipaddress>:SLM-1.1.0.0-ISO
    
  8. Restart the appliance.

    rcsentinel_log_mgr restart