Migrating the Uyuni Proxy to openSUSE Tumbleweed

1. Copy the Uyuni proxy configuration directory to a safe location:

   scp -r /etc/uyuni <USER>@<HOST>:/some/where/safe/

2. Identify Apache and Squid tuning files currently in use by the legacy proxy services:

   systemctl cat uyuni-proxy-httpd.service | grep EXTRA_CONF= | sed 's/.*=-v\([^:]\+\):.*/\1/'
   systemctl cat uyuni-proxy-squid.service | grep EXTRA_CONF= | sed 's/.*=-v\([^:]\+\):.*/\1/'

3. Copy those tuning files to the same safe location as well.

Typical default paths after you copy them back will be: Apache tuning: /etc/uyuni/proxy/apache.conf Squid tuning: /etc/uyuni/proxy/squid.conf

1. Reinstall the machine with openSUSE Tumbleweed (server profile recommended).

2. Set the same hostname/FQDN and IP as before when possible.

1. From the Uyuni Web UI, obtain the system reactivation key for the existing proxy system record (Systems > Details > Reactivation).

2. Bootstrap/re-register the Tumbleweed host using that reactivation key so it claims the existing system entry.

Use your standard bootstrapping process for Tumbleweed hosts in your environment (for example, the bootstrap script or your configuration management), ensuring the reactivation key is applied.

1. Add the Uyuni Stable repository and install tools:

   zypper ar https://download.opensuse.org/repositories/systemsmanagement:/Uyuni:/Stable/images/repo/Uyuni-Proxy-POOL-x86_64-Media1 uyuni-proxy-stable
   zypper ref
   zypper in mgrpxy mgrctl mgrpxy-bash-completion mgrctl-bash-completion

2. Ensure Podman is installed (required to run containers):

   zypper in podman

1. Copy back the saved configuration directory to the new host:

   scp -r <USER>@<HOST>:/some/where/safe/uyuni /etc/

2. If you saved Apache/Squid tuning files, place them at the expected default paths or note their locations for parameters in the next command:

   # Default paths expected by mgrpxy parameters (adjust/move your files accordingly)
   # Apache tuning: /etc/uyuni/proxy/apache.conf
   # Squid tuning:  /etc/uyuni/proxy/squid.conf

3. Run the proxy installation with Podman. If you do not use tuning files, omit the corresponding parameters:

   # With tuning files
   mgrpxy install podman \
   	--tuning-httpd /etc/uyuni/proxy/apache.conf \
   	--tuning-squid /etc/uyuni/proxy/squid.conf
   
   # If you have no tuning files, remove the tuning parameters:
   # mgrpxy install podman

In an upcoming release, if tuning files are placed at the default paths noted above, the explicit parameters will not be required.

1. Check containers are running:

   mgrctl ps
   # or
   podman ps

2. Confirm the proxy appears healthy in the Uyuni Web UI and that clients using this proxy operate normally.