RsyncBackup:

Purpose:

Prerequisites:

• The reader is executing the procedure herein on a supported platform, as defined here.
• The person performing this procedure can log into the source and backup NetMAX systems as the administrative user.
• The person performing this procedure is experienced with general UNIX system administration.
• The person performing this procedure is familiar with the basics of operating a NetMAX server, as outlined in the NetMAX Server Manual.

Obtaining A License

Purchase the license code for the RsyncBackup package from the NetMAX Store .
The proper procedure for making a purchase through the NetMAX Store is to log in with your Store userid and password, before making any purchases.
If you do not currently have an account on the NetMAX store,create one and log in before purchasing the license code. These steps are necessary so that Cybernet Systems can more easily assist you in the future if there is a question regarding NetMAX products you have purchased.
The license code can be found by typing the word rsyncbackup into the search box in the upper left of the NetMAX Store.
Follow the normal procedure to purchase the license code, which will be sent via email to the location specified in the NetMAX Store account.

Once you have received the license code, in the NetMAX interface of the server on which the RsyncBackup package will be installed, access HOME|System|License Management.
In the Currently Installed License numbers table, enter the license code from the last few steps, but do not click the “+” icon yet.
Note the Registration Activation Key in the lower left of the table.
Keep the license management window open, and a new browser window.,
In this new browser window access NetMAX online registration .
Login and register the license number, using the Registration Activation Key noted earlier.On the resultant page, the Registration Code for your NetMAX RsyncBackup license number is displayed. Enter this Registration Code into the NetMAX window you kept open earlier, to the right of the new license number.
Click the “+” icon to add the new license number and registration code to your NetMAX.
Click the APPROVE button.
Click the COMMIT ALL button and wait for the commit.

Overview

• Download and install the RsyncBackup utility files.
• Prepare storage space for the NetMAX backup.
• Specify source and destination parameters.
• Configure the backup target machine to allow rsync backups.
• Execute the RsyncBackup utility (manually or automatically).
• Recover from disk failure or data corruption by swapping the backup disks for their originals.

Downloading and Installing the RsyncBackup utility package

1. Access the NetMAX Package Manager. (HOME|System|Package Management)
2. Click the ADD button.
3. Ensure that is FTP is selected for Mode.
4. Click the DOWNLOAD INDEX button to ensure you have the latest list of packages.
5. Once the Index download has finished, select the entry NetMAX/Addons from the Index of Categories pulldown menu.
6. Install the following packages:

   RsyncBackup-1.0-4.02.0.i386.rpm

Preparing storage space for a NetMAX backup

fdisk -u -l /dev/hda

fdisk -u /dev/hde

    Add a new partition (/dev/hde1):
    
    >> choose "n" (new partition)
    >> choose "p" (primary partition)
    >> choose "1" (partition number)
    >> first sector - (see fdisk info from NetMAX disk /dev/hda)
    >> last sector - (see fdisk info from NetMAX disk /dev/hda)
    
     
    Now create a second extended partition (/dev/hde2)
    
    >> choose "n" (new partition)
    >> choose "e" (extended partition)
    >> choose "2" (partition number)
    >> first sector - (see fdisk info from NetMAX disk /dev/hda)
    >> last sector (see fdisk info from NetMAX disk /dev/hda)
     
    
    Now create a logical partiton within the extended partition (/dev/hde5)
    
    >> choose "n" (new partition)
    >> choose "l" (logical partition)
    >> first sector - (see fdisk info from NetMAX disk /dev/hda)
    >> last sector - see fdisk info from NetMAX disk /dev/hda, double the Blocks info from hda5,
                     so if hda is 102368, then enter 204736.
    
     
    
    Now create the last logical partition (/dev/hde6)
    
    >> choose "n" (new partition)
    >> choose "l" (logical partition)
    >> first sector - (see fdisk info from NetMAX disk /dev/hda)
    >> last sector - (see fdisk info from NetMAX disk /dev/hda)
    
     
    Now fix the partiton type on /dev/hde5
    
    >> choose "t" (type)
    >> choose "5" (partition number)
    >> choose "82" (hex code for Linux Swap)
    
     
    Print out the partition table, does it look correct
    
    >> choose "p"
    
     
    Now write out the partition info
    
    >> choose "w"
    
    
    The backup disk is now partitioned and needs to be formatted  and labeled. Execute the following steps at the UNIX command prompt to accomoplish this:
    
    > mke2fs /dev/hde1 (this will be the root disk "/")
    > mke2fs /dev/hde6 (this will make the var disk "/var")
    > mkswap /dev/hde5 (this will make the swap partition)
    > e2label /dev/hde1 "NETMAX"
    > e2label /dev/hde6 "www" (if the name of the machine that has
                               /dev/hda is "www.netmax.com")
    
    

The final step of backup disk preparation is making the backup storage space available. Backup disk partitions must be mounted to a mount point named after the disk (ex. sdc, sdd,) at the mount location (ex. /var/mnt) specified by the basepath in the RsyncBackupConfig file (See the "Specifying source and destination parameters" section for more information). The admin must create the "dirs" (as specified in the RsyncBackupConfig file) in the device path (ex. /var/mnt/sdb) to backup to. So, it is recommended that if for example sdb1 is supposed to backup sda1 on the source system, and sda1 is /, then you should mount sdb1 to to / rooted at /var/mnt/sdb on the local (backup) system. And if sdb6 is supposed to backup sda6 on the source system, and sda6 is /var, then you should mount sdb6 to /var/mnt/sdb/var on the local (backup) system. The goal being that in the end, the backup storage configuration looks identical to the source disk.

The NetMAX administrator must repeat the entire storage preparation process for all disks on the NetMAX system that he/she wishes to backup.

Specifying source and destination parameters

[local]
        disks=<list of comma separated backup disk device names>
        basepath=<base path of backup "disks" mount points>

[<label of partition 6 of backup disk 1>]
    fqdn=<FQDN of source machine with disk that you want to backup>
    targets=<Comma separated names of  targets that you want to backup>
    dirs=<Comma separated names of backup directories. Order corresponds to target specification>
    options=<rsync options>
    lilo=<yes/no backup lilo>



[<label of partition 6 of backup disk 2>]
    .
    .
    .
    .
    
    

    
[local]
        disks=sdb
        basepath=/var/mnt
    
[test]
        fqdn=rsync.test.com
        targets=var,root
        dirs=/var,/
        options=-alHpDx
        lilo=yes
    

The example specifies that the backup disk with partition 6 labeled as "www" will store a backup of the target "var" in the local directory "/var" and target "root" in the local directory "/". It also specifies that rsync will be run with the options "-alHpDx" and that lilo will be setup on the backup disk. The options "-alHpDx" are the default options used by RsyncBackup if you do not specify your own options. The default options work well for typical NetMAX system backups. The options field allows you to override these options.

Configuring the backup source machine to allow a rsync backup

    
log file = /var/log/rsyncd
pid file = /var/run/rsyncd.conf
    
[var]
        path = /var
        read only = true     
        uid = 0
        gid = 0
        dont compress = *.gz *.tgz *.zip *.z *.rpm *.jpg *.gif *.mpg *.JPG *.GIF *.mpeg *.mp3
        hosts allow = 192.168.33.77
     
    
[root]
        path = /
        read only = true
        uid = 0
        gid = 0
        dont compress = *.gz *.tgz *.zip *.z *.rpm *.jpg *.gif *.mpg *.JPG *.GIF *.mpeg *.mp3
        hosts allow = 192.168.33.77
     

Recovering from failure or data corruption using your backups