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.
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. |
- Open the navigation menu and select Storage. Under File Storage, select File Systems.
- In the List scope section, under Compartment, select a compartment.
- Click the name of the file system that you want to replicate.
- On the file system's details page, under Resources, click Replications.
- Click Replication estimator.
The Replication estimator window opens.
- (Optional) Update the Change rate in MBps to see how the file system's rate of change affects replication time.
- Click Calculate.
Use the
fs file-system estimate-replicationcommand 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": 15 }, "etag": "1d7f6b8f824621fff51f334e7f70b5abe58bf086a3d9c02d8c567a378c251313" }Note
If you don't provide the optionalchange-rateparameter, 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
EstimateReplicationoperation to estimate the replication time for source the file system.Note
If you don't provide the optionalchangeRateInMBpsparameter, 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.