14.3 Upgrading the Appliance Installation

For information about appliance upgrade paths, see Appliance Upgrading Paths.

Ensure that NTP synchronized your computer time with the network time. To upgrade the Change Guardian appliance, complete the following step:

Applying Updates

After completing the upgrade, perform the post upgrade configurations.

14.3.1 Applying Updates

The following are the three methods in which you can apply updates:

Applying Updates By Using the Change Guardian Appliance Console

Pre-requisites:

Download and run the utility change_guardian_appliance_configuration_utility-<version>.tar.gz from Change Guardian downloads page.

  1. Register to the Change Guardian appliance update channel.

  2. Get the Change Guardian and the operating system updates from the appliance update channel.

    NOTE:Check whether the product and operating system repositories are available and are enabled. If the two repositories are not available, reregister the appliance.

  3. Log in to the Change Guardian Appliance Console as vaadmin or root user using the following URL: https://IP_Address_Change_Guardian_server:9443.

  4. Click Online Update.

    NOTE:When you apply appliance patches on a Change Guardian appliance, you will see a few conflicts for OS patches. Ensure to select Solution 1 to perform deinstallation of packages to proceed with upgrade for the conflicts.

  5. (Conditional) If you want to schedule online updates, click Schedule and select the frequency.

  6. (Conditional) If you want to update manually, complete the following steps:

    1. Click Schedule > Manual.

    2. To view the list of available patches, click Refresh.

    3. Select Needed Patches from the drop-down list and click Update Now.

    4. Select Needed Patches from the drop-down list to ensure that there are no pending updates.

  7. (Conditional) If you want to view the details of a patch, complete the following steps:

    1. Select Installed Patches or Needed Patches.

    2. Select the name of the patch and click View Info.

  8. Log in to the Change Guardian server as root.

  9. Install the operating system package updates:

    zypper up

  10. Restart the Change Guardian services:

    rcsentinel start

    NOTE:If you receive an error message during the restart, see Applying Updates on Change Guardian Appliance Fails With an Error Message for troubleshooting steps.

  11. Restart the Change Guardian server:

    reboot

Applying Updates Using Zypper

Zypper is a command-line package manager that allows you to perform an interactive upgrade of the Change Guardian appliance.

Pre-requisites:

Download and run the utility change_guardian_appliance_configuration_utility-<version>.tar.gz from Change Guardian downloads page.

  1. Register to the Change Guardian appliance update channel.

  2. Get the Change Guardian and the operating system updates from the appliance update channel.

  3. Log in to the Change Guardian server as root.

  4. (Conditional) Check whether the product and operating system repositories are available and are enabled:

    zypper lr

    NOTE:If the two repositories are not available, reregister the appliance.

  5. Check for available updates:

    zypper lp

  6. Run the following command:

    zypper patch

    This checks the installed packages and resolves any file conflicts.

  7. Rerun the command to install appliance updates:

    zypper patch

    NOTE:When you apply appliance patches on a Change Guardian appliance, you will see a few conflicts for OS patches. Ensure to select Solution 1 to perform deinstallation of packages to proceed with upgrade for the conflicts.

  8. Install the operating system updates:

    zypper up

  9. Restart the Change Guardian services:

    rcsentinel start

    NOTE:If you receive an error message during the restart, see Applying Updates on Change Guardian Appliance Fails With an Error Message for troubleshooting steps.

  10. Restart the Change Guardian appliance:

    reboot

For more information about Zypper, see Zypper Cheat Sheet.

Performing Offline Updates

You can perform an update by using an offline ISO file under the following conditions:

  • When there is no internet access and you are unable to register the appliance.

  • When you prefer not to download the latest release available in the appliance download repository, but an earlier release. For more information, see Product Support Lifecycle.

  • When the current version that you are running is incompatible with the latest version, download a version that is compatible and then upgrade it to the latest version. For more information, see Product Support Lifecycle.

While applying the patch, if you encounter registry/ repository issues, clear the registry and repository entries in your system.

To clean up the registration and repository details on the appliance:

  • Take a backup of the files before clearing the registry entries and create a backup directory. For example: mkdir /etc/zypp/backup

  • Copy the following registry files to the backup directory. For example:

    • cp /etc/zypp/credentials.d /etc/zypp/backup

    • cp /etc/zypp/repos.d/* /etc/zypp/backup

    • cp /etc/zypp/services.d/* /etc/zypp/backup

  • Delete the following registry files:

    rm -fr /etc/zypp/credentials.d

    rm -fr /etc/zypp/repos.d/*

    rm -fr /etc/zypp/services.d/*

For more information, contact Technical Support.

Applying the ISO Patch

Pre-requisites:
  • Download the migration file change_guardian_appliance_configuration_utility-<version>.tar.gz from Downloads website.

  • Log in to the server as root.

  • Extract the files:

    tar -zxvf change_guardian_appliance_configuration_utility-<version>.tar.gz

  • Change to the directory where the file was extracted.

  • Run the migration utility:

    ./cg<version>_appliance_configuration.sh

  • Follow the instructions

To apply the patch:
  1. Download the patch to a directory. For example: <directoryname>/change_guardian_offline_appliance-<version>.iso

  2. Create a directory for mounting the CD using a command. For example: mkdir -p /opt/trial

  3. Mount the patch CD locally using a command. For example:

    mount <directoryname>/change_guardian_offline_appliance-<version>.iso /opt/trial

  4. Add the product and operating system repositories. For example:

    zypper ar -c -t plaindir "/opt/trial/product-repo" "<product repository>"

    zypper ar -c -t plaindir "/opt/trial/osupdate-repo" "<operating system repository>"

  5. (Optional) Confirm if the repos are added successfully using the command: zypper repos

  6. Check if the patches are bundled in the patch CD using the command: zypper lp

  7. Run command zypper patch. This checks the installed packages and resolves any file conflicts.

  8. Rerun the command to install appliance updates: zypper patch

    NOTE:When you apply appliance patches on a Change Guardian appliance, you will see a few conflicts for OS patches. Ensure to select Solution 1 to perform deinstallation of packages to proceed with upgrade for the conflicts.

  9. Install the operating system updates: zypper up

  10. Clean up the repositories list using the following command:

    zypper rr "<product repository>"

    zypper rr "<operating system repository>"

  11. Start Change Guardian services before reboot: rcsentinel start

  12. After the update is complete, reboot the machine using the command: reboot