Difference between revisions of "MongoDB: Production Standalone"

From The Uniform Server Wiki
Jump to navigation Jump to search
(New page: {{Nav MongoDB}} '''''MongoDB''''' == Introduction == MongoDB Standalone Production installs MongoDB server. A Windows interface is provided allowing you to start and stop MongoDB server....)
 
(Punctuation and grammatical changes; some clarification.)
Line 4: Line 4:
 
MongoDB Standalone Production installs MongoDB server.  
 
MongoDB Standalone Production installs MongoDB server.  
  
A Windows interface is provided allowing you to start and stop MongoDB server. From this interface you can start either the mongo-client or a cmd prompt. These allow you to administer mongo-databases.  
+
A Windows interface is provided, allowing you to start and stop MongoDB server. From this interface you can start either the mongo-client or a cmd prompt. These allow you to administer mongo-databases.  
  
From the drop-down menus you can create and delete databases in addition you can assign and delete users for a database.
+
From the drop-down menus you can create and delete databases. In addition, you can assign and delete users for a database.
  
Production in this context is referring to authenticated access. All databases are assigned a user name and user password. Creating a database you are forced to provide a name and password.
+
Production in this context is referring to authenticated access. All databases are assigned a user name and user password. When creating a database, you are required to provide a name and password.
  
The Admin database is pre-configured with a name and password of root and root respectively.
+
The Admin database is pre-configured with a name and password of '''root''' and '''root''' respectively.
 
+
The first task after installation is to change this Admin default password.
First task after installation is to change the Admin default password.
 
  
 
Independent operation is achieved using a single binary (PHP 5.3.2 compiled with common extensions including new WinBinder with UTF-8 support) extracted from phpack v0.7.5 see [http://winbinder.org/forum/viewtopic.php?f=8&t=1148 '''Winbinder forum'''] for details. The dll is located in phpack basic stubs folder.
 
Independent operation is achieved using a single binary (PHP 5.3.2 compiled with common extensions including new WinBinder with UTF-8 support) extracted from phpack v0.7.5 see [http://winbinder.org/forum/viewtopic.php?f=8&t=1148 '''Winbinder forum'''] for details. The dll is located in phpack basic stubs folder.
  
'''''[[#top | Top]]'''''
 
  
 
== Download and Install ==
 
== Download and Install ==
 
=== Options 1 ===
 
=== Options 1 ===
* Download file mongo_pro_standalone_v1_0.exe from Sourceforge
+
* Download file '''''mongo_pro_standalone_v1_0.exe''''' from Sourceforge
 
* Save to any folder (no spaces in path)
 
* Save to any folder (no spaces in path)
 
* To extract files, double click on file mongo_pro_standalone_v1_0.exe no need to change the path.
 
* To extract files, double click on file mongo_pro_standalone_v1_0.exe no need to change the path.
Line 27: Line 25:
  
 
=== Options 2 ===
 
=== Options 2 ===
* Download file mongo_pro_standalone_v1_0.zip from Sourceforge
+
* Download file '''''mongo_pro_standalone_v1_0.zip''''' from Sourceforge
 
* Save to any folder (no spaces in path)
 
* Save to any folder (no spaces in path)
 
* Extract files, navigate to folder mongo_pro_standalone_v1_0
 
* Extract files, navigate to folder mongo_pro_standalone_v1_0
Line 35: Line 33:
 
For download details see [[MongoDB: Introduction | '''MongoDB Introduction (Main Start page)''']]
 
For download details see [[MongoDB: Introduction | '''MongoDB Introduction (Main Start page)''']]
  
'''''[[#top | Top]]'''''
 
  
 
== Run ==
 
== Run ==
Line 45: Line 42:
 
Double click on file '''Run_MongoDB.exe''' located in folder mongodb_1.
 
Double click on file '''Run_MongoDB.exe''' located in folder mongodb_1.
  
* I hate nag pop-ups however this one is very important.
+
* I hate nag pop-ups, but this one is very important.
* Always close MongoDB before turning your PC off
+
* '''Always''' close MongoDB before turning your PC off.
 
* It needs to perform a clean up to maintain data integrity.
 
* It needs to perform a clean up to maintain data integrity.
  
The nag pop-up can be infuriating hence click '''''no''''' not to display it again at next start up.
+
The nag pop-up can be infuriating, but you can click '''''no''''' to not display it again at next start up.
  
'''''Note'':''' If you want to restore the nag pop-up delete the following file:
+
'''''Note'':''' If you want to restore the nag pop-up, delete the following file:
  
 
mongodb_1\control\'''no_nag.txt'''
 
mongodb_1\control\'''no_nag.txt'''
Line 62: Line 59:
 
Start server click '''Start MongoDB''' button.
 
Start server click '''Start MongoDB''' button.
  
'''''Note'':''' With the server running greyed out button is enabled.
+
'''''Note'':''' With the server running, greyed out button is enabled.
  
 
'''''Stop Server'''''
 
'''''Stop Server'''''
Line 79: Line 76:
 
'''Button ''Start Mongo Client'''''
 
'''Button ''Start Mongo Client'''''
  
Opens a command window and runs mongo-client. Button is enabled when server is running otherwise is disabled.
+
Opens a command window and runs mongo-client. Button is enabled when server is running; otherwise it's disabled.
  
 
'''Button ''Help and Information'''''
 
'''Button ''Help and Information'''''
Line 89: Line 86:
 
|}
 
|}
  
