qpid-config.xml

You use the file <MB_HOME>/repository/conf/advanced/qpid-config.xml to configure WSO2 Message Broker. Following is a tree of the XML elements in the file:  

<broker>
    <prefix>
    <work>
    <conf>
    <plugin-directory>
    <cache-directory>   
    <connector>
        <ssl>
            <enabled>
            <sslOnly>
            <keystorePath>
            <keystorePassword>
        <qpidnio>
        <protectio>
            <enabled>
            <readBufferLimitSize>
            <writeBufferLimitSize>    
        <transport>
        <port>
        <sslport>
        <socketReceiveBuffer>
        <socketSendBuffer>
    <management>
        <enabled>
        <jmxport>
        <ssl>
            <enabled>
            <keyStorePath>
            <keyStorePassword>
    <advanced>
        <filterchain>
        <enablePooledAllocator>
        <enableDirectBuffers>
        <framesize>
        <compressBufferOnQueue>
        <enableJMSXUserID>
        <locale>
    <security>
       <pd-auth-manager>
            <principal-database>             
                <class>
                <attributes>
                    <attribute>
                        <name>
                        <value>
       <msg-auth>
    <virtualhosts>   
    <heartbeat>
        <delay>
        <timeoutFactor>
    <queue>
        <auto_register>
        <viewMessageCounts>
    <status-updates>
    <clustering>
        <enabled>       
        <OnceInOrderSupportEnabled>
        <externalCassandraServerRequired>
        <externalZookeeperServerRequired>
        <coordination>
            <ZooKeeperConnection>
            <ReferenceTime>
        <tuning>
            <messageBatchSizes>
                <maxNumberOfUnackedMessages>
                <maxNumberOfReadButUndeliveredMessages>
                <messageBatchSizeForSubscribersQueues>
                <messageBatchSizeForSubscribers>
                <globalQueueWorkerMessageBatchSize>
                <contentPublisherMessageBatchSize>
                <medataDatePublisherMessageBatchSize>
                <messageBatchSizeForBrowserSubscriptions>
            <threading>
                <flusherPoolSize>
                <subscriptionPoolSize>
                <internalSequentialThreadPoolSize>
                <andesInternalParallelThreadPoolSize>
                <publisherPoolSize> 
           <waitTimes>
                <maxAckWaitTime>
                <queueMsgDeliveryCurserResetTimeInterval>
                <maxAckWaitTimeForBatch>
                <queueWorkerInterval>
                <pubSubMessageRemovalTaskInterval>
                <contentRemovalTaskInterval>
                <contentRemovalTimeDifference>
                <topicPublisherTaskInterval>
                <virtualHostSyncTaskInterval> 
           <maximumNumberOfMessageDeliveryAttempts>         

Click an element below for more information about that element.

<broker>

This is the top level element of qpid-config.xml file. It contains all the other elements needed to configure WSO Message Broker. The setting of the prefixes for QPID_HOME and QPID_WORK allows environment variables to be used throughout the config.xml and removes the need for hard coding of paths in this file.

Configurable Sub Elements

<connector>

Defines connection parameters.

Configurable Sub Elements

<ssl>

This comes under <connector>. SSL section allows configuration of SSL and related keystore settings. By default SSL is enabled with default parameters. If sslOnly is set to 'true' Non-SSL port will be disabled.

Configurable Sub Elements

<management> 

This configuration option is there for managing JMX console. 

Configurable Sub Elements

<advanced>

The elements in this section are used under the covers in the broker. At present, we do not recommend any changes to these settings.

Configurable Sub Elements

Back to Top ^

<security>

The security section specifies exactly one authentication manager (responsible for determining that a user's credentials are correct) and zero or more access plugins (limits what the user may and may not do). No configuration change is needed here.

<virtualhosts>

This element allows you to specify a location for the virtualhosts.xml file that you wish to use. If you are not using a subdirectory under $QPID_HOME you can provide a fully qualified path instead. For more information on the content of the virtualhosts.xml file please see 

<heartbeat>

The Qpid broker sends an internal (only) heartbeat. This element allows configuration of the frequency of this heartbeat. It is needed to configure a proper delay for the heartbeat value if the connections are going to stay idle for a long time.All configurations related to this is described here.

Configurable Sub Elements

<queue>

This should NOT be changed lightly as it sets the broker up to automatically bind queues to exchanges. It could theoretically be used to prevent users creating new queues at runtime, assuming that you have created all queues/topics etc at broker startup. However, best advice is to leave unchanged for now. Enabling the <viewMessageCounts> element in this section will directly effect to broker performance hence make it 'true' only if a performance degrade is acceptable.

Configurable Sub Elements

<tuning>

 Under this tag all tuning parameters for WSO2 Message Broker is defined. Threading wait times, Thread pool sizes, Message batch sizes can be configured to suit the memory availability and the performance expected. There is a balance between performance, reliability, and the resources in hand.

Configurable Sub Elements

<clustering>

WSO2 Message Broker can be clustered to meet scalability requirements. There are a few clustering patterns supported by WSO2 MB with Cassandra and Zookeeper servers are also clustered. See Clustered Deployment for more information.  

Configurable Sub Elements

<messageBatchSizes>

This configuration is found under <tuning>. In Broker operations at various places messages are read or written, either to memory or to Cassandra Database. In order to handle performance and to cope with the memory requirements, it might be required to configure sizes of message batches that should be handled. 

Configurable Sub Elements

<threading>

Configurations to define thread pool sizes for WSO2 Message Broker

Configurable Sub Elements

<waitTimes> 

These are time based configurations for WSO2 Message Broker. 

Configurable Sub Elements

Back to Top ^