Proxy - Upgrade Procedure

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.

Preparation

As a preparation step, add the openSUSE Leap 15.2 channels to the server.

Procedure: Adding 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_2 \
    opensuse_leap15_2-non-oss \
    opensuse_leap15_2-non-oss-updates \
    opensuse_leap15_2-updates \
    opensuse_leap15_2-uyuni-client \
    uyuni-proxy-stable-leap-152
  2. Fully synchronize all channels with spacewalk-repo-sync. In case of already defined repository URLs, continue with Uyuni 2020.07: Troubleshooting with Duplicated Repository URLs.

Uyuni 2020.07: Troubleshooting with Duplicated Repository URLs

If you want to add two or more repositories with the same URL (client tools for openSUSE Leap 15.0, 15.1, and 15.2) in Uyuni 2020.07 with spacewalk-common-channels, you will see an error such as:

ERROR: opensuse_leap15_2-uyuni-client-x86_64:
redstone.xmlrpc.XmlRpcFault: There's already a defined repository with given url, please reuse it

Work around with assigning the 15.1 repository to the 15.2 channel:

Procedure: Assigning 15.1 Repositories to the 15.2 Channel:
  1. In the Uyuni Server Web UI, navigate to Software  Manage  Channels and click the Uyuni Client Tools for openSUSE Leap 15.2 (x86_64) channel name.

  2. In the upper right corner, click Manage Channel.

  3. Click the Repositories tab, and select External - Uyuni Client Tools for openSUSE Leap 15.1 (x86_64)

  4. Click Update Repositories.

  5. Navigate to Repositories  Sync subtab, and click Sync Now.

  6. Do the same with Uyuni Proxy Stable for openSUSE Leap 15.2 (x86_64) and External - Uyuni Proxy Stable for openSUSE Leap 15.1 (x86_64).

If you unfold the openSUSE Leap 15.2 (x86_64), you will see all child channels propulated with packages.

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.2 channel that is listed in the Customs Channels list.

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

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

  8. Click Software  Packages  Upgrade, and select all the packages to be updated on the proxy, and then apply the selection.

  9. Re-register with the reactivation key using the rhnreg_ks command-line utility. The system will be re-registered with the same id, history, and groups.

  10. 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.