This Quick Start Guide enables prospective Attunity customers to configure Attunity RepliWeb to load / replicate files from on-premises sources to Amazon S3.

The entire process can be set up in minutes and consists of the following stages:

Stage 1: Review the Prerequisites

1.  Source Server(s)

  • Windows 64-bit or Linux 64-bit
  • Accepts installation of 'Attunity RepliWeb' software
  • For Network Attached Storage, please provision a Windows or Linux server which can map to network path / recognize a local mount.  
  • Minimum recommended hardware requirements:  Windows Server 2008 R2, Quad-core processor, 8 GB RAM, and 320 GB of disk space. 

2.  Connectivity & Ports:  Firewall port 2837 (data transfer) opened for one-way, outbound communication.

3.  Amazon S3 Bucket:  Make sure that the following information about your Amazon S3 Bucket is readily available:

  • Amazon S3 Bucket Name
  • Amazon S3 Bucket Region
  • Amazon S3 Access Key and Secret Key

'Attunity RepliWeb' performs the following operations on the Amazon S3 Bucket:

  • On the Amazon S3 Bucket itself:  'List' and 'Read' of files (including file properties)
  • During upload, 'Attunity RepliWeb' also performs 'Write' and 'Delete' of files (including file properties)

To achieve successful replication, the user must be granted the permissions immediately above.

Stage 2: Launch the 'Attunity CloudBeam for Amazon S3' EC2 Instance

1.  Locate 'Attunity CloudBeam for Amazon S3' in the AWS Marketplace.  

Free Trial & Hourly Option:  Attunity CloudBeam for Amazon S3 - Hourly

Bring Your Own License:  Attunity CloudBeam for Amazon S3 - BYOL

2.  Click 'Continue'.  

3:  As with any EC2 Instance, a Key Pair is required in order to generate a Windows password which will let you log in to your Attunity CloudBeam EC2 instance remotely.  If you already have a Key Pair, skip to Step 5.

4:  Scroll down to the bottom of the Key Pair section.  Click 'Key Pair' and then follow the instructions to create a Key Pair.   

5:  Upon returning to the 'Launch on EC2' page, select 'Accept Terms & Launch with 1-Click'.  

Upon clicking 'Accept Terms & Launch with 1-Click', you will receive a 'Welcome Email' which contains the download link for the 'Attunity RepliWeb' software (we will refer back to this email shortly).  

6:  A subscription confirmation message will be displayed.  Close the message and wait for your EC2 instance to be ready.  This may take a few minutes (feel free to refresh the browser page to check the state or confirm readiness).  

7:  Once the EC2 instance is running, select 'Manage in AWS Console'.  

The AWS Console will open, showing your EC2 instance.  

8:  Right-click on the instance and select 'Get Windows Password'.  If a message is displayed, stating "Your password is not ready", wait a few minutes and try again.  

9:  The 'Retrieve Default Windows Administrator Password' window opens.  Browse to your Key Pair file and select 'Decrypt Password'.  

10:  The information required to connect remotely to your Attunity CloudBeam EC2 Instance will be displayed at the bottom of the window.  Please make note of the Public DNS (ie, the EC2 IP address), which will later be supplied when configuring jobs within the 'Attunity RepliWeb' software.  

Stage 3: Configure the 'Attunity CloudBeam for Amazon S3' EC2 Instance

To establish a secure connection between the Source Servers (running 'Attunity RepliWeb') and the Attunity AMI / EC2 Instance, one must create a certificate and associate the two machines.  

1:  Log in to your Attunity CloudBeam EC2 Instance using Remote Desktop or a similar utility.  After logging in, on the desktop, you will find a shortcut to the 'Attunity CloudBeam Configuration' utility.  

2:  Right-click on the short-cut to the 'Attunity CloudBeam Configuration utility' and 'Run as Administrator'.

3.  Click 'Create Certificate'.  A "Certificate created successfully" message will be displayed.  

4.  Close the message.  Windows Explorer will open automatically, displaying the newly created certificate file.  

