Configuring CloudMirror replication

The StorageGRID Webscale CloudMirror replication service enables a tenant to automatically replicate objects to an external S3 bucket. You can enable replication using the Tenant Management Interface.

Attention: StorageGRID Webscale 11.0 includes the initial release of platform services. CloudMirror replication, notifications, and search integration are currently appropriate only for specific situations and workloads. You must contact your NetApp representative if you want to use the initial release of these services.

Before you begin

You must have already created a bucket to act as the replication source. Buckets are created using the StorageGRID Webscale S3 API.
Platform services must be enabled for your tenant account by a StorageGRID Webscale grid administrator.
The endpoint that you intend to use as a destination for CloudMirror replication must already exist, and you must have its URN.
You must belong to a user group that has the Manage All Containers or the Root Access permission, which allows you to manage the settings for all S3 buckets in your tenant account. These permissions override the permission settings in group or bucket policies when configuring the bucket using the Tenant Management Interface.

About this task

CloudMirror replication copies objects from a source bucket to a destination bucket that is specified in an endpoint. To enable CloudMirror replication for a bucket, you must create and apply valid bucket replication configuration XML. The replication configuration XML must use an S3 bucket endpoint URN as its destination.

For general information on bucket replication and how to configure it, see the Amazon documentation on Cross-Region replication. For information on how StorageGRID Webscale implements the S3 bucket replication configuration API, see the StorageGRID Webscale S3 Implementation Guide.

If you enable CloudMirror replication on a bucket that contains objects, new objects added to the bucket are replicated but the existing objects in the bucket are not. You must update existing objects to trigger replication.

Steps

Enable replication for your source bucket:
1. Use a text editor to create the replication configuration XML required to enable replication, as specified in the Simple Storage Service (S3) replication API.
  When configuring the XML, use the URN of an S3 bucket endpoint as the destination.
  
  Example
```
<ReplicationConfiguration>
    <Role></Role>
    <Rule>
        <Status>Enabled</Status>
        <Prefix>2017</Prefix>
        <Destination>
           <Bucket>urn:sgws:s3:::2017-records</Bucket>
           <StorageClass>STANDARD</StorageClass>
         </Destination>
     </Rule>
</ReplicationConfiguration>
```
2. In the Tenant Management Interface go to S3 > Buckets.
3. Select the source bucket, then click Configure Replication.
4. Paste the replication configuration into the text box, and click Save.
  
  Note: Platform services must be enabled for each tenant account by a StorageGRID Webscale administrator using the Grid Management Interface or Management API. Contact your grid administrator if an error occurs when you save the configuration XML.
Verify that replication is configured correctly:
1. Add an object to the source bucket that meets the requirements for replication as specified in the replication configuration.
  In the example shown earlier, objects that match the prefix "2017" are replicated.
2. Confirm that the object has been replicated to the destination bucket.
  For small objects, replication happens quickly.
You have configured your source bucket for StorageGRID Webscale bucket replication.