Skip to content

Commit f582a15

Browse files
committed
Merge pull request #2068 from kangas/DOCS-4429-noprealloc
DOCS-4429 --noprealloc is deprecated
2 parents 5177304 + 8ff8286 commit f582a15

File tree

4 files changed

+6
-41
lines changed

4 files changed

+6
-41
lines changed

source/faq/storage.txt

Lines changed: 0 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -129,25 +129,6 @@ inserted into the database. Consider the following possible causes:
129129
file that may be 90% empty. For most larger databases, unused
130130
allocated space is small compared to the database.
131131

132-
On Unix-like systems, :program:`mongod` preallocates an additional data file and
133-
initializes the disk space to ``0``. Preallocating data files in
134-
the background prevents significant delays when a new database file
135-
is next allocated.
136-
137-
You can disable preallocation by setting
138-
:setting:`~storage.preallocDataFiles` to ``false``. However do not
139-
disable :setting:`~storage.preallocDataFiles` for production
140-
environments: only use :setting:`~storage.preallocDataFiles` for
141-
testing and with small data sets where you frequently drop
142-
databases.
143-
144-
On Linux systems you can use ``hdparm`` to get an idea of how costly
145-
allocation might be:
146-
147-
.. code-block:: sh
148-
149-
time hdparm --fallocate $((1024*1024)) testfile
150-
151132
- The :term:`oplog`.
152133

153134
If this :program:`mongod` is a member of a replica set, the data

source/includes/options-conf.yaml

Lines changed: 0 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -717,20 +717,6 @@ post: |
717717
The {{role}} option is available only for :program:`mongod`.
718718
---
719719
program: conf
720-
name: storage.preallocDataFiles
721-
type: boolean
722-
default: true
723-
directive: setting
724-
replacement:
725-
program: ":program:`mongod`"
726-
inherit:
727-
name: noprealloc
728-
program: mongod
729-
file: options-mongod.yaml
730-
post: |
731-
The {{role}} option is available only for :program:`mongod`.
732-
---
733-
program: conf
734720
name: storage.nsSize
735721
type: integer
736722
default: 16

source/includes/options-mongod.yaml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -591,10 +591,10 @@ name: noprealloc
591591
args: null
592592
directive: option
593593
description: |
594-
Disables the preallocation of data files. This shortens the
595-
start up time in some cases and can cause significant performance
596-
penalties during normal operations.
597-
optional: true
594+
.. deprecated:: 2.6
595+
596+
Disables the preallocation of data files. Currently the default.
597+
Exists for future compatibility and clarity.
598598
---
599599
program: mongod
600600
name: noscripting

source/tutorial/add-replica-set-arbiter.txt

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -38,12 +38,10 @@ arbiter's :doc:`configuration file </reference/configuration-options>`:
3838

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

41-
- :setting:`~storage.preallocDataFiles` to ``false``
42-
4341
These settings are specific to arbiters. Do not set
4442
:setting:`journal.enabled <storage.journal.enabled>` to ``false`` on a
45-
data-bearing node. Similarly, do not set :setting:`~storage.smallFiles` or
46-
:setting:`~storage.preallocDataFiles` unless specifically indicated.
43+
data-bearing node. Similarly, do not set :setting:`~storage.smallFiles`
44+
unless specifically indicated.
4745

4846
Add an Arbiter
4947
--------------

0 commit comments

Comments
 (0)