Linux Service

These instructions are for Debian and Linux-based systems

Installing a service for Linux can be very useful if you want to start, stop, or even restart mango.

With that said, a full Linux service tutorial is out of the reach of this wiki. But please feel free to look at these links:

https://wiki.debian.org/LSBInitScripts
https://wiki.debian.org/Daemo

http://debian-handbook.info/browse/stable/unix-services.html

Service Install Instructions

cd /etc/init.d
sudo nano mango

Add this code to the file

Please note that if you have mango installed at a location other than: /opt/mango you will need to change the start and stop variables to your full path in which mango is installed.

 
#!/bin/sh
# chkconfig: 235 99 10
# description: Start or stop the Mango Automation
#
### BEGIN INIT INFO
# Provides: mango
# Required-Start: $network $syslog
# Required-Stop: $network
# Default-Start: 2 3 5
# Default-Stop: 0 1 6
# Description: Start or stop the Mango Automation
### END INIT INFO
start="/opt/mango/bin/ma.sh start"
stop="/opt/mango/bin/ma.sh stop"
lockfile=/var/lock/subsys/mango
name='Mango'
case "$1" in
'start')
$start>/dev/null 2>&1 </dev/null
RETVAL=$?
if [ "$RETVAL" = "0" ]; then
touch $lockfile>/dev/null 2>&1
fi
;;
'stop')
$stop
RETVAL=$?
if [ "$RETVAL" = "0" ]; then
rm -f $lockfile
fi
;;
'status')
status Mango
;;
'restart'|'reload'|'condrestart')
$stop ; $start
RETVAL=$?
;;
*)
echo "Usage: sudo service{ start | stop | restart | reload | condrestart}"
RETVAL=1
;;
esac
exit $RETVAL
 

Press ctrl+x then save the file

Next we need to set the permissions for the service to be excludable

sudo chmod u+x /etc/init.d/mango

Next we need to tell the system about this on Debian-based systems (Ubuntu, Linux Mint, ect.)

sudo  update-rc.d  mango defaults

That's it! You can now start and stop the services like so:

stop

sudo service mango stop

start
restart

sudo service mango restart

status

sudo service mango status

Windows Service

We recommend using YAJSW for installing a windows service. We are providing a prepackaged file to make this very easy:

  1. Download the zip file yajsw.zip Unzip the fine in your MA_HOME folder.
  2. Inside the MA_HOME/yajsw/conf/wrapper.conf file you can edit the location where Mango is installed. By default it assumes Mango is installed at C:\Mango
  3. In the command prompt cd to MA_HOME\yajsw\bat and they run installService.bat.
  4. After the service is installed you can open up your windows services screen and start or stop the service named Mango.

Note: When running as a windows service in this way the automatic upgrade of the Mango core will not fully complete and you will have to finish the upgrade manually by deleting the MA_HOME\lib folder and unzipping the m2m2-core.x.x.x.zip file that will be downloaded during the upgrade process.