diff options
Diffstat (limited to 'doc/cephfs/cephfs-mirroring.rst')
-rw-r--r-- | doc/cephfs/cephfs-mirroring.rst | 26 |
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 |