Skip to content

Conversation

@jcayouette
Copy link
Contributor

@jcayouette jcayouette commented Oct 27, 2025

Summary

Adds step-by-step guides to migrate an Uyuni Server and an Uyuni Proxy from SUSE Micro 5.5 to a fresh openSUSE Tumbleweed host.

Both pages follow the Uyuni docs style, include clear commands, cautions, and optional steps, and note current limitations.
Changes

New/updated pages:

[migrate-uyuni-server-from-micro55-tumbleweed.adoc]

  • Backup/restore flow using mgradm backup/restore
  • Repo setup for tools, explicit podman install note
  • Optional persistent storage prep via mgr-storage-server
  • Verification and troubleshooting notes

[migrate-uyuni-proxy-from-micro55-tumbleweed.adoc]

  • Backup /etc/uyuni and capture Apache/Squid tuning file paths from systemd
  • Re-register host using the system reactivation key
  • Install mgrpxy and podman; restore config
  • Run mgrpxy install podman with optional --tuning-httpd/--tuning-squid
  • Verification and troubleshooting notes

Why

Tumbleweed becomes the new base OS for Uyuni; we need practical migration instructions for both Server and Proxy.
Captures real-world steps validated by smoke tests on minimal setups.

@jcayouette jcayouette self-assigned this Oct 27, 2025
@jcayouette jcayouette added enhancement New feature or request docs migration labels Oct 27, 2025
Copy link
Contributor

@0rnela 0rnela left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Procedure names are written in gerund form.
Otherwise, lgtm.

jcayouette and others added 10 commits October 27, 2025 13:39
Co-authored-by: Ornela Marić <[email protected]>
…uni/migrate-uyuni-proxy-from-micro55-tumbleweed.adoc

Co-authored-by: Ornela Marić <[email protected]>
…uni/migrate-uyuni-proxy-from-micro55-tumbleweed.adoc

Co-authored-by: Ornela Marić <[email protected]>
…uni/migrate-uyuni-proxy-from-micro55-tumbleweed.adoc

Co-authored-by: Ornela Marić <[email protected]>
…uni/migrate-uyuni-proxy-from-micro55-tumbleweed.adoc

Co-authored-by: Ornela Marić <[email protected]>
…uni/migrate-uyuni-server-from-micro55-tumbleweed.adoc

Co-authored-by: Ornela Marić <[email protected]>
…uni/migrate-uyuni-server-from-micro55-tumbleweed.adoc

Co-authored-by: Ornela Marić <[email protected]>
…uni/migrate-uyuni-server-from-micro55-tumbleweed.adoc

Co-authored-by: Ornela Marić <[email protected]>
…uni/migrate-uyuni-server-from-micro55-tumbleweed.adoc

Co-authored-by: Ornela Marić <[email protected]>
…uni/migrate-uyuni-server-from-micro55-tumbleweed.adoc

Co-authored-by: Ornela Marić <[email protected]>
@jcayouette
Copy link
Contributor Author

@0rnela Thank you. You are right of course. Preferred method is gerunds.

@jcayouette jcayouette requested a review from 0rnela October 27, 2025 12:43
…uni/migrate-uyuni-proxy-from-micro55-tumbleweed.adoc

Co-authored-by: Ornela Marić <[email protected]>
Copy link
Contributor

@deneb-alpha deneb-alpha left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • on Uyuni we run on openSUSE Leap Micro 5.5, not on SUSE Micro 5.5
  • the TW client tools stable will be available with the next release, no need to use Master in the documentation

Copy link
Contributor

@raulillo82 raulillo82 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agree to Marina's requests, it needs to be Stable and not Master. Other than that, I rendered everything and it was looking fine, so we can probably approve and merge once the suggestions are committed.

jcayouette and others added 9 commits October 27, 2025 16:59
…uni/migrate-uyuni-proxy-from-micro55-tumbleweed.adoc

Co-authored-by: Marina Latini <[email protected]>
…uni/migrate-uyuni-proxy-from-micro55-tumbleweed.adoc

Co-authored-by: Marina Latini <[email protected]>
…uni/migrate-uyuni-proxy-from-micro55-tumbleweed.adoc

Co-authored-by: Marina Latini <[email protected]>
…uni/migrate-uyuni-server-from-micro55-tumbleweed.adoc

Co-authored-by: Marina Latini <[email protected]>
…uni/migrate-uyuni-server-from-micro55-tumbleweed.adoc

Co-authored-by: Marina Latini <[email protected]>
…uni/migrate-uyuni-server-from-micro55-tumbleweed.adoc

Co-authored-by: Marina Latini <[email protected]>
…uni/migrate-uyuni-server-from-micro55-tumbleweed.adoc

Co-authored-by: Marina Latini <[email protected]>
…uni/migrate-uyuni-server-from-micro55-tumbleweed.adoc

Co-authored-by: Marina Latini <[email protected]>
…uni/migrate-uyuni-server-from-micro55-tumbleweed.adoc

Co-authored-by: Marina Latini <[email protected]>
@jcayouette
Copy link
Contributor Author

All set, thank you @deneb-alpha and @raulillo82 .

jcayouette and others added 4 commits October 27, 2025 17:01
…uni/migrate-uyuni-proxy-from-micro55-tumbleweed.adoc

Co-authored-by: Marina Latini <[email protected]>
…uni/migrate-uyuni-server-from-micro55-tumbleweed.adoc

Co-authored-by: Marina Latini <[email protected]>
…uni/migrate-uyuni-server-from-micro55-tumbleweed.adoc

Co-authored-by: Marina Latini <[email protected]>
…uni/migrate-uyuni-server-from-micro55-tumbleweed.adoc

Co-authored-by: Marina Latini <[email protected]>
Copy link
Contributor

@raulillo82 raulillo82 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This one was left over in the first review, sorry!

…uni/migrate-uyuni-proxy-from-micro55-tumbleweed.adoc

Co-authored-by: Raúl Osuna <[email protected]>
@jcayouette jcayouette requested a review from raulillo82 October 27, 2025 16:06
Copy link
Contributor

@deneb-alpha deneb-alpha left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think in the Proxy doc there are wrong references to the server repos and packages, but it could be I'm just confused

----
zypper ar https://download.opensuse.org/repositories/systemsmanagement:/Uyuni:/Stable/images/repo/Uyuni-Server-POOL-x86_64-Media1 uyuni-server-stable
zypper ref
zypper in mgrpxy mgrctl mgradm-bash-completion mgrctl-bash-completion
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
zypper in mgrpxy mgrctl mgradm-bash-completion mgrctl-bash-completion
zypper in mgrpxy mgrctl mgrpxy-bash-completion mgrctl-bash-completion

this is the proxy, no mgradm, I suppose it was a typo.

[source,shell]
----
zypper ar https://download.opensuse.org/repositories/systemsmanagement:/Uyuni:/Stable/images/repo/Uyuni-Server-POOL-x86_64-Media1 uyuni-server-stable
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
zypper ar https://download.opensuse.org/repositories/systemsmanagement:/Uyuni:/Stable/images/repo/Uyuni-Server-POOL-x86_64-Media1 uyuni-server-stable
zypper ar https://download.opensuse.org/repositories/systemsmanagement:/Uyuni:/Stable/images/repo/Uyuni-Proxy-POOL-x86_64-Media1 uyuni-proxy-stable

if you are installing things on the proxy you should use the proxy repos, or am I missing something?

----
zypper ar https://download.opensuse.org/repositories/systemsmanagement:/Uyuni:/Stable/images/repo/Uyuni-Server-POOL-x86_64-Media1 uyuni-server-stable
zypper ref
zypper in mgrpxy mgrctl mgradm-bash-completion mgrctl-bash-completion
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

About the list of packages to install, on paper it should just work out of the box installing Uyuni-Proxy-release that should pull in all the others. we should test this again, but it should just work

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs enhancement New feature or request migration

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants