Skip to content

minor 2.4 patch edits #738

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 1 commit into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 5 additions & 33 deletions source/faq/concurrency.txt
Original file line number Diff line number Diff line change
Expand Up @@ -145,11 +145,6 @@ The following administrative operations require an exclusive
- :method:`db.copyDatabase()`. This operation may lock all
databases. See :ref:`faq-concurrency-lock-multiple-dbs`.

The :method:`db.collection.group()` operation takes a read lock and does
not allow any other threads to execute JavaScript while it is running.

.. todo The above sentence might no longer apply in version 2.4, which will use V8.

The following administrative commands lock the database but only hold
the lock for a very short time:

Expand Down Expand Up @@ -233,31 +228,8 @@ secondaries, in a two phases:
What kind of concurrency does MongoDB provide for JavaScript operations?
------------------------------------------------------------------------

A single :program:`mongod` can only run a *single* JavaScript
operation at once. Therefore, operations that rely on JavaScript cannot
run concurrently; however, the :program:`mongod` can often run other
database operations concurrently with the JavaScript execution. This
limitation with JavaScript affects the following operations:

- :dbcommand:`mapReduce`

The JavaScript operations within a :dbcommand:`mapReduce` job are
short lived and yield many times during the operation. Portions of
the map-reduce operation take database locks for reading, writing
data to a temporary collection and writing the final output of the
write operation.

- :dbcommand:`group`

The :dbcommand:`group` takes a read lock in addition to blocking all
other JavaScript execution.

- :method:`db.eval()`

Unless you specify the ``nolock`` option, :method:`db.eval()` takes
a write lock in addition to blocking all JavaScript operations.

- :operator:`$where`

Only a single query that uses the :operator:`$where` operation can
run at a time.
.. versionchanged:: 2.4
The V8 JavaScript engine added in 2.4 allows multiple JavaScript
operations to run at the same time. Prior to 2.4, a single
:program:`mongod` could only run a *single* JavaScript operation at
once.
3 changes: 2 additions & 1 deletion source/includes/fact-eval-authentication.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,5 @@ With :setting:`authentication <auth>` enabled, |object| will fail
during the operation if you do not have the permission to perform a
specified task.

.. .. versionchanged:: 2.4 You must have full admin access to run.
.. versionchanged:: 2.4
You must have full admin access to run.
8 changes: 1 addition & 7 deletions source/reference/limits.txt
Original file line number Diff line number Diff line change
Expand Up @@ -101,18 +101,12 @@ Capped Collections
~~~~~~~~~~~~~~~~~~

.. limit:: Maximum Number of Documents in a Capped Collection

Capped collections can hold no more than 2\ :sup:`32` documents.

.. COMMENT

.. FOR 2.4, change this section to match the following...

.. versionchanged:: 2.4

If you specify a maximum number of documents for a capped
collection using the ``max`` parameter to
:dbcommand:`createCollection`, the limit must be less than 2\ :sup:`32`
:dbcommand:`create`, the limit must be less than 2\ :sup:`32`
documents. If you do not specify a maximum number of documents when
creating a capped collection, there is no limit on the number of
documents.
Expand Down
4 changes: 0 additions & 4 deletions source/reference/method/db.collection.insert.txt
Original file line number Diff line number Diff line change
Expand Up @@ -14,10 +14,6 @@ db.collection.insert()
an array of documents to perform a bulk insert of the
documents into the collection.

.. include:: /includes/note-bulk-inserts-on-sharded-clusters.rst

.. todo:: for 2.4, remove: /includes/note-bulk-inserts-on-sharded-clusters.rst

Consider the following behaviors of the :method:`insert()
<db.collection.insert()>` method:

Expand Down
16 changes: 8 additions & 8 deletions source/reference/mongoperf.txt
Original file line number Diff line number Diff line change
Expand Up @@ -150,16 +150,16 @@ Configuration Fields

Either :setting:`~mongoperf.r` or :setting:`~mongoperf.w` must be ``true``.

.. version-added-2.4
.. setting:: mongoperf.recSizeKB

.. setting:: mongoperf.recSizeKB: {integer}`
.. versionadded:: 2.4

*Type:* Integer.

*Default:* 4 kb

The size of each write operation.

*Type:* Integer.

*Default:* 4 kb

The size of each write operation.

.. setting:: mongoperf.syncDelay

*Type:* Integer.
Expand Down
4 changes: 0 additions & 4 deletions source/tutorial/manage-chunks-in-sharded-cluster.txt
Original file line number Diff line number Diff line change
Expand Up @@ -380,7 +380,3 @@ cluster`. For bulk insert operations, consider the following strategies:
and see :ref:`Shard Key Internals <sharding-internals-shard-keys>` (in
particular, :ref:`sharding-internals-operations-and-reliability` and
:ref:`sharding-internals-choose-shard-key`).

.. todo:: remove the below include for 2.4

.. include:: /includes/note-bulk-inserts-on-sharded-clusters.rst