DOCS-408 proc to convert secondary to arbiter

Author: Bob Grabar

draft/tutorial/convert-secondary-into-arbiter.txt

@@ -4,6 +4,11 @@ Convert a Secondary to an Arbiter
 
 .. default-domain:: mongodb
 
+You can convert a secondary member to an arbiter either by shutting down
+the secondary and restarting it as an arbiter, or by starting the
+arbiter on a new port and then shutting down the instance of the
+secondary. This document describes both procedures.
+
 Synopsis
 --------
 
@@ -41,11 +46,10 @@ Convert a Secondary to an Arbiter and Reuse the Port Number
 
    .. code-block:: javascript
 
-      rs.remove("*hostname:port number*")
+      rs.remove("<hostname>:<port>")
 
-#. Ensure that the secondary has been removed from the replica set by
-   calling the :method:`rs.config()` method while connected to the current
-   primary in the :program:`mongo` shell:
+#. Verify that the replica set no longer includes the secondary by
+   calling the :method:`rs.config()` method in the :program:`mongo` shell:
 
    .. code-block:: javascript
 
@@ -59,7 +63,7 @@ Convert a Secondary to an Arbiter and Reuse the Port Number
 
       mv /data/db /data/db-old
 
-   Optionally, you can remove the data entirely.
+   .. optional:: You may remove the data instead.
 
 #. Modify your application so that MongoDB queries don't reach
    the secondary.
@@ -81,23 +85,21 @@ Convert a Secondary to an Arbiter and Reuse the Port Number
 
       mongod --port 27021 --dbpath /data/db --replSet rs
 
-#. In the :program:`mongo` shell connected to the current primary,
-   convert the secondary to an arbiter using the :method:`rs.addArb()`
-   method:
+#. In the :program:`mongo` shell convert the secondary to an arbiter
+   using the :method:`rs.addArb()` method:
 
    .. code-block:: javascript
 
-      rs.addArb("*hostname:port number*")
+      rs.addArb("<hostname>:<port>")
 
-#. Verify the arbiter is added to the replica set by calling the
-   :method:`rs.config()` method in the :program:`mongo` shell (connected
-   to the current primary).
+#. Verify the arbiter belongs to the replica set by calling the
+   :method:`rs.config()` method in the :program:`mongo` shell.
 
    .. code-block:: javascript
 
       rs.config()
 
-   The arbiter member should include the following field and value:
+   The arbiter member should include the following:
 
    .. code-block:: javascript
 
@@ -128,17 +130,16 @@ Convert a Secondary to an Arbiter Running on a New Port Number
 
    .. code-block:: javascript
 
-      rs.addArb("*hostname:port number*")
+      rs.addArb("<hostname>:<port>")
 
-#. Verify the arbiter is added to the replica set by calling the
-   :method:`rs.config()` method in the :program:`mongo` shell (connected
-   to the current primary).
+#. Verify the arbiter belongs to the replica set by calling the
+   :method:`rs.config()` method in the :program:`mongo` shell.
 
    .. code-block:: javascript
 
       rs.config()
 
-   The arbiter member should include the following field and value:
+   The arbiter member should include the following:
 
    .. code-block:: javascript
 
@@ -150,16 +151,14 @@ Convert a Secondary to an Arbiter Running on a New Port Number
    secondary, remove the reference.
 
 #. Remove the :term:`secondary` from the :term:`replica set` by calling
-   the :method:`rs.remove()` method while connected to the current
-   :term:`primary` in the :program:`mongo` shell:
+   the :method:`rs.remove()` method in the :program:`mongo` shell:
 
    .. code-block:: javascript
 
-      rs.remove("*hostname:port number*")
+      rs.remove("<hostname>:<port>")
 
-#. Ensure that the secondary has been removed from the replica set by
-   calling the :method:`rs.config()` method while connected to the current
-   primary in the :program:`mongo` shell:
+#. Verify that the replica set no longer includes the secondary by
+   calling the :method:`rs.config()` method in the :program:`mongo` shell:
 
    .. code-block:: javascript
 
@@ -171,4 +170,4 @@ Convert a Secondary to an Arbiter Running on a New Port Number
 
       mv /data/db /data/db-old
 
-   Optionally, you can remove the data entirely.
+   .. optional:: You may remove the data instead.