PBA

From Amahi Wiki
Revision as of 19:52, 10 May 2009 by Cpg (talk | contribs)
Jump to: navigation, search

Amahi now includes the Personal Backup Appliance, or PBA, with the collaboration of the PBA leader, Roland Hui. Here is what the web interface looks like:

Backups.png

This application is essentially a hard disk clone, backup and restore application.

Basic principle

  • You boot the system to back up off the network.
  • The system boots the PBA-included linux mini-distro
  • You back up one driver or restore one drive, via the network

DO NOT RESTORE to the original media. Please TEST first and make sure the backup and restore works with your hardware!

What to do, in 2 simple steps

  1. Simply boot your machine from the network. Pressing F12 during BIOS may work after you enable network boot, else see other tips on network booting
  2. The option to Backup/Restore will appear on the screen:
    Pba-client-main.png
    • When Backup is selected, it will ask what disk you want to back up (if you have more than one).
    • When Restore is selected, it will ask what image of the list you want to restore, and to what drive.

More

  • The PBA app provides a simple user-friendly interface to backup and restore entire hard disk drives over the network. This functionality is similar to that of commercial products such as Norton Ghost Server, but there is no added cost for additional software or hardware. This feature simplifies consumer hard disk backup down to very simple steps.
  • The intended audience is any user that wants a no-hassles backup solution. All you need to do is power on the machine you want to backup/restore, boot from the network and select what you want to backup.
  • Restoring a backup does not even require you to format a new drive!
  • The PBA app backs up the entire hard disk. The MBR, partition table and all partitions are copied. The Personal Backup Appliance aims to be an easy and fast backup solution. Most partitions types such as NTFS, FAT16/32, and ext3 are supported by tools that understand the filesystem, so only the data is copied, and empty space is ignored. This makes copying very fast. For other partition types, raw copies are made. The technology working behind the scenes in PBA is not new. In fact, many of the open source programs and tools used in PBA have been around for a long time. The innovation in PBA is in the presentation and the integration of these programs and tools.
  • Thanks to Roland Hui for helping port the personal backup appliance to the HDA!

CHANGE PBA FULL BACKUP PATH

The PBA backups default path is set to /var/hda/apps/pba/backups directory on the operating system drive. To change this after Adding a second hard drive to your HDA, a symbolic link is required.

  • Make a sub directory backup to the files directory on the secondary hard drive.
  • Change to the /var/hda/apps/pba directory on the operating system drive. Ensure the backups directory does not exist. If it does, remove it.
  • As user root, enter ln –sf /var/hda/files/backups backups (must match the path set when adding a secondary hard drive.
  • Verify ownership of /var/hda/pba/backups (symbolic link) is set to apache:apache.
SimLink.PNG
  • Ensure settings in /etc/fstab for the secondary drive include uid=48,gid=48 (see note).
  • Reboot and attempt a LAN backup. The full backup files should now be saved to the secondary hard drive.

NOTE: This sets ownership of the drive/directories to user apache and group apache. To verify the correct uid and gid, enter id apache. It will display the applicable uid and gid. Permissions must be set as such for the PBA backups to be directed to the secondary hard drive. This is how my secondary drive is configured in /etc/fstab.

Added by diskmounter utility
/dev/sdb1 /var/hda/files vfat rw,user,uid=48,gid=48,fmask=0111,dmask=0000 0 0

Troubleshooting

PBA has some error codes, which can be cryptic.

Here is the list of PBA errors for reference:

  • 1,general error
  • 2,error while saving MBR
  • 3,error while saving partition table
  • 4,error while pushing files to server
  • 5,partition file not found
  • 6,mbr file not found
  • 7,error while writing MBR
  • 8,error while partitioning drive
  • 9,no hard disk drive found
  • 10,general syntax error
  • 11,partition is not valid
  • 12,PBA archive not found
  • 13,please run as root on pba client
  • 14,could not fetch images.toc
  • 15,error while pushing .skip file
  • 21,dd error while processing partition
  • 22,ntfsclone error while processing partition
  • 23,partimage error while processing partition
  • 33,unzsplit failed while processing partition

Some errors are more common. Here is what we see more often:

  • Code 22: this usually indicates a permission problem. Make sure that the file /var/hda/apps/pba/backups/data exists and is not owned by root.
  • Code 23: indicates that there may be a partition in the drive or a partition scheme that partimage (the program doing the job of duping the partition) does not understand, such as hidden partitions (for restore), or some other unusual partitions, such as LoJack, etc.