raspiBackup - Which filesystem can be used on the backup partition
- Details
- Category: raspiBackup
-
Also available:
- Hits: 8767
Depending on the backup method used in raspiBackup you should choose the right filesystem on your backup partition. Following table lists the different filesystems per backup method.
: not possible, 
: limited, 
: possible, 
: suggested
Read more: raspiBackup - Which filesystem can be used on the backup partition
raspiBackup - How do hardlinks work with rsync
- Details
- Category: raspiBackup
-
Also available:
- Hits: 10475
User Rating: 4 / 5
A lot of time people ask how the rsync backup type works and how hardlinks are used. Following article describes what happens when files are created and deleted on the file system in the backup process and how hardlinks are used.
raspiBackup - Configuration update when upgrading to a new version
- Details
- Category: raspiBackup
-
Also available:
- Hits: 7195
User Rating: 1 / 5
Whenever an upgrade to a new version of raspiBackup is executed it's tested whether the new version has new configuration options. If there are new configuration options used the local configuration file will be merged into a new file with the new configuration file while upgrading raspiBackup. Following page describes in detail what's going on during a configuration update.
Note
If a version less than 0.6.5 is upgraded the configuration file merge has to be started manually after upgrading. Following command will start the configuration update:
sudo raspiBackup.sh --updateConfig
When the two configuration files are merged raspiBackup writes various information messages. Following messages are written when upgrading raspiBackup from v0.6.4.3 to v0.6.5:
--- RBK0241I: Merging current configuration v0.1.3 with new configuration v0.1.4 into /usr/local/etc/raspiBackup.conf.merged.
--- RBK0248I: Added option DEFAULT_SMART_RECYCLE=0.
--- RBK0248I: Added option DEFAULT_SMART_RECYCLE_DRYRUN=1.
--- RBK0248I: Added option DEFAULT_SMART_RECYCLE_OPTIONS="7 4 12 1".
--- RBK0248I: Added option DEFAULT_TELEGRAM_TOKEN="".
--- RBK0248I: Added option DEFAULT_TELEGRAM_CHATID="".
--- RBK0248I: Added option DEFAULT_TELEGRAM_NOTIFICATIONS="F".
--- RBK0248I: Added option DEFAULT_NOTIFY_START=0.
--- RBK0248I: Added option DEFAULT_COLORING="CM".
--- RBK0243I: Configuration merge finished successfullly but not activated.
!!! RBK0245W: Backup current configuration in /usr/local/etc/raspiBackup.conf.bak and activate updated configuration? y/N
Configuration file
/usr/local/etc/raspiBackup.conf.merged
will be created and receive the merged configuration files /usr/local/etc/raspiBackup.conf with the new configuration . RBK248 lists which changes are applied. Finally you have to answer the question whether you want to activate the merged configuration file. The existing configuration file will be saved in /usr/local/etc/raspiBackup.conf.bak. Do you answer with yes the configuration update is finished and you get following messages
--- RBK0240I: Saving current configuration /usr/local/etc/raspiBackup.conf to /usr/local/etc/raspiBackup.conf.bak.
--- RBK0244I: Merged configuration /usr/local/etc/raspiBackup.conf.merged copied to /usr/local/etc/raspiBackup.conf and activated.
That's the easiest way to activate the merged configuration file and you're done quickly.
But you also can answer no and the merged configuration file will not be activated. You get following message:
--- RBK0247I: Now review /usr/local/etc/raspiBackup.conf.merged and copy the configuration file to /usr/local/etc/raspiBackup.conf to finish the configuration update.
The new options in the merged configuration file can easily be identified:
# Smart recycle
# >>>>> NEW OPTION added in config version "0.1.4" <<<<<
DEFAULT_SMART_RECYCLE=0
# Smart recycle dryrun
# >>>>> NEW OPTION added in config version "0.1.4" <<<<<
DEFAULT_SMART_RECYCLE_DRYRUN=1
# Smart recycle parameters (daily, weekly, monthly and yearly)
# >>>>> NEW OPTION added in config version "0.1.4" <<<<<
DEFAULT_SMART_RECYCLE_OPTIONS="7 4 12 1"
Now use your editor and check /usr/local/etc/raspiBackup.conf.merged and change the contents if needed. Finally copy the merged configuration file to /usr/local/etc/raspiBackup.conf to activate the new configuration file.
Finally execute as usual whenever you upgraded raspiBackup a backup/restore cycle and test whether everything still works as before.
raspiBackup supports usage of different configuration files. The automatic configuration update is only done for /usr/local/etc/raspiBackup.conf. All other configuration files have to be updated manually. Just copy the lines marked as new configuration lines into the other configuration files.
raspiBackup - Smart recycle backup strategy
- Details
- Category: raspiBackup
-
Also available:
- Hits: 15136
User Rating: 5 / 5
Starting with release 0.6.5 of raspiBackup an itelligent rotation strategy of your backups is supported. It's also called GFS (grandfather-father-son backup). The implementation was inspired by Manuel Dewalds article Automating backups on a Raspberry Pi NAS
raspiBackup retains following backups per default if a daily backup is created:
1) Backup of the current day and the last 6 days
2) Backup of the current week and the last 3 weeks
3) Backup of the current month and the last 11 months
4) Backup of the current year and the last two years
If weekly backups are created there will be no daily backups kept. Different retention values for daily, weekly, monthly and yearly can be defined with an option, e.g. if you want to retain weekly, monthly and yearly backups. Keep in mind the weekly backup day then will become the day of the weekly and monthly backup: If you configure Monday as the weekly backup day your monthly backup will be the first Monday of every month. Yout yearly backup will be the first Monday of the year. Iy you create a weekly backup every Sunday the monthly backup will be the first Sunday of the month and the yearly backup will be the first Sunday of the year.
raspiBackup - Introduction and installation - Youtube Video in English
- Details
- Category: raspiBackup
-
Also available:
- Hits: 7794
User Rating: 4 / 5
I finally picked myself up and created a video about raspiBackup and published it on Youtube. Topics in the video are
- Introduction of raspiBackup
- Visit of the most important websites for raspiBackup
- Visit of github which is used as a question- and issue handling tool for raspiBackup
- Live installation of raspiBackup with the menu driven installer
Slides used in the video can be downloaded here.
Read more: raspiBackup - Introduction and installation - Youtube Video in English
raspiBackup - Used all over the world
- Details
- Category: raspiBackup
-
Also available:
- Hits: 7946
User Rating: 4 / 5
Users of raspiBackup in the world (Status 01/2024)
Countries: 70
raspiBackup - Manual installation and configuration
- Details
- Category: raspiBackup
-
Also available:
- Hits: 17425
In general using the installer is the fastest method to install raspiBackup. The installer also can be used to install raspiBackup with it's default configuration via the commandline. If you want to install raspiBackup manually execute the following steps:
Read more: raspiBackup - Manual installation and configuration
raspiBackup - Usage- and configuration examples
- Details
- Category: raspiBackup
-
Also available:
- Hits: 17619
User Rating: 5 / 5
Following pages describe different usage scenarios and configurations. They should help to find the right usage configuration out of the various configuration options of raspiBackup. Later on these usage scenarios can be customized further. An overview of all option is available here. The different ways to restore a backup are described here.
All configurations which don't use a dd backup save an external rootfilesystem together with the SD boot partition. If the USB bootmode is used and no SD card is used any more the whole rootpartition is also saved.
Usage scenarios described:
1a. A Windows user wants to backup his Raspberry and restore it with windisk32imager on Windows.
1b. A Windows user has a 32GB SD card but uses only 12GB and 12GB should be saved only.
1c. A Windows user wants to use pishrink to create a minimal backup image.
3. Raspberry should be saved on a Samba mounted filesystem, which is provided by a Windows box.
5. A USB boot system backup should include an additional partition.
6. Raspberry should be saved on a local USB stick or a local USB disk.
raspiBackup - Donations
- Details
- Category: raspiBackup
-
Also available:
- Hits: 12538
User Rating: 5 / 5
Any recognition of raspiBackup development- and maintenance effort and any support is greatly appreciated. There exist following donation alternatives:
1) Become a github sponsor for raspiBackup
2) Paypal: The eMail framp att linux-tips-and-tricks dott de is known by PayPal and everybody who owns a Paypal account can donate to this eMail.
3) Neither one: Just contact me with at the eMail above and we will find a solution. For example I already received multiple times donations in a good old postal letter :-)
raspiBackup - Developmentenvironment
- Details
- Category: raspiBackup
-
Also available:
- Hits: 5725
raspiBackup is developed primarily on a Linux desktop. But finally raspiBackup is tested on a real Raspberry. There exist various raspibian images on disk which are restrored with raspiBackup on a SD card and/or USB stick and then the new or changed functionality of raspiBackup ist tested manually.
At some point in time a new version of raspiBackup has to be published. Initially I tested a lot of different variants by hand which takes a long time and reduces the number of my SD cards. Therefore I set up a Raspberry simulation environment on Linux. Now every new raspiBackup version is regression tested in the simulation environment. That's much faster and I don't have to buy new SD cards all the time any more.
On the following picture you can see a 3B Raspberry I use for tests together with various SD cards of different size and USB sticks.
raspiBackup - Errormessages, root causes, suggested actions
- Details
- Category: raspiBackup
-
Also available:
- Hits: 19195
User Rating: 5 / 5
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....).
Read more: raspiBackup - Errormessages, root causes, suggested actions
raspiBackup - Regressiontests executed before publishing a new release
- Details
- Category: raspiBackup
-
Also available:
- Hits: 10344
Every new version of raspiBackup is regression tested before it's published. There are a lot of options and hard- and softwareenvironments possible which cannot be regression tested - unfortunately. Following page describes how the regressiontest is executed and which tests are executed.
Read more: raspiBackup - Regressiontests executed before publishing a new release
raspiBackup - Useful helper scripts
- Details
- Category: raspiBackup
-
Also available:
- Hits: 5016
raspiBackup has some helper scrips which are available on github for download.
1) raspiBackupWrapper.sh : Helps to do additional stuff before and after invocation of raspiBackup. The backuppartition is mounted already before starting raspiBackup and unmounted if it wasn't mounted when starting. Some basic bash scripting knowlege is required to customize the script for individual needs.
2) raspiBackupNfsWrapper.sh: Check if a NFS server is online and start raspiBackup. Don't start raspiBackup if the server is offline. This script can be used out of the box. Some constants regarding the nfs server have to be customized.
3) raspiBackupRestore2Image.sh: This script allows to convert a tar or rsync backup which was created in normal backup mode into a dd image. pishrink is used to make sure the image is as small as possible. kmbach suggested to create this script. No customization of the script required.
4) raspiImageMail.sh: THis script was created by raspiBackup user kmbach. He wanted to get an eMail at the end of raspiBackupRestore2Image.sh. eMail configuration is extracted from raspiBackup configuration file.
Page 2 of 4