Skip to content

Commit

Permalink
Updates from tech review
Browse files Browse the repository at this point in the history
  • Loading branch information
tahliar committed Aug 22, 2024
1 parent 57e4e44 commit bf84ac9
Showing 1 changed file with 5 additions and 36 deletions.
41 changes: 5 additions & 36 deletions xml/ha_rear.xml
Original file line number Diff line number Diff line change
Expand Up @@ -168,10 +168,6 @@

<sect2 xml:id="sec-ha-rear-concept-versions">
<title>&rear; version updates</title>
<para>
&productname; &productnumber; ships with &rear; version 2.7, provided by the
package <package>rear27a</package>.
</para>

<note>
<title>Find important information in changelogs</title>
Expand Down Expand Up @@ -491,22 +487,14 @@
Therefore, the subvolumes must be explicitly included in the &rear; configuration.
</para>
<para>
This <filename>/etc/rear/local.conf</filename> example is simplified from the example file
<filename>SLE12-SP2-btrfs-example.conf</filename>. It includes the whole
<filename>/var</filename> directory instead of specific <filename>/var</filename> subdirectories.
</para>
<para>
Adjust this example as required for your setup. See the example file for details about the settings.
Add this configuration snippet to <filename>/etc/rear/local.conf</filename> and
adjust it according to your setup. For more information and additional options, see the
example files at <filename>/usr/share/rear/conf/examples/SLE*-btrfs-example.conf</filename>.
</para>
<screen>OUTPUT=ISO
BACKUP=NETFS
BACKUP_OPTIONS="nfsvers=4,nolock"
BACKUP_URL=nfs://<replaceable>host.&exampledomain;/path/to/rear/backup</replaceable>
NETFS_KEEP_OLD_BACKUP_COPY=yes
REQUIRED_PROGS=( "${REQUIRED_PROGS[@]}" snapper chattr lsattr )
COPY_AS_IS=( "${COPY_AS_IS[@]}" /usr/lib/snapper/installation-helper /etc/snapper/config-templates/default )
BACKUP_PROG_INCLUDE=( /root /boot/grub2/i386-pc /tmp /opt /var /boot/grub2/x86_64-efi /srv /usr/local )
POST_RECOVERY_SCRIPT=( 'if snapper --no-dbus -r $TARGET_FS_ROOT get-config | grep -q "^QGROUP.*[0-9]/[0-9]" ; then snapper --no-dbus -r $TARGET_FS_ROOT set-config QGROUP= ; snapper --no-dbus -r $TARGET_FS_ROOT setup-quota &amp;&amp; echo snapper setup-quota done || echo snapper setup-quota failed ; else echo snapper setup-quota not used ; fi' )</screen>
BACKUP_PROG_INCLUDE=( /root /boot/grub2/i386-pc /tmp /opt /var /boot/grub2/x86_64-efi /srv /usr/local )</screen>
<tip>
<title>Directories for <literal>BACKUP_PROG_INCLUDE</literal></title>
<para>
Expand Down Expand Up @@ -542,17 +530,9 @@ RETENTION_TIME="Month"</screen>
<example xml:id="ex-ha-rear-config-multipath">
<title>Backing up multipath devices</title>
<para>
By default, &rear; ignores file systems on <filename>/dev/mapper</filename> devices because
it cannot re-create them when restoring the system. You can allow &rear; to include
these file systems by adding the following line to <filename>/etc/rear/local.conf</filename>:
By default, &rear; ignores file systems on multipath devices because it assumes they are on shared storage, not part of the local system. You can make &rear; include these file systems by adding the following line to <filename>/etc/rear/local.conf</filename>:
</para>
<screen>AUTOEXCLUDE_MULTIPATH=n</screen>
<important role="compact">
<para>
Before you can restore the backup, you must manually re-create the device structure on
the new system.
</para>
</important>
</example>

<example xml:id="ex-ex-ha-rear-config-UEFI">
Expand Down Expand Up @@ -666,17 +646,6 @@ RETENTION_TIME="Month"</screen>
everything works as expected.
</para>
</warning>
<important>
<title>Restoring a multipath backup</title>
<para>
If your backup includes file systems on a multipath device, you must manually re-create
the device structure on the new system before you can restore the backup.
</para>
<para>
Backing up multipath devices is disabled by default, but can be enabled by setting
<literal>AUTOEXCLUDE_MULTIPATH=n</literal> in <filename>/etc/rear/local.conf</filename>.
</para>
</important>

<procedure xml:id="pro-ha-rear-testing">
<title>Performing a disaster recovery on a test machine</title>
Expand Down

0 comments on commit bf84ac9

Please sign in to comment.