Rear
Relax-and-Recover - Linux bare metal disaster recovery and system migration solution (cfr. mksysb, ignite)
Install / Use
/learn @rear/RearREADME
Relax-and-Recover Linux Disaster Recovery & Bare Metal Restore
Relax-and-Recover (abbreviated ReaR) is the de facto standard disaster recovery framework on Linux.
It is in particular used on enterprise Linux distributions like Red Hat Enterprise Linux (RHEL) and SUSE Linux Enterprise Server (SLES).
ReaR is a system administrator tool and framework to create a bootable disaster recovery system image for bare metal disaster recovery with data backup restore on physical or virtual replacement hardware.
For bare metal disaster recovery the ReaR recovery system is booted on pristine replacement hardware. On replacement hardware first the storage setup/layout is recreated (disk partitioning, filesystems, mount points), then a backup restore program is called to restore the data (system files) into the recreated storage, and finally a boot loader is installed.
System administrators use the ReaR framework to set up a disaster recovery procedure as part of their disaster recovery policy (which complements their existing backup policy).
ReaR complements backup and restore of data with bare metal disaster recovery. ReaR can also act as local backup software, but ReaR is not a a backup management software. In many enterprise environmentments, data backup and restore happens via dedicated backup software which is integrated by ReaR and used to restore the data onto a replacement system as part of the automated disaster recovery procedure implemented by ReaR.
ReaR has support for built-in backup methods using 'tar' and 'rsync' that are used for backup and restore.
ReaR integrates supports the following 3rd party, also commercial, tools for restoring a backup.
The complete list of backup methods (BACKUP=...) is:
AVADell EMC Avamar / EMC AvamarBACULABaculaBAREOSBareosBLOCKCLONEblock device cloning viaddBORGBorg BackupCDMRubrik Cloud Data ManagementDPOpenText Data ProtectorDUPLICITYDuplicity / DuplyEXTERNALExternal custom restore methodFDRUPSTREAMFDR/UpstreamGALAXY11Commvault Galaxy 11 / Commvault SimpanaNBKDCNovaStor DataCenterNBUVeritas NetBackup / Symantec NetBackupNETFSReaR built-in backup and restore viarsyncortarto a network file system or to a locally attached backup disk (USB, eSATA, ...)NFS4SERVERNFS4 server to push data to the rescue systemNSRDell EMC NetWorker / EMC NetWorker / Legato NetWorkerOBDROne Button Disaster Recovery via tapePPDMDell PowerProtect Data ManagerRBMERsync Backup Made EasyREQUESTRESTORERequest restore from a human operatorRSYNCReaR built-in backup usingrsyncviarsyncorsshprotocolSESAMSEP SesamTSMIBM Storage Protect / Tivoli Storage Manager / IBM Spectrum ProtectVEEAMVeeam Backup
ReaR integrates well with Disaster Recovery Linux Manager (DRLM) drlm.org, which can act as a central management tool for ReaR deployments.
Professional services and support are available.
REQUIREMENTS
Relax-and-Recover is written entirely in Bash and does not require any external programs. It utilizes the standard tools on your Linux system to create the rescue system, and works out of the box on most systems.
ReaR supports many different use cases and includes support for many 3rd party backup tools. Therefore our packages have only the dependencies for the ReaR core functionality, but not for all the tools required for all the ReaR features. This is to keep your install size small when you don't need all the features. When using it, ReaR will let you know if your specific use case or workflow requires additional tools and ask you to install them.
QUICK START GUIDE
Note: Instead of cloning the sources from GitHub you can also download and install a snapshot build from our GitHub Releases page and continue from rear format.
This quick start guide shows how to run Relax-and-Recover from the git checkout and create a bootable USB backup and rescue medium.
Start by cloning the Relax-and-Recover sources from GitHub:
git clone https://github.com/rear/rear.git
Move into the 'rear/' directory (it gets created by git clone):
cd rear/
Prepare your USB medium.
Change /dev/sdX to the correct device in your environment.
Relax-and-Recover will 'own' the whole device.
This will destroy all data on that device.
sudo usr/sbin/rear format /dev/sdX
Relax-and-Recover asks you to confirm that you want to format your USB device:
Yes
The device gets labeled REAR-000 by the rear format workflow.
Now edit the etc/rear/local.conf configuration file:
### write the rescue initramfs to USB and update the USB bootloader
OUTPUT=USB
### create a backup using the internal NETFS method, using 'tar'
BACKUP=NETFS
### write both rescue image and backup to the device labeled REAR-000
BACKUP_URL=usb:///dev/disk/by-label/REAR-000
Ensure you have at least defined the OUTPUT, BACKUP and BACKUP_URL variables.
Now you are ready to create a ReaR rescue image on your USB device. We want verbose output (-v option):
sudo usr/sbin/rear -v mkrescue
The output you get will look like this:
Relax-and-Recover <version>
Using log file: /var/log/rear/rear-<hostname>.log
Creating disk layout
Creating root filesystem layout
Copying files and directories
Copying binaries and libraries
Copying kernel modules
Creating initramfs
Writing MBR to /dev/sdX
Copying resulting files to usb location
You may check the log file for possible errors or see more details what Relax-and-Recover is doing.
Now reboot your system and verify that you can boot the ReaR rescue environment from your USB device as a test.
In the ReaR rescue environment log in as root (no password) and directly shut it down (it was only a test).
Again boot your normal system.
In your normal system (with your REAR-000 labeled USB rescue device connected)
create a backup of your system (provided your USB device has enough space) by using:
sudo usr/sbin/rear -v mkbackup
The output you get will look like the above but now with a backup done at the end.
When all went well (also check the log file), you have a bootable USB rescue medium with a backup of your system.
You are now better prepared for disaster recovery.
If your system got destroyed you can boot from your USB backup and rescue medium,
log in as root into the ReaR rescue environment and call rear -v recover.
This will completely re-create your system from scratch and restore your backup
which will destroy and overwrite all previously existing data on your system disk.
So to test if rear recover works, you need fully compatible replacement hardware
where you can verify that rear recover works (at least on your replacement hardware).
INSTALLATION
We recommend installing a suitable rear package that we provide, see the Relax-and-Recover Download page. On RHEL, SUSE, Ubuntu, Debian, Arch Linux, and other distributions, you can install the package with the package manager of your distribution.
Alternatively as a software developer you may manually build it from the source tree with:
make package
This will create a package for your distribution in dist.
Alternatively as a software developer you may install manually via:
make install
Do not mix different installation methods.
You should remove a package before doing a manual installation.
CONFIGURATION
Note: This is just a quick overview, please take a look at our full Relax-and-Recover documentation for more details.
To configure Relax-and-Recover you have to edit the configuration files in
/etc/rear/. All *.conf files there are part of the configuration, but
only site.conf and local.conf are intended for the user configuration.
All other configuration files hold defaults for various distributions and
should not be changed.
In /etc/rear/templates/ there are also some template files which are use by
Relax-and-Recover to create configuration files (mostly for the boot
environment). You can use these templates to prepend your own configurations
to the configuration files created by Relax-and-Recover, for example you can
edit PXE_pxelinux.cfg to add some general pxelinux configuration you use
(I put there stuff to install Linux over the network).
In almost all circumstances you have to configure two main settings and their parameters: The BACKUP method and the OUTPUT method.
The backup method defines how your data is to be saved and whether Relax-and-Recover should backup your data as part of the mkrescue process or whether you use an external application, e.g. backup software to archive your data.
The output method defines how the rescue system is written to disk and how you plan to boot the failed computer from the rescue system.
See /usr/share/rear/conf/default.conf for an overview of the possible methods
and their options. An example to use TSM for backup and PXE for output and
would be to add these lines to /etc/rear/local.conf:
BACKUP=TSM
OUTPUT=PXE
And since all your computers use NTP for time synchronisation, you should also add these lines to /etc/rear/local.conf:
TIMESYNC=NTP
Don’t forget to distribute the local.conf to all your systems.
The resulting PXE files (kernel, initrd and pxelinux configuration) will be written to file
Related Skills
node-connect
328.7kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
81.0kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
openai-whisper-api
328.7kTranscribe audio via OpenAI Audio Transcriptions API (Whisper).
commit-push-pr
81.0kCommit, push, and open a PR
