Uyuni Server Setup

This section covers Uyuni Server setup, using these procedures:

  • Create the main administration account with the Uyuni Web UI

  • Name your base organization and add login credentials

  • Synchronize the SUSE Linux Enterprise product channel from SUSE Customer Center

  • Set up Uyuni with external database

Uyuni is part of the SUSE Linux Enterprise product family and thus compatible with the software shipped with SUSE Linux Enterprise Server.

Uyuni is a complex system, and therefore installing third party software is not allowed. Installing monitoring software provided by a third party vendor is allowed only if you do not exchange basic libraries such as SSL, cryptographic software, and similar tools. As part of providing product support, SUSE reserves the right to ask to remove any third party software (and associated configuration changes) and then to reproduce the problem on a clean system.

Do not register the Uyuni Server to itself. The Uyuni Server must be managed individually or by using another separate Uyuni Server. For more information about using multiple servers, see Multiple Servers with Hub to Manage Large Scale Deployments.

1. Creating the Main Administration Account

This section guides you through creating your organization’s main administration account for Uyuni.

The main administration account is the highest authority account within Uyuni and therefore account access information should be stored in a secure location.

For security it is recommended that the main administrator creates low level admin accounts designated for administration of organizations and individual groups.

Newer browser versions can block web access to the Uyuni Server FQDN in case the user enabled HSTS.

Installing the CA certificate from the pub directory via HTTP and importing it to the browser will then allow access to the server:

  1. On the server, go to http://<server>

  2. Import the certificate file. In the browser settings (for Firefox), open Privacy & Security  Certificates  View Certificates, and import the file.

Procedure: Setting Up the Main Administration Account
  1. In the browser, enter the address provided after completing setup. With this address you open the Uyuni Web UI.

  2. In 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.

    quickstart mgr setup admin1

    You are now presented with the Uyuni Home  Overview page.

2. 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 may receive updates, and 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.

Before you can synchronize software repositories with SCC, you will need to enter organization credentials in SUSE Manager. In previous versions, so-called mirror credentials were used instead. The organization credentials give you access to the SUSE product downloads. You will find your organization credentials in

Enter your organization credentials in the SUSE Manager Web UI:

Procedure: Entering Organization Credentials
  1. In the SUSE Manager Web UI, select Admin  Setup Wizard.

  2. From the Setup Wizard page select the Organization Credentials tab.

  3. Click Add a new credential.

  4. In the dialog, enter Username and Password, and confirm with Save.

    When the credentials are confirmed with a check-mark icon, proceed with Procedure: Synchronizing with SUSE Customer Center.

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

  2. From the Setup Wizard page select the SUSE Products tab. If you previously registered with SUSE Customer Center a list of products will populate the table. This operation could take up to a few minutes. You can monitor the progress of the operation in section on the right Refresh the product catalog from SUSE Customer Center. The table of products lists architecture, channels, and status information. For more information, see Wizard.

    admin suse products
  3. Use Filter by product description and Filter by architecture to filter the liste of displayed products. 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.

    • 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.

    • Click Add Products to start product synchronization.

      After adding the channel, Uyuni will schedule the channel to be synchronized. This can take a long time as Uyuni will copy channel software sources from the SUSE repositories located at SUSE Customer Center to local /var/spacewalk/ directory of your server.

      In some environments, Transparent Huge Pages provided by the kernel may slow down PostgreSQL workloads significantly.

      To disable Transparant Huge Pages set the transparent_hugepage kernel parameter to never. This has to be changed in /etc/default/grub and added to the line GRUB_CMDLINE_LINUX_DEFAULT, for example:

      GRUB_CMDLINE_LINUX_DEFAULT="resume=/dev/sda1 splash=silent quiet showopts elevator=none transparent_hugepage=never"

      To write the new configuration run grub2-mkconfig -o /boot/grub2/grub.cfg.

      Monitor the channel synchronization process in real-time by viewing channel log files located in the directory /var/log/rhn/reposync:

      tail -f /var/log/rhn/reposync/<CHANNEL_NAME>.log

      When the channel synchronization process is complete, you can continue with client registration. For more instructions, see Client Registration.

3. Set up Uyuni with external database

In this example, we use RDS product from Amazon Web Service.

Currently, configuring an external database is not supported by yast2 setup.

You can configure an external database using the mgr-setup command line tool.

This section guides you through Uyuni setup using mgr-setup.

Procedure : Configuring server with external database
  1. Create file in the /root directory.

  2. Set the variables defining your certificate information and password. For more information about certificates, see [proc-quickstart-certificate-information-yast].

  3. Define your database. The user and password are created during the setup. If you are using an external database, specify the hostname and port.

    MANAGER_DB_HOST="db hostname"
    MANAGER_DB_PORT="db port"
  4. Set up the variables defining the specific configuration for the external database. In this scenario, an RDS database has been deployed and is accessible by the server. To establish a connection, an AWS certificate is also required. EXTERNALDB_ADMIN_USER and EXTERNALDB_ADMIN_PASS are the credentials set during the RDS deployment:

  5. To connect to the external database, configure the report database with the RDS hostname and port. REPORT_DB_USER and REPORT_DB_PASS will be created by the script:

    REPORT_DB_HOST="db hostname"
    REPORT_DB_PORT="db port"

    Do not use MANAGER_USER as the user when deploying RDS.