diff --git a/config/sphinx.yaml b/config/sphinx.yaml index 05aad1f898b..2047786a3dc 100644 --- a/config/sphinx.yaml +++ b/config/sphinx.yaml @@ -25,7 +25,6 @@ web-base: inherit: root-base excluded: - /meta/reference.txt - - /meta/use-cases.txt - /meta/administration.txt - /meta/manual.txt tags: diff --git a/source/administration/security-user-role-management.txt b/source/administration/security-user-role-management.txt index 89c49e3adbe..92ac4f33be2 100644 --- a/source/administration/security-user-role-management.txt +++ b/source/administration/security-user-role-management.txt @@ -1,3 +1,5 @@ +.. _user-management-guide: + ================================== User and Role Management Tutorials ================================== diff --git a/source/applications/design-notes.txt b/source/applications/design-notes.txt index 2e509e5067f..2d5a43375fb 100644 --- a/source/applications/design-notes.txt +++ b/source/applications/design-notes.txt @@ -97,7 +97,7 @@ No Fully Generalized Transactions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ MongoDB does not have :doc:`fully generalized transactions -`. If you model your data +`. If you model your data using rich documents that closely resemble your application's objects, each logical object will be in one MongoDB document. MongoDB allows you to modify a document in a single atomic operation. These diff --git a/source/core/authentication.txt b/source/core/authentication.txt index f6ae617fda6..f213a1aed0d 100644 --- a/source/core/authentication.txt +++ b/source/core/authentication.txt @@ -179,6 +179,7 @@ appropriate privileges on the databases required by the user. See :doc:`/tutorial/authenticate-as-client` for more information. .. _inter-process-auth: +.. _replica-set-security: Authentication Between MongoDB Instances ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/source/faq/developers.txt b/source/faq/developers.txt index d599d0b060d..abbbdb74435 100644 --- a/source/faq/developers.txt +++ b/source/faq/developers.txt @@ -103,7 +103,7 @@ MongoDB *does* have support for atomic operations *within* a single document. Given the possibilities provided by nested documents, this feature provides support for a large number of use-cases. -.. seealso:: The :doc:`/tutorial/isolate-sequence-of-operations` page. +.. seealso:: The :doc:`/core/write-operations-atomicity` page. How do you aggregate data with MongoDB? --------------------------------------- diff --git a/source/includes/fact-findAndModify-update-comparison.rst b/source/includes/fact-findAndModify-update-comparison.rst index 7c0f8a6d3ec..153ff4d949a 100644 --- a/source/includes/fact-findAndModify-update-comparison.rst +++ b/source/includes/fact-findAndModify-update-comparison.rst @@ -31,5 +31,5 @@ When updating a document, |operation| and the When modifying a *single* document, both |operation| and the :method:`~db.collection.update()` method *atomically* update the -document. See :doc:`/tutorial/isolate-sequence-of-operations` for more +document. See :doc:`/core/write-operations-atomicity` for more details about interactions and order of operations of these methods. diff --git a/source/includes/options-conf.yaml b/source/includes/options-conf.yaml index 2eba0dac750..780a6cf7ab7 100644 --- a/source/includes/options-conf.yaml +++ b/source/includes/options-conf.yaml @@ -1035,4 +1035,18 @@ inherit: name: chunkSize program: mongos file: options-mongos.yaml +--- +program: conf +name: storage.preallocDataFiles +type: boolean +default: true +directive: setting +replacement: + program: ":program:`mongod`" +description: | + Enables or disables data file preallocation. +post: | + Do **not** disable data file preallocation in production systems. Only + use this option for testing and with small data sets where you + frequently drop databases. ... diff --git a/source/includes/steps-backup-sharded-clusters-dumps.yaml b/source/includes/steps-backup-sharded-clusters-dumps.yaml index 083fa7743de..b0f972a43f9 100644 --- a/source/includes/steps-backup-sharded-clusters-dumps.yaml +++ b/source/includes/steps-backup-sharded-clusters-dumps.yaml @@ -15,11 +15,8 @@ post: | For more information, see the :ref:`sharding-balancing-disable-temporarily` procedure. - .. warning:: + .. warning:: If you do not stop the balancer, the backup could have duplicate data or omit data as :term:`chunks ` migrate while recording backups. - If you do not stop the balancer, the backup could have duplicate - data or omit data as :term:`chunks ` migrate while recording - backups. --- title: Lock replica set members. stepnum: 2 diff --git a/source/reference/command/connectionStatus.txt b/source/reference/command/connectionStatus.txt index 4712aaff8ef..4b0fd58f837 100644 --- a/source/reference/command/connectionStatus.txt +++ b/source/reference/command/connectionStatus.txt @@ -41,7 +41,7 @@ Output .. data:: connectionStatus.authinfo.authenticatedUserRoles[n].role The definition of the current roles associated with the current - authenticated users. See :doc:`/reference/build-in-roles` and + authenticated users. See :doc:`/reference/built-in-roles` and :doc:`/reference/privilege-actions` for more information. .. data:: connectionStatus.authinfo.authenticatedUserRoles[n].db diff --git a/source/reference/database-references.txt b/source/reference/database-references.txt index e7785134f5d..3a6b090e6c3 100644 --- a/source/reference/database-references.txt +++ b/source/reference/database-references.txt @@ -17,13 +17,13 @@ typically in different collections or databases. MongoDB applications use one of two methods for relating documents: -#. :ref:`Manual references ` where you save the +- :ref:`Manual references ` where you save the ``_id`` field of one document in another document as a reference. Then your application can run a second query to return the related data. These references are simple and sufficient for most use cases. -#. :ref:`DBRefs ` are references from one document to another +- :ref:`DBRefs ` are references from one document to another using the value of the first document's ``_id`` field, collection name, and, optionally, its database name. By including these names, DBRefs allow documents located in multiple collections to be more easily linked @@ -99,9 +99,9 @@ references as needed. The only limitation of manual linking is that these references do not convey the database and collection names. If you have documents in a single collection that relate to documents in more than one -collection, you may need to consider using :ref:`DBRefs `. +collection, you may need to consider using DBRefs. -.. _dbref: +.. _dbref-explanation: DBRefs ------ diff --git a/source/reference/glossary.txt b/source/reference/glossary.txt index c63f4757df2..b34b4ce0ab1 100644 --- a/source/reference/glossary.txt +++ b/source/reference/glossary.txt @@ -889,7 +889,7 @@ Glossary :doc:`/tutorial/create-tailable-cursor`. topology - The state of a :term:`deployment` of MongoDB instances, including + The state of a deployment of MongoDB instances, including the type of deployment (i.e. standalone, replica set, or sharded cluster) as well as the availability of servers, and the role of each server (i.e. :term:`primary`, :term:`secondary`, diff --git a/source/reference/program/mongorestore.txt b/source/reference/program/mongorestore.txt index a16ae35d442..40064d60a30 100644 --- a/source/reference/program/mongorestore.txt +++ b/source/reference/program/mongorestore.txt @@ -127,9 +127,6 @@ Options .. include:: /includes/option/option-mongorestore-restoreDbUsersAndRoles.rst -.. this does not exist: -.. .. include:: /includes/option/option-mongorestore-restoreDbUserasAndRoles.rst - .. include:: /includes/option/option-mongorestore-w.rst .. _mongorestore-path-option: diff --git a/source/release-notes/2.8.txt b/source/release-notes/2.8.txt index 38d050051cf..1b0980e5b72 100644 --- a/source/release-notes/2.8.txt +++ b/source/release-notes/2.8.txt @@ -121,7 +121,7 @@ MongoDB 2.8 adds a new ``SCRAM-SHA-1`` authentication mechanism. Changes to the Localhost Exception ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -When using :ref:`localhost exception` to access MongoDB, you have limited +When using :ref:`localhost-exception` to access MongoDB, you have limited access and can only create a user in the ``admin`` database. Query Engine Improvements diff --git a/source/tutorial.txt b/source/tutorial.txt index 2547d7bba9d..010e3c54763 100644 --- a/source/tutorial.txt +++ b/source/tutorial.txt @@ -119,7 +119,6 @@ Development Patterns -------------------- - :doc:`/tutorial/perform-two-phase-commits` -- :doc:`/tutorial/isolate-sequence-of-operations` - :doc:`/tutorial/create-an-auto-incrementing-field` - :doc:`/tutorial/enforce-unique-keys-for-sharded-collections` - :doc:`/applications/aggregation` diff --git a/source/tutorial/define-roles.txt b/source/tutorial/define-roles.txt index bbfb3361482..a6c6bcc7e1e 100644 --- a/source/tutorial/define-roles.txt +++ b/source/tutorial/define-roles.txt @@ -1,3 +1,5 @@ +.. _define-roles: + ============= Create a Role ============= diff --git a/source/tutorial/manage-mongodb-processes.txt b/source/tutorial/manage-mongodb-processes.txt index 217bf1b6810..32abb534424 100644 --- a/source/tutorial/manage-mongodb-processes.txt +++ b/source/tutorial/manage-mongodb-processes.txt @@ -45,8 +45,8 @@ than* ``/data/db`` you can specify a :setting:`~storage.dbPath`. The :setting:`~storage.dbPath` must exist before you start :program:`mongod`. If it does not exist, create the directory and the permissions so that :program:`mongod` can read and write data to this path. For more -information on permissions, see the :ref:`security operations -documentation `. +information on permissions, see the :doc:`security operations +documentation `. To specify a :setting:`~storage.dbPath` for :program:`mongod` to use as a data directory, use the :option:`--dbpath ` option. The diff --git a/source/tutorial/update-if-current.txt b/source/tutorial/update-if-current.txt index ff3116ae46f..e8efe9898f6 100644 --- a/source/tutorial/update-if-current.txt +++ b/source/tutorial/update-if-current.txt @@ -7,7 +7,7 @@ Update Document if Current Overview -------- -The :ref:`Update if Current ` +The *Update if Current* pattern is an approach to :ref:`concurrency control ` when multiple applications have access to the data.