Knowledgebase

Portal Home > Knowledgebase > Offsite Backup Services > Linux QuickStart Guide

Linux QuickStart Guide

To configure the linux client for the backup account you should first download the client to the machine either by using lynx or wget.

You will then proceed to create the neccessary directory:

mkdir -p /usr/local/obm
cp CLIENTadv_linux.tar.gz /usr/local/obm/
cd /usr/local/obm

bin/install.sh
This installs and starts the scheduler and updater services.

bin/Configurator.sh
This will run the initial account setup

From here it will ask for login name, password, which protocol to use and the proxy.
Sometimes it may ask for the backup server url even though it is included in the config files.

Backup Server URL: YOUR_RESELLER_USERNAME.bs.backupaccount.com

Ensure you change the YOUR_RESELLER_USERNAME to the reseller username you use to login to your reseller control panel. This is also the same as the subdomain you use to access the control panel.

Once you have installed and configured the client with the above commands, you can proceed with configuring the backup sets and schedules from the clients web interface. Because the java based GUI interacts with X11 and some servers do not run X11 environment you will have to rely on the web interface for the majority of the accounts functions.

Once you have finished configuring the client via the web interface you should run the bin/Configurator.sh again to verify that it downloads all the settings and then set the encryption settings for the backup sets.

Below is the list of shell scripts located in /usr/local/obm/bin/ for managing your backups.

Installation/Configuration

install.sh
Installs necessary services for scheduler and auto updater.

uninstall.sh
Uninstalls all services for scheduler and auto updater.

Configurator.sh
After running install.sh this will be where you setup the account details and encryption settings.

Managing Backups

BackupManager.sh
Launches X11 GUI of the backup manager. Because not all servers operate with X11 installed this command may not work.

ListBackupSet.sh
Will output the list of backup sets and there associated numerical ID.
Example Output:
BackupSet Name= Backup Set Linux 1, ID= 1205598738531
BackupSet Name= Backup Set Linux 2, ID= 1205598738826

ListBackupJob.sh [BackupSetID]
Will output the backup jobs the client has backed up recently
Example Output:
Backup Set [1205598738531]
2008-10-31-08-52-15
2008-10-31-08-50-47
2008-10-30-16-20-02
2008-10-28-16-20-04
2008-10-28-12-12-18
2008-10-27-16-20-06

SeedLoad.sh [BackupSetName] [OutputDirectory]
Uses a configured backup set name and an output directory of an attached storage device that we would send out for an initial backup

RunBackupSet.sh [BackupSetName | BackupSetID]
Will use either the name above in quotes OR the ID above to select a backup set to run manually. Will run backup using configured settings from the web interface.

ListBackupSetFiles.sh [BackupSetID]
Will dump the specified backup set’s list of files to dump.xml.

Restoring Data

Restore.sh
Edit this commented file and define parameters, like backup set, backup files, backup point-in-time, output directory, permissions.

Decrypt.sh
Edit this commented file to define parameters for decrypting backup data that we may send to you in the event of a disaster.