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
GuidesAPI
- Quickstart Guide
- Installation and Upgrade guide
- Client Configuration Guide
- Administration Guide
- Reference Guide
- Retail Guide
- Common Workflows Guide
- Specialized Guides Guide
- Legal Information
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 athttps://<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
Each supported Operating System has a repository, for all supported architectures:
- openSUSE Leap 15.* (x86_64, aarch64)
- openSUSE Leap Micro 5.* (x86_64, aarch64)
- SLE12 (x86_64, pcc64le, s390x, aarch64)
- SLE15 (x86_64, pcc64le, s390x, aarch64)
- RHEL, CentOS, Oracle Linux and SLES ES 7 (x86_64, ppc64le, aarch64)
- RHEL, CentOS, Oracle Linux and SLES ES 8 (x86_64, aarch64)
- Amazon Linux 2 (x86_64, aarch64)
- Alibaba Linux 2 (x86_64, aarch64)
- AlmaLinux 8 (x86_64, aarch64)
- openEuler 22.03 (x86_64, aarch64)
- Rocky Linux 8 (x86_64, aarch64)
- RHEL, Oracle, AlmaLinux and Rocky Linux 9 (x86_64, ppc64le, aarch64, s390x)
- Oracle Linux (x86_64, ppc64le, aarch64)
- Amazon Linux 2023 (x86_64, aarch64)
- Ubuntu 20.04 (x86_64)
- Ubuntu 22.04 (x86_64)
- Debian 11 (x86_64, aarch64, armv7l, i586, ppc64le, s390x)
- Debian 12 (x86_64, aarch64, armv7l, i586, ppc64le, s390x)
- Raspberry Pi OS 12 (arm64, armhf)
Reporting Bugs
Submit bugs to the issues tab located at our Github repository.