'''''Note 1'':''' When challenged by your firewall always grant Internet access
+
'''''Note 1'':''' When challenged by your firewall, always grant Internet access.
  
 
'''''Note 2'':''' This server runs as a standard program and not as a service.
 
'''''Note 2'':''' This server runs as a standard program and not as a service.
 
'''''[[#top | Top]]'''''
 
  
 
== Menu Bar ==
 
== Menu Bar ==
Line 101: Line 96:
 
* '''''Configuration'''''
 
* '''''Configuration'''''
 
# ''Change Port''            - Change Mongo listen port
 
# ''Change Port''            - Change Mongo listen port
# ''Change Admin Password''  - Change default Admin passwordd
+
# ''Change Admin Password''  - Change default Admin password
  
 
* '''''Databases'''''
 
* '''''Databases'''''
# ''Create Database'' - Create a new database assign user and password<br>For an existing database update user password<br>For existing database assign a new user and password
+
# ''Create Database'' - Create a new database, assign user and password<br>For an existing database update user password<br>For existing database assign a new user and password
# ''Drop Database''    - Select a datbase and delete it          -
+
# ''Drop Database''    - Select a database and delete it          -
  
 
* '''''Users'''''  
 
* '''''Users'''''  
# Add User              - Addnew user and password to existing database
+
# Add User              - Add new user and password to existing database
 
# Delete User            - Select database lists all users select a user and delete
 
# Delete User            - Select database lists all users select a user and delete
  
Line 114: Line 109:
 
# ''Help''                  - Displays help file
 
# ''Help''                  - Displays help file
 
# ''About''                - Displays Components details and version
 
# ''About''                - Displays Components details and version
'''''[[#top | Top]]'''''
+
 
 
=== Configuration ===
 
=== Configuration ===
 
Both menu items open the same pop-up window
 
Both menu items open the same pop-up window
Line 123: Line 118:
  
 
* Enabled only when MongoDB server stopped
 
* Enabled only when MongoDB server stopped
* Eneter new listening port
+
* Enter new listening port
 
* Click button Set MongoDB Port
 
* Click button Set MongoDB Port
 
* Close window (cross top right)
 
* Close window (cross top right)
Line 141: Line 136:
 
[[Image:Mongodb_common_2.gif]]
 
[[Image:Mongodb_common_2.gif]]
 
|}
 
|}
'''''[[#top | Top]]'''''
+
 
 
=== Databases ===
 
=== Databases ===
 
These menu items require MongoDB to be running
 
These menu items require MongoDB to be running
Line 156: Line 151:
 
'''''Note'':'''
 
'''''Note'':'''
  
This pop-up is mufti-purpose
+
This pop-up is multi-purpose
 
|
 
|
 
[[Image:Mongodb_create_db.gif]]
 
[[Image:Mongodb_create_db.gif]]
Line 170: Line 165:
 
[[Image:Mongodb_drop_db.gif]]
 
[[Image:Mongodb_drop_db.gif]]
 
|}
 
|}
'''''[[#top | Top]]'''''
 
  
 
=== Users ===
 
=== Users ===
Line 205: Line 199:
 
[[Image:Mongodb_delete_user.gif]]
 
[[Image:Mongodb_delete_user.gif]]
 
|}
 
|}
'''''[[#top | Top]]'''''
+
 
  
 
== Alternative control ==
 
== Alternative control ==
Line 218: Line 212:
 
                       you to run MongoDB's command line tools
 
                       you to run MongoDB's command line tools
 
</pre>
 
</pre>
 
'''''[[#top | Top]]'''''
 
  
 
== Summary ==
 
== Summary ==
Running MongoDB is as simple as the above.
+
Running MongoDB is really simple.
 
 
Hey! Don’t like the control interface, change it; [[MongoDB Tutorial 3: Introduction | MongoDB Tutorial 3]]  provides details.
 
  
'''''[[#top | Top]]'''''
+
Hey! If you don’t like the control interface, change it; [[MongoDB Tutorial 3: Introduction | MongoDB Tutorial 3]] provides details.
  
 
----
 
----

Revision as of 00:35, 6 September 2010

 

UniServer 6-Carbo
MongoDB Uniform Server Series.

MongoDB

Introduction

MongoDB Standalone Production installs MongoDB server.

