JarCastingkevoree-watchdog
Kevoree Watchdog : Software ensures the continuity of service of a Kevoree Runtime
The Kevoree Watchdog is a service that downloads (if necessary), installs, starts and monitors a Kevoree Runtime. This watchdog service monitors the Kevoree Runtime by regularly sending ping messages. If no answer is received within 3000 ms, the watchdog restarts the runtime.
Using the Watchdog in the console
The Kevoree Watchdog service has two parameters
- kevoree.version (mandatory) is the version number of the runtime you want to launch (e.g.: 2.0.0, 1.9.0-SNAPSHOT).
- bootmodel (optional) is a Kevoree model (.kev) or a KevScript (.kevs) that will be passed on to the launched runtime at startup.
wget "http://repository.sonatype.org/service/local/artifact/maven/redirect?r=central-proxy&g=org.kevoree.watchdog&a=org.kevoree.watchdog&v=RELEASE" --content-disposition
java -jar org.kevoree.watchdog-0.<version>.jar <kevoree.version> <bootmodel>
Download the Watchdog directly
Additional system properties
Kevoree watchdog also support dedicated system properties to configure standard output and error stream. The following option which must appears BEFORE the -jar option, and allows to redirect standard and error stream to a file
-Dlog.out=path_to_file
In addition the following option, aims at redirect the error stream to a file.
-Dlog.err=path_to_file
If this option is not explicitly declared, but the log.out is declared, by default Kevoree Watchdig redirect BOTH error and standard output to the same file declared with log.out option.
Finelly, the full watchdig startup can be done throught:
java -Dlog.out=path_to_file -jar org.kevoree.watchdog-0.12.jar <kevoree.version> <bootmodel>
Install Kevoree Watchdog as a Linux service (Debian and Ubuntu)
Simply download the last .deb version of Kevoree Watchdog
wget "http://repository.sonatype.org/service/local/artifact/maven/redirect?r=central-proxy&g=org.kevoree.watchdog&a=org.kevoree.watchdog&v=RELEASE&p=deb" --content-disposition
sudo dpkg -i org.kevoree.watchdog*.deb
Download the Watchdog directly The service is automatically registered to start as a service when the system starts.
Configuring the Linux service in /etc/kevoree/config
Default content :
KEVOREE_USER=kevoree
KEVOREE_GROUP=kevoree
KEVOREE_VERSION=RELEASE
NODE_NAME=$(hostname)
PING_PORT=9999
PING_TIMEOUT=3000
- KEVOREE_USER The user which is used to start the kevoree watchdog
- KEVOREE_GROUP The group which is used to start the kevoree watchdog
- KEVOREE_VERSION Sets the version of the runtime to be managed (downloaded, started, monitored).
- NODE_NAME Name of the Kevoree node. Initialy set to the host name plus user name.
- PING_PORT Is the tcp port used ping the runtime. Set it to a free port.
- PING_TIMEOUT Sets the max no-response time before rebooting the managed runtime.
Bootstrap model
by default the service lookup for a bootstrap model (XMI or KevScript) in the following file
/etc/kevoree/boot.kevs
If this model is empty, the runtime create one (as in standalone mode). In short place your bootstrap model and the informations relative to your node name at this place.
You are also able to specify the bootstrap model on the configuration file. To do so add the following line and adapt it according to your needs:
BOOTMODEL=/etc/kevoree/boot.kevs
Start Kevoree service
sudo service kevoree start
Monitor the log file
tail -f -n 200 /var/log/kevoree/kevoree.log
Get status (PID) of current Kevoree Runtime
sudo service kevoree status
Stop Kevoree runtime service (and the child kevoree process)
sudo service kevoree stop
Uninstall Kevoree bootstrap (Debian and Ubuntu)
To remove the kevoree runtime and the startup script you should use the dpkg command using the kevoree package name kevoree.bootstrap, simply as follow :
sudo dpkg -r kevoree.watchdog
