Estimating Replication Time

When you create a replication for a file system, the process includes an initial sync of the data from the source file system to the target file system. Depending on the amount of data written to the file system, this sync can take hours. To help plan a replication, File Storage provides a tool you can use to estimate how long the initial sync could take.

Caution

The replication estimator uses historical data of the source file system to provide its estimates. If the file system is new, the estimate might not be accurate.

The replication time estimator analyzes the source file system and provides the following details:

Field	Description
Replication Supported	Whether this file system supports replication.
Minimum Supported Replication Interval in Minutes	The minimum supported replication interval for specified file system in minutes. A value of `-1` indicates that the system can't provide an accurate estimate or replication is unsupported.
Estimated Base Copy Time in Minutes	The approximate time required for the base sync between source and target to finish. A value of `-1` indicates that the system can't provide an accurate estimate or replication is unsupported.
Detected Change Rate in MBps	The rate of change on source file system which was used to provide the default estimate in megabytes per second. A value of `-1` indicates that the system can't provide an accurate estimate or replication is unsupported.
Change Rate in MBps	The rate of change on source file system which was used to provide the estimate in megabytes per second.
Allowed Target Regions	The regions that support a replication target for this file system. If the file system doesn't support replication, this field is empty. See Limitations and Considerations for more information.

1. Open the navigation menu and click Storage. Under File Storage, click File Systems.
2. In the List scope section, under Compartment, select a compartment.
3. Click the name of the file system that you want to replicate.
4. On the file system's details page, under Resources, click Replications.
5. Click Replication estimator.
  The Replication estimator window opens.
6. (Optional) Update the Change rate in MBps to see how the file system's rate of change affects replication time.
7. Click Calculate.

Use the fs file-system estimate-replication command and required parameters to estimate the replication time for source the file system:

oci fs file-system estimate-replication --file-system-id <file_system_OCID> --change-rate <megabytes_per_second>

For example:

oci fs file-system estimate-replication --file-system-id ocid1.filesystem.oc1.iad.exampleuniqueID
{
  "data": {
    "allowed-target-regions": ["us-ashburn-1"],
    "change-rate-in-mbps": 3,
    "estimated-base-copy-time-in-minutes": 348,
    "is-replication-supported": true,
    "minimum-supported-interval-in-minutes": 60
  },
  "etag": "1d7f6b8f824621fff51f334e7f70b5abe58bf086a3d9c02d8c567a378c251313"
}

Note

If you don't provide the optional change-rate parameter, the tool uses historical data to create the estimate.

For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

Run the EstimateReplication operation to estimate the replication time for source the file system.

Note

If you don't provide the optional changeRateInMBps parameter, the tool uses historical data to create the estimate.

For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.

Oracle Cloud Infrastructure Documentation

Estimating Replication Time