- Replication >
- Replica Set Maintenance Tutorials >
- Change the Size of the Oplog
Change the Size of the Oplog¶
On this page
Warning
In MongoDB versions 3.4 and earlier, the oplog was resized by
dropping and recreating the local.oplog.rs collection.
In MongoDB versions 3.6 and later, use the
replSetResizeOplog command to resize the oplog as shown
in this tutorial.
Starting in MongoDB 4.0, MongoDB forbids dropping the
local.oplog.rs collection. For more information on this
restriction, see Oplog Collection Behavior.
This procedure changes the size of the oplog [1] on each member of a
replica set using the replSetResizeOplog command, starting
with the secondary members before proceeding to the
primary.
Perform these steps on each secondary replica set member first. Once you have changed the oplog size for all secondary members, perform these steps on the primary.
A. Connect to the replica set member¶
Connect to the replica set member using the mongo shell:
Note
If the replica set enforces authentication,
you must authenticate as a user with privileges to modify the
local database, such as the clusterManager or
clusterAdmin role.
B. (Optional) Verify the current size of the oplog¶
To view the current size of the oplog, switch to the local
database and run db.collection.stats() against the
oplog.rs collection. stats() displays the
oplog size as maxSize.
The maxSize field displays the collection size in bytes.
C. Change the oplog size of the replica set member¶
To resize the oplog, run the replSetResizeOplog command,
passing the desired size in megabytes as the size parameter. The
specified size must be greater than 990, or 990 megabytes.
The following operation changes the oplog size of the replica set member to 16 gigabytes, or 16000 megabytes.
| [1] | Starting in MongoDB 4.0, the oplog can grow past its configured size
limit to avoid deleting the majority commit point. |
D. (Optional) Compact oplog.rs to reclaim disk space¶
Reducing the size of the oplog does not automatically reclaim
the disk space allocated to the original oplog size. You must run
compact against the oplog.rs collection in the
local database to reclaim disk space. There are no benefits to
running compact on the oplog.rs collection after increasing the
oplog size.
Important
Starting in MongoDB v4.4, a replica set member can replicate oplog
entries while the compact operation is ongoing. Previously, oplog
replication would be paused during compaction. Because of this, it was
recommended that oplog compaction only be performed during maintenance
windows, where writes could be minimized or stopped. In MongoDB 4.4 and
later, it is no longer necessary to limit compaction operations on the
oplog to maintenance windows, as oplog replication can continue as normal
during compaction.
Do not run compact against the primary replica set member.
Connect a mongo shell directly to the primary
(not the replica set) and run rs.stepDown(). If successful,
the primary steps down. From the mongo shell, run
the compact command on the now-secondary member.
The following operation runs the compact command against the
oplog.rs collection:
For clusters enforcing authentication,
authenticate as a user with the compact privilege
action on the local database and the oplog.rs collection.
For complete documentation on compact authentication
requirements, see compact Required Privileges.