Proxy - Major Upgrade

Before you perform any proxy update, schedule a maintenance window. The clients registered to Uyuni through the proxy will not be able to connect to Uyuni while the update is in progress. For more information about maintenance windows, see administration:maintenance-windows.adoc.

Major proxy upgrades include a version upgrade of the operating system. For more information, see the Uyuni 2021.09 release notes.

Preparation for the Upgrade

Procedure: Update the package opensuse-build-key at the proxies
  1. At the command prompt on the Uyuni Server, as root, use the spacewalk-repo-sync command to sync all the openSUSE Leap 15.2 channels:

spacewalk-repo-sync -p opensuse_leap15_2-x86_64
  1. Update the package openSUSE-build-key on all Uyuni proxies.

Procedure: Adding openSUSE Leap 15.3 Software Channels at the Command Prompt
  1. At the command prompt on the Uyuni Server, as root, use the spacewalk-common-channels command to add the appropriate channels:

    spacewalk-common-channels opensuse_leap15_3 \
    opensuse_leap15_3-non-oss \
    opensuse_leap15_3-non-oss-updates \
    opensuse_leap15_3-updates \
    opensuse_leap15_3-backports-update \
    opensuse_leap15_3-sle-updates \
    opensuse_leap15_3-uyuni-client \
    uyuni-proxy-stable-leap-153
  2. Fully synchronize all channels with spacewalk-repo-sync.

Upgrade the Proxy

To upgrade a proxy you first stop the proxy service, then you replace the software repositories and update the software, and finally you restart the proxy service.

Procedure: Updating the Uyuni Proxy
  1. In the Uyuni Server Web UI, navigate to proxy system’s details page, click the Reactivation subtab.

  2. Click Generate New Key to generate a reactivation key.

  3. On the Uyuni Proxy, stop the proxy service:

    spacewalk-proxy stop
  4. In the Uyuni Server Web UI, navigate to Systems  Proxy and click the name of the proxy.

  5. Click Software  Software Channels, and as the base channel select the openSUSE Leap 15.3 channel that is listed in the Customs Channels list.

  6. In the Child Channels pane, select the 15.3 child channels.

  7. Click Next, and Confirm Software Channel Change with Confirm.

  8. Click Details  Remote Command, add zypper dup --allow-vendor-change to the script field, and click Schedule

  9. Wait until the remote command is executed.

  10. Re-register with the reactivation key using the rhnreg_ks command-line utility. The system is re-registered with the same ID, history, and groups.

  11. On the Uyuni Proxy, start the proxy service:

    spacewalk-proxy start

If you need to update many proxies, you can create an action chain of this command sequence on the Uyuni Server. You can use the action chain to perform updates on multiple proxies at the same time.