Viewing replication details - Amazon Elastic File System

Viewing replication details

You can monitor the time when the last successful sync was completed in a replication configuration. Any changes to data on the source file system that occurred before this time have been successfully replicated to the destination file system. Any changes that occurred after this time might not be fully replicated. To monitor when the last replication successfully finished, you can use the Amazon EFS console, AWS CLI, API, or Amazon CloudWatch.

  • In the EFS console – The Last synced property in the File system details > Replication section shows the time when the last successful sync between the source and destination was completed.

  • In the AWS CLI or API – The LastReplicatedTimestamp property in the Destination object shows the time that the last successful sync was completed. To access this property, use the describe-replication-configurations CLI command. DescribeReplicationConfigurations is the equivalent API operation.

  • In CloudWatch – The TimeSinceLastSync CloudWatch metric for Amazon EFS shows the time that has elapsed since the last successful sync was completed. For more information, see CloudWatch metrics for Amazon EFS.

A replication configuration can have one of the status values described in the following table.

Replication state Description

ENABLED

The replication configuration is in a healthy state and available for use.

ENABLING

Amazon EFS is in the process of creating the replication configuration.

DELETING

Amazon EFS is deleting the replication configuration in response to a user-initiated delete request.

PAUSING

 Amazon EFS is in the process of pausing replication.

PAUSED

 Replication is paused due to a problem with the configuration. Additional information about the problem is provided.

Some problems that cause the replication to be paused include:

  • Authorization error. Permissions issues prevent Amazon EFS from performing replication. Make sure that the IAM role used to create the replication configuration has permission to perform replication. Also make sure that the file system policies are correct.

  • AWS account is unavailable. Make sure that the source and destination accounts are opted in to the appropriate AWS Regions and are not suspended. For more information, see Specify which AWS Regions your account can use in the AWS General Reference Guide.

  • KMS key for the source or destination file system is not accessible. Make sure that the KMS key assigned to each file system is accessible. For more information, see Managing KMS keys for EFS file systems.

ERROR

The replication configuration is in a failed state and is unrecoverable. You must delete the replication configuration and create a new one.

Additional information about the problem is provided. For cross-account or cross-Region replication, the error may be caused because the replication configuration was deleted from the other AWS account or AWS Region.

  1. Open the Amazon Elastic File System console at https://console.aws.amazon.com/efs/.

  2. In the left navigation pane, choose File systems.

  3. Choose a file system from the list.

  4. Choose the Replication tab to display the Replication section.

    In the Replication section, you can see the following information for the replication configuration:

    • Replication state may be Enabling, Enabled, Deleting, Pausing, Paused, or Error. Amazon EFS displays details about the cause for the Paused or Error state.

    • Replication direction shows the direction in which data is being replicated. The first file system listed is the source, and its data is being replicated to the second file system listed, which is the destination.

    • Last synced shows when the last successful sync occurred on the destination file system. Any changes to data on the source file system that occurred before this time were successfully replicated to the destination file system. Any changes that occurred after this time might not be fully replicated.

    • Replication file systems lists each file system in the replication configuration by its file system ID, the role it has in the replication configuration (either source or destination), the AWS Region in which it's located, and its Permission. A source file system has a permission of Writable, and a destination file system has a permission of Read-only.

To view a replication configuration, use the describe-replication-configurations command. You can view the replication configuration for either a specific file system, or all replication configurations for a particular AWS account in an AWS Region. The equivalent API command is DescribeReplicationConfigurations.

If the status of the replication configuration is PAUSED or ERROR, information about the cause of the issue and how to fix it is returned in the StatusMessage parameter.

Example : View the replication configuration for a specific file system

The following example describes the replication configuration for the file system fs-0123456789abcdef1.

aws efs describe-replication-configurations --file-system-id fs-0123456789abcdef1

The AWS CLI responds as follows.

{
    "Replications": [
        {
            "SourceFileSystemArn": "arn:aws:elasticfilesystem:eu-west-1:111122223333:file-system/fs-abcdef0123456789a", 
            "CreationTime": 1641491892.0,
            "SourceFileSystemRegion": "eu-west-1", 
            "OriginalSourceFileSystemArn": "arn:aws:elasticfilesystem:eu-west-1:111122223333:file-system/fs-abcdef0123456789a", 
            "SourceFileSystemId": "fs-abcdef0123456789a", 
            "Destinations": [
                {
                    "Status": "ENABLED", 
                    "FileSystemId": "fs-0123456789abcdef1", 
                    "Region": "us-east-1"
                }
            ]
        }
    ]
}
Example : View the replication configuration for all the replication configurations in an account

The following example describes the replication configuration for all the replication configurations for an account in an AWS Regionthe file system. 


        aws efs describe-replication-configurations

The AWS CLI responds as follows.


     {
    "Replications": [
        {
            "SourceFileSystemArn": "arn:aws:elasticfilesystem:eu-west-1:555555555555:file-system/fs-0123456789abcdef1", 
            "CreationTime": 1641491892.0, 
            "SourceFileSystemRegion": "eu-west-1", 
            "OriginalSourceFileSystemArn": "arn:aws:elasticfilesystem:eu-west-1:555555555555:file-system/fs-0123456789abcdef1", 
            "SourceFileSystemId": "fs-0123456789abcdef1", 
            "Destinations": [
                {
                    "Status": "ENABLED", 
                    "FileSystemId": "fs-abcdef0123456789a", 
                    "Region": "us-east-1",
                    "LastReplicatedTimestamp": 1641491802.375
                }
            ]
        }, 
        {
            "SourceFileSystemArn": "arn:aws:elasticfilesystem:eu-west-1:555555555555:file-system/fs-021345abcdef6789a", 
            "CreationTime": 1641491822.0, 
            "SourceFileSystemRegion": "eu-west-1", 
            "OriginalSourceFileSystemArn": "arn:aws:elasticfilesystem:eu-west-1:555555555555:file-system/fs-021345abcdef6789a", 
            "SourceFileSystemId": "fs-021345abcdef6789a", 
            "Destinations": [
                {
                    "Status": "ENABLED", 
                    "FileSystemId": "fs-012abc3456789def1", 
                    "Region": "us-east-1", 
                    "LastReplicatedTimestamp": 1641491823.575
                }
            ]
        }
    ]
}