Proxy - Upgrade Procedure

Before you perform any proxy update, schedule a maintenance window. The clients registered to SUSE Manager through the proxy will not be able to connect to SUSE Manager while the update is in progress. For more information about maintenance windows, see Maintenance Windows.

1. Preparation

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

Procedure: Adding Software Channels at the Command Prompt
  1. At the command prompt on the SUSE Manager 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 \
  2. Fully synchronize all channels with spacewalk-repo-sync. In case of already defined repository URLs, continue with Troubleshooting Duplicate Repository URLs.

2. Troubleshooting Duplicate Repository URLs

If you add two or more repositories with the same URL (client tools for openSUSE Leap 15.0, 15.1, and 15.2) in SUSE Manager with spacewalk-common-channels, an error like this is shown:

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 SUSE Manager 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. Navigate to 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).

Expand the openSUSE Leap 15.2 (x86_64) channel to see the child channels populated with packages.

3. 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 SUSE Manager Proxy
  1. In the SUSE Manager 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 SUSE Manager Proxy, stop the proxy service:

    spacewalk-proxy stop
  4. In the SUSE Manager 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.5 channel that is listed in the Customs Channels list.

  6. In the Child Channels pane, select the 15.5 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 is re-registered with the same ID, history, and groups.

  10. On the SUSE Manager 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 SUSE Manager Server. You can use the action chain to perform updates on multiple proxies at the same time.