487
edits
(New page: {{Nav MongoDB}} '''''MongoDB''''' == Introduction == MongoDB Plugin Production installs MongoDB server. A Windows interface is provided allowing you to start and stop MongoDB server. Fro...) |
(Punctuation and grammatical changes; some clarification.) |
||
Line 2: | Line 2: | ||
'''''MongoDB''''' | '''''MongoDB''''' | ||
== Introduction == | == Introduction == | ||
MongoDB Plugin Production installs MongoDB server. | The Uniform Server MongoDB Plugin Production installs MongoDB server, the phpMoAdmin browser administration interface and the PHP driver on Uniform Server 6-Carbo. | ||
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 | From the drop-down menus you can create and delete databases. In addition, you can assign and delete users for a database. You can also run phpMoAdmin. | ||
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. Creating a database you are forced 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 the Admin default password. | ||
== Download and Install == | == Download and Install == | ||
Line 31: | Line 28: | ||
For download details see [[MongoDB: Introduction | '''MongoDB Introduction (Main Start page)''']] | For download details see [[MongoDB: Introduction | '''MongoDB Introduction (Main Start page)''']] | ||
== Run == | == Run == | ||
Line 41: | Line 37: | ||
Double click on file '''Start_MongoDB.exe''' located in folder UniServer. | Double click on file '''Start_MongoDB.exe''' located in folder UniServer. | ||
* I hate nag pop-ups | * 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 | 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: | ||
UniServer\usr\local\mongo\us_info\'''no_nag.txt''' | UniServer\usr\local\mongo\us_info\'''no_nag.txt''' | ||
Line 58: | Line 54: | ||
Start server click '''Start Servers''' button. | Start server click '''Start Servers''' button. | ||
'''''Note'':''' With the servers running greyed out buttons are enabled. | '''''Note'':''' With the servers running, greyed out buttons are enabled. | ||
'''''Stop Server''''' | '''''Stop Server''''' | ||
Line 75: | Line 71: | ||
'''Button ''Start Mongo Client''''' | '''Button ''Start Mongo Client''''' | ||
Opens a command window and runs mongo-client. Button is enabled when servers are running otherwise is disabled. | Opens a command window and runs mongo-client. Button is enabled when servers are running; otherwise is disabled. | ||
'''Button ''Run phpMoAdmin''''' | '''Button ''Run phpMoAdmin''''' | ||
Opens phpMoAdmin in default browser. Button is enabled when servers are running otherwise is disabled. | Opens phpMoAdmin in default browser. Button is enabled when servers are running; otherwise is disabled. | ||
'''Button ''Help and Information''''' | '''Button ''Help and Information''''' | ||
Line 89: | Line 85: | ||
|} | |} | ||
'''''Note 1'':''' When challenged by your firewall always grant Internet access | '''''Note 1'':''' When challenged by your firewall, always grant Internet access | ||
'''''Note 2'':''' Plugin is self-contained | '''''Note 2'':''' Plugin is self-contained. No need to run UniTray. | ||
'''''Note 3'':''' This plugin runs as a standard program and not as a service. | '''''Note 3'':''' This plugin runs as a standard program and not as a service. | ||
'''''Note 4'':''' Status bar is dual function displays messages or acts as a progress bar | '''''Note 4'':''' Status bar is dual function: it displays messages or acts as a progress bar | ||
== Menu Bar == | == Menu Bar == | ||
* '''''File''''' | * '''''File''''' | ||
Line 119: | Line 114: | ||
# ''About'' - Displays Components details and version | # ''About'' - Displays Components details and version | ||
=== Configuration === | === Configuration === | ||
Both menu items open the same pop-up window | Both menu items open the same pop-up window | ||
Line 146: | Line 140: | ||
[[Image:Mongodb_common_2.gif]] | [[Image:Mongodb_common_2.gif]] | ||
|} | |} | ||
=== Databases === | === Databases === | ||
Line 176: | Line 169: | ||
[[Image:Mongodb_drop_db.gif]] | [[Image:Mongodb_drop_db.gif]] | ||
|} | |} | ||
=== Users === | === Users === | ||
These menu items require MongoDB to be running | These menu items require MongoDB to be running | ||
Line 210: | Line 203: | ||
[[Image:Mongodb_delete_user.gif]] | [[Image:Mongodb_delete_user.gif]] | ||
|} | |} | ||
== Test == | == Test == | ||
Line 246: | Line 239: | ||
When you have finished playing you probably will want to clean up and start afresh. | When you have finished playing you probably will want to clean up and start afresh. | ||
* Use the drop-down menus and delete any databases you created. | |||
==== New User ==== | ==== New User ==== | ||
If you are a new user to Uniform Server welcome | If you are a new user to Uniform Server, welcome. Your website files are placed in folder UniServer\www. | ||
To clean this folder prior to adding your material | To clean this folder prior to adding your material, you can delete everything except file '''.htaccess'''. | ||
Plugins may add to this folder for testing. MongoDB plugin adds a single file '''mongo_test_1.php''' | Plugins may add to this folder for testing. MongoDB plugin adds a single file '''mongo_test_1.php''' which you may delete after testing. | ||
== Alternative control == | == Alternative control == | ||
Line 264: | Line 256: | ||
They use '''uniserv.exe''' to run MongoDB hidden in the background. | They use '''uniserv.exe''' to run MongoDB hidden in the background. | ||
For convenience two batch files are provided | For convenience, two batch files are provided. One opens a command prompt allowing you to access Mongo’s command line tools, and the other directly runs the Mongo client tool. | ||
'''''Files'':''' | '''''Files'':''' | ||
Line 278: | Line 270: | ||
'''''Note'':''' | '''''Note'':''' | ||
You can delete folder '''alt_control''' | You can delete folder '''alt_control'''. It contains batch/script pairs that are not required. | ||
== Summary == | == Summary == | ||
Installing and running the MongoDB plugin is quick and easy. | Installing and running the MongoDB plugin is quick and easy. | ||
Hey! | Hey! If you don’t like the control interface, change it; [[MongoDB Tutorial 4: Introduction | MongoDB Tutorial 4]] provides details. | ||
---- | ---- |