To have BackupEDGE back up to Amazon S3, you must: 1 Register with Microlite Corporation for Amazon S3 services.
2 Browse to a special URL on Amazon payments and associate BackupEDGE with Amazon
S3. You may log in to an existing account, or create a new account, at this time.
3 Create (or re-generate) an Activation Key.
4 Copy or paste the Activation Key into EDGEMENU within one hour. This key is used to create a secure connection between your server and will download the Security Keyset
BackupEDGE uses when authenticating with Amazon. Note that the Activation Key
may be re-generated and copied into BackupEDGE at any time if more than one server is associated with the account, or if BackupEDGE must be removed and re-installed.
5 Create BackupEDGE AWS (Amazon Web Services) Resources.
6 Select an AWS Resource (such as aws0) for EDGEMENU or for scheduled backups.
Registering with Microlite Corporation.
Browse to www.microlite.com/s3. Click on “Register for S3 Backups”, fill out the registration form, and click Continue.
Getting an Amazon S3 Activation Key
From the launch page, click the hyperlink that says “Browse to Amazon Web Services”.You’ll get the following screen.
Log in to your current Amazon account, or create a new account. This URL will redirect you to an acceptance screen for Microlite BackupEDGE. By clicking on the “Place your order”
button you are agreeing to the displayed monthly charges and the Amazon Payments “Billing Services Agreement”.
Create / Regenerate and Activation Key
Click on “Generate Key” at the Key generation menu.
Enter the Activation Key into EDGEMENU
Within ONE HOUR of generating the Activation Key, you must launch EDGEMENU, go to Setup->Amazon S3 Setup, and type or paste in the key.
The first time you activate a copy of BackupEDGE with your Amazon Activation Key, a unique storage area is created on Amazon Web Services under your account. This is called a “bucket”, and all of the directories you create are actually just file names in your bucket. No files other than those created by BackupEDGE should ever be stored in this bucket.
If you “Cancel the use of Microlite BackupEDGE” on Amazon Payments, or cancel your
entire account, stored data will be forever lost. However, if you keep the account and, for example, remove and re-install BackupEDGE, it is possible at any time to generate a new
Activation Key and enter it into EDGEMENU. BackupEDGE will re-authenticate to
Amazon Web Services, download the Security Keyset, and find your bucket again automatically.
Create a BackupEDGE aws0 Resource.
After EDGEMENU installs the Security Keyset, you will be asked if you want to create an
AWS Resource.
The default backup directory is “/backups”, which is in reality stored in the BackupEDGE-created storage bucket within your Amazon account.
+S3 Activation---+ |Please Enter The Amazon Activation Code. | | | | | | | | | |[AC6QMZ6YKUICNYRKWDOQSK3HUUEQ ]| | | |[Activate] [Cancel]| +---+
NOTE: When [Activate] is selected, this key is used to create a secure connection between
Amazon S3 and your server and download the Security Keyset BackupEDGE uses when connecting with S3. Note that this key may be re-generated and copied into BackupEDGE at any time if more than one server is associated with the account, or if BackupEDGE must be removed and re-installed.
+ BackupEDGE Resource Information ---+ ¦- General Resource Information ---¦ |Resource Type Amazon S3 Resource | |Resource Name [aws0 ] Change as appropriate | |Description [S3 Backup Resource ] | |Changer Assoc [Standalone Device] | |Interface [Other ] | | | |- S3 Resource Information ---| |Directory [/backups ] [Test URL] | |URL s3://s3.amazonaws.com/backups | | | ¦- Default Backup Properties ---¦ ¦Quota (K) [0 ] [S] Compression Level [5] ¦ ¦Edge Block Size [64 ] [Y] Double Buffering ¦ ¦[Next] [Prev] [Cancel]¦ +---+
As with URL Resource, we recommend that you set the directory to reflect your system name and schedule name. Here is an example of an AWS Resource set for use with the default backup scheduled (simple_job) for system ml310..
The ‘Quota’ field represents the storage quota, or total amount of space that BackupEDGE
will use for all archives stored on this FTP site. A value of 0 means it will use as much space
as is necessary.
If not, use edgemenu:Admin->Define Resources to do this. Select ‘[NEW]’, and use the
right-arrow and left-arrow keys to change the resource type to ‘URL’.
Testing the AWS Resource
Test the AWS server connection from the machine with BackupEDGE installed. The
[Test URL] button uses the information on the AWS Resource screen to create a connection
with Amazon S3 and test transferring files back and forth to the appropriate directory. If a failure occurs, the reasons will be displayed on the screen to help with debugging. For reference, a copy of the most recent test failure log (if any) will be saved in the file
/usr/lib/edge/tmp/testurl.log.
Initialize the AWS Resource
When you press [Next] to save the resource, you will be asked if you want to ‘Initialize’ it.
You must let BackupEDGE initialize the resource. This tests the connection again and creates a control file named CTL in the destination directory. To initialize at a later time, use edgemenu:Admin->Initialize Medium. Note that initializing the resource will not erase
any existing backups. If existing backups exits, the CTL file, which contains information
about the individual archive segments, will be re-calculated.
Selecting the AWS Resource
Select the AWS resource as you would any other resource. Remember to pick slot names if the schedule doesn't provide them. Otherwise, the default slot name (which is ‘default’) will
be used. Since every backup would have the same slot name, every night would overwrite the previous night's backup. This is probably not what you want.
When you set up a new schedule, it's a good idea to use
edgemenu:Verify->Show Archive Label to see how many archives are actually present
after a few days. You want to be sure that you did not inadvertently tell BackupEDGE to overwrite backups nightly, such as by not specifying a slot name in the schedule.
+ BackupEDGE Resource Information ---+ ¦- General Resource Information ---¦ |Resource Type Amazon S3 Resource | |Resource Name [aws0 ] Change as appropriate | |Description [S3 Backup Resource ] | |Changer Assoc [Standalone Device] | |Interface [Other ] | | | |- S3 Resource Information ---| |Directory [/backups/ml310/simple_job ] [Test URL] | |URL s3://s3.amazonaws.com/backups/ml310/simple_job | | | ¦- Default Backup Properties ---¦ ¦Quota (K) [0 ] [S] Compression Level [5] ¦ ¦Edge Block Size [64 ] [Y] Double Buffering ¦ ¦[Next] [Prev] [Cancel]¦ +---+