MongoDB: Production Plugin: Difference between revisions

Punctuation and grammatical changes; some clarification.
(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 in addition you can assign and delete users for a database. Inaddition you can run phpMoAdmin  
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.


First task after installation is to change the Admin default password.
'''''[[#top | Top]]'''''


== 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)''']]


'''''[[#top | Top]]'''''


== 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 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:


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 no need to run UniTray.   
'''''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


'''''[[#top | Top]]'''''
== Menu Bar ==
== Menu Bar ==
* '''''File'''''
* '''''File'''''
Line 119: Line 114:
# ''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 146: Line 140:
[[Image:Mongodb_common_2.gif]]
[[Image:Mongodb_common_2.gif]]
|}
|}
'''''[[#top | Top]]'''''


=== Databases ===
=== Databases ===
Line 176: Line 169:
[[Image:Mongodb_drop_db.gif]]
[[Image:Mongodb_drop_db.gif]]
|}
|}
'''''[[#top | Top]]'''''
 
=== 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]]
|}
|}
'''''[[#top | Top]]'''''
 


== 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 ou created.
* 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, your website files are placed in folder UniServer\www.
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 with the exception of file '''.htaccess''' you can delete everything.
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''' hence deletr it after testing.
Plugins may add to this folder for testing. MongoDB plugin adds a single file '''mongo_test_1.php''' which you may delete after testing.


'''''[[#top | Top]]'''''


== 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 one opens a command prompt allowing you to access Mongo’s command line tools the other directly runs the Mongo client tool.
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''' it contains batch/script pairs that are not required.   
You can delete folder '''alt_control'''. It contains batch/script pairs that are not required.   


'''''[[#top | Top]]'''''


== Summary ==
== Summary ==
Installing and running the MongoDB plugin is quick and easy.
Installing and running the MongoDB plugin is quick and easy.


Hey! Don’t like the control interface, change it; [[MongoDB Tutorial 4: Introduction | MongoDB Tutorial 4]] provides details.
Hey! If you don’t like the control interface, change it; [[MongoDB Tutorial 4: Introduction | MongoDB Tutorial 4]] provides details.
 
 
'''''[[#top | Top]]'''''


----
----