Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Add deprecation warning
Info

This page is no longer maintained. For the master copy of this documentation refer to the Configuring And Managing and the Virtual Host XML sections of the Java broker book

virtualhosts.xml Overview

...

I have also added some inline comments on each section, which should give some extra information on the purpose of the various elements.

No Format


<virtualhosts>
    <!-- Sets the default virtual host for connections which do not specify a vh -->
    <default>localhost</default>
    <!-- Define a virtual host and all it's config -->
    <virtualhost>
        <name>localhost</name>
        <localhost>    
            <!-- Define the types of additional AMQP exchange available for this vh -->   
            <!-- Always get amq.direct (for queues) and amq.topic (for topics) by default -->     
            <exchanges>
                <!-- Example of declaring an additional exchanges type for developer use only -->
                <exchange>
                    <type>direct</type>
                    <name>test.direct</name>
                    <durable>true</durable>
                </exchange>
            </exchanges>
             
            <!-- Define the set of queues to be created at broker startup -->
            <queues>
                <!-- The properties configured here will be applied as defaults to all -->
                <!-- queues subsequently defined unless explicitly overridden -->
                <exchange>amq.direct</exchange>
                <!-- Set threshold values for queue monitor alerting to log --> 
                <maximumQueueDepth>4235264</maximumQueueDepth>  <!-- 4Mb -->
                <maximumMessageSize>2117632</maximumMessageSize> <!-- 2Mb -->
                <maximumMessageAge>600000</maximumMessageAge>  <!-- 10 mins -->
                <!-- Minimum length of time that must elapse between alerts -->
                <minimumAlertRepeatGap>60000</minimumAlertRepeatGap>    <!-- 60 secs -->

                <!-- Define a queue with all default settings -->   
                <queue>
                    <name>ping</name>
                </queue>
                <!-- Example definitions of queues with overriden settings -->
                <queue>
                    <name>test-queue</name>
                    <test-queue>
                        <exchange>test.direct</exchange>
                        <durable>true</durable>
                    </test-queue>
                </queue>
                <queue>
                    <name>test-ping</name>
                    <test-ping>
                        <exchange>test.direct</exchange>
                    </test-ping>
                </queue>
            </queues>
        </localhost>
    </virtualhost>
</virtualhosts>

...