Links

Main

About

Documentation

  Installation

  Configuration

  Example

  Future

Download

Installation

Installation is pretty simple. You will need to extract the tar.gz file into a directory location of your choosing. Typical installation location would be /opt, which will be used in the examples further in the document.

The directory layout is as follows

bin Program execution
classes Classes used by program
drivers Not used yet
conf Configuration directory
includes Program includes
certs SSL Certs

 

Configuration

The application receives its configuration through the config.xml located in the conf directory.

The following elements are used in the xml

config Configuration of either the server or CLI.
process Process definition

The config element has the following entries

TCP
Host
Name Hostname or IP. Used by CLI to connect to default host
Port Port. Used by CLI for default port
Transport

Values are either:

tcp
ssl

SSLOption
local_cert filename of cert
passphrase passphrase for cert
allow_self_signed 0 (false) or 1 (true)
verify_peer 0 (false) or 1 (true)
Password Password to use for jobs
Log Filename to log console message.
User User to execute processes, ignored if program is not executed by root
Group Group to execute processes, ignored if program is not executed by root

 

The process element has the following configuration items.

Name Unique name for instance
Description Description of process
Command Binary to be executed
WorkingDir Working directory to execute program
Param Params passed to binary
Env

Environmental vars for program execution

name variable name
value value to set variable
Pipe
name Value is either stdout or stderr
value Output type, currently only "file"
file Where to direct output
mode
write overwrite if file exists
append append if file exists
Autostart 0 (false) or 1 (true). Determines if process starts upon program starts.

 

Example


<processes>

      <config>

      	<TCP>

      		<HOST name="localhost" port="8000" transport="ssl"/>

      		<SSLOption name="local_cert" value="certs/mycert.pem"/>

      		<SSLOption name="passphrase" value="comet" />

      		<SSLOption name="allow_self_signed" value="1" />

      		<SSLOption name="verify_peer" value="0" />

      		<Password>pwned</Password>

      	</TCP>

      	<Log>/tmp/output.log</Log>

     	<User>nobody</User>

      	<Group>nobody</Group>

      </config>

      <process driver="standard">

      	<Name>tomcat8050</Name>

      	<Description>The tomcat 8050 jvm start up</Description>

      	<Command>/usr/bin/java</Command>

      	<WorkingDir>/www/tomcat6.0</WorkingDir>

      

      	<Param>-Dcatalina.base=/www/tomcat6.0_8050</Param>

      	<Param>-Dcatalina.home=/www/tomcat6.0</Param>

      	<Param>-classpath "/Library/Java/Home/lib/tools.jar:/www/tomcat6.0/bin/bootstrap.jar:/www/tomcat6.0/bin/commons-logging-api.jar"</Param>

      	<Param>-Xms128m -Xmx512m</Param>

      	<Param>-server</Param>

      	<Param>-Dcom.sun.management.jmxremote</Param>

      	<Param>-Dnetworkaddress.cache.ttl=10</Param>

      	<Param>-Djava.io.tmpdir=/www/tomcat6.0_8050/temp</Param>

      	<Param>-Djava.awt.headless=true</Param>

      	<Param>org.apache.catalina.startup.Bootstrap</Param>

      	<Env name="JAVA_HOME" value="/Library/Java/Home" />

      

      	<Pipe name="stdout" value="file" file="/www/catalina8050.log" mode="append" />

      	<Pipe name="stderr" value="file" file="/www/catalina8050.log" mode="append" />

      	<Autostart>0</Autostart>

      </process>
</processes>