Return-Path: Delivered-To: apmail-geronimo-activemq-commits-archive@www.apache.org Received: (qmail 28351 invoked from network); 1 Feb 2006 22:06:03 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 1 Feb 2006 22:06:03 -0000 Received: (qmail 33236 invoked by uid 500); 1 Feb 2006 22:06:02 -0000 Delivered-To: apmail-geronimo-activemq-commits-archive@geronimo.apache.org Received: (qmail 33140 invoked by uid 500); 1 Feb 2006 22:06:01 -0000 Mailing-List: contact activemq-commits-help@geronimo.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: activemq-dev@geronimo.apache.org Delivered-To: mailing list activemq-commits@geronimo.apache.org Received: (qmail 33064 invoked by uid 99); 1 Feb 2006 22:06:00 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 01 Feb 2006 14:06:00 -0800 X-ASF-Spam-Status: No, hits=-9.4 required=10.0 tests=ALL_TRUSTED,NO_REAL_NAME X-Spam-Check-By: apache.org Received: from [209.237.227.194] (HELO minotaur.apache.org) (209.237.227.194) by apache.org (qpsmtpd/0.29) with SMTP; Wed, 01 Feb 2006 14:05:55 -0800 Received: (qmail 27969 invoked by uid 65534); 1 Feb 2006 22:05:34 -0000 Message-ID: <20060201220534.27967.qmail@minotaur.apache.org> Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r374192 [3/5] - /incubator/activemq/site/www.activemq.org/ Date: Wed, 01 Feb 2006 22:05:30 -0000 To: activemq-commits@geronimo.apache.org From: jstrachan@apache.org X-Mailer: svnmailer-1.0.5 X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N Added: incubator/activemq/site/www.activemq.org/ActiveMQ+3+Transport+Configurations URL: http://svn.apache.org/viewcvs/incubator/activemq/site/www.activemq.org/ActiveMQ%2B3%2BTransport%2BConfigurations?rev=374192&view=auto ============================================================================== --- incubator/activemq/site/www.activemq.org/ActiveMQ+3+Transport+Configurations (added) +++ incubator/activemq/site/www.activemq.org/ActiveMQ+3+Transport+Configurations Wed Feb 1 14:05:20 2006 @@ -0,0 +1,434 @@ + + + + + + + + ActiveMQ - ActiveMQ 3 Transport Configurations + + + + + + + + + + + + + + + +
+ + + + + + +
+

Overview

+ +

Community

+ +

Using ActiveMQ

+ +

Features

+ +

Connectivitiy

+ +

Utilities

+ +

External Tools

+ +

Related Projects

+ +

Support

+ +

Developers

+ +

Tools we use

 + +

Feeds

+ + + + + + + + + +
+
+ 		+ Site +
+ + + News +
+ 		+ +
+ + + + + +
+ ActiveMQ 3 Transport Configurations + + +
+
+ + +
+
+

Some of the transports support configuration, such as timeout values, maximum retry count and so forth. To configure the transports you can use the URI query syntax. e.g.

+

+

+ 
tcp://foo:1234?asyncSend=true&socketBufferSize=10000
+
+

+

If you are using a list of URLs like above with the list and reliable protocols you can wrap the list in parens to be able to configure the list. e.g.

+

+

