diff --git a/source/tutorial/install-mongodb-on-windows.txt b/source/tutorial/install-mongodb-on-windows.txt index 72e75d9d80d..bdf5ce3931d 100644 --- a/source/tutorial/install-mongodb-on-windows.txt +++ b/source/tutorial/install-mongodb-on-windows.txt @@ -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 --------- @@ -29,10 +26,10 @@ downloads page `_. 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 @@ -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:: @@ -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 ` 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 @@ -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 @@ -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 @@ -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.