Skip to content

DOCS-1130 remove limitation on killop #683

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

Merged
merged 1 commit into from
Feb 26, 2013
Merged
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
4 changes: 2 additions & 2 deletions source/administration/indexes.txt
Original file line number Diff line number Diff line change
Expand Up @@ -458,6 +458,6 @@ of the ``query`` field and the ``msg`` field will indicate if the
operation is an index build. The ``msg`` field also indicates the
percent of the build that is complete.

You can only terminate a background index build. If you need to
terminate an ongoing index build, You can use the
To
terminate an ongoing index build, use the
:method:`db.killOp()` method in the :program:`mongo` shell.
9 changes: 5 additions & 4 deletions source/faq/indexes.txt
Original file line number Diff line number Diff line change
Expand Up @@ -104,11 +104,12 @@ background. See :ref:`index-creation-operations`.

If you build a large index without the background option, and if doing
so causes the database to stop responding,
wait for the index to finish building.
do one of the following:

.. FUTURE When SERVER-3067 is fixed, this option also will be available:
Kill the current operation (see :method:`db.killOp()`). The partial
index will be deleted.
- Wait for the index to finish building.

- Kill the current operation (see :method:`db.killOp()`). The partial
index will be deleted.

.. _faq-index-min-max:

Expand Down
4 changes: 0 additions & 4 deletions source/includes/note-foreground-index-kill-limitation.rst

This file was deleted.

5 changes: 0 additions & 5 deletions source/reference/current-op.txt
Original file line number Diff line number Diff line change
Expand Up @@ -80,9 +80,6 @@ Operations
You can use the :method:`db.killOp()` in conjunction with the
:data:`~currentOp.opid` field to terminate a currently running
operation.

.. include:: /includes/note-foreground-index-kill-limitation.rst

The following JavaScript operations for the
:program:`mongo` shell filter the output of
specific types of operations:
Expand All @@ -101,8 +98,6 @@ depending on the kind of operation and its state.
:method:`db.killOp()` in the :program:`mongo` shell to terminate the
operation.

.. include:: /includes/note-foreground-index-kill-limitation.rst

.. data:: currentOp.active

A boolean value, that is ``true`` if the operation has started
Expand Down
6 changes: 0 additions & 6 deletions source/reference/limits.txt
Original file line number Diff line number Diff line change
Expand Up @@ -177,12 +177,6 @@ Operations

.. see:: :operator:`$or` and :doc:`/core/geospatial-indexes`.

.. _cannot-kill-foreground:
.. limit:: Cannot Kill Foreground Index Build

You cannot use :method:`db.killOp()` to kill a foreground index
build.

Naming Restrictions
~~~~~~~~~~~~~~~~~~~

Expand Down
4 changes: 0 additions & 4 deletions source/reference/method/db.collection.ensureIndex.txt
Original file line number Diff line number Diff line change
Expand Up @@ -154,10 +154,6 @@ db.collection.ensureIndex()
- Non-background indexing operations will block all other
operations on a database.

- You cannot stop a foreground index build once it's begun. See the
:ref:`indexes-admin-stop-in-progress-build` for more
information.

.. [#] The default index version depends on the version of
:program:`mongod` running when creating the index. Before version
2.0, the this value was 0; versions 2.0 and later use version 1.
2 changes: 0 additions & 2 deletions source/reference/method/db.killOp.txt
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,4 @@ db.killOp()
:doc:`/reference/current-op` for full documentation of the output
of :method:`db.currentOp()`.

.. include:: /includes/note-foreground-index-kill-limitation.rst

.. include:: /includes/warning-terminating-operations.rst
7 changes: 7 additions & 0 deletions source/release-notes/2.4.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1320,3 +1320,10 @@ key. Consider the following properties when using a hashed shard key:
Avoid using hashed shard keys when the hashed field has non-integral floating
point values, see :ref:`hashed indexes <hashed-index-warning>` for
more information.

``db.killOp()`` Can Now Kill Foreground Index Builds
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The :method:`db.killOp()` method will now terminate a foreground index
build, in addition to the other operations supported in previous
versions.