As soon as I upload the patches to Qpid (and possibly commit them), I will add the documentation here or provide a URL to a wiki.

Running the JMS client with Realtime Java
=========================================
The JMS Client can be run with Realtime Java in order achieve more deterministic behaviour.
In order to run the client in the Realtime java environment you need to do the following,

1. The client needs to run on a real time operating system suported by your Realtime java vendor.
2. Place the realtime jars provided by your vendor (We support only Sun and IBM implementations) in your classpath
3. Set the following JVM argument.
   -Dqpid.thread_factory="org.apache.qpid.thread.RealtimeThreadFactory"
   This will ensure that the JMS Client will use javax.realtime.RealtimeThread's instead java.lang.Thread's.

Optionally you could also set a priority for the Threads using -Dqpid.rt_thread_priority=30.
The default value is set at 20.

Based on your workload you will need to tune the JVM to achieve the best results.
Please refer to your vendors JVM tuning guide on how to tune your JVM.

<this is work in progress - the report/white paper is likely not to happen before MRG 1.1 goes out>
The following whitepaper illustrates tuning Sun Realtime JVM 2.1 on Red Hat MRG Realtime<insert version> for a sample MRG Messaging work load.
</this is work in progress - the report/white paper is likely not to happen before MRG 1.1 goes out>

I'm passing this on to Jonathan, as it really belongs in the Tutorial.

Cheers,
LKB

I really don't think this belongs in the Tutorial - the Installation Guide seems like the right place, probably in a new section. 

Jonathan

OK, I can run with that. It's moved into 1.1.1.

LKB

And has now slipped into the next release.

LKB

Done.

LKB