Registering openSUSE Clients

This section contains information about registering Salt clients running openSUSE operating systems. Uyuni supports openSUSE Leap 15.1 Clients using Salt. Traditional clients are not supported.

Bootstrapping is supported for starting openSUSE clients and performing initial state runs such as setting repositories and performing profile updates.

Prepare to Register

Some preparation is required before you can register openSUSE clients to the Uyuni Server.

Procedure: Adding the openSUSE Channels
  1. At the command prompt on the Uyuni Server, as root, install the spacewalk-utils package:

    zypper in spacewalk-utils
  2. Add the openSUSE channels.

    spacewalk-common-channels \
    opensuse_leap15_1 \
    opensuse_leap15_1-non-oss \
    opensuse_leap15_1-non-oss-updates \
    opensuse_leap15_1-updates \
    opensuse_leap15_1-uyuni-client
  3. Synchronize the new custom channels.

You need all the new channels fully synchronized before bootstrapping any openSUSE client. openSUSE channels can be very large. Synchronization can sometimes take several hours.

To synchronize, navigate to Software  Manage  Channels, and for each channel you created, click it and:

  1. Navigate to the Repositories tab.

  2. Navigate to the Sync sub-tab, and click Sync Now to begin synchronization immediately.

You can also schedule synchronization from this screen.

Monitor Synchronization Progress

There are two ways to check if a channel has finished synchronizing:

  • In the Uyuni Web UI, navigate to Software  Manage  Channels, then click the channel associated to the repository. Navigate to the Repositories tab, then click Sync and check Sync Status.

  • Check the synchronization log file at the command prompt:

    [command]``tail -f /var/log/rhn/reposync/<channel-label>.log``.

    Each child channel will generate its own log during the synchronization progress. You will need to check all the base and child channel log files to be sure that the synchronization is complete.

Trust GPG Keys on Clients

By default, openSUSE does not trust the GPG key for Uyuni openSUSE client tools. The clients can be successfully bootstrapped without the GPG key being trusted. However, they will not be able to install new client tool packages or update them.

To fix this, add this key to the ORG_GPG_KEY= parameter in all openSUSE bootstrap scripts:

uyuni-gpg-pubkey-0d20833e.key

You do not need to delete any previously stored keys.

If you are boostrapping clients from the Uyuni Web UI, you will need to use a Salt state to trust the key. Create the salt state and assign it to the organization. You can then use an activation key and configuration channels to deploy the key to the clients.

Register Clients

To register your openSUSE clients, you need a bootstrap repository. By default, bootstrap repositories are automatically created, and regenerated daily for all synchronized products. You can manually create the bootstrap repository from the command prompt, using this command:

mgr-create-bootstrap-repo --with-custom-channels

For more information on registering your clients, see client-configuration:registration-overview.adoc.