Skip to content

DOCS-413 - fixed log command error; revised parts for clarity #129

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.

Sign up for GitHub

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
Aug 17, 2012
Merged

DOCS-413 - fixed log command error; revised parts for clarity #129

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
64 changes: 30 additions & 34 deletions source/tutorial/install-mongodb-on-windows.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,16 +7,13 @@ Install MongoDB on Windows
Synopsis
--------

This tutorial outlines the basic installation process for
:term:`MongoDB` on Microsoft Windows systems. This tutorial provides a
basic method for installing and running the MongoDB server
(i.e. ":program:`mongod.exe`") on Windows systems through the
:guilabel:`Command Shell` and will also outline the process for
setting up MongoDB as a :guilabel:`Windows Service`.
This tutorial provides a method to installing and running the
MongoDB server (i.e. ":program:`mongod.exe`") on the Microsoft Windows
platform through the :guilabel:`Command Shell` and outline the process
for setting up MongoDB as a :guilabel:`Windows Service`.

MongoDB for Windows is similar to MongoDB for other systems and
most components have similar operations with similar operational
patterns.
MongoDB for Windows is similar to MongoDB for other platforms and
most components share the same operations and patterns.

Procedure
---------
Expand All @@ -29,10 +26,10 @@ downloads page <http://www.mongodb.org/downloads>`_.

There are three builds of MongoDB for Windows:

- The MongoDB for Windows Server 2008 R2 edition will only run on
Windows Server 2008 R2, Windows 7 64-bit, or newer versions of
Windows. This build contains additional enhancements that are only
available on these platforms.
- MongoDB for Windows Server 2008 R2 edition will only run on Windows
Server 2008 R2, Windows 7 64-bit, or newer versions of Windows. This
build contains additional enhancements that are only available on
these platforms.

- MongoDB for Windows 64-bit runs on any 64-bit version of Windows
newer than Windows XP, including Windows Server 2008 R2 and Windows
Expand All @@ -45,25 +42,24 @@ There are three builds of MongoDB for Windows:
.. note::

Ensure you download the proper version of MongoDB for your
architecture of Windows. The 64-bit version of MongoDB will not
architecture of Windows. The 64-bit versions of MongoDB will not
work in 32-bit Windows.

The 32-bit versions of MongoDB are suitable for testing and
evaluation purposes but can only support small databases and are
not appropriate for production deployments.
32-bit versions of MongoDB are suitable only for testing and evaluation
purposes and only support databases smaller than 2GB.

You can find the architecture of your version of Windows
installation using the following command in the :guilabel:`Command
platform using the following command in the :guilabel:`Command
Shell`

.. code-block:: powershell

wmic os get osarchitecture

In Windows Explorer, find the MongoDB download file, typically in the
default Downloads directory, and extract the archive to ``C:\`` by
right clicking on the archive and selecting :guilabel:`Extract All`
and browsing to ``C:\``.
Once MongoDB has downloaded, extract the archive. In Windows Explorer,
find the MongoDB download file, typically in the default Downloads
directory, and extract the archive to ``C:\`` by right clicking on the
archive and selecting :guilabel:`Extract All` and browsing to ``C:\``.

.. note::

Expand Down Expand Up @@ -98,13 +94,13 @@ Shell`, issue the following commands:

.. note::

MongoDB is self-contained and does not have any other system
MongoDB is self-contained and do not have any other system
dependencies. You can run MongoDB from any folder you choose. You
may install MongoDB in any directory (e.g. ``D:\test\mongodb``)

MongoDB requires a :term:`data folder <dbpath>` to store its files. The default
location for the MongoDB data directory is ``C:\data\db``. Create this
folder using the :guilabel:`Command Shell` and issuing the following
folder using the :guilabel:`Command Shell` and the following
command sequence:

.. code-block:: powershell
Expand Down Expand Up @@ -154,13 +150,13 @@ This will start the main MongoDB database process.

.. warning::

Do not make :program:`mongod.exe` accessible to public networks
without running in "Secure Mode" (i.e. :setting:`auth`) on a public
network. Usually, MongoDB runs in "trusted environments" and the
Do not allow :program:`mongod.exe` to be accessible to public
networks without running in "Secure Mode" (i.e. :setting:`auth`.)
MongoDB is designed to be run in "trusted environments" and the
database does not enable authentication or "Secure Mode" by
default.

To connect to MongoDB using the :program:`mongo.exe`, open another
Connect to MongoDB using the :program:`mongo.exe`, open another
:guilabel:`Command Shell` and issue command:

.. code-block:: powershell
Expand All @@ -170,10 +166,10 @@ To connect to MongoDB using the :program:`mongo.exe`, open another
.. note::

Executing the command ``start C:\mongodb\bin\mongo.exe`` will
automatically start the :program:`mongo` shell in a separate
automatically start the :program:`mongo.exe` shell in a separate
:guilabel:`Command Shell` window.

This :program:`mongo` shell will connect to the database running on
The :program:`mongo.exe` shell will connect to :program:`mongod.exe` running on
the localhost interface and port ``27017`` by default. At the
:program:`mongo.exe` prompt, issue the following two commands to
insert a record in the ``test`` :term:`collection` of the default
Expand Down Expand Up @@ -223,14 +219,14 @@ Service: a path for the log output (i.e. :setting:`logpath`) and a

.. code-block:: powershell

echo logpath=C:\mongodb\log > C:\mongodb\mongod.cfg
echo logpath=C:\mongodb\log\mongo.log > C:\mongodb\mongod.cfg

While these optional steps are optional, using the configuration file,
and creating a specific location for log files are good practice.
While these optional steps are optional, creating a specific location
for log files and using the configuration file are good practice.

.. note::

Also consider setting the :setting:`logappend` option, otherwise,
Consider setting the :setting:`logappend` option, otherwise,
:program:`mongod.exe` will delete the contents of the existing log
file when starting.

Expand Down