Suggest improving Guide text re recursive snapshotting and replication
I suggest improvements in the Guide to the descriptions of what happens when you check the 'recursive' boxes for snapshots and replication. It is currently unclear to me and others. Snapshot recursion was recently explained to me, so I have a suggested change for that, but I still don't know about replication recursion. At least I can point out the ambiguity.
Table 8.2a: Options When Creating a Periodic Snapshot
What it says:
"Select this box to take separate snapshots of the volume/dataset and each of its child datasets; if unchecked, only one snapshot is taken of the specified Volume/Dataset."
How it can be interpreted:
"Select this box to take separate snapshots of the volume/dataset and each of its child datasets; if unchecked, only one snapshot is taken of the specified Volume/Dataset, and that snapshot will include the child datasets."
How it might be rephrased (if this is correct):
"Select this box to take separate snapshots of the volume/dataset and each of its child datasets. If unchecked, a single snapshot is taken of only the selected volume or dataset, without any child datasets."
Table 8.3a: Adding a Replication Task
What it says:
"if checked will also replicate child datasets"
I don't know enough about the behavior to recommend a more detailed explanation, but that is needed. How is this related to recursive snapshots? When checking this box, will child datasets be replicated even if only the parent dataset is snapshotted (ie, snapshots of the parent not done recursively)? Or, for recursive replication to work as expected, must all the child datasets have snapshots also?
If the latter is true, I might suggest:
"If checked, child datasets will also be replicated. Each dataset in the hierarchy must have a periodic snapshot for replication to work. These can be done as separate periodic snapshot tasks or as a single task with the recursive box checked."
#9 Updated by Warren Block over 2 years ago
Vaibhav Chauhan wrote:
can this be marked RFR ?
I committed an update just now which I think addresses this bug although maybe not in the way the reporter suggested (https://github.com/freenas/freenas-docs/commit/f3d20eb651ab39c5de3d82842b85aff006cfb2be). Please review.