Registering SLE Micro Clients

This section contains information about registering clients running these  SLE Micro operating systems:

  • SLE Micro 5.2, and 5.3 x86-64

  • SLE Micro 5.2, and 5.3 ARM64

  • SLE Micro 5.2, and 5.3 IBM Z (s390x)

Support for SLE Micro clients is provided as a technology preview for testing purposes, and not all features are fully functional at this stage. This feature is expected to be fully supported in a later version of Uyuni. Do not use this feature on production systems.

The SLE Micro is an ultra-reliable, lightweight operating system purpose built for edge computing. It leverages the enterprise hardened security and compliance components of SUSE Linux Enterprise and merges them with a modern, immutable, developer-friendly OS platform.

The SLE Micro uses transactional updates. Transactional updates are atomic (all updates are applied only if all updates succeed) and support rollbacks. They do not affect a running system as no changes are activated until after the system is rebooted. This information is displayed in the Systems  Details  Overview subtab.

For more information on transactional updates and rebooting, see https://documentation.suse.com/sles/html/SLES-all/cha-transactional-updates.html.

1. Add Software Channels

Before you register SLE Micro clients to your Uyuni Server, you need to add the required software channels, and synchronize them.

In the following section, descriptions often default to the x86_64 architecture. Replace it with other architectures if appropriate.

The products you need for this procedure are:

Table 1. SLE Micro Products - WebUI
OS Version Product Name

SLE Micro 5.1 x86-64

SUSE Linux Enterprise Micro 5.1 x86_64

SLE Micro 5.1 ARM64

SUSE Linux Enterprise Micro 5.1 aarch64

SLE Micro 5.1 s390x

SUSE Linux Enterprise Micro 5.1 s390x

SLE Micro 5.2 x86-64

SUSE Linux Enterprise Micro 5.2 x86_64

SLE Micro 5.2 ARM64

SUSE Linux Enterprise Micro 5.2 aarch64

SLE Micro 5.2 s390x

SUSE Linux Enterprise Micro 5.2 s390x

SLE Micro 5.3 x86-64

SUSE Linux Enterprise Micro 5.3 x86_64

SLE Micro 5.3 ARM64

SUSE Linux Enterprise Micro 5.3 aarch64

SLE Micro 5.3 s390x

SUSE Linux Enterprise Micro 5.3 s390x

Procedure: Adding Software Channels
  1. In the Uyuni Web UI, navigate to Admin  Setup Wizard  Products.

  2. Locate the appropriate products for your client operating system and architecture using the search bar, and check the appropriate product. This will automatically check all mandatory channels. Also all recommended channels are checked as long as the include recommended toggle is turned on. Click the arrow to see the complete list of related products, and ensure that any extra products you require are checked.

  3. Click Add Products and wait until the products have finished synchronizing.

Alternatively, you can add channels at the command prompt. The channels you need for this procedure are:

Table 2. SLE Micro Products - CLI
OS Version Base Channel Updates Channel

SLE Micro 5.1 x86-64

suse-microos-5.1-pool-x86_64

suse-microos-5.1-updates-x86_64

SLE Micro 5.1 ARM64

suse-microos-5.1-pool-aarch64

suse-microos-5.1-updates-aarch64

SLE Micro 5.1 IBM Z (s390x)

suse-microos-5.1-pool-s390x

suse-microos-5.1-updates-s390x

SLE Micro 5.2 x86-64

suse-microos-5.2-pool-x86_64

suse-microos-5.2-updates-x86_64

SLE Micro 5.2 ARM64

suse-microos-5.2-pool-aarch64

suse-microos-5.2-updates-aarch64

SLE Micro 5.2 IBM Z (s390x)

suse-microos-5.2-pool-s390x

suse-microos-5.2-updates-s390x

SLE Micro 5.3 x86-64

sle-micro-5.3-pool-x86_64

sle-micro-5.3-updates-x86_64

SLE Micro 5.3 ARM64

sle-micro-5.3-pool-arm64

sle-micro-5.3-updates-arm64

SLE Micro 5.3 IBM Z (s390x)

sle-micro-5.3-pool-s390x

sle-micro-5.3-updates-s390x

Procedure: Adding Software Channels at the Command Prompt
  1. At the command prompt on the Uyuni Server, as root, use the mgr-sync command to add the appropriate channels:

    mgr-sync add channel <channel_label_1>
    mgr-sync add channel <channel_label_2>
    mgr-sync add channel <channel_label_n>
  2. Synchronization starts automatically. If you want to synchronize the channels manually, use:

    mgr-sync sync --with-children <channel_name>
  3. Ensure the synchronization is complete before continuing.

To add the client tools, add these channels from the command prompt:

Table 3. SLE Micro Channels - CLI
OS Version Client Channel

SLE Micro 5.1

suse-microos-5.1-uyuni-client

SLE Micro 5.2

suse-microos-5.2-uyuni-client

SLE Micro 5.3

sle-micro-5.3-uyuni-client

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 \
    <base_channel_label>
    <child_channel_label_1> \
    <child_channel_label_2> \
    ... <child_channel_label_n>
  2. If automatic synchronization is turned off, synchronize the channels:

    spacewalk-repo-sync -p <base_channel_label>
  3. Ensure the synchronization is complete before continuing.

2. Check Synchronization Status

Procedure: Checking Synchronization Progress from the Web UI
  1. In the Uyuni Web UI, navigate to Software  Manage  Channels, then click the channel associated to the repository.

  2. Navigate to the Repositories tab, then click Sync and check Sync Status.

Procedure: Checking Synchronization Progress from the Command Prompt
  1. At the command prompt on the Uyuni Server, as root, use the tail command to check the synchronization log file:

    tail -f /var/log/rhn/reposync/<channel-label>.log
  2. Each child channel generates its own log during the synchronization progress. You need to check all the base and child channel log files to be sure that the synchronization is complete.

3. Register Clients

SLE Micro clients require reboot after registering. Reboot is automatically scheduled after registration is completed, but it is respecting the default reboot manager maintenance window. This window may be several hours after the client is registered. To speed up SLE Micro registration, manually reboot the client after the registration script finishes.

To register your SLE Micro 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

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