Install Uyuni Server with openSUSE Leap

Uyuni Server can be installed on openSUSE Leap.

1. Software and Hardware Requirements

This table shows the software and hardware requirements for installing an Uyuni Server on openSUSE Leap.

Table 1. Software and Hardware Requirements
Software and Hardware Recommended

Operating System:

openSUSE Leap 15.5: Clean installation, up-to-date

CPU:

Minimum 4 dedicated 64-bit x86-64CPU cores

RAM:

Test Server Minimum 8 GB

Base Installation Minimum 16 GB

Production Server Minimum 32 GB

Disk Space:

Disk space depends on your channel requirements, at least 100 GB

50 GB per SUSE or openSUSE product and 360 GB per Red Hat product

Swap space:

3 GB

2. Install Uyuni Server on openSUSE Leap

You can use a physical or virtual machine running openSUSE Leap to install the Uyuni Server. Configure a resolvable fully qualified domain name on the server before you begin, to ensure that the server is accessible across the network.

The Uyuni Server software is available from download.opensuse.org, and you can use zypper to retrieve the software and install it.

Procedure: Installing openSUSE Leap with Uyuni
  1. Install openSUSE Leap as the base system, and ensure all available service packs and package updates have been applied.

  2. Configure a resolvable fully qualified domain name (FQDN) with YaST by navigating to System  Network Settings  Hostname/DNS.

  3. At the command prompt, as root, add the repository for installing the Uyuni Server software:

    repo=repositories/systemsmanagement:/
    repo=${repo}Uyuni:/Stable/images/repo/Uyuni-Server-POOL-x86_64-Media1/
    zypper ar https://download.opensuse.org/$repo uyuni-server-stable
  4. Refresh metadata from the repositories:

    zypper ref
  5. Install the pattern for the Uyuni Server:

    zypper in patterns-uyuni_server
  6. Reboot the server.

When the installation is complete, you can continue with Uyuni setup. For more information, see Uyuni Server Setup.

3. Set up Uyuni Server with YaST

The initial setup procedure is handled by YaST.

Procedure: Uyuni Setup
  1. Log in to the Uyuni Server and start YaST.

  2. In YaST, navigate to Network Services  Uyuni Setup to begin the setup.

  3. From the introduction screen select Uyuni Setup  Set up Uyuni from scratch and click Next to continue.

  4. Enter an email address to receive status notifications and click Next to continue. Uyuni can sometimes send a large volume of notification emails. You can disable email notifications in the Web UI after setup, if you need to.

  5. Enter your certificate information and a password. Passwords must be at at least seven characters in length, and must not contain spaces, single or double quotation marks (' or "), exclamation marks (!), or dollar signs ($). Always store your passwords in a secure location.

    If you need to also set up a Uyuni Proxy Server, ensure you have taken a note of the certificate password.

  6. Click Next to continue.

  7. From the Uyuni Setup  Database Settings screen, enter a database user and password and click Next to continue. Passwords must be at at least seven characters in length, and must not contain spaces, single or double quotation marks (' or "), exclamation marks (!), or dollar signs ($). Always store your passwords in a secure location.

  8. Click Next to continue.

  9. Click Yes to run setup when prompted.

  10. When setup is complete, click Next to continue. You will see the address of the Uyuni Web UI.

  11. Click Finish to complete Uyuni setup.

4. Create the Main Administration Account

Before you can log in to the server to manage your clients, you need to have created an administration account. The main administration account has the highest authority within Uyuni. Ensure you keep access information for this account secure. We recommend that you create lower level administration accounts for organizations and groups. Do not share the main administration access details.

Procedure: Setting Up the Main Administration Account
  1. In your web browser, enter the address for the Uyuni Web UI. This address was provided after you completed setup.

  2. Sign in to the Web UI, navigate to the Create Organization  Organization Name field, and enter your organization name.

  3. In the Create Organization  Desired Login and Create Organization  Desired Password fields, enter your username and password.

  4. Fill in the account information fields, including an email for system notifications.

  5. Click Create Organization to finish creating your administration account.

When you have completed the Uyuni Web UI setup, you are taken to the Home  Overview page.

5. Optional: Synchronizing Products from SUSE Customer Center

SUSE Customer Center (SCC) maintains a collection of repositories which contain packages, software and updates for all supported enterprise client systems. These repositories are organized into channels each of which provide software specific to a distribution, release, and architecture. After synchronizing with SCC, clients can receive updates, be organized into groups, and assigned to specific product software channels.

This section covers synchronizing with SCC from the Web UI and adding your first client channel.

For Uyuni, synchronizing products from SUSE Customer Center is optional.

Before you can synchronize software repositories with SCC, you will need to enter organization credentials in Uyuni. The organization credentials give you access to the SUSE product downloads. You will find your organization credentials in https://scc.suse.com/organizations.

Enter your organization credentials in the Uyuni Web UI:

Optional Procedure: Entering Organization Credentials
  1. In the Uyuni Web UI, navigate to Admin  Setup Wizard.

  2. In the Setup Wizard page, navigate to the Organization Credentials tab.

  3. Click Add a new credential.

  4. Enter a username and password, and click Save.

A check mark icon is shown when the credentials are confirmed. When you have successfully entered the new credentials, you can synchronize with SUSE Customer Center.

Optional Procedure: Synchronizing with SUSE Customer Center
  1. In the Uyuni Web UI, navigate to Admin  Setup Wizard.

  2. From the Setup Wizard page select the SUSE Products tab. Wait a moment for the products list to populate. If you previously registered with SUSE Customer Center a list of products will populate the table. This table lists architecture, channels, and status information.

  3. If your SUSE Linux Enterprise client is based on x86_64 architecture scroll down the page and select the check box for this channel now.

  4. Add channels to Uyuni by selecting the check box to the left of each channel. Click the arrow symbol to the left of the description to unfold a product and list available modules.

  5. Click Add Products to start product synchronization.

When a channel is added, Uyuni will schedule the channel for synchronization. Depending on the number and size of this channels, this can take a long time. You can monitor synchronization progress in the Web UI.

For more information about using the setup wizard, see Wizard.

When the channel synchronization process is complete, you can register and configure clients. For more instructions, see Client Registration.