5.  Copy the certificate.  Later, after 'Attunity RepliWeb' is installed, you must paste this certificate into the 'Attunity RepliWeb' certificates folder.  

Stage 4: Download and Install 'Attunity RepliWeb'

1: After launching the Attunity CloudBeam EC2 instance, the AWS account owner receives a 'Welcome Email' that includes a link to download the 'Attunity RepliWeb' software.  Please proceed to download. 

2:  Install Attunity RepliWeb on the source server(s).  Please install 'Center', 'Edge', and 'Console'.  

Note:  If using 'Attunity CloudBeam for Amazon S3 - BYOL', you will need to purchase an appropriate 'Attunity RepliWeb' license.  Please contact sales for assistance.

Stage 5: Apply the SSL Certificate into the 'Attunity RepliWeb Cert Folder'

After installing 'Attunity RepliWeb', one must now paste the SSL certificate copied earlier into the 'Attunity RepliWeb' Cert folder.  

1.  On the 'Attunity RepliWeb' machine, open Windows Explorer and browse to:  C:\Program Files\RepliWeb\RDS\Config\SSL\Cert (the default path).

2.  Paste the Certificate into the Cert folder.  

Stage 6: Define an On-Premises to Amazon S3 Upload Job

1.  From the Start menu, select All Programs > RepliWeb > Attunity RepliWeb Deployment Platform > Attunity RepliWeb Console.  

2.  'Attunity RepliWeb' works under the rights of existing users.  Please supply the following values:

  • 'Center':  hostname or IP address of the machine on which 'Attunity RepliWeb' is installed.
  • 'User':  Local or Domain user
  • 'Password':  ****
  • 'Domain':  if applicable

Click 'Connect'.  

3.  When the 'Attunity RepliWeb' Console opens, the 'Attunity RepliWeb Console Usage' window will be displayed.  Make sure that 'Cloud Deployment Automation' is selected, then click 'OK'.  

4.  Click 'Upload'.  

5.  Within the 'New Upload' interface, proceed to supply the necessary values:

  • 'Name':  a logical name for this job
  • 'Description':  optional, for additional details
  • 'Source':  Select 'File Server'
  • 'Source Directory':  Supply a path to the parent folder which you'd like to replicate
  • 'Target':  Select 'Cloud Storage'
  • 'Attunity CloudBeam Access Details':  Supply values for the 'AMI EC2 IP Address', 'AMI User', and 'AMI Password'.  
  • 'Amazon S3 Target':  Supply values to access the target Amazon S3 Bucket (Bucket name, Access Key, Secret Key, and Target Folder'.  

6.  In the upper right of the 'New Upload' window, select 'Schedule'.  

In the 'Schedule Mode' box, select the mode which meets your needs ('Run Once', 'Scheduled', or 'Continuous Update' - available only on a Windows source).  

Provide whatever additional scheduling properties are relevant.  

Click 'OK'.

7.  Return to the primary Job Configuration window.  Additional Job Properties may be configured.  For details, please review the 'Attunity RepliWeb' User Guide.  

8.  When comfortable with the job configuration details, click 'Submit'.

Stage 7: Monitor the Upload Job

After submitting the job, both the Scheduled job (represented by a 'clock' icon) and the Running job (represented by an 'arrow' icon) will be displayed within the 'Attunity RepliWeb' console.  

To monitor progress, double-click on the Running job.  

The 'Upload Job <Name> Details (Job ID n) window will open, showing the transfer status of each file being uploaded as well as the overall transfer status.  

To supplement this Quick Start Guide, users may also benefit from these popular resources:

 

Dev Tool:

Request: products/cloudbeam/solutions-attunity-cloudbeam-amazon-s3
Matched Rewrite Rule: (.?.+?)(?:/([0-9]+))?/?$
Matched Rewrite Query: pagename=products%2Fcloudbeam%2Fsolutions-attunity-cloudbeam-amazon-s3&page=
Loaded Template: page.php