Fuse Fabric
Projects

Process Management

The Process Manager bundle provides support for running managed processes on a machine. A managed process is a stand alone operating system process which is managed by the Process Manager.

A managed process keeps running if the Process Manager is restarted and it can still start/stop/restart/uninstall the process after it itself is restarted; as the Process Manager knows how to find the underlying operating system process ID (PID) of each managed process.

The Process Manager can run any application; in which case it acts like using init.d, xinit.d, daemontools, monit and other kinds of unix process manager. The difference though is the Process Manager can act at the Fuse Fabric level since we can use Fabric Profiles to determine which machines run which proceses in a fabric.

A managed process is similar conceptually to child containers in a root Apache Karaf container; each managed process is a separate, stand alone operating system process installed in a sub directory of ${karaf-home}/processes and is managed by the root container to install/start/stop/restart/uninstall the process.

To users familiar with Apache Karaf, a managed process feels similar to a bundle or feature in a Karaf container and its interactive shell; the difference being a managed process is a separate, stand alone operating system process.

A process typically has a directory which contains a launcher script according to the Init Script Actions Specification for starting/stopping/restarting etc.

Deploying JARs as managed processes

The Process Manager also supports turning any Java code (a collection of jars and an executable class name) into a stand alone managed process which can be managed like other operating system processes.

This means you can have fine grained process isolation at the JAR level. Rather than running all your Java code in one big container in a single process, you can decouple executable jars into separate processes all managed as if it were inside a single Java container - will full process isolation and no concerns over potential resource leaks.

One bad managed process will not affect any others and each process can be easily stopped without affecting any others.

This means with Fuse you can easily move your Java code between OSGi bundles, Fuse Bundles or managed processes depending on your coupling, scaling or process isolation requirements.

Managing processes like Tomcat, Jetty, HQ Agent

The ProcessController can run any process; though it needs to know exactly how to run it. It assumes the Init Script Actions Specification for starting/stopping/restarting etc.

The default is to use a launch script called bin/launcher and then specify a parameter for each command

You can also specify a configuration in JSON for the controller to use:

process:install -c urlOfJson urlOfTarBall

For example to install Apache Tomcat:

process-install -c https://raw.github.com/fusesource/fuse/master/process/Process Manager/src/main/resources/tomcat.json http://apache.favoritelinks.net/tomcat/tomcat-7/v7.0.29/bin/apache-tomcat-7.0.29.tar.gz

then once installed you can start/stop/restart/status it like any other process.

Kinds of process controller

Process Manager ships with some default kinds of controller which lets you use a more concise command to run some common processes.

For example to install an Apache Tomcat distro, in this case Apache TomEE:

process:install -k tomcat mvn:org.apache.openejb/apache-tomee/1.5.0/tar.gz/plus

You can use any URL for a distro of Tomcat you wish in the above command. For example you could refer to a specific HTTP URL for a Tomcat distro…

process:install -k tomcat http://repo2.maven.org/maven2/org/apache/openejb/apache-tomee/1.5.0/apache-tomee-1.5.0-plus.tar.gz

To run Jetty:

process:install -k jetty http://central.maven.org/maven2/org/eclipse/jetty/jetty-distribution/8.1.4.v20120524/jetty-distribution-8.1.4.v20120524.tar.gz

or

process:install -k jetty mvn:org.eclipse.jetty/jetty-distribution/8.1.4.v20120524

Or to install a Fuse HQ Agent

process:install -k fusehq-agent someURLToDistro

Working with processes from the Shell

Once a process is installed it given a number (1, 2, 3 etc) which refers to the ID used within the shell to refer to it, to be able to start/stop/restart etc. Note that this is not the same thing as the operating system PID!

To view the current installations and their IDs and PIDs use

ps

You'll then see the simple IDs, the real OS PIDs and the URLs of the installed processes.

Once you know the process number you can then start/stop/restart/status/kill it

process:start 1
process:restart 1
process:status 1

To see all the available commands type

help process

Installing a jar as a managed process

You can use the process:install-jar command to install a jar as a managed process as follows:

process:install-jar groupId artifactId version

e.g. to create a managed process from this sample jar:

 process:install-jar org.fusesource.fabric.samples process-sample-camel-spring 99-master-SNAPSHOT

This will then download the jar using the maven coordinates (groupID / artifactId / version) and create a binary installation with the launcher to start/stop/restart the process etc

If the jar has no main class

Some jars just contain, say, Spring XML or blueprints and don't contain an executable main. If you need to supply one just specify the -m or —main options on the command line.

For example:

process:install-jar -m org.apache.camel.spring.Main org.fusesource.fabric.samples process-sample-camel-spring-just-xml 99-master-SNAPSHOT

This will then boot up all the Spring XML files in the META-INF/spring/*.xml URI on the classpath.

Creating a managed process distro from Java code

See the example project for how you can take any jar with an executable main and turn it into a tar.gz which can then be installed directly.

Generally its a case of

So to install the above sample as a tarball use:

process:install mvn:org.fusesource.fabric.samples/process-sample-camel-spring/99-master-SNAPSHOT/tar.gz