Skip to content

DOCS-4429 --noprealloc is deprecated #2068

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
Nov 26, 2014
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
19 changes: 0 additions & 19 deletions source/faq/storage.txt
Original file line number Diff line number Diff line change
Expand Up @@ -129,25 +129,6 @@ inserted into the database. Consider the following possible causes:
file that may be 90% empty. For most larger databases, unused
allocated space is small compared to the database.

On Unix-like systems, :program:`mongod` preallocates an additional data file and
initializes the disk space to ``0``. Preallocating data files in
the background prevents significant delays when a new database file
is next allocated.

You can disable preallocation by setting
:setting:`~storage.preallocDataFiles` to ``false``. However do not
disable :setting:`~storage.preallocDataFiles` for production
environments: only use :setting:`~storage.preallocDataFiles` for
testing and with small data sets where you frequently drop
databases.

On Linux systems you can use ``hdparm`` to get an idea of how costly
allocation might be:

.. code-block:: sh

time hdparm --fallocate $((1024*1024)) testfile

- The :term:`oplog`.

If this :program:`mongod` is a member of a replica set, the data
Expand Down
14 changes: 0 additions & 14 deletions source/includes/options-conf.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -717,20 +717,6 @@ post: |
The {{role}} option is available only for :program:`mongod`.
---
program: conf
name: storage.preallocDataFiles
type: boolean
default: true
directive: setting
replacement:
program: ":program:`mongod`"
inherit:
name: noprealloc
program: mongod
file: options-mongod.yaml
post: |
The {{role}} option is available only for :program:`mongod`.
---
program: conf
name: storage.nsSize
type: integer
default: 16
Expand Down
8 changes: 4 additions & 4 deletions source/includes/options-mongod.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -591,10 +591,10 @@ name: noprealloc
args: null
directive: option
description: |
Disables the preallocation of data files. This shortens the
start up time in some cases and can cause significant performance
penalties during normal operations.
optional: true
.. deprecated:: 2.6

Disables the preallocation of data files. Currently the default.
Exists for future compatibility and clarity.
---
program: mongod
name: noscripting
Expand Down
6 changes: 2 additions & 4 deletions source/tutorial/add-replica-set-arbiter.txt
Original file line number Diff line number Diff line change
Expand Up @@ -38,12 +38,10 @@ arbiter's :doc:`configuration file </reference/configuration-options>`:

- :setting:`~storage.smallFiles` to ``true``

- :setting:`~storage.preallocDataFiles` to ``false``

These settings are specific to arbiters. Do not set
:setting:`journal.enabled <storage.journal.enabled>` to ``false`` on a
data-bearing node. Similarly, do not set :setting:`~storage.smallFiles` or
:setting:`~storage.preallocDataFiles` unless specifically indicated.
data-bearing node. Similarly, do not set :setting:`~storage.smallFiles`
unless specifically indicated.

Add an Arbiter
--------------
Expand Down