Articles in this section

Managing S3 Replication Peers

Sara Levy
  • Updated
Follow

Creating an S3 replication peer on a VAST Cluster enables you to:

  • Configure replication of the VAST Cluster's data to an AWS S3 or custom S3 bucket.

  • Access data that was already replicated to the peer from a client mount of the VAST Cluster's file system.

You can have multiple S3 replication peers configured in parallel on a VAST Cluster. This enables you to access data that was replicated to all of those peers. However, you cannot back up data to more than one peer at any given time.

One active protected path can replicate the cluster's data to any one of the active peers. All restore points on all active peers are exposed to clients via the NFS export or SMB share of the root directory of the file system.

Creating an S3 Replication Peer via the VAST Web UI

  1. From the left navigation menu, select Data Protection and then S3 Replication Peers.

  2. Click Create S3 Replication Peer.

  3. Complete the fields:

    Field

    Description

    Target Name

    Enter a name for the peer.

    Bucket Name

    Enter the bucket name of the S3 bucket to which you are replicating the cluster's data.

    HTTP Protocol

    If Target Type is Custom S3, select the HTTP protocol over which to access the target:

    • HTTP

    • HTTPS (Default)

    Target Type

    Select one of the following:

    • AWS S3. The target is an AWS S3 bucket.

    • Custom S3. The target is a custom S3 bucket.

    Custom Bucket URL

    If you selected Custom S3 for Target Type, enter the URL of the custom bucket.

    Aws Region

    If you selected AWS S3 for Target Types, enter the name of the AWS region where the bucket resides.

    For example: us-east-1.

    Secret Key

    Enter the secret key of a key pair for accessing the bucket.

    Access Key

    Enter the access key of the same key pair as the secret key.

    Proxies

    Optionally configure proxies here. If proxies are configured, replication traffic is routed via the proxies to and from the replication peer.

    Proxies can either be external to the cluster or they can run on a subset of the cluster's CNodes.

    To use a CNode as a proxy, first install third party proxy software on the CNode and then enter the proxy here.

    You can specify up to eight proxies. Traffic is load balanced between the specified proxies, excluding any inactive proxies if applicable.

    Enter each proxy in the format http://<username>:<password>@<proxy IP>:<proxy port>, in which <username> and <password> or the user name and password for authenticating to the proxy, <proxy IP> is the proxy's IP address and <proxy port> is the proxy port.

    For example: http://admin:admin@192.0.2.0:8080,http://admin:admin@192.0.2.1:8080,http://admin:admin@192.0.2.2:8080

  4. Click Create.

    The replication peer is created and its details are displayed in the S3 Replication Peers page. Assuming the cluster can successfully access the target using the credentials you provided, the state will be displayed as ACTIVE.

Modifying an S3 Replication Peer via the VAST Web UI

To modify the configuration of a peer, click ActionsButtonGUI2.png to open the Actions menu for the peer and select Edit. Make your changes and then click Update.

Removing an S3 Replication Peer via the VAST Web UI

To remove a peer, click ActionsButtonGUI2.png to open the Actions menu for the peer and select Remove. Click Yes to confirm the removal.

Managing S3 Replication Peers via the VAST CLI

To manage S3 replication peers via the VAST CLI, use the following commands.

Task

Command 

Display S3 replication peers.

replicationtarget list

Display details of a specific S3 replication peer.

replicationtarget show

Create a S3 replication peer.

replicationtarget create

Modify a S3 replication peer.

replicationtarget modify

Delete a S3 replication peer.

replicationtarget delete

Comments

0 comments

Article is closed for comments.