From 80333404a460f0540ccd409e338d93c81f3b83a8 Mon Sep 17 00:00:00 2001 From: Aaron Honeycutt Date: Thu, 25 May 2023 12:00:57 -0600 Subject: [PATCH 1/4] Work on issue 971 --- content/live-disk.md | 4 ++++ content/pop-recovery.md | 2 +- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/content/live-disk.md b/content/live-disk.md index 67a3ee600d..40318e2cb4 100644 --- a/content/live-disk.md +++ b/content/live-disk.md @@ -185,6 +185,10 @@ The list provided at the beginning of the article provides links to other articl Since the live environment is a full Pop!_OS installation, it works just like the normal environment. There are tools and methods that allow to `chroot` (change root) into the normal installation and work in the existing operating system to repair a broken package or other problem that is preventing normal booting. +### Refreshing the Operating System + +If Pop!\_OS is installed and a Pop!\_OS live disk is used it can be used to Refresh the OS without losing user account information and data in the home directory. You can find out more about this option [here](/articles/pop-recovery) + ### Backing Up Files Perhaps you're reinstalling, or maybe you can't boot but you want to try and recover and back up your files? The live environment will automatically detect and mount most file systems including Linux and Windows. You can then copy files from the disk to another external disk using the familiar Files utility. diff --git a/content/pop-recovery.md b/content/pop-recovery.md index 2df6394dd2..aad7943f5a 100644 --- a/content/pop-recovery.md +++ b/content/pop-recovery.md @@ -55,7 +55,7 @@ If the `Refresh Install` option is not present on the install screen, one of two ### Reinstall -Once Recovery has booted, the Pop Installer will start automatically. If the system needs to be reinstalled, go ahead and continue the installation steps as demonstrated [here](/articles/install-pop/). +Once Recovery has booted, the Pop Installer will start automatically. If the system needs to be reinstalled, go ahead and continue the installation steps as demonstrated [here](/articles/install-pop/#refresh-install). If the existing install is encrypted, please see the [encrypted disk](#encrypted-disk) instructions. From 8977659083deca538415c3c9851f8815725da503 Mon Sep 17 00:00:00 2001 From: Aaron Honeycutt Date: Thu, 25 May 2023 12:01:49 -0600 Subject: [PATCH 2/4] Revert change --- content/pop-recovery.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pop-recovery.md b/content/pop-recovery.md index aad7943f5a..2df6394dd2 100644 --- a/content/pop-recovery.md +++ b/content/pop-recovery.md @@ -55,7 +55,7 @@ If the `Refresh Install` option is not present on the install screen, one of two ### Reinstall -Once Recovery has booted, the Pop Installer will start automatically. If the system needs to be reinstalled, go ahead and continue the installation steps as demonstrated [here](/articles/install-pop/#refresh-install). +Once Recovery has booted, the Pop Installer will start automatically. If the system needs to be reinstalled, go ahead and continue the installation steps as demonstrated [here](/articles/install-pop/). If the existing install is encrypted, please see the [encrypted disk](#encrypted-disk) instructions. From eaea0b472e983be92b12c270a8b8f7883ebeb085 Mon Sep 17 00:00:00 2001 From: Aaron Honeycutt Date: Thu, 25 May 2023 12:04:29 -0600 Subject: [PATCH 3/4] Add about using the Refresh option --- content/pop-incomplete-upgrade.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/pop-incomplete-upgrade.md b/content/pop-incomplete-upgrade.md index c4ab21a21b..8c463208aa 100644 --- a/content/pop-incomplete-upgrade.md +++ b/content/pop-incomplete-upgrade.md @@ -200,6 +200,8 @@ After you have made the edit, save the file and start the upgrade again. ## If you are still not able to upgrade +You can Refresh the OS without losing user account information and data in the home directory. You can find out more about this option [here](/articles/pop-recovery) + If the system is still not able to upgrade and you have a System76 system, please open a [support ticket](https://system76.com/my-account/support-tickets/new) and include this file: ```bash From fcaceb4a95e3cd7e412e35373fd3eb1239cd35c9 Mon Sep 17 00:00:00 2001 From: Jacob Kauffmann Date: Wed, 2 Aug 2023 12:38:01 -0600 Subject: [PATCH 4/4] Improve wording & address feedback about home dir formatting --- content/live-disk.md | 6 +++--- content/pop-incomplete-upgrade.md | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/content/live-disk.md b/content/live-disk.md index 40318e2cb4..36dc46b4e6 100644 --- a/content/live-disk.md +++ b/content/live-disk.md @@ -179,15 +179,15 @@ Pop!_OS will boot into the familiar Pop!_OS desktop. ## Using the Live Environment -The list provided at the beginning of the article provides links to other articles on using the live environment for hardware testing, restoration/upgrades, and boot repair. +Aside from [installing Pop!_OS](/articles/install-pop), you can also use the live environment for hardware testing, restoration/upgrades, and boot repair. ### Repairing an Existing Operating System -Since the live environment is a full Pop!_OS installation, it works just like the normal environment. There are tools and methods that allow to `chroot` (change root) into the normal installation and work in the existing operating system to repair a broken package or other problem that is preventing normal booting. +Since the live environment is a full Pop!_OS installation, it has all the same tools as the normal environment. If the system can't boot normally, you can `chroot` (change root) into the normal installation using the commands [here](/articles/pop-recovery#chroot), which allows you to run commands in the existing operating system to repair broken packages or other problems. ### Refreshing the Operating System -If Pop!\_OS is installed and a Pop!\_OS live disk is used it can be used to Refresh the OS without losing user account information and data in the home directory. You can find out more about this option [here](/articles/pop-recovery) +A Pop!\_OS live disk can also be used to refresh an existing Pop!_OS installation without losing user account information and data in the `/home` directory. You can find out more about this option [here](/articles/pop-recovery#refresh-install). ### Backing Up Files diff --git a/content/pop-incomplete-upgrade.md b/content/pop-incomplete-upgrade.md index 8c463208aa..9fdd471af2 100644 --- a/content/pop-incomplete-upgrade.md +++ b/content/pop-incomplete-upgrade.md @@ -200,7 +200,7 @@ After you have made the edit, save the file and start the upgrade again. ## If you are still not able to upgrade -You can Refresh the OS without losing user account information and data in the home directory. You can find out more about this option [here](/articles/pop-recovery) +You can refresh the OS without losing user account information and data in the `/home` directory. You can find out more about this option [here](/articles/pop-recovery). If the system is still not able to upgrade and you have a System76 system, please open a [support ticket](https://system76.com/my-account/support-tickets/new) and include this file: