Download
Download the Zip-file for your operating system. The Enterprise Edition can be downloaded directly from the shop or the support area.
LINK TO SHOP
Following dependencies have to be installed first:
- Node.js (0.10.x)
- MongoDB (2.4.x)
- RedisIO (2.4.x) (optional)
Alternativly use Baboonstack. It is solving all dependencies in a simple one-click solution for different operating systems. It also offers an easy way to register a Node.js application as a service in Windows operation systems.
Installation
- Make sure the dependencies are resolved
- Unzip the zip-file from Mongo Management Studio into the desired folder
- Adjust the settings in the config.js suitable for your environment
- Open the command prompt as administrator
- Run the setup script
| Codeblock |
|---|
|
node scripts/setup.js |
- Run the application in a browser (Default-URL: http://127.0.0.1:3333)
- Log in as administrator (login: sysadmin password: a)
- Change the password of the sysadmin
| Warnung |
|---|
You really should change the password of the sysadmin for security reasons! |
Run the application as a service
Find the instructions for your OS here.
Windows
In Windows you can register the application as a service. Then Mongo Management Studio runs even after restart of your system.
| Codeblock |
|---|
|
// Installation as service
// Pseudo Code
bbs service install [Name of the service] [Node version] ["Path to server.js file"]
// Example
// Service is named mms
// Use node version 0.10.26
// Zip file was unpacked in the folder c:\mms
bbs service install mms 0.10.26 "c:\mms\server.js"
// Start the service
// Pseudo Code
bbs service start [Name of the service]
// Example
// Service is named mms
bbs service start mms |
Linux
Below are two examples of different init systems under Linux. If necessary, change the settings for your system.
Example upstart script for Debian/Ubuntu
| Codeblock |
|---|
|
$ nano /etc/init/mmsd.conf
$ service mmsd start |
| Codeblock |
|---|
| theme | Emacs |
|---|
| title | /etc/init/mmsd |
|---|
| firstline | 1 |
|---|
| linenumbers | true |
|---|
| collapse | true |
|---|
|
#!upstart
description "Mongo Management Studio Daemon"
author "Litixsoft 2014"
#start on (local-filesystems and net-device-up IFACE=eth0)
stop on runlevel 0
respawn # restart job if died
respawn limit 5 60 # after 5 trys in 60 seconds abort
script
NODEBIN="/opt/litixsoft/baboonstack/node/0.10.26/bin/node"
APPPATH="/opt/litixsoft/mongo_management_studio/"
NODEAPP="server.js"
LOGFILE="/var/log/mmsd.log"
PIDFILE="/var/run/mmsd.pid"
exec start-stop-daemon --start --make-pidfile --pidfile $PIDFILE --chdir $APPPATH --exec $NODEBIN $NODEAPP
end script |
Example init.d script for CentOS
| Codeblock |
|---|
|
$ nano /etc/init.d/mmsd
$ chmod +x /etc/init.d/mmsd
$ update-rc.d mmsd defaults
$ ./etc/init.d/mmsd start |
| Codeblock |
|---|
| theme | Emacs |
|---|
| language | bash |
|---|
| title | /etc/init.d/mmsd |
|---|
| firstline | 1 |
|---|
| linenumbers | true |
|---|
| collapse | true |
|---|
|
#!/bin/sh
#
# chkconfig: 35 99 99
# description: Mongo Management Studio Daemonize
#
. /etc/rc.d/init.d/functions
USER="nodejs"
NODEBIN="/opt/litixsoft/baboonstack/node/0.10.26/bin/node"
NODEAPP="/opt/litixsoft/mongo_management_studio/server.js"
LOGFILE="/var/log/mmsd.log"
LCKFILE="/var/lock/subsys/mmsd"
do_start()
{
if [ ! -f "$LCKFILE" ] ; then
echo -n $"Starting $NODEAPP: "
runuser -l "$USER" -c "$NODEBIN $NODEAPP >> $LOGFILE &" && echo_success || echo_failure
RETVAL=$?
echo
[ $RETVAL -eq 0 ] && touch $LCKFILE
else
echo "$NODEAPP is locked."
RETVAL=1
fi
}
do_stop()
{
echo -n $"Stopping $NODEAPP: "
pid=`ps -aefw | grep "$NODEBIN $NODEAPP" | grep -v " grep " | awk '{print $2}'`
kill -9 $pid > /dev/null 2>&1 && echo_success || echo_failure
RETVAL=$?
echo
[ $RETVAL -eq 0 ] && rm -f $LCKFILE
}
case "$1" in
start)
do_start
;;
stop)
do_stop
;;
restart)
do_stop
do_start
;;
*)
echo "Usage: $0 {start|stop|restart}"
RETVAL=1
esac
exit $RETVAL |
Mac
Please use tools based on node.js like PM2 or forever.
Update
- Stop the service or the Node.js application (Mac)
| Codeblock |
|---|
|
// Pseudo Code
bbs service stop [name of service]
// example
// service is mms
bbs service stop mms |
- Backup your current config.js file
- Unzip the Zip-file
- Copy and overwrite the files into the application's folder
- Compare your saved config.js with the new config.js and adapt changed settings if necessary