MongoDB: Production Standalone

From The Uniform Server Wiki
Jump to navigation Jump to search

 

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.