There exist three types of messages:
1) Informational - Messagenumber ends with I
2) Warning - Messagenumber ends with W
3) Error - Messagenumber ends with E
Most errormessages of raspiBackup give detailed information about the root cause. Sometimes it's required to get additional information in order to get rid of them. raspiBackup has about 200 errormessages and it's so boring to explain all of them here. If you miss a message first use your search engine and serach for the message number. if you still don't find an answer add the message text in a comment at the end of the page and the message with more detailed explanations will be addded on this page. That way the most common raspiBackup messages will show up on this page.
Messages in the number range from 0-999 are written by raspiBackup. Messages from 1000-1999 are written by sample plugins. All other number ranges are custom plugin messages.
In addition raspiBackup terminates with an error code which oints to the root cause. A list of error codes is available at the end of this page.
If the information for a message does'nt help just use your seach engine to search for the message number (RBK....).
List of most error messages
Description of error messages
raspiBackup ends with an error and didn't create a backup
There should be another error message preceding this message. Lookup this message and fix the root cause.
raspiBackup saves the first two partitions only. If there exist more partitions this message is written.
Either delete the additionsl partitionsor use option
--ignoreAdditionalPartitions. That way you tell raspiBackup to ignore the additional partitions which are NOT saved. Otherwise use backup type DD or parition oriented backup mode to save all partitions.
raspiBackup rejects to start in parallel. Either raspiBackup is still active or a previous raspiBackup run terminated unsuccessful and didn't delete the lock file.
ps-ef | grep raspiBackup
whether raspiBackup is active right now. If yes wait until raspiBackup finishes and try again. If no you have to delete /var/lock/raspiBackup with
sudo rm /var/lock/raspiBackup
raspiBackup allows to backup a running system. Before saving the system important services should be stopped and started afterwards to make sure the backup is consistent. There are no services defined to stop and start.
Use both options to define the services to stop and start or use the installer to define the services to stop and start in the configuration file. See details on FAQ page.
A backup filesystem for rsync has to support softlinks. It's supported by EXT2, EXT3 and EXT4. FAT32 or NTFS don't support softlinks. For details see FAQ19
Reformat the backup partition with EXT2, 3 or 4 or use a different backup type dd or tar.
dd, tar or rsync used to create a backup terminated with an error. RC is the return code of the backup program. RC 1 for dd is a read or write error. RC 1 for tar and RC 23 or RC 24 for rsync is returned by the backup tools when a file or directory changed during backup. RC2 for tar is a fatal error. This means that some fatal, unrecoverable error occurred.
RC23 for rsync also happens if there is some authorization missing.
Leading messages should point to the root cause of the error. Please also check the debug log for error messages which follow the line
executeCmd Command where the Linux backup tool is called.
If this doesn't help use option -v with tar or rsync to get detailed informations from the backup program in the debug log. Then pass the error messages into your favorit search engine to find the root cause. See the FAQ page where a lot of error messages and their root cause is explained. For rsync you will find all error rsync messages in the debug log just after the call of rsync. They help to find the root cause of the error.
You can also ignore errors from tar and rsync. See FAQ32.
A lot of time the backup partition - in particula if it's connected via network (nfs, samba) - the root cause for the issue - network transmission errors or network misconfiguration. Sometimes it's also the backup device which has write errors.
If the backup partition is mounted via nfs read this article
If authorization is missing make sure root has full control on the backup partition.
raspiBackup checks whether there is an external backup partition mounted on the backup path. Otherwise the backup would be stored on the SD card which doesn't make sense and if the SD card is small it will be blown up.
Let's assume %1 is /backup which is the default backup path. You should mount either your local your backup partition which resides on an USB stick or -disk or a remote backup partition on /backup. Use /etc/fstab to define the mount point /backup. Check with
until the remote partition is mounted.
If you know what you are doing you can use option -c to disable this error message.
A filename was passed instead of the backup directory.
Remove the filename and pass the backupdirectory name only.
Creation of a file with dd failed. RC 1 is returned for read/write errors.
If this message is written during restore the SD card is corrupted. Use another SD card. If this message is written during backup there are issues to write on the backup partition. See dd messages written earlier to get more insights about the root cause.
The commands Befehle defined with option -a/-o or configparameter DEFAULT_STARTSERVICES/DEFAULT_STOPSERVICES which start/stop services get an error.
You have to find the command which fails. Enter every command in the list step by step with sudo and watch for error messages. Then fix the root cause of the error message.
Your target partition is largern than 2TB and gpt is required. If the backup uses mbr the target partition can only be expanded until 2TB.
Ignore the message if your backup already uses gbt. Otherwise you have to create a gpt on your target drive and create your partitions beforehand. Then you can restore your backup with option -0 and your target partition will be expanded to it's maximum capacity.
raspiBackup looks up the boot partition backup in the backup directory but is unable to find it
The backup directory passed for restore is no raspiBackup directory or is incomplete. Check here for the files which have to exist in the backup directory. A backup directory has to follow following naming schema: Start with the hostname of the Raspberry followed by the backup type and end with the backup createion date and time. Examples: raspberrypi-dd-backup-20160415-222900 or raspberrypi-rsync-backup-20160416-094106
Some error occured during restore. This can either be an error when the partitions are created or the backup data is restored.
Check for any leading error messages. In addition check the debug log when the partitions are created. Search for Checking that no-one is using this disk right now and check for error messages. There is a known issue with a new sfdisk version in Bullseye if the backup is restored on a system running a previous version of sfdisk. The errormessage is
>>> line 5: unsupported command
Solution is to either use a Linux system which uses the new sfdisk version available in Buster
sfdisk from util-linux 2.36.1
or to manually delete the 5th line in the file with extension .sfdisk in the backup directory.
raspiBackup will create partitoins during restore on the SD card. Thus the SD card has to be passed as the target device for restore. It's not allowed to pass a partition.
Instead of e.g. /dev/sdb1, which defines a parition use e.g. /dev/sdb. But WARNING: All data of the SD card will be overwritten during restore. Make sure you don't need any data from other partitions any more. See also this page about restore.
raspiBackup generates a backup directory which follows a special directory naming. The backup directory has to conform to the following format. <hostname>-<backuptype>-backup-<date>-<time>. For details see here.
Das Backupverzeichnis muss gemäß der o.g. Form umbenannt werden.
raspiBackup failed with an error and deletes the empty or inconsistent backup directory.
Fix the root cause why raspiBackup failed.
raspibackup is not able to detect the boot device. This usually happens if another hardware than a Raspberry is used or another operating systemn than Raspbian is used.
Report the issue either on github or in a comment below.
raspiBackup received an error from the backup program used to create the backup in partition oriented mode.
The filesystem of the backup spaces only supports files with a maximum size of 4GB which is too small for a backup.
Create another filesystem on the backup space. Which filesystem is the right one depends on the backup type you use. Read this page and pick the correct filesystem from the table.
A partition must be not mounted when it's written to.
sudo mount | grep <device> (<device> is mentioned in the message) to find the mounted partition and use
sudo umount <partition> where <partition> should be the partition name, e.g. /dev/sda1 to umount the partition.
The dd backup is larger than the SD card used for restore and therefore it's impossible to restore the image. This message is written only for a dd backup. A tar or rsync restore will adjust the size accordingly.
The dd backup for the boot partition fails with a dd RC. RC1 is an input/output error.
Check the dd RC description. If it's RC1 check the boot device and or backup partition.
rsync will use hardlinks in order to reduce backup time and backup space. Hardlinks are supported by ext3/ext4 filesystems mounted locally or via nfs. Samba and sshfs doesn't support hardlinks.
Either use a backup partition which supports hardlinks to get the benefits of hardlinks or use tar or dd backup type. But keep in mind every backup will be a full backup which requires much more space and time.
An error occured when raspiBackup tried to send an eMail.
Most of the time this is caused by an incorrect MTA configuration if you setup your eMail notification for raspibackup. A lot of time even raspiBackup doesn't fail to send an eMail but the eMail is not received. Please check the log of the used MTA to find the root cause of the missing eMail. Configuration of a MTA is complicated and no issue of raspiBackup. Please read FAQ47. In addition look up the RC of the eMail client to get an idea what's the root cause of the issue. For example your eMail receiver may have problems to receive the eMail.
raspiBackup tries to discover the boot device but fails for some unknown reasons.
Create an issue in github and attach the debug log.
Note: NVMe storage is not supported. Development misses NVMe storage and adapter to add NVMe support and carefully execute tests. Any donations for NVMe support development and test are welcome. See here how to donate.
raspiBackup supports with option -P only to save SD cards.
If you use the normal backup mode you can create a backup when USB boot mode is used. If there are more than 2 partitions used option
--ignoreAdditionalPartitions will exclude all additional partitions from the backup.
RBK0263E: Filesystem on %s does not support Linux fileattributes.
Backup method rsync requires a backupartiton which supports Linux fileattributes. Current filesystem does not support them. Usually it's a NTFS filesystem. If the backup partition is mounted via nfs thie error message usually means the nfs partition was not expoerted with no_root_squash.
Either use dd or tar backup method or use a backuppartition which supports Linux fileattributes. For details see this page.
raspiBackup is supported on Raspberries and Raspbian only. There exist other Linux distributions and raspberry compatible hardware wre raspiBackup runs successfully. But because of missing test hardware and software and time there environments are not supported.
Use option --unsupportedEnvironment and cross fingers raspiBackup will be able to run successfully on your environment. If it fails there is no support given. See also this page.
The backup directory of a system should only contain directories created by raspiBackup. All other directories or files will cause this message.
Either delete the files and/or directories or move them to a different place.
The restore device is mounted. Either because it's the device with the root filesystem and a restore onto the running system is forbidden or because by error an active device used for other purposes is selected as the restore device and will be overwritten.
Umount the device first.
Disc sample extension requires bc for calculation.
Installi bc with 'sudo apt-get install bc' and the disk sample extension will write detailed messages.
In general raspiBackup terminates with an error code 0. Otherwise one of the following error codes is returned. An error message contains more detailed information about the cause of the error.