From c0b7a8f64fc6f6735fab2ecc23074050593084b2 Mon Sep 17 00:00:00 2001 From: Schlomo Schapiro Date: Wed, 10 Apr 2024 17:14:12 +0200 Subject: [PATCH] improve docs and hints for portable mode --- doc/user-guide/17-Portable-Mode.adoc | 10 +++++++++- .../rear/init/default/002_check_rear_recover_mode.sh | 2 +- 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/doc/user-guide/17-Portable-Mode.adoc b/doc/user-guide/17-Portable-Mode.adoc index 9c8c68273..ff259dc60 100644 --- a/doc/user-guide/17-Portable-Mode.adoc +++ b/doc/user-guide/17-Portable-Mode.adoc @@ -10,7 +10,15 @@ The purpose of the portable mode is to solve special scenarios where the ReaR re To create a portable rescue archive, run `rear mkrescue` or `rear mkbackup` with the `OUTPUT=PORTABLE` option. This will create a portable rescue archive in the `output/` directory. The archive is a tarball with the name `rear--portable.tar.gz`. It will be also copied to the `OUTPUT_URL` if it is set. -To recover a system from a portable rescue archive, you need to extract the archive on your rescue system, change into the directory and run `./usr/sbin/rear -p recover`. The recovery process will then use the extracted ReaR installation to recover the system. +To recover a system from a portable rescue archive, you need to + +1. extract the archive on your rescue system into a directory + +2. set the machine hostname to the target machine, e.g. via `hostnamectl hostname ` or `hostname ` + +3. change into the directory and run `./usr/sbin/rear -p recover` + +The recovery process will then use the extracted ReaR installation to recover the system. == Caveats diff --git a/usr/share/rear/init/default/002_check_rear_recover_mode.sh b/usr/share/rear/init/default/002_check_rear_recover_mode.sh index 048afb176..39a19160c 100644 --- a/usr/share/rear/init/default/002_check_rear_recover_mode.sh +++ b/usr/share/rear/init/default/002_check_rear_recover_mode.sh @@ -30,7 +30,7 @@ else # We are in the normal/original system: case "$WORKFLOW" in (recover|layoutonly|restoreonly|finalizeonly|mountonly) - Error "The workflow $WORKFLOW is only supported in the ReaR rescue/recovery system" + Error "The workflow $WORKFLOW is only supported in the ReaR rescue/recovery system, use --portable to disable this check." ;; (*) LogPrint "Running workflow $WORKFLOW on the normal/original system"