search

uyuni-project / uyuni-docs

Uyuni documentation sources. Uyuni docs are written in Asciidoc (Asciidoctor flavor).
https://www.uyuni-project.org/uyuni-docs/
Other
24 stars 99 forks source link

Uyuni - Installation and Upgrade Guide missing Container update/upgrade instructions #3227

Open simonflood opened 3 months ago

simonflood commented 3 months ago

Documentation Update Required

With the change to Container-only Uyuni the Installation and Upgrade Guide is missing update and/or upgrade instructions.

What does the documentation say now?

There are currently no instructions on updating/upgrading the Container deployment of Uyuni, either the underlying Leap Micro OS or the Uyuni container.

There are still pages (which should currently remain) on Minor and Major upgrades of the Legacy deployment of Uyuni.

What change is required?

Need a page with instructions on updating/upgrading the Container deployment of Uyuni.

Version

Which version of the software is this feature/update expected to land in (if known)?

Pre-2024.07

Which version of the documentation must this feature/update land in (if known)?

2024.07

Does the content need to be backported to previous documentation versions (if known)?

Yes - 2024.05 and earlier

============= Edit:

simonflood commented 3 months ago

What is required is a page like https://documentation.suse.com/suma/5.0/en/suse-manager/installation-and-upgrade/container-management/updating-server-containers.html for recently released SUMA 5.0.

Fortunately this page exists as the steps are the same for Uyuni (container), namely:

  1. transactional-update
  2. reboot
  3. mgradm upgrade podman

Perhaps an extra section should be added to cover managing old Uyuni images?

keichwa commented 3 months ago

Thanks for the report! Internally, we'll track it as https://github.com/SUSE/spacewalk/issues/24769.

stdevel commented 2 months ago

Second.

Thanks for sharing the commands. I found out that this section already exists in the SUMA 5.0 documentation: https://documentation.suse.com/suma/5.0/en/suse-manager/installation-and-upgrade/container-management/updating-server-containers.html

ppanon2022 commented 2 weeks ago

The Installation and Upgrade PDF for 2024.10 and linked to in the release notes still doesn't cover these steps. If the containerized version is the only supported version going forwards, it's imperative that it includes these upgrade steps. Admins shouldn't need to go searching for documentation bug reports to figure out how to do a mandatory upgrade process.