'supervised' bootstrap strategy

Author: andreyaksenov

doc/reference/configuration/configuration_reference.rst

@@ -933,9 +933,7 @@ The ``replication`` section defines configuration parameters related to :ref:`re
     *   ``config``: use the specified node to bootstrap a replica set.
         To specify the bootstrap leader, use the :ref:`<replicaset_name>.bootstrap_leader <configuration_reference_replicasets_name_bootstrap_leader>` option.
 
-    *   ``supervised``: a bootstrap leader isn't chosen automatically but should be appointed using ``box.ctl.make_bootstrap_leader()`` on the desired node.
-
-        Configuration fails if no bootstrap leader is appointed during a :ref:`replication.connect_timeout <configuration_reference_replication_connect_timeout>`.
+    *   ``supervised``: a bootstrap leader isn't chosen automatically but should be appointed using :ref:`box.ctl.make_bootstrap_leader() <box_ctl-make_bootstrap_leader>` on the desired node.
 
     *   ``legacy`` (deprecated since :doc:`2.11.0 </release/2.11.0>`): a node requires the :ref:`replication_connect_quorum <cfg_replication-replication_connect_quorum>` number of other nodes to be connected.
         This option is added to keep the compatibility with the current versions of Cartridge and might be removed in the future.

doc/reference/reference_lua/box_ctl.rst

@@ -62,6 +62,9 @@ Below is a list of all ``box.ctl`` functions.
         *  - :doc:`./box_ctl/demote`
            - Revoke the leader role from the instance
 
+        *  - :doc:`./box_ctl/make_bootstrap_leader`
+           - Make the instance a bootstrap leader of a replica set
+
 ..  toctree::
     :hidden:
 
@@ -75,3 +78,4 @@ Below is a list of all ``box.ctl`` functions.
     box_ctl/is_recovery_finished
     box_ctl/promote
     box_ctl/demote
+    box_ctl/make_bootstrap_leader

doc/reference/reference_lua/box_ctl/make_bootstrap_leader.rst

@@ -0,0 +1,20 @@
+.. _box_ctl-make_bootstrap_leader:
+
+box.ctl.make_bootstrap_leader()
+===============================
+
+.. function:: make_bootstrap_leader()
+
+    **Since:** :doc:`3.0.0 </release/3.0.0>`.
+
+    Make the instance a bootstrap leader of a :ref:`replica set <replication-bootstrap>`.
+    To be able to choose the instance as a bootstrap leader manually, you need to set the :ref:`replication.bootstrap_strategy <configuration_reference_replication_bootstrap_strategy>` configuration option to ``supervised``.
+
+    When ``replication.bootstrap_strategy`` is set to ``supervised``, the instances do not choose a bootstrap leader automatically but wait for it to be appointed manually.
+    Configuration fails if no bootstrap leader is appointed during a :ref:`replication.connect_timeout <configuration_reference_replication_connect_timeout>`.
+
+    ..  NOTE::
+
+        When a new instance joins the existing replica set with ``replication.bootstrap_strategy`` set to ``supervised``,
+        this replica doesn't choose the bootstrap leader automatically but joins to the instance on which
+        ``box.ctl.make_bootstrap_leader()`` was executed last time.