diff --git a/source/administration/backups.txt b/source/administration/backups.txt index c758d3a27be..f073a40ac29 100644 --- a/source/administration/backups.txt +++ b/source/administration/backups.txt @@ -369,6 +369,8 @@ the snapshot has completed, use the following command in the db.runCommand( { fsync: 1, lock: true } ); db.runCommand( { fsync: 1, lock: false } ); + .. include:: /includes/note-disable-profiling-fsynclock.rst + .. _backup-amazon-software-raid: Amazon EBS in Software RAID 10 Configuration diff --git a/source/includes/note-disable-profiling-fsynclock.rst b/source/includes/note-disable-profiling-fsynclock.rst new file mode 100644 index 00000000000..1b19ca31bb5 --- /dev/null +++ b/source/includes/note-disable-profiling-fsynclock.rst @@ -0,0 +1,9 @@ +.. note:: + + The database cannot be locked with :func:`db.fsyncLock()` while profiling is enabled. + You must disable profiling before locking the database with :func:`db.fsyncLock()`. + Disable profiling using :func:`db.setProfilingLevel()` as follows in the :program:`mongo` shell: + +.. code-block:: javascript + + db.setProfilingLevel(0) diff --git a/source/reference/commands.txt b/source/reference/commands.txt index 86645dcebcb..c0784ba5f14 100644 --- a/source/reference/commands.txt +++ b/source/reference/commands.txt @@ -1375,6 +1375,8 @@ Administration The :func:`db.fsyncLock()` and :func:`db.fsyncUnlock()` helpers in the shell. + .. include:: /includes/note-disable-profiling-fsynclock.rst + .. dbcommand:: dropDatabase The :dbcommand:`dropDatabase` command drops a database, deleting @@ -2170,6 +2172,8 @@ Diagnostics around this functionality in the :program:`mongo` shell. + .. include:: /includes/note-disable-profiling-fsynclock.rst + .. dbcommand:: listCommands The :dbcommand:`listCommands` command generates a list of all diff --git a/source/reference/javascript.txt b/source/reference/javascript.txt index 209d13cdcc7..f9eea90cb0a 100644 --- a/source/reference/javascript.txt +++ b/source/reference/javascript.txt @@ -1099,6 +1099,8 @@ Database the :setting:`slowms` to the log even when the database profiler is not active. + .. include:: /includes/note-disable-profiling-fsynclock.rst + .. function:: db.shutdownServer() Shuts down the current :program:`mongod` or :program:`mongos` @@ -1154,6 +1156,8 @@ Database This function locks the database and create a window for :doc:`backup operations `. + .. include:: /includes/note-disable-profiling-fsynclock.rst + .. function:: db.fsyncUnlock() Unlocks a database server to allow writes and reverses the