Hub Requirements

To set up a Hub installation, you require:

  • One central Uyuni Server, which acts as the Hub Server.

  • One or more additional Uyuni Servers, registered to the Hub. This document refers to these additional servers as peripheral servers.

  • Any number of clients registered to the peripheral servers.

  • Ensure the Hub Server and all peripheral servers are running Uyuni 5.0 or higher.

1. Hub Server

Deploy the central Uyuni Server, which acts as the Hub Server, with mgradm. For more information about deploying with mgradm, see Deploy Uyuni 2024.10 Server.

The Hub Server must not have clients registered to it. Clients should only be registered to the peripheral servers.

2. Peripheral Servers

Deploy the peripheral servers with mgradm. For more information about deploying with mgradm, see Deploy Uyuni 2024.10 Server.

Peripheral servers must be registered to the Hub Server as foreign clients. Standard registration methods cannot be used. Use mgradm on the peripheral server host:

mgradm hub register --api-server <HUB_FQDN> --api-user <HUB_ADMIN> --api-password <HUB_ADMIN_PASSWORD>

The peripheral servers must be registered to the Hub Server directly, do not use a proxy.

Optionally, it is possible to register the podman container host as a standard client (Salt minion) and manage it from Uyuni Server.

You need credentials to access the XMLRPC APIs on each server, including the Hub Server.