Merge pull request ceph#62639 from phlogistonjohn/jjm-doc-note-clustering-opt

doc/mgr: add a warning about the smb clustering option & placement

Reviewed-by: Adam King <[email protected]>
Reviewed-by: Anthony D'Atri <[email protected]>
Reviewed-by: Avan Thakkar <[email protected]>
Reviewed-by: Sachin Prabhu <[email protected]>

Author: adk3798

doc/mgr/smb.rst

@@ -495,6 +495,14 @@ custom_smb_global_options
     things in ways that the Ceph team can not help with. This special key will
     automatically be removed from the list of options passed to Samba.
 
+.. warning::
+   Setting the ``clustering`` option allows an administrator to choose exactly
+   when Samba's CTDB clustering will be used. By default, the use of Samba's
+   clustering is derived from the ``placement`` count.  If you choose to set
+   ``clustering`` make sure you understand how clustering interacts with
+   placement. In particular, be aware that running multiple instances of the
+   same ``smb`` service without clustering enabled can cause unexpected behavior.
+
 
 .. _join-source-fields: