Skip to content

Commit b8765db

Browse files
author
Sam Kleinman
committed
DOCS-155 edits in response to technical review and comments.
See the comments: #44
1 parent d9d7e70 commit b8765db

File tree

1 file changed

+32
-10
lines changed

1 file changed

+32
-10
lines changed

source/tutorial/install-mongodb-on-windows.txt

Lines changed: 32 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -34,10 +34,12 @@ downloads page <http://www.mongodb.org/downloads>`_.
3434
work in 32-bit Windows.
3535

3636
The 32-bit versions of MongoDB are suitable for testing and
37-
evaluation purposes but cannot use databases larger than 2GB.
37+
evaluation purposes but can only support small databases and are
38+
not appropriate for production deployments.
3839

3940
You can find the architecture of your version of Windows
40-
installation using the following command in the :guilabel:`Command Shell`
41+
installation using the following command in the :guilabel:`Command
42+
Shell`
4143

4244
.. code-block:: powershell
4345

@@ -92,8 +94,8 @@ command sequence:
9294

9395
.. code-block:: powershell
9496

95-
mkdir data
96-
mkdir data\db
97+
md data
98+
md data\db
9799

98100
.. note::
99101

@@ -105,6 +107,14 @@ command sequence:
105107

106108
C:\mongodb\bin\mongod.exe --dbpath d:\test\mongodb\data
107109

110+
If your path includes spaces, enclose the entire path in double
111+
quotations, for example:
112+
113+
.. code-block:: powershell
114+
115+
C:\mongodb\bin\mongod.exe --dbpath "d:\test\mongo db data"
116+
117+
108118
Start MongoDB
109119
~~~~~~~~~~~~~
110120

@@ -169,18 +179,18 @@ MongoDB as a Windows Service
169179
Setup MongoDB as a :guilabel:`Windows Service`, so that the database
170180
will start automatically following each reboot cycle.
171181

172-
Configure the MongoDB Service
173-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
182+
Configure the System
183+
~~~~~~~~~~~~~~~~~~~~
174184

175-
You must specify two options when running MongoDB as a Windows
176-
Service: a directory for the log output and a :doc:`configuration file
177-
</reference/configuration-options>`.
185+
You should specify two options when running MongoDB as a Windows
186+
Service: a path for the log output (i.e. :setting:`logpath`) and a
187+
:doc:`configuration file </reference/configuration-options>`.
178188

179189
#. Create a specific directory for MongoDB log files:
180190

181191
.. code-block:: powershell
182192

183-
mkdir C:\mongodb\log
193+
md C:\mongodb\log
184194

185195
#. Create a configuration file for the :setting:`logpath` option for
186196
MongoDB in the :guilabel:`Command Shell` by issuing this command:
@@ -189,6 +199,18 @@ Service: a directory for the log output and a :doc:`configuration file
189199

190200
echo logpath=C:\mongodb\log > C:\mongodb\mongodb.cfg
191201

202+
While these optional steps are optional, using the configuration file,
203+
and creating a specific location for log files are good practice.
204+
205+
.. note::
206+
207+
Also consider setting the :setting:`logappend` option, otherwise,
208+
:program:`mongod.exe` will delete the contents of the existing log
209+
file when starting.
210+
211+
.. versionchanged:: 2.2
212+
This behavior will change in the 2.2 release.
213+
192214
Install and Run the MongoDB Service
193215
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
194216

0 commit comments

Comments
 (0)