+ 
reliable:(tcp://foo:61699,tcp://bar:61617,tcp://whatnot:61698)?maximumRetries=0
+
+

+

Generic configuration options

+

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Option NameDefault ValueType
brokerXmlConfignullString
cachingEnabledtrueboolean
clientIDnullString
copyMessageOnSendtrueboolean
disableTimeStampsByDefaultfalseboolean
doMessageCompressiontrueboolean
doMessageFragmentationtrueboolean
messageCompressionLimit32768int
messageCompressionStrategy0int
messageFragmentationLimit65536int
optimizedMessageDispatchfalseboolean
passwordnullString
prepareMessageBodyOnSendtrueboolean
turboBoosttrueboolean
useAsyncSendtrueboolean
useEmbeddedBrokerfalseboolean
userNamenullString
wireFormatdefaultString
noDelayfalseboolean
+

+

brokerXmlConfig

+

Sets the Xml Configuration file used to configure the ActiveMQ broker via Spring if using embedded mode. The filename is assumed to be on the classpath unless a URL is specified. So a value of

+

+

+ 
foo/bar.xml
+
would be assumed to be on the classpath whereas
+ 
file:dir/file.xml
+
would use the file system. Any valid URL string is supported.

+

cachingEnabled

+

Provides optimisations on the wire format (caching data at each end and using references to it to minmise the message size

+

clientID

+

Used to set the JMS clientID of connection.

+

copyMessageOnSend

+

Use to avoid the overhead of doing a deep copy of the JMS message everytime the message is sent.

+

disableTimeStampsByDefault

+

Use to avoid the overhead of setting a timestamp on each message produced.

+

doMessageCompression

+

If messages should be compressed.

+

doMessageFragmentation

+

If messages should be chunked into smaller fragments on the clients side.

+

messageCompressionLimit

+

Data size above which compression will be used

+

messageCompressionStrategy

+

The compression strategy to use when compressing messages. Defaults to the value of java.util.zip.Deflater.DEFAULT_STRATEGY (0).

+

messageFragmentationLimit

+

Data size above which message fragmentation will be used

+

optimizedMessageDispatch

+

password

+

The user password used to authenticate with the broker.

+

prepareMessageBodyOnSend

+

Causes pre-serialization of messages before send.

+

turboBoost

+

Enables a number of performance enhancements which are disabled by default to ensure J2EE certification. turboBoost turns on a bunch of optimisations: disableTimeStampsByDefault, useAsyncSend, cachingEnabled, and optimizedMessageDispatch and then disables copyMessageOnSend and prepareMessageBodyOnSend

+

useAsyncSend

+

Used to enable asynchronous sending, which boost performance by using another thread to handle sending of messages to the socket.

+

useEmbeddedBroker

+

Set to true if you want start an embeded broker when the first connection is created.

+

userName

+

The user name used to authenticate with the broker.

+

wireFormat

+

Allows a custom wire format to be used; otherwise the default Java wire format is used which is designed for minimum size and maximum speed on the Java platform.

+

noDelay

+

Used to indicate whether messages are dispatched as quickly as possible or not. (The latency versus throughput trade off). When using TCP based transport this option is a means of disabling Nagles which can often improve performance on synchronous sends.

+

TCP configuration options

+
    +
  • soTimeout (long) sets the SO_TIMEOUT value (in milliseconds) on the socket
    • +
  • socketBufferSize (int) the size of the buffer size on the socket
    • +
+

SSL configuration options

+

Same as TCP. SSL certificates are configured at the VM level. See How do I use SSL

+

List configuration options

+
    +
  • maximumRetries (int) the maximum number of times that this protocol will attempt to make a connection on a failure before giving up completely and throwing an exception up to the JMS client. Set this value to zero (or -1) to force an infinite reconnection loop. Warning: setting an infinite reconnection loop could hang your JMS client program indefinitely.
    • +
+
    +
  • failureSleepTime (long) the amout of time that the transport will sleep before trying to reconnect again
    • +
+
    +
  • establishConnectionTimeout (long) the timeout value for which a connection must start by on connection start - otherwise the start connection will fail
    • +
+
    +
  • incrementTimeout (boolean) should the timeout increase, exponentially as connection attempts are made
    • +
+
    +
  • maximumTimeout (long) the maximum timeout value that it should increase to (if enabled)
    • +
+

Reliable and Remote configuration options

+

Same as the List configuration options above - plus

+
    +
  • keepAliveTimeout (long) the amount of time without receiving a keep alive ping before the connection is considered dead.
    • +
+

Peer configuration options

+
    +
  • discoveryURI (string) the URI used to discover find other nodes; which defaults to using multicast discovery
    • +
+
    +
  • remoteUserName, removePassword (string) the optional login/password to connect to the remote brokers with
    • +
+
    +
  • peerURIs (string) the hard coded URIs of peers to connect to
    • +
+

Discovery configuration options

+
    +
  • channelName (string) provides a way to separate out different logical groups of nodes in the cluster
    • +
+

Multicast configuration options

+
    +
  • timeToLive (int) defaults to 1 so we don't send multicast messages beyond our own local subnet.
    • +
+
    +
  • loopbackMode (boolean) defaults to false so we don't see our own messages
    • +
+
+
+ +   +