A Windows interface is provided, allowing you to start and stop MongoDB server. From this interface you can start either the mongo-client or a cmd prompt. These allow you to administer mongo-databases.

From the drop-down menus you can create and delete databases. In addition, you can assign and delete users for a database.

Production in this context is referring to authenticated access. All databases are assigned a user name and user password. When creating a database, you are required to provide a name and password.

The Admin database is pre-configured with a name and password of root and root respectively. The first task after installation is to change this Admin default password.

Independent operation is achieved using a single binary (PHP 5.3.2 compiled with common extensions including new WinBinder with UTF-8 support) extracted from phpack v0.7.5 see Winbinder forum for details. The dll is located in phpack basic stubs folder.


Download and Install

Options 1

  • Download file mongo_pro_standalone_v1_0.exe from Sourceforge
  • Save to any folder (no spaces in path)
  • To extract files, double click on file mongo_pro_standalone_v1_0.exe no need to change the path.
  • Navigate to folder mongodb_1.
  • Double click Run_MongoDB.exe opens control menu

Options 2

  • Download file mongo_pro_standalone_v1_0.zip from Sourceforge
  • Save to any folder (no spaces in path)
  • Extract files, navigate to folder mongo_pro_standalone_v1_0
  • Navigate to folder mongodb_1.
  • Double click Run_MongoDB.exe opens control menu

For download details see MongoDB Introduction (Main Start page)


Run

Start Windows interface

Double click on file Run_MongoDB.exe located in folder mongodb_1.

  • I hate nag pop-ups, but this one is very important.
  • Always close MongoDB before turning your PC off.
  • It needs to perform a clean up to maintain data integrity.

The nag pop-up can be infuriating, but you can click no to not display it again at next start up.

Note: If you want to restore the nag pop-up, delete the following file:

mongodb_1\control\no_nag.txt

MongoDB 1 start.gif

Start Server

Start server click Start MongoDB button.

Note: With the server running, greyed out button is enabled.

Stop Server

Button toggles displaying Stop MongoDB

Open cmd Window

Opens a command window and changes to folder: mongodb_1\bin

Provides access to Mongo’s suite of command-line tools.

Mongodb c 1.gif

Button Start Mongo Client

Opens a command window and runs mongo-client. Button is enabled when server is running; otherwise it's disabled.

Button Help and Information

Opens main read me file in Notepad.

Mongodb c 2.gif

Note 1: When challenged by your firewall, always grant Internet access.

Note 2: This server runs as a standard program and not as a service.

Menu Bar

  • File
  1. Exit - Close application
  • Configuration
  1. Change Port - Change Mongo listen port
  2. Change Admin Password - Change default Admin password
  • Databases
  1. Create Database - Create a new database, assign user and password
    For an existing database update user password
    For existing database assign a new user and password
  2. Drop Database - Select a database and delete it -
  • Users
  1. Add User - Add new user and password to existing database
  2. Delete User - Select database lists all users select a user and delete
  • Help
  1. Help - Displays help file
  2. About - Displays Components details and version

Configuration

Both menu items open the same pop-up window

Change Port

  • Enabled only when MongoDB server stopped
  • Enter new listening port
  • Click button Set MongoDB Port
  • Close window (cross top right)

Mongodb common 1.gif

Change Admin Password

  • Enabled only when MongoDB server is running
  • Enter a new password
    • Minimum of six alphanumeric characters
    • No spaces allowed
  • Click Set Admin Password
  • Close window (cross top right)

Mongodb common 2.gif

Databases

These menu items require MongoDB to be running

Create Database

  • Enter a User Name
  • Enter a password for that user  
  • Enter database name to create
  • Click Create or change button

Note:

This pop-up is multi-purpose

Mongodb create db.gif

Drop Database

  • Either enter a database name
  • Or select one from the list
  • Click Drop button

Mongodb drop db.gif

Users

These menu items require MongoDB to be running

Add User

  • Select a database from the list

New User - No user or password displayed

  • Enter a User name
  • Enter a password for that user
  • Click Click Create or change button

Existing User - User name displayed

Change password for that user

  • Enter a new password for that user
  • Click Click Create or change button

Mongodb create db.gif

Delete User

  • Select database from list
  1. Displays database in top text window
  2. Displays a list of user on right
  • Select a user from this list
  1. User displayed in top text window
  • Click Delete button

Mongodb delete user.gif


Alternative control

If you prefer to use batch files take a look in folder alt_control_2

Files:

Run_start_mongo.bat  - Run MongoDB server hidden
Run_stop_mongo.bat   - Cleanly stop MongoDB server
Run_client.bat       - Directly runs mongo-client
Run_cmd.bat          - Opens a command window changes to bin folder allowing
                       you to run MongoDB's command line tools

Summary

Running MongoDB is really simple.

Hey! If you don’t like the control interface, change it; MongoDB Tutorial 3 provides details.