TweetFollow Us on Twitter

LBackup: Flexible backup for system administrators

Volume Number: 24 (2008)
Issue Number: 08
Column Tag: Backup

LBackup: Flexible backup for system administrators

by Henry Shustak, Infinity Architect

Project History

Since the project started over eight years ago various people have contributed to LBackup in one way or another. In 2007 the project was released under the GNU GPL and a website for the project was also established.

If you had asked me what I thought about backup ten years ago, I would probably have replied, "It is an important but extremely boring topic". However, my attitude towards backup since then has dramatically changed.

I was put in charge of backups at work. The company already had established a backup system. They were using commercial backup software to manage the data which were copied to tapes by an expensive and extremely slow (by today's standards) tape drive unit. I had been tasked with keeping the system running.

The backups were often running behind schedule. Initially, I assumed this was due to the tape errors which would often greet me on Monday mornings. It slowly dawned on me that the tape errors were not the only reason that I was perpetually playing backup catch-up. The primary issue was actually the limited amount of time that was available for the backup to run. Looking through the logs, I calculated that the backup would often take longer than the time available for the backup to run. I wanted to find a solution to this problem, but there were no inexpensive solutions readily available. This is what initially sparked my interest in backup technology.

A couple of years later, I enrolled at university. Initially, I used the school computers and the backups of my computer files were managed for me by the system administrators at the university.

There were not enough computers in the labs at university and the times which undergraduates were allowed access to the computer labs was strictly regulated.

Luckily, just prior to starting university, I had been gifted a second-hand laptop. This was a great gift and I convinced myself that working remotely from home would not only be more convenient, but also more productive. However, in reality, working remotely from home was intolerably slow. Therefore, it was not long until I had many important documents stored locally on my laptop rather than on the university computer system.

Backing up these locally stored files manually was not an attractive option. In addition, I did not want to return to the daily competition with other students for computer access.

If something was to happen to my laptop and was to I lose all my schoolwork, I could fail multiple courses. The danger of my situation was reinforced by the recent memory of installing a new hard drive for the previous owner of my laptop due to a hard drive failure.

It was time to take action. I begin researching various backup solutions that would protect my precious files. The initial aim of this project was not to build a backup system; it was to find an existing backup tool that was reliable, simple, unobtrusive and most importantly inexpensive.

After testing various backup systems I eventually, settled upon rsync. I was delighted that my important schoolwork was now backed up. I had no idea at the time that this script which had been whipped up for testing was going to evolve into LBackup.

Not long after installing and configuring the script on a few machines, I realized there were some new features which I desperately required on some of these new setups. I manually added the new feature to each installation as required. After repeating this process a few times it became clear that there had to be a better way. A more sensible approach would be to separate the code which performed the backup, from the configuration information which contained the details of how to perform the backup, on each individual machine.

I spoke to a friend whom I had met at university about the problem and together we worked out a solution. It was not long before an example configuration directory was included and the system became commonly referred to as LBackup.

Adding the configuration system meant that additional features could easily be added as required.

About LBackup

LBackup is an open source backup tool. It relies on many other open source tools in order to function.

A basic LBackup configuration file often takes less than 10 minutes to setup (excluding the time required for testing). Although the current version of LBackup is not yet as easy to setup as Time Machine, it is completely customizable.

Below is a list of the key LBackup features as of version 0.9.8q6.

Designed for user data backup

Full backup tree

Encrypted backups (Transport and Storage)

Email reports

Hard links (Saving Space)

RSync back-end (Reliable)

Pre and post actions (such as mounting and un-mounting volumes)

Network backup


All these features are documented in further detail on the LBackup website.

Basic Backup Tutorial

After completing this tutorial you should have an idea of whether LBackup is right for your needs. This tutorial aims to provide you with a feel for how LBackup works. This tutorial assumes you are running Mac OS 10.4.x or later and that you are familiar with using Mac OS X.

Step (1): Create a new directory on in the /Users/Shared directory called source.

Step (2): Create another new directory in the /Users/Shared directory called destination.

Step (3): Visit the LBackup web page and download the latest version of LBackup

Step (4): Run the LBackup installer and follow the on screen instructions.

Step (5): Open the root directory on the system which you just installed LBackup.

Step(6): Open the lbackup directory within the root directory.

Step (7): Copy the example_backup_config directory into the /Users/Shared directory.

Step (8): Rename the directory you copied in the previous step to testinglbackup.

Step (9): Locate the file called example_backup.conf within the testinglbackup directory.

Step (10): Rename the example_backup.conf file to testinglbackup.conf.

Step (11): Edit the configuration file so it is the same as the listing below.


Step (12): Open a Terminal.

Step (13): Type the following into the terminal and then press return.

/usr/local/sbin/lbackup /Users/Shared/testinglbackup/testinglbackup.conf

Next you should see something similar to the following as output on the terminal:

Loading Backup Script Configuration Data...
Checking for Pre Action Scripts...
First Run Full Copy...
Number of files: 1
Number of files transferred: 0
Total file size: 0 bytes
Total transferred file size: 0 bytes
Literal data: 0 bytes
Matched data: 0 bytes
File list size: 62
Total bytes sent: 74
Total bytes received: 20
sent 74 bytes  received 20 bytes  188.00 bytes/sec
total size is 0  speedup is 0.00
real   0m0.153s
user   0m0.004s
sys   0m0.018s
Rotating Backups...
Performing Atomic Swap...
Checking for Post Action Scripts...
Backup Completed Successfully

You have just configured and run LBackup. Check inside the destination directory you created in step (2) and you will see a new directory called Section.0. This directory contains the latest successful backup of the source directory which you created in step (1).

Add some files or directories into the source directory. Then run LBackup again by following the instructions in Step (12) and Step (13). There will now be two directories in the destination directory. One called Section.0 and one called Section.1. If you open the latest backup directory (Section.0), then you should see a directory called source. If you open this source directory then any of the files and directories you placed in the backup source directory should also be visible.

If you would like to exclude files from being copied from the source directory to the destination directory then edit the excludes.txt file located within the testlbackup directory which is located within the /Users/Shared directory.

MetaData Preservation

On Mac OS X systems, many file system objects have associated metadata. The extended file system (HFS+) supports the storage of this metadata. It is important that you check your backups and ensure that any required metadata is being preserved before you accept any backup system as a suitable backup solution.

The compilation options of rsync and the run time flags specified by LBackup determine which metadata is preserved when you run LBackup.

On a Mac OS X systems, the user who executes the backup is also an important factor in preserving metadata. For example, if your backup policy states that preserving the POSIX (portable operating system interface) owner and groups of files and directories is important. Then you should run the backup and check that this data has in fact been preserved.

The ownerships are a special case when performing a backup on Mac OS X systems. This is because the only user who is capable of the modifying the owner of existing file system objects is root. Therefore, if you are backing up files that belong to various users, it is important to run LBackup as root so this metadata is able to be preserved. For example, if you were to run the backup as user with UID (user identifier) 508 then all the files which are backed up will have the POSIX owner set to 508 regardless of whether the file system object being backed up had this UID.

Restoring a File or Directory

To restore a file or directory to the desktop simply locate the file or directory you would like to restore within the backup destination directory and then copy this file or directory to the desktop.

When restoring a file or directory, metadata preservation may still be important. For example, if you were going to restore a network home directory, then it would be advisable to copy (restore) the directory as root. This will preserve the permissions of the NHD and its contents.

User Access to Backups

Because LBackup stores the backup(s) in a file tree rather than in an archive, it is possible to configure the backup directory so it is available via the network, as a read only share point. Such a setup will allow users to perform file level restores, without needing to contact the backup operator.

Why is Lbackup Open Source?

In 2007, it was decided that LBackup should be available to anyone and everyone for free. One motivation behind the decision was that I and many of the companies I was working with preferred to use an open source backup solution when available and appropriate. Another reason behind the open-source move was that rsync had also been released under the GNU GPL and as such this was an obvious license to release LBackup under. However, the most important reason for open sourcing the project was to ensure that other people would have a tool which could be quickly and easily modified to meet their own specific needs.

Essentially this means that if you add a feature, then everyone else using LBackup also benefits from your work and vice versa. Open source development makes sense on many different levels for this kind of project.

Why the Crazy Version Numbers?

I have been using LBackup at home for more than eight years and at work for more than four years. A goal of a "1.0" release is a GUI which will allow users to create a basic LBackup configuration.

The future of LBackup

I would like to see a clean up of the code. It is nothing a little re-factoring will not fix. I am sure this will happen at some stage in the near future.

In addition to a general code clean up, there are some other new features listed below which I believe people would find handy:

A GUI offering even basic backup setup options.

Some bundled scripts for shutting down and starting up various databases.

An installer or some sort of automated setup of network backup client(s).

A system for handling network backup clients that come onto and off the network.

(I have heard that TimeCapsule and Time Machine does a pretty good job under 10.5)

Some bundled scripts for performing various database dumps.

A bundled script to handle backup locking

A system to make the setup of encrypted backups a little easier.

A pre- or post- script which performs a malware scan of the client or client data.

Possible integration with Link-Backup (which looks like an interesting backup system!).

There are of course many more features that other people are sure to need and may even develop. The LBackup team is always open to ideas. If you feel like adding a feature or just tidying-up some code then please consider joining the LBackup team, thus making the world a better place.

LBackup Support

If you require assistance with the setup or integration of LBackup, then Lucid Information Systems is available to help. Lucid offers on-site support for LBackup in selected regions. Visit their web page for contact details.

LBackup Pre and Post Scripts

LBackup supports pre and post scripts. This per-configuration feature is useful, if you would like to perform certain actions before or after a backup.

The LBackup scripting sub-system opens up a great deal of flexibility to those who are comfortable with programming. In addition LBackup ships with a variety of example scripts. The example pre and post scripts offer a way for you to get started quickly with the LBackup scripting subsystem.

The pre and post action examples may be found in the LBackup example_backup_config directory. If you open the resources directory and then open the example-scripts directory you will be able to browse though the example scripts.

One of the example scripts for Mac OS X users, allows LBackup to perform a push backup via SSH to an encrypted disk image. This script requires that you have installed MacFUSE and the MacFUSE SSH File System module. This pre script will mount the directory of a remote machine via SSH. Then it will proceed to mount an encrypted disk image that may be configured as the backup destination for this LBackup configuration.

There are also associated post scripts to unmount the encrypted disk image and the SSH mount point.

LBackup also ships with a variety of scripts to handle local drives and image files. With regards to the LBackup scripting interface, your imagination is the limit.

The LBackup scripting subsystem and the bundled scripts allow the configuration of redundant encrypted backups for a single data source. This way should something happen to one of your encrypted backups, your data should still be safe in one of the other encrypted redundant backups.

More Scripting

LBackup is command line and configuration file driven. Therefore, it is possible to build control systems which wrap around or extend LBackup.

For example you may want to create backup chains or integrate LBackup with third party (or your own) analysis and monitoring tools.

Documentation and Development

The LBackup development and documentation is open for editing. Provided this is not abused, the intention is to keep it this way.

This means you are able to look into the future of LBackup and even express your opinion with regards development decisions and directions..

In addition, you have the ability to fix any spelling or grammatical errors you may find within the documentation. You may even end up adding some pages on how to perform some sort of special backup routine using LBackup.


Let your backup policy dictate your requirements. Then find a system that is a good fit. Also, try different backup systems and see which system is the best for you and your requirements.

You may find that you end up using more than one backup system. For example, one system may not cover all of your requirements or you may find that one system will work better in certain situations, while another will work better in other situations.

Have a look at the LBackup web page and screen casts and then give it a try.

Other Notable Free Backup Tools For Mac OS X

If you are looking for a free backup tool for use with Mac OS X then the following free tools are defiantly worth investigating.

Carbon Copy Cloner



Time Machine (requires 10.5 or later.)



Related Links



Carbon Copy Cloner:




Time Machine: Machine.html





Lucid Information Systems:

In 1982, Henri used an Apple Computer for the first time. It was an Apple ][e and ever since he has enjoyed programming. Henri is not the only one who has loaded data onto a computer and has then later been unable to retrieve this data. However, in spite these experiences, he continues to use computer systems designed by Apple to store various digital information. More recently he has made an effort to prevent the loss of this data by trying, building, deploying and testing various digital data protection systems.


Community Search:
MacTech Search:

Software Updates via MacUpdate

Dash 3.4.0 - Instant search and offline...
Dash is an API documentation browser and code snippet manager. Dash helps you store snippets of code, as well as instantly search and browse documentation for almost any API you might use (for a full... Read more
AirRadar 3.1.9 - $9.95
With AirRadar, scanning for wireless networks is now easier and more personalized! It allows you to scan for open networks and tag them as favourites or filter them out. View detailed network... Read more
Printopia 2.1.22 - Share Mac printers wi...
Run Printopia on your Mac to share its printers to any capable iPhone, iPad or iPod Touch. Printopia will also add virtual printers, allowing you to save print-outs to your Mac and send to apps.... Read more
SteerMouse 5.0 - Powerful third-party mo...
SteerMouse is an advanced driver for USB and Bluetooth mice. It also supports Apple Mighty Mouse very well. SteerMouse can assign various functions to buttons that Apple's software does not allow,... Read more
Alarm Clock Pro 10.2.5 - $19.95
Alarm Clock Pro isn't just an ordinary alarm clock. Use it to wake you up in the morning, send and compose e-mails, remind you of appointments, randomize the iTunes selection, control an internet... Read more
Cocktail 10.1 - General maintenance and...
Cocktail is a general purpose utility for macOS that lets you clean, repair and optimize your Mac. It is a powerful digital toolset that helps hundreds of thousands of Mac users around the world get... Read more
RapidWeaver 7.1.7 - Create template-base...
RapidWeaver is a next-generation Web design application to help you easily create professional-looking Web sites in minutes. No knowledge of complex code is required, RapidWeaver will take care of... Read more
MacCleanse 5.1.6 - $29.95
MacCleanse is the product of thousands of hours of intense research and development. It meticulously scans all of the nooks and crannies of a computer for unnecessary junk that can take up huge... Read more
Slack 2.3.0 - Collaborative communicatio...
Slack is a collaborative communication app that simplifies real-time messaging, archiving, and search for modern working teams. Version 2.3.0: Note: Now requires OS X 10.8 or later New The app... Read more
Firefox 49.0.2 - Fast, safe Web browser.
Firefox offers a fast, safe Web browsing experience. Browse quickly, securely, and effortlessly. With its industry-leading features, Firefox is the choice of Web development professionals and casual... Read more

Latest Forum Discussions

See All

4 addictive clicker games like Best Fien...
Clickers are passive games that take advantage of basic human psychology to suck you in, and they're totally unashamed of that. As long as you're aware that this game has been created to take hold of your brain and leave you perfectly content to... | Read more »
Smile Inc. Guide: How not to die on the...
As if Mondays weren't bad enough, at Smile Inc. you have to deal with giant killer donuts, massive hungry staplers, and blasting zones. It's not exactly a happy, thriving work environment. In fact, you'll be lucky to survive the nine to five.... | Read more »
Oh...Sir! The Insult Simulator (Games)
Oh...Sir! The Insult Simulator 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: | Read more »
WitchSpring2 (Games)
WitchSpring2 1.27 Device: iOS Universal Category: Games Price: $3.99, Version: 1.27 (iTunes) Description: This is the story of Luna, the Moonlight Witch as she sets out into the world. This is a sequel to Witch Spring. Witch Spring 2... | Read more »
4 popular apps getting a Halloween makeo...
'Tis the season for all things spooky. So much, so, in fact, that even apps are getting into the spirt of things, dressing up in costume and spreading jack o' lanterns all about the place. These updates bring frightening new character skins, scary... | Read more »
Pokémon GO celebrates Halloween with can...
The folks behind Pokémon GO have some exciting things planned for their Halloween celebration, the first in-game event since it launched back in July. Starting October 26 and ending on November 1, trainers will be running into large numbers of... | Read more »
Best Fiends Forever Guide: How to collec...
The fiendship in Seriously's hit Best Fiends has been upgraded this time around in Best Fiends Forever. It’s a fast-paced clicker with lots of color and style--kind of reminiscent of a ‘90s animal mascot game like Crash Bandicoot. The game... | Read more »
5 apps for the budding mixologist
Creating your own cocktails is something of an art form, requiring a knack for unique tastes and devising interesting combinations. It's easy to get started right in your own kitchen, though, even if you're a complete beginner. Try using one of... | Read more »
5 mobile strategy games to try when you...
Strategy enthusiasts everywhere are celebrating the release of Civilization VI this week, and so far everyone seems pretty satisfied with the first full release in the series since 2010. The series has always been about ultra-addictive gameplay... | Read more »
Popclaire talk to us about why The Virus...
Humanity has succumbed to a virus that’s spread throughout the world. Now the dead have risen with a hunger for human flesh, and all that remain are a few survivors. One of those survivors has just called you for help. That’s the plot in POPCLAIRE’... | Read more »

Price Scanner via

Apple refurbished 2015 13-inch MacBook Airs a...
Apple has Certified Refurbished 2015 13″ MacBook Airs available starting at $759. An Apple one-year warranty is included with each MacBook, and shipping is free: - 2015 13″ 1.6GHz/4GB/128GB MacBook... Read more
64GB Apple TV on sale for $159, save $40
Best Buy has the 64GB Apple TV on sale for $40 off MSRP on their online store. Choose free shipping or free local store pickup (if available). Sale price for online orders only, in-store price may... Read more
EyeQue Introduces iOS And Android Based Advan...
Affordable vision technologies developers EyeQue have announced what they claim to be the world’s most advanced intelligent vision solution, pitched as enabling anyone, anywhere to easily and... Read more
Smartwatch Market Tanks, Declining 51.6% in 2...
The worldwide smartwatch market experienced a round of growing pains in the third quarter of 2016 (3Q16), resulting in a year-over-year decline in shipment volumes. According to data from the... Read more
CAZE announces Ultra Thin Glass Screen Protec...
Hong Kong based CAZE has announced its first ultra thin glass screen protector, the Glazz Pro for iPhone 7/7 Plus. Glazz Pro is made from chemically reinforced glass with an anti-fingerprint... Read more
11-inch MacBook Airs on sale for up to $120 o...
Newegg has 11″ MacBook Airs on sale for up to $120 off MSRP. Shipping is free: - 11″ 1.6GHz/128GB MacBook Air: $799.99 $100 off MSRP - 11″ 1.6GHz/256GB MacBook Air: $979 $120 off MSRP Read more
Up to $300 off Macs, $20 off iPads with Apple...
Purchase a new Mac or iPad using Apple’s Education Store and take up to $300 off MSRP. All teachers, students, and staff of any educational institution qualify for the discount. Shipping is free, and... Read more
Apple’s Thursday “Hello Again” Event A Largel...
KGI Securities analyst Ming-Chi Kuo, who has a strong record of Apple hardware prediction accuracy, forecasts in a new note to investors released late last week that a long-overdue redo of the... Read more
12-inch Retina MacBooks on sale for $100 off...
Amazon has 2016 12″ Apple Retina MacBooks on sale for $100 off MSRP. Shipping is free: - 12″ 1.1GHz Silver Retina MacBook: $1199.99 $100 off MSRP - 12″ 1.1GHz Gold Retina MacBook: $1199.99 $100 off... Read more
Save up to $600 with Apple refurbished Mac Pr...
Apple has Certified Refurbished Mac Pros available for up to $600 off the cost of new models. An Apple one-year warranty is included with each Mac Pro, and shipping is free. The following... Read more

Jobs Board

*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Solutions Consultant - Apple (United...
# Apple Solutions Consultant Job Number: 52812872 Houston, Texas, United States Posted: Oct. 18, 2016 Weekly Hours: 40.00 **Job Summary** As an Apple Solutions Read more
Lead *Apple* Solutions Consultant - Apple (...
# Lead Apple Solutions Consultant Job Number: 52812906 Houston, Texas, United States Posted: Oct. 18, 2016 Weekly Hours: 40.00 **Job Summary** The Lead ASC is an Read more
*Apple* Retail - Multiple Positions- Towson,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
Software Engineering Intern: Integration / QA...
Job Summary Apple is currently seeking enthusiastic interns who can work full-time for a minimum of 12-weeks between Fall 2015 and Summer 2016. Our software Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.