Stable version 2024.08

keyboard_arrow_left Go back

Release notes

WARNING: Remember to review the release notes! They contain valuable information and, depending on your current version, required procedures to update to the most recent one! Make sure you read the release notes for all the versions between the one you are using now, and 2024.08!

Documentation

HTML

Important note: Due to unexpected problems while building, for this version 2024.08 the documentation guides are only available in English. The rest of the languages will be restored as soon as possible, likely with the release of 2024.09

Guides
API
PDF

The latest documentation is also listed in the server's WebUI navigation after installation.

Server Setup


Hardware and Software Requirements
Requirement Description
openSUSE Leap 15.5 Clean installation, up-to-date
Multi-core CPU x86_64
16GB RAM * Sufficient for testing purposes
100GB Disk Space ** Disk space depends on your channel requirements

* 32GB of RAM recommended for a production environment (16GB for a base installation)

**50GB per SUSE/openSUSE product and 360GB per Red Hat Product


Quickstart Installation Instructions

Please note Uyuni requires FQDNs for the Server, Proxy and clients, so usage of a properly-configured DNS server is mandatory for client updates to work.

If you want to install Uyuni in lab mode, for testing, you may be interested in how to easily make use of libvirt's included dnsmasq DNS and DHCP server: Libvirt DNS and DCHP without Avahi.

1. Update openSUSE Leap 15.5:

$ sudo zypper update

2. Configure a resolvable fully quallified domain name with Yast2 > System > Netwok Settings > Hostname/DNS

3. Add the repository for the server:

$ sudo zypper ar https://download.opensuse.org/repositories/systemsmanagement:/Uyuni:/Stable/images/repo/Uyuni-Server-POOL-x86_64-Media1/ uyuni-server-stable

4. Refresh metadata from the repositories:

$ sudo zypper ref

5. Install the pattern for the Uyuni server:

$ sudo zypper in patterns-uyuni_server

6. Run Yast2 and navigate to Network Services > Uyuni Setup

7. Follow the setup assistant

Once the setup assistant is ready, you will be able to access the WebUI at https://<FQDN>/

From that point you can start working with the Uyuni Server.

Proxy Setup


Hardware and Software Requirements
Requirement Description
openSUSE Leap 15.5 Clean installation, up-to-date
Multi-core CPU x86_64
2GB RAM * Minimum for testing and production
50GB Disk Space ** Disk space depends on your channel requirements

**50GB per SUSE/openSUSE product and 360GB per Red Hat Product to be mirrored by the proxy


Quickstart Installation Instructions

Installation of Uyuni Proxy is done via the Uyuni Server web interface.

See the Installation Guide for step-by-step instructions for installing and configuring Uyuni Proxy.

The repository for the Proxy is https://download.opensuse.org/repositories/systemsmanagement:/Uyuni:/Stable/images/repo/Uyuni-Proxy-POOL-x86_64-Media1/

Client Tools

Reporting Bugs

Submit bugs to the issues tab located at our Github repository.