Onboarding

Uyuni is all about managing client systems. So one of the first things you need to do is onboard some clients. This workflow shows you how to set up your Uyuni Server to manage a new client, set up the software channels you need, and bootstrap the client using an activation key.

1. Use case

This workflow shows you how to onboard a client to your Uyuni Server.

The client must be running a supported Linux operating system. For a list of supported client systems, see installation-and-upgrade:client-requirements.adoc.

This is one of the first tasks you need to do when you set up Uyuni for the first time, and you will probably have to do it many more times as you use the product.

2. Outcome

When you have completed this workflow, your client is onboarded, and it can be seen in the systems list of the Uyuni Web UI. You can then use Uyuni to manage the client.

3. Preparation

Before you start, you should already have:

  • Uyuni Server installed, that you can access using the Web UI.

  • Client machine with an operating system installed, which you can access across the network that your Uyuni Server is on, using SSH.

  • Appropriate subscriptions from http://scc.suse.com for the products you are using.

This workflow uses a SUSE Linux Enterprise Server 15 SP2 operating system. You can use other Linux operating systems, but some of the steps might be different. For more information on onboarding other clients, see client-configuration:registration-methods.adoc.

4. Step-by-step workflow instructions

Procedure: Configure a fully qualified domain name (FQDN) on your client
  1. On the client, at the command prompt, show the current hostname:

    hostname -f

    This command will probably return an error, or show something like localhost.

  2. Set a new hostname. Your new hostname should have a subdomain name and thus include at least two periods. In this example, we are using client1.suma.example

    hostnamectl set-hostname client1.suma.example
  3. Check that your change was successful:

    hostnamectl
  4. Open YaST and navigate to Network Services  Hostnames. Edit the hostname to match the one you just set, and click OK.

  5. In YaST, navigate to System  Network Settings and go to the Hostname/DNS tab. In the Static hostname field, type your new hostmame.

  6. Check that the change was successful:

    hostname -f

    This command should return your new FQDN.

Procedure: Prepare software channels on the Uyuni Server
  1. In the Uyuni Web UI, navigate to Admin  Setup Wizard.

  2. In the Organization Credentials tab, ensure you have entered your SUSE Customer Center credentials, and are correctly authenticated.

  3. In the Products tab, ensure that the product catalog is fully updated:

    scc sync
  4. Use the product search bar to find the channels you need for your client operating system. Check the channels you want to install, and click Add products:

    add products
  5. Wait for the product channels to fully synchronize. Depending on the products you have chosen, this could take a long time.

Procedure: Create an activation key
  1. In the Uyuni Web UI, navigate to Systems  Activation Keys, and click Create Key.

  2. Give your activation key a name, and select the base channel that matches the client you want to onboard. This should be the product you just enabled:

    activationkey base
  3. Check the child channels to include, and any add-on system types you want clients registered with this key to have. Click Create Activation Key:

    child
Procedure: Bootstrap the client
  1. In the Uyuni Web UI, navigate to Systems  Bootstrapping.

  2. Type the hostname and provide authentication credentials for the client you want to onboard, and select the activation key. Click Bootstrap:

    bootstrap
  3. Navigate to Systems  System List to manage your new client.