DOCS-246 added an include on changing oplog size

Author: Bob Grabar

source/administration/replica-sets.txt

@@ -21,10 +21,13 @@ suggestions for administers of replica sets.
    The following tutorials provide task-oriented instructions for
    specific administrative tasks related to replica set operation.
 
-   - :doc:`/tutorial/deploy-replica-set`
-   - :doc:`/tutorial/expand-replica-set`
+   - :doc:`/tutorial/change-hostnames-in-a-replica-set`
+   - :doc:`/tutorial/change-oplog-size`
    - :doc:`/tutorial/convert-replica-set-to-replicated-shard-cluster`
+   - :doc:`/tutorial/convert-secondary-into-arbiter`
    - :doc:`/tutorial/deploy-geographically-distributed-replica-set`
+   - :doc:`/tutorial/deploy-replica-set`
+   - :doc:`/tutorial/expand-replica-set`
 
 .. _replica-set-node-configurations:
 .. _replica-set-member-configurations:
@@ -484,6 +487,15 @@ of the member with the highest :data:`members[n].priority` setting.
    <replica-set-reconfiguration-usage>` example revolves around
    changing the priorities of the :data:`members` of a replica set.
 
+Changing Oplog Size
+~~~~~~~~~~~~~~~~~~~
+
+The following is an overview of the procedure for changing the size of the oplog:
+
+.. include:: /includes/procedure-change-oplog-size.rst
+
+For a detailed procedure, see :doc:`/tutorial/change-oplog-size`.
+
 .. _replica-set-security:
 
 Security

source/includes/procedure-change-oplog-size.rst

@@ -0,0 +1,20 @@
+1. Shut down the current :term:`primary` instance in the
+   :term:`replica set` and then restart it on a different port
+   and in "standalone" mode.
+
+#. Create a backup of the old (current) oplog. This is optional.
+
+#. Save the last entry from the old oplog.
+
+#. Drop the old oplog.
+
+#. Create a new oplog of a different size.
+
+#. Insert the previously saved last entry from the old oplog into the
+   new oplog.
+
+#. Restart the server as a member of the replica set on its usual
+   port.
+
+#. Apply this procedure to any other member of the replica set that
+   *could become* primary.

source/tutorial/change-oplog-size.txt

@@ -20,6 +20,14 @@ oplog size affects :term:`delayed members <delayed member>` and affects
 topic and the :ref:`replica-set-replication-lag` topic in
 :doc:`/administration/replica-sets`.
 
+Overview
+--------
+
+The following is an overview of the procedure for changing the size of
+the oplog:
+
+.. include:: /includes/procedure-change-oplog-size.rst
+
 Procedure
 ---------
 
@@ -32,7 +40,7 @@ The examples in this procedure use the following configuration:
 - The replica set is running with a :setting:`data directory <dbpath>`
   of ``/srv/mongodb``.
 
-1. Shutdown the current :term:`primary` instance in the replica set and
+1. Shut down the current :term:`primary` instance in the replica set and
    then restart it in "standalone" mode running on a different port.
    Note that shutting down the primary will trigger a failover situation
    and another member in the replica set will become primary.