From cbd5a6c10e87172560211ac113acd61069d74c7d Mon Sep 17 00:00:00 2001 From: Andrew David Wong Date: Tue, 15 Jun 2021 21:22:35 -0700 Subject: [PATCH] Steer newbies away from in-place upgrades even more https://qubes-os.discourse.group/t/cat-etc-fedora-release-what-to-do-if-wrong-version/4510/6 --- user/managing-os/debian/debian-upgrade.md | 6 ++++++ user/managing-os/debian/debian.md | 4 ++-- user/managing-os/fedora/fedora-upgrade.md | 5 +++++ user/managing-os/fedora/fedora.md | 4 ++-- 4 files changed, 15 insertions(+), 4 deletions(-) diff --git a/user/managing-os/debian/debian-upgrade.md b/user/managing-os/debian/debian-upgrade.md index 04fdb7b1..ea251f00 100644 --- a/user/managing-os/debian/debian-upgrade.md +++ b/user/managing-os/debian/debian-upgrade.md @@ -14,6 +14,12 @@ title: In-place upgrade of Debian TemplateVMs # Upgrading Debian TemplateVMs + + + This page provides instructions for performing an in-place upgrade of an installed [Debian TemplateVM](/doc/templates/debian/). If you wish to install a new, unmodified Debian TemplateVM instead of upgrading a template that is already installed in your system, please see the [Debian TemplateVM](/doc/templates/debian/) page instead. ([Learn more about the two options.](/doc/templates/debian/#upgrading)) diff --git a/user/managing-os/debian/debian.md b/user/managing-os/debian/debian.md index 925647a7..bfb430b1 100644 --- a/user/managing-os/debian/debian.md +++ b/user/managing-os/debian/debian.md @@ -48,9 +48,9 @@ For routine daily TemplateVM updates within a given Debian release, see [Updatin There are two ways to upgrade your TemplateVM to a new Debian release: -- [Install a fresh template to replace the existing one.](#installing) This option may be simpler for less experienced users. After you install the new template, redo all desired template modifications and [switch everything that was set to the old template to the new template](/doc/templates/#switching). You may want to write down the modifications you make to your templates so that you remember what to redo on each fresh install. In the old Debian template, see `/var/log/dpkg.log` and `/var/log/apt/history.log` for logs of package manager actions. +- [Install a fresh template to replace the existing one.](#installing) **This option may be simpler for less experienced users.** After you install the new template, redo all desired template modifications and [switch everything that was set to the old template to the new template](/doc/templates/#switching). You may want to write down the modifications you make to your templates so that you remember what to redo on each fresh install. In the old Debian template, see `/var/log/dpkg.log` and `/var/log/apt/history.log` for logs of package manager actions. -- [Perform an in-place upgrade of an existing Debian template.](/doc/template/debian/upgrade/) This option will preserve any modifications you've made to the template, but it may be more complicated for less experienced users. +- [Perform an in-place upgrade of an existing Debian template.](/doc/template/debian/upgrade/) This option will preserve any modifications you've made to the template, **but it may be more complicated for less experienced users.** ## Release-specific notes diff --git a/user/managing-os/fedora/fedora-upgrade.md b/user/managing-os/fedora/fedora-upgrade.md index 209a9519..6333e20b 100644 --- a/user/managing-os/fedora/fedora-upgrade.md +++ b/user/managing-os/fedora/fedora-upgrade.md @@ -25,6 +25,11 @@ title: In-place upgrade of Fedora TemplateVMs # Upgrading Fedora TemplateVMs + + This page provides instructions for performing an in-place upgrade of an installed [Fedora TemplateVM](/doc/templates/fedora/). If you wish to install a new, unmodified Fedora TemplateVM instead of upgrading a template that is already installed in your system, please see the [Fedora TemplateVM](/doc/templates/fedora/) page instead. ([Learn more about the two options.](/doc/templates/fedora/#upgrading)) diff --git a/user/managing-os/fedora/fedora.md b/user/managing-os/fedora/fedora.md index e3b703c2..9061c932 100644 --- a/user/managing-os/fedora/fedora.md +++ b/user/managing-os/fedora/fedora.md @@ -40,7 +40,7 @@ For routine daily updates within a given release, see [Updating software in Temp There are two ways to upgrade your TemplateVM to a new Fedora release: -- [Install a fresh template to replace the existing one.](#installing) This option may be simpler for less experienced users. After you install the new template, redo all desired template modifications and [switch everything that was set to the old template to the new template](/doc/templates/#switching). You may want to write down the modifications you make to your templates so that you remember what to redo on each fresh install. To see a log of package manager actions, open a terminal in the old Fedora template and use the `dnf history` command. +- [Install a fresh template to replace the existing one.](#installing) **This option may be simpler for less experienced users.** After you install the new template, redo all desired template modifications and [switch everything that was set to the old template to the new template](/doc/templates/#switching). You may want to write down the modifications you make to your templates so that you remember what to redo on each fresh install. To see a log of package manager actions, open a terminal in the old Fedora template and use the `dnf history` command. -- [Perform an in-place upgrade of an existing Fedora template.](/doc/template/fedora/upgrade/) This option will preserve any modifications you've made to the template, but it may be more complicated for less experienced users. +- [Perform an in-place upgrade of an existing Fedora template.](/doc/template/fedora/upgrade/) This option will preserve any modifications you've made to the template, **but it may be more complicated for less experienced users.**