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

Bookends 12.6.0 - Reference management a...
Bookends is a full-featured bibliography/reference and information-management system for students and professionals. Access the power of Bookends directly from Mellel, Nisus Writer Pro, or MS Word (... Read more
Apple iBooks Author 2.4 - Create and pub...
Apple iBooks Author helps you create and publish amazing Multi-Touch books for iPad. Now anyone can create stunning iBooks textbooks, cookbooks, history books, picture books, and more for iPad. All... Read more
Web Snapper 3.3.9 - Capture entire Web p...
Web Snapper lets you capture Web pages exactly as they appear in your browser. You can send them to a file as images or vector-based, multi-page PDFs. It captures the whole Web page - eliminating the... Read more
Tunnelblick 3.6beta10 - GUI for OpenVPN...
Tunnelblick is a free, open source graphic user interface for OpenVPN on OS X. It provides easy control of OpenVPN client and/or server connections. It comes as a ready-to-use application with all... Read more
EtreCheck 2.5.1 - For troubleshooting yo...
EtreCheck is a simple little app to display the important details of your system configuration and allow you to copy that information to the Clipboard. It is meant to be used with Apple Support... Read more
Paragraphs 1.0.4 - Writing tool just for...
Paragraphs is an app just for writers. It was built for one thing and one thing only: writing. It gives you everything you need to create brilliant prose and does away with the rest. Everything in... Read more
Things 2.8 - Elegant personal task manag...
Things is a task management solution that helps to organize your tasks in an elegant and intuitive way. Things combines powerful features with simplicity through the use of tags and its intelligent... Read more
Coda 2.5.12 - One-window Web development...
Coda is a powerful Web editor that puts everything in one place. An editor. Terminal. CSS. Files. With Coda 2, we went beyond expectations. With loads of new, much-requested features, a few surprises... Read more
PCalc 4.3 - Full-featured scientific cal...
PCalc is a full-featured, scriptable scientific calculator with support for hexadecimal, octal, and binary calculations, as well as an RPN mode, programmable functions, and an extensive set of unit... Read more
DiskMaker X 5.0 - Make a bootable OS X i...
DiskMaker X (was Lion DiskMaker) helps you to build a bootable drive from the official OS X installer app (the one you download from the Mac App Store). It detects the OS X Install program with... Read more

Camel Up (Games)
Camel Up 1.0.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0.0 (iTunes) Description: | Read more »
The Martian: Bring Him Home (Games)
The Martian: Bring Him Home 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: Based on the best selling novel and critically acclaimed film, THE MARTIAN tells the story of Astronaut Mark... | Read more »
This Week at 148Apps: September 21-30, 2...
Leap Into Fall With 148Apps How do you know what apps are worth your time and money? Just look to the review team at 148Apps. We sort through the chaos and find the apps you're looking for. The ones we love become Editor’s Choice, standing out above... | Read more »
Tweetbot 4 for Twitter (Social Networki...
Tweetbot 4 for Twitter 4.0 Device: iOS Universal Category: Social Networking Price: $4.99, Version: 4.0 (iTunes) Description: *** 50% off for a limited time. *** | Read more »
Mori (Games)
Mori 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: Stop, rewind and unwind with Mori. Time is always running, take a moment to take control. Mori is an action puzzle game about infinitely... | Read more »
100 Years' War (Games)
100 Years' War 1.0 Device: iOS Universal Category: Games Price: $3.99, Version: 1.0 (iTunes) Description: | Read more »
Tower in the Sky (Games)
Tower in the Sky 0.0.60 Device: iOS Universal Category: Games Price: $1.99, Version: 0.0.60 (iTunes) Description: | Read more »
hocus. (Games)
hocus. 1.0.0 Device: iOS Universal Category: Games Price: $.99, Version: 1.0.0 (iTunes) Description: New, polished, mind-bending, minimal puzzle game with dozens of levels and extra-ordinary design Features:- Beautifully crafted... | Read more »
Mos Speedrun 2 (Games)
Mos Speedrun 2 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: Mos is back, in her biggest and most exciting adventure ever! Wall-jump to victory through 30 mysterious, action packed levels... | Read more »
3D Touch could be a game-changer, but it...
Were you one of the lucky/financially secure enough ones to buy a new iPhone 6s or iPhone 6s Plus over the weekend? Yup, me too (I’m not convinced I was either of those two things, but let’s go with lucky for now), so I thought I’d delve into just... | Read more »

Price Scanner via

12-inch MacBooks in stock for up to $120 off,...
Adorama has 12″ Retina MacBooks in stock for up to $120 off MSRP including free shipping plus NY & NJ sales tax only. For a limited time, Adorama will include a free Apple USB-C to USB Adapter,... Read more
15-inch 2.2GHz Retina MacBook Pro on sale for... has the 15″ 2.2GHz Retina MacBook Pro on sale for $1799 including free shipping. Their price is $200 off MSRP, and it’s the lowest price available for this model (except for Apple’s $1699... Read more
iPhone 6s and 6s Plus Feature Improved Durabi...
Upgraded components in the new iPhone 6s Plus cost $16 more than the components in the earlier iPhone 6 Plus according to a preliminary estimate from IHS Inc. The bill of materials (BOM) for an... Read more
13-inch Retina MacBook Pros on sale for up to...
Adorama has 13″ Retina MacBook Pros on sale for up to $130 off MSRP. Shipping is free, and Adorama charges sales tax for NY & NJ residents only: - 13″ 2.7GHz/128GB Retina MacBook Pro: $1199.99 $... Read more
Apple refurbished 2014 13-inch Retina MacBook...
Apple has Certified Refurbished 2014 13″ 2.6GHz/128GB SSD Retina MacBook Pros available $979, $320 off original MSRP. An Apple one-year warranty is included, and shipping is free: - 13″ 2.6GHz/128GB... Read more
iOS 9 Reflections Ten Days In – The ‘Book Mys...
I’ve never been much of an early adopter by philosophy or temperament, although I did buy the iPad Air 2 I’m typing this column on last fall only about a month after Apple unveiled it. However, my... Read more
Apple refurbished Time Capsules available for...
Apple has certified refurbished Time Capsules available for $120 off MSRP. Apple’s one-year warranty is included with each Time Capsule, and shipping is free: - 2TB Time Capsule: $179, $120 off - 3TB... Read more
OS X El Capitan Available as a Free Update To...
OS X El Capitan, the latest major release of Apple’s desktop operating system, is available today, September 30 as a free update for Mac users. “People love using their Macs, and one of the biggest... Read more
15-inch Retina MacBook Pros on sale for $150-...
B&H Photo has 2015 15″ Retina MacBook Pros on sale for up to $200 off MSRP including free shipping plus NY sales tax only: - 15″ 2.2GHz Retina MacBook Pro: $1815 $184 off - 15″ 2.5GHz Retina... Read more
Updated For iOS 9, InterConneX Lets You Store...
InterConneX version 1.2 is now a 64-bit app that’s completely compatible with iOS 9. InterConneX is a file storage, file management, and file sharing app for the iPhone or iPad that now takes... Read more

Jobs Board

*Apple* Systems Engineer (Mclean, VA and NYC...
Title: Apple Systems Engineer (Mclean, VA and NYC)Location: United States-New York-New York-NYC 200 Park Avenue (22005)Other Locations: United Read more
*Apple* Retail - Multiple Positions (US) - A...
Job Description:SalesSpecialist - Retail Customer Service and SalesTransform Apple Store visitors into loyal Apple customers. When customers enter the store, you're Read more
*Apple* Retail - Multiple Customer Support P...
Job Description:Customer SupportSpecialist - Retail Customer Service and SalesTransform Apple Store visitors into loyal Apple customers. When customers enter the Read more
*Apple* Solutions Consultant - Retail Sales...
**Job Summary** As an Apple Solutions Consultant (ASC) you are the link between our customers and our products. Your role is to drive the Apple business in a retail Read more
SW QA Engineer - *Apple* TV - Apple (United...
**Job Summary** The Apple TV team is looking for experienced Quality Assurance Engineers with a passion for delivering first in class home entertainment solutions. **Key Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.