summaryrefslogtreecommitdiffstats
path: root/doc/cephfs/cephfs-mirroring.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/cephfs/cephfs-mirroring.rst')
-rw-r--r--doc/cephfs/cephfs-mirroring.rst26
1 files changed, 17 insertions, 9 deletions
diff --git a/doc/cephfs/cephfs-mirroring.rst b/doc/cephfs/cephfs-mirroring.rst
index f54050514ed..8bdfefa1268 100644
--- a/doc/cephfs/cephfs-mirroring.rst
+++ b/doc/cephfs/cephfs-mirroring.rst
@@ -120,7 +120,9 @@ system, run a command of the following form:
.. note:: "Mirroring module" commands are prefixed with ``fs snapshot mirror``.
This distinguishes them from "monitor commands", which are prefixed with ``fs
- mirror``. Be sure (in this context) to use module commands.
+ mirror``. Enabling mirroring by using monitor commands will result in the mirror daemon
+ entering the "failed" state due to the absence of the `cephfs_mirror` index object.
+ So be sure (in this context) to use module commands.
To disable mirroring for a given file system, run a command of the following form:
@@ -189,6 +191,12 @@ To configure a directory for mirroring, run a command of the following form:
ceph fs snapshot mirror add <fs_name> <path>
+To list the configured directories, run a command of the following form:
+
+.. prompt:: bash $
+
+ ceph fs snapshot mirror ls <fs_name>
+
To stop mirroring directory snapshots, run a command of the following form:
.. prompt:: bash $
@@ -340,7 +348,7 @@ command is of format `filesystem-name@filesystem-id peer-uuid`::
"last_synced_snap": {
"id": 120,
"name": "snap1",
- "sync_duration": 0.079997898999999997,
+ "sync_duration": 3,
"sync_time_stamp": "274900.558797s",
"sync_bytes": 52428800
},
@@ -374,7 +382,7 @@ When a directory is currently being synchronized, the mirror daemon marks it as
"last_synced_snap": {
"id": 120,
"name": "snap1",
- "sync_duration": 0.079997898999999997,
+ "sync_duration": 3,
"sync_time_stamp": "274900.558797s",
"sync_bytes": 52428800
},
@@ -403,7 +411,7 @@ E.g., adding a regular file for synchronization would result in failed status::
"last_synced_snap": {
"id": 121,
"name": "snap2",
- "sync_duration": 300,
+ "sync_duration": 5,
"sync_time_stamp": "500900.600797s",
"sync_bytes": 78643200
},
@@ -439,7 +447,7 @@ In the remote filesystem::
"last_synced_snap": {
"id": 120,
"name": "snap1",
- "sync_duration": 0.079997898999999997,
+ "sync_duration": 3,
"sync_time_stamp": "274900.558797s"
},
"snaps_synced": 2,
@@ -513,16 +521,16 @@ CephFS exports mirroring metrics as :ref:`Labeled Perf Counters` which will be c
- The total number of snapshots renamed
* - avg_sync_time
- Gauge
- - The average time (ms) taken by all snapshot synchronizations
+ - The average time taken by all snapshot synchronizations
* - last_synced_start
- Gauge
- - The sync start time (ms) of the last synced snapshot
+ - The sync start time of the last synced snapshot
* - last_synced_end
- Gauge
- - The sync end time (ms) of the last synced snapshot
+ - The sync end time of the last synced snapshot
* - last_synced_duration
- Gauge
- - The time duration (ms) of the last synchronization
+ - The time duration of the last synchronization
* - last_synced_bytes
- counter
- The total bytes being synchronized for the last synced snapshot