You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@activemq.apache.org by cl...@apache.org on 2017/09/14 19:48:13 UTC

svn commit: r1018163 [6/45] - in /websites/production/activemq/content/artemis/docs: 2.2.0/ latest/ latest/diagrams/ latest/gitbook/ latest/gitbook/fonts/ latest/gitbook/fonts/fontawesome/ latest/gitbook/gitbook-plugin-fontsettings/ latest/gitbook/gitb...

Added: websites/production/activemq/content/artemis/docs/latest/config-reload.html
==============================================================================
--- websites/production/activemq/content/artemis/docs/latest/config-reload.html (added)
+++ websites/production/activemq/content/artemis/docs/latest/config-reload.html Thu Sep 14 19:48:11 2017
@@ -0,0 +1,1700 @@
+
+<!DOCTYPE HTML>
+<html lang="" >
+    <head>
+        <title>Configuration Reload · ActiveMQ Artemis Documentation</title>
+        <meta charset="UTF-8">
+        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+        <meta name="description" content="">
+        <meta name="generator" content="GitBook 3.1.1">
+        
+        
+        
+    
+    <link rel="stylesheet" href="gitbook/style.css">
+
+    
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
+                
+            
+                
+                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
+                
+            
+        
+
+    
+
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+        
+    
+
+        
+    
+    
+    <meta name="HandheldFriendly" content="true"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
+    <meta name="apple-mobile-web-app-capable" content="yes">
+    <meta name="apple-mobile-web-app-status-bar-style" content="black">
+    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
+    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">
+
+    
+    <link rel="next" href="connection-ttl.html" />
+    
+    
+    <link rel="prev" href="configuring-transports.html" />
+    
+
+    </head>
+    <body>
+        
+<div class="book">
+    <div class="book-summary">
+        
+            
+<div id="book-search-input" role="search">
+    <input type="text" placeholder="Type to search" />
+</div>
+
+            
+                <nav role="navigation">
+                
+
+
+<ul class="summary">
+    
+    
+
+    
+
+    
+        
+        
+    
+        <li class="chapter " data-level="1.1" data-path="./">
+            
+                <a href="./">
+            
+                    
+                    Introduction
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.2" data-path="notice.html">
+            
+                <a href="notice.html">
+            
+                    
+                    Legal Notice
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.3" data-path="preface.html">
+            
+                <a href="preface.html">
+            
+                    
+                    Preface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.4" data-path="project-info.html">
+            
+                <a href="project-info.html">
+            
+                    
+                    Project Info
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.5" data-path="messaging-concepts.html">
+            
+                <a href="messaging-concepts.html">
+            
+                    
+                    Messaging Concepts
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.6" data-path="architecture.html">
+            
+                <a href="architecture.html">
+            
+                    
+                    Architecture
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.7" data-path="using-server.html">
+            
+                <a href="using-server.html">
+            
+                    
+                    Using the Server
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.8" data-path="address-model.html">
+            
+                <a href="address-model.html">
+            
+                    
+                    Address Model
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.9" data-path="using-jms.html">
+            
+                <a href="using-jms.html">
+            
+                    
+                    Using JMS
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.10" data-path="using-core.html">
+            
+                <a href="using-core.html">
+            
+                    
+                    Using Core
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.11" data-path="using-AMQP.html">
+            
+                <a href="using-AMQP.html">
+            
+                    
+                    Using AMQP
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.12" data-path="jms-core-mapping.html">
+            
+                <a href="jms-core-mapping.html">
+            
+                    
+                    Mapping JMS Concepts to the Core API
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.13" data-path="client-classpath.html">
+            
+                <a href="client-classpath.html">
+            
+                    
+                    The Client Classpath
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.14" data-path="examples.html">
+            
+                <a href="examples.html">
+            
+                    
+                    Examples
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.15" data-path="wildcard-routing.html">
+            
+                <a href="wildcard-routing.html">
+            
+                    
+                    Routing Messages With Wild Cards
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.16" data-path="wildcard-syntax.html">
+            
+                <a href="wildcard-syntax.html">
+            
+                    
+                    Understanding the Apache ActiveMQ Artemis Wildcard Syntax
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.17" data-path="filter-expressions.html">
+            
+                <a href="filter-expressions.html">
+            
+                    
+                    Filter Expressions
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.18" data-path="persistence.html">
+            
+                <a href="persistence.html">
+            
+                    
+                    Persistence
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.19" data-path="configuring-transports.html">
+            
+                <a href="configuring-transports.html">
+            
+                    
+                    Configuring Transports
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter active" data-level="1.20" data-path="config-reload.html">
+            
+                <a href="config-reload.html">
+            
+                    
+                    Configuration Reload
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.21" data-path="connection-ttl.html">
+            
+                <a href="connection-ttl.html">
+            
+                    
+                    Detecting Dead Connections
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.22" data-path="slow-consumers.html">
+            
+                <a href="slow-consumers.html">
+            
+                    
+                    Detecting Slow Consumers
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.23" data-path="network-isolation.html">
+            
+                <a href="network-isolation.html">
+            
+                    
+                    Avoiding Network Isolation
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.24" data-path="critical-analysis.html">
+            
+                <a href="critical-analysis.html">
+            
+                    
+                    Detecting Broker Issues (Critical Analysis)
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.25" data-path="transaction-config.html">
+            
+                <a href="transaction-config.html">
+            
+                    
+                    Resource Manager Configuration
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.26" data-path="flow-control.html">
+            
+                <a href="flow-control.html">
+            
+                    
+                    Flow Control
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.27" data-path="send-guarantees.html">
+            
+                <a href="send-guarantees.html">
+            
+                    
+                    Guarantees of sends and commits
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.28" data-path="undelivered-messages.html">
+            
+                <a href="undelivered-messages.html">
+            
+                    
+                    Message Redelivery and Undelivered Messages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.29" data-path="message-expiry.html">
+            
+                <a href="message-expiry.html">
+            
+                    
+                    Message Expiry
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.30" data-path="large-messages.html">
+            
+                <a href="large-messages.html">
+            
+                    
+                    Large Messages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.31" data-path="paging.html">
+            
+                <a href="paging.html">
+            
+                    
+                    Paging
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.32" data-path="queue-attributes.html">
+            
+                <a href="queue-attributes.html">
+            
+                    
+                    Queue Attributes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.33" data-path="scheduled-messages.html">
+            
+                <a href="scheduled-messages.html">
+            
+                    
+                    Scheduled Messages
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.34" data-path="last-value-queues.html">
+            
+                <a href="last-value-queues.html">
+            
+                    
+                    Last-Value Queues
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.35" data-path="message-grouping.html">
+            
+                <a href="message-grouping.html">
+            
+                    
+                    Message Grouping
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.36" data-path="pre-acknowledge.html">
+            
+                <a href="pre-acknowledge.html">
+            
+                    
+                    Extra Acknowledge Modes
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.37" data-path="management.html">
+            
+                <a href="management.html">
+            
+                    
+                    Management
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.38" data-path="management-console.html">
+            
+                <a href="management-console.html">
+            
+                    
+                    Management Console
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.39" data-path="security.html">
+            
+                <a href="security.html">
+            
+                    
+                    Security
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.40" data-path="broker-plugins.html">
+            
+                <a href="broker-plugins.html">
+            
+                    
+                    Broker Plugins
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.41" data-path="resource-limits.html">
+            
+                <a href="resource-limits.html">
+            
+                    
+                    Resource Limits
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.42" data-path="jms-bridge.html">
+            
+                <a href="jms-bridge.html">
+            
+                    
+                    The JMS Bridge
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.43" data-path="client-reconnection.html">
+            
+                <a href="client-reconnection.html">
+            
+                    
+                    Client Reconnection and Session Reattachment
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.44" data-path="diverts.html">
+            
+                <a href="diverts.html">
+            
+                    
+                    Diverting and Splitting Message Flows
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.45" data-path="core-bridges.html">
+            
+                <a href="core-bridges.html">
+            
+                    
+                    Core Bridges
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.46" data-path="duplicate-detection.html">
+            
+                <a href="duplicate-detection.html">
+            
+                    
+                    Duplicate Message Detection
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.47" data-path="clusters.html">
+            
+                <a href="clusters.html">
+            
+                    
+                    Clusters
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.48" data-path="ha.html">
+            
+                <a href="ha.html">
+            
+                    
+                    High Availability and Failover
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.49" data-path="graceful-shutdown.html">
+            
+                <a href="graceful-shutdown.html">
+            
+                    
+                    Graceful Server Shutdown
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.50" data-path="libaio.html">
+            
+                <a href="libaio.html">
+            
+                    
+                    Libaio Native Libraries
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.51" data-path="thread-pooling.html">
+            
+                <a href="thread-pooling.html">
+            
+                    
+                    Thread management
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.52" data-path="logging.html">
+            
+                <a href="logging.html">
+            
+                    
+                    Logging
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.53" data-path="rest.html">
+            
+                <a href="rest.html">
+            
+                    
+                    REST Interface
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.54" data-path="embedding-activemq.html">
+            
+                <a href="embedding-activemq.html">
+            
+                    
+                    Embedding Apache ActiveMQ Artemis
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.55" data-path="karaf.html">
+            
+                <a href="karaf.html">
+            
+                    
+                    Apache Karaf
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.56" data-path="spring-integration.html">
+            
+                <a href="spring-integration.html">
+            
+                    
+                    Spring Integration
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.57" data-path="cdi-integration.html">
+            
+                <a href="cdi-integration.html">
+            
+                    
+                    CDI Integration
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.58" data-path="intercepting-operations.html">
+            
+                <a href="intercepting-operations.html">
+            
+                    
+                    Intercepting Operations
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.59" data-path="protocols-interoperability.html">
+            
+                <a href="protocols-interoperability.html">
+            
+                    
+                    Protocols and Interoperability
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.60" data-path="tools.html">
+            
+                <a href="tools.html">
+            
+                    
+                    Tools
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.61" data-path="maven-plugin.html">
+            
+                <a href="maven-plugin.html">
+            
+                    
+                    Maven Plugin
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.62" data-path="unit-testing.html">
+            
+                <a href="unit-testing.html">
+            
+                    
+                    Unit Testing
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.63" data-path="perf-tuning.html">
+            
+                <a href="perf-tuning.html">
+            
+                    
+                    Troubleshooting and Performance Tuning
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.64" data-path="configuration-index.html">
+            
+                <a href="configuration-index.html">
+            
+                    
+                    Configuration Reference
+            
+                </a>
+            
+
+            
+        </li>
+    
+        <li class="chapter " data-level="1.65" data-path="updating-artemis.html">
+            
+                <a href="updating-artemis.html">
+            
+                    
+                    Updating Artemis
+            
+                </a>
+            
+
+            
+        </li>
+    
+
+    
+
+    <li class="divider"></li>
+
+    <li>
+        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
+            Published with GitBook
+        </a>
+    </li>
+</ul>
+
+
+                </nav>
+            
+        
+    </div>
+
+    <div class="book-body">
+        
+            <div class="body-inner">
+                
+                    
+
+<div class="book-header" role="navigation">
+    
+
+    <!-- Title -->
+    <h1>
+        <i class="fa fa-circle-o-notch fa-spin"></i>
+        <a href="." >Configuration Reload</a>
+    </h1>
+</div>
+
+
+
+
+                    <div class="page-wrapper" tabindex="-1" role="main">
+                        <div class="page-inner">
+                            
+<div id="book-search-results">
+    <div class="search-noresults">
+    
+                                <section class="normal markdown-section">
+                                
+                                <h1 id="configuration-reload">Configuration Reload</h1>
+<p>The system will perform a periodic check on the configuration files, configured by <code>configuration-file-refresh-period</code>, with the default at 5000, in milliseconds.</p>
+<p>Once the configuration file is changed (broker.xml) the following modules will be reloaded automatically:</p>
+<ul>
+<li>Address Settings</li>
+<li>Security Settings</li>
+<li>Diverts</li>
+<li>Addresses &amp; queues</li>
+</ul>
+<p>Notice: </p>
+<p>Deletion of Address&apos;s and Queue&apos;s, not auto created is controlled by Address Settings</p>
+<ul>
+<li><p>config-delete-addresses</p>
+<ul>
+<li>OFF (DEFAULT) - will not remove upon config reload.</li>
+<li>FORCE - will remove the address and its queues upon config reload, even if messages remains, losing the messages in the address &amp; queues.</li>
+</ul>
+</li>
+<li><p>config-delete-queues</p>
+<ul>
+<li>OFF (DEFAULT) - will not remove upon config reload.</li>
+<li>FORCE - will remove the queue upon config reload, even if messages remains, losing the messages in the queue.</li>
+</ul>
+</li>
+</ul>
+<p>By default both settings are OFF as such address &amp; queues won&apos;t be removed upon reload, given the risk of losing messages. </p>
+<p>When OFF You may execute explicit CLI or Management operations to remove address &amp; queues.</p>
+<h2 id="configuration-parameters-that-are-reloaded-at-runtime">Configuration Parameters that are reloaded at runtime</h2>
+<p>The broker configuration file has 2 main parts, <code>&lt;core&gt;</code> and <code>&lt;jms&gt;</code>. Some of the parameters in the 2 parts are monitored and, 
+if modified, reloaded into the broker at runtime.</p>
+<p>Please note that elements under <code>&lt;jms&gt;</code> are deprecated. Users are encouraged to use <code>&lt;core&gt;</code> configuration entities.</p>
+<blockquote>
+<p><em>Note:</em>
+Most parameters reloaded take effect immediately after reloading. However there are some 
+that won&#x2019;t take any effect unless you restarting the broker.
+Such parameters are specifically indicated in the following text.</p>
+</blockquote>
+<h3 id="parameters-in-core-that-can-be-reloaded-at-runtime">Parameters in <code>&lt;core&gt;</code> that can be reloaded at runtime</h3>
+<h4 id="parameters-under-security-settings">Parameters under <code>&lt;security-settings&gt;</code></h4>
+<ul>
+<li><code>&lt;security-setting&gt;</code> element</li>
+</ul>
+<p>Changes to any <security-setting> elements will be reloaded. Each <security-setting> defines security roles for a matched address. </security-setting></security-setting></p>
+<ul>
+<li><p>The <code>match</code> attribute</p>
+<p>This attribute defines the address for which the security-setting is defined. It can take wildcards such as &#x2018;#&#x2019; and &#x2018;*&#x2019;.  </p>
+</li>
+<li><p>The <code>&lt;permission&gt;</code> sub-elements</p>
+<p>Each <code>&lt;security-setting&gt;</code> can have a list of <code>&lt;permission&gt;</code> elements, each of which defines a specific permission-roles mapping. 
+Each permission has 2 attributes &#x2018;type&#x2019; and &#x2018;roles&#x2019;. The &#x2018;type&#x2019; attribute defines the type of operation allowed, the &#x2018;roles&#x2019; 
+defines which roles are allowed to perform such operation. Refer to the user&#x2019;s manual for a list of operations that can be defined.</p>
+</li>
+</ul>
+<blockquote>
+<p><em>Note:</em>
+Once loaded the security-settings will take effect immediately. Any new clients will subject
+to the new security settings. Any existing clients will subject to the new settings as well, as soon as they performs
+a new security-sensitive operation.</p>
+</blockquote>
+<p>Below lists the effects of adding, deleting and updating of an element/attribute within the <code>&lt;security-settings&gt;</code> element, whether
+an change can be done or can&#x2019;t be done.</p>
+<table>
+<thead>
+<tr>
+<th style="text-align:left">Operation</th>
+<th style="text-align:left">Add</th>
+<th style="text-align:left">Delete</th>
+<th style="text-align:left">Update</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td style="text-align:left"><code>&lt;security-settings&gt;</code></td>
+<td style="text-align:left">X* (at most one element is allowed)</td>
+<td style="text-align:left">Deleting it means delete the whole security settings from the running broker.</td>
+<td style="text-align:left">N/A*</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;security-setting&gt;</code></td>
+<td style="text-align:left">Adding one element means adding a new set of security roles for an address in the running broker</td>
+<td style="text-align:left">Deleting one element means removing a set of security roles for an address in the running broker</td>
+<td style="text-align:left">Updating one element means updating the security roles for an address (if match attribute is not changed), or means removing the old match address settings and adding a new one (if match attribute is changed)</td>
+</tr>
+<tr>
+<td style="text-align:left">attribute <code>match</code></td>
+<td style="text-align:left">N/A*</td>
+<td style="text-align:left">X*</td>
+<td style="text-align:left">Changing this value is same as deleting the whole <security-setting> with the old match value and adding</security-setting></td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;permission&gt;</code></td>
+<td style="text-align:left">Adding one means adding  a new permission definition to runtime broker</td>
+<td style="text-align:left">Deleting a permission from the runtime broker</td>
+<td style="text-align:left">Updating a permission-roles in the runtime broker</td>
+</tr>
+<tr>
+<td style="text-align:left">attribute <code>type</code></td>
+<td style="text-align:left">N/A*</td>
+<td style="text-align:left">X*</td>
+<td style="text-align:left">Changing the type value means remove the permission of the old one and add the permission of this type to the running broker.</td>
+</tr>
+<tr>
+<td style="text-align:left">attribute <code>roles</code></td>
+<td style="text-align:left">N/A*</td>
+<td style="text-align:left">X*</td>
+<td style="text-align:left">Changing the &#x2018;roles&#x2019; value means updating the permission&#x2019;s allowed roles to the running broker</td>
+</tr>
+</tbody>
+</table>
+<blockquote>
+<ul>
+<li><code>N/A</code> means this operation is not applicable.</li>
+<li><code>X</code> means this operation is not allowed.</li>
+</ul>
+</blockquote>
+<h4 id="parameters-under-address-settings">Parameters under <code>&lt;address-settings&gt;</code></h4>
+<ul>
+<li><code>&lt;address-settings&gt;</code> element</li>
+</ul>
+<p>Changes to elements under <code>&lt;address-settings&gt;</code> will be reloaded into runtime broker. It contains a list of <code>&lt;address-setting&gt;</code> elements.</p>
+<ul>
+<li><p><code>&lt;address-setting&gt;</code> element</p>
+<p>Each address-setting element has a &#x2018;match&#x2019; attribute that defines an address pattern for which this address-setting is defined. It also has a list of sub-elements used to define the properties of a matching address.</p>
+<blockquote>
+<p><em>Note:</em>
+Parameters reloaded in this category will take effect immediately after reloading. The effect of deletion of Address&apos;s and Queue&apos;s, 
+not auto created is controlled by parameter <code>config-delete-addresses</code> and <code>config-delete-queues</code> as described in the doc.</p>
+</blockquote>
+</li>
+</ul>
+<p>Below lists the effects of adding, deleting and updating of an element/attribute within the address-settings element, whether an change 
+can be done or can&#x2019;t be done.</p>
+<table>
+<thead>
+<tr>
+<th style="text-align:left">Operation</th>
+<th style="text-align:left">Add</th>
+<th style="text-align:left">Delete</th>
+<th style="text-align:left">Update</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td style="text-align:left"><code>&lt;address-settings&gt;</code></td>
+<td style="text-align:left">X(at most one element is allowed)</td>
+<td style="text-align:left">Deleting it means delete the whole address settings from the running broker</td>
+<td style="text-align:left">N/A</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;address-setting&gt;</code></td>
+<td style="text-align:left">Adding one element means adding a set of address-setting for a new address in the running broker</td>
+<td style="text-align:left">Deleting one  means removing a set of address-setting for an address in the running broker</td>
+<td style="text-align:left">Updating one element means updating the address setting for an address (if match attribute is not changed), or means removing the old match address settings and adding a new one (if match attribute is changed)</td>
+</tr>
+<tr>
+<td style="text-align:left">attribute <code>match</code></td>
+<td style="text-align:left">N/A</td>
+<td style="text-align:left">X</td>
+<td style="text-align:left">Changing this value is same as deleting the whole <address-setting> with the old match value and adding a new one with the new match value.</address-setting></td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;dead-letter-address&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">Removing the configured dead-letter-address address from running broker.</td>
+<td style="text-align:left">The dead letter address of the matching address will be updated after reloading</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;expiry-address&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">Removing the configured expiry address from running broker.</td>
+<td style="text-align:left">The expiry address of the matching address will be updated after reloading</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;expiry-delay&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured expiry-delay will be removed from running broker.</td>
+<td style="text-align:left">The expiry-delay for the matching address will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;redelivery-delay&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured redelivery-delay will be removed from running broker after reloading</td>
+<td style="text-align:left">The redelivery-delay for the matchin address will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;redelivery-delay-multiplier&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured redelivery-delay-multiplier will be removed from running broker after reloading.</td>
+<td style="text-align:left">The redelivery-delay-multiplier will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;max-redelivery-delay&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured max-redelivery-delay will be removed from running broker after reloading.</td>
+<td style="text-align:left">The max-redelivery-delay will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;max-delivery-attempts&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured max-delivery-attempts will be removed from running broker after reloading.</td>
+<td style="text-align:left">The max-delivery-attempts will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;max-size-bytes&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured max-size-bytes will be removed from running broker after reloading.</td>
+<td style="text-align:left">The max-size-bytes will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;page-size-bytes&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured page-size-bytes will be removed from running broker after reloading.</td>
+<td style="text-align:left">The page-size-bytes will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;page-max-cache-size&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured page-max-cache-size will be removed from running broker after reloading.</td>
+<td style="text-align:left">The page-max-cache-size will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;address-full-policy&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured address-full-policy will be removed from running broker after reloading.</td>
+<td style="text-align:left">The address-full-policy will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;message-counter-history-day-limit&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured message-counter-history-day-limit will be removed from running broker after reloading.</td>
+<td style="text-align:left">The message-counter-history-day-limit will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;last-value-queue&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured last-value-queue will be removed from running broker after reloading (no longer a last value queue).</td>
+<td style="text-align:left">The last-value-queue will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;redistribution-delay&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured redistribution-delay will be removed from running broker after reloading.</td>
+<td style="text-align:left">The redistribution-delay will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;send-to-dla-on-no-route&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured send-to-dla-on-no-route will be removed from running broker after reloading.</td>
+<td style="text-align:left">The send-to-dla-on-no-route will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;slow-consumer-threshold&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured slow-consumer-threshold will be removed from running broker after reloading.</td>
+<td style="text-align:left">The slow-consumer-threshold will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;slow-consumer-policy&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured slow-consumer-policy will be removed from running broker after reloading.</td>
+<td style="text-align:left">The slow-consumer-policy will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;slow-consumer-check-period&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured slow-consumer-check-period will be removed from running broker after reloading. (meaning the slow consumer checker thread will be cancelled)</td>
+<td style="text-align:left">The slow-consumer-check-period will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;auto-create-queues&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured auto-create-queues will be removed from running broker after reloading.</td>
+<td style="text-align:left">The auto-create-queues will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;auto-delete-queues&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured auto-delete-queues will be removed from running broker after reloading.</td>
+<td style="text-align:left">The auto-delete-queues will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;config-delete-queues&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured config-delete-queues will be removed from running broker after reloading.</td>
+<td style="text-align:left">The config-delete-queues will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;auto-create-addresses&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured auto-create-addresses will be removed from running broker after reloading.</td>
+<td style="text-align:left">The auto-create-addresses will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;auto-delete-addresses&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured auto-delete-addresses will be removed from running broker after reloading.</td>
+<td style="text-align:left">The auto-delete-addresses will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;config-delete-addresses&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured config-delete-addresses will be removed from running broker after reloading.</td>
+<td style="text-align:left">The config-delete-addresses will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;management-browse-page-size&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured management-browse-page-size will be removed from running broker after reloading.</td>
+<td style="text-align:left">The management-browse-page-size will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;default-purge-on-no-consumers&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured default-purge-on-no-consumers will be removed from running broker after reloading.</td>
+<td style="text-align:left">The default-purge-on-no-consumers will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;default-max-consumers&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured default-max-consumers will be removed from running broker after reloading.</td>
+<td style="text-align:left">The default-max-consumers will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;default-queue-routing-type&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured default-queue-routing-type will be removed from running broker after reloading.</td>
+<td style="text-align:left">The default-queue-routing-type will be updated after reloading.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;default-address-routing-type&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">The configured default-address-routing-type will be removed from running broker after reloading.</td>
+<td style="text-align:left">The default-address-routing-type will be updated after reloading.</td>
+</tr>
+</tbody>
+</table>
+<h4 id="parameters-under-diverts">Parameters under <code>&lt;diverts&gt;</code></h4>
+<p>All <code>&lt;divert&gt;</code> elements will be reloaded. Each <code>&lt;divert&gt;</code> element 
+has a &#x2018;name&#x2019; and several sub-elements that defines the properties of a divert.</p>
+<blockquote>
+<p><em>Note:</em>
+Reloading <code>&lt;diverts&gt;</code> only resulting in deploying new diverts. Existing diverts 
+won&#x2019;t get undeployed even if you delete a <code>&lt;divert&gt;</code> element. Nor an existing 
+divert will be updated if its element is updated after reloading. 
+To make this happen you need a restart of the broker.</p>
+</blockquote>
+<p>Below lists the effects of adding, deleting and updating of an element/attribute 
+within the diverts element, whether an change can be done or can&#x2019;t be done.</p>
+<table>
+<thead>
+<tr>
+<th style="text-align:left">Operation</th>
+<th style="text-align:left">Add</th>
+<th style="text-align:left">Delete</th>
+<th style="text-align:left">Update</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td style="text-align:left"><code>&lt;diverts&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">Deleting it means delete  (undeploy) all diverts in running broker.</td>
+<td style="text-align:left">N/A</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;divert&gt;</code></td>
+<td style="text-align:left">Adding a new divert. It will be deployed after reloading</td>
+<td style="text-align:left">No effect on the deployed divert.(unless restarting broker, in which case the divert will no longer be deployed)</td>
+<td style="text-align:left">No effect on the deployed divert (unless restarting broker, in which case the divert will be redeployed)</td>
+</tr>
+<tr>
+<td style="text-align:left">attribute <code>name</code></td>
+<td style="text-align:left">N/A</td>
+<td style="text-align:left">X</td>
+<td style="text-align:left">A new divert with the name will be deployed. (if it is not already there in broker). Otherwise no effect.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;transformer-class-name&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">No effect on the deployed divert.(unless restarting broker, in which case the divert will be deployed without the transformer class)</td>
+<td style="text-align:left">No effect on the deployed divert.(unless restarting broker, in which case the divert has the transformer class)</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;exclusive&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">No effect on the deployed divert.(unless restarting broker)</td>
+<td style="text-align:left">No effect on the deployed divert.(unless restarting broker)</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;routing-name&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">No effect on the deployed divert.(unless restarting broker)</td>
+<td style="text-align:left">No effect on the deployed divert.(unless restarting broker)</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;address&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">No effect on the deployed divert.(unless restarting broker)</td>
+<td style="text-align:left">No effect on the deployed divert.(unless restarting broker)</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;forwarding-address&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">No effect on the deployed divert.(unless restarting broker)</td>
+<td style="text-align:left">No effect on the deployed divert.(unless restarting broker)</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;filter&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">No effect on the deployed divert.(unless restarting broker)</td>
+<td style="text-align:left">No effect on the deployed divert.(unless restarting broker)</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;routing-type&gt;</code></td>
+<td style="text-align:left">X (no more than one can be present)</td>
+<td style="text-align:left">No effect on the deployed divert.(unless restarting broker)</td>
+<td style="text-align:left">No effect on the deployed divert.(unless restarting broker)</td>
+</tr>
+</tbody>
+</table>
+<h4 id="parameters-under-addresses">Parameters under <code>&lt;addresses&gt;</code></h4>
+<p>The <code>&lt;addresses&gt;</code> element contains a list <code>&lt;address&gt;</code> elements. Once changed, all <code>&lt;address&gt;</code> elements
+ in <code>&lt;addresses&gt;</code> will be reloaded.</p>
+<blockquote>
+<p><em>Note:</em>
+Once reloaded, all new addresses (as well as the pre-configured queues) will be 
+deployed to the running broker and all those that are missing from the configuration will be undeployed.</p>
+<p><em>Note:</em>
+Parameters reloaded in this category will take effect immediately after reloading. 
+The effect of deletion of Address&apos;s and Queue&apos;s, not auto created is controlled by 
+parameter <code>config-delete-addresses</code> and <code>config-delete-queues</code> as described in this doc.</p>
+</blockquote>
+<p>Below lists the effects of adding, deleting and updating of an element/attribute 
+within the <code>&lt;addresses&gt;</code> element, whether an change can be done or can&#x2019;t be done.</p>
+<table>
+<thead>
+<tr>
+<th style="text-align:left">Operation</th>
+<th style="text-align:left">Add</th>
+<th style="text-align:left">Delete</th>
+<th style="text-align:left">Update</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td style="text-align:left"><code>&lt;addresses&gt;</code></td>
+<td style="text-align:left">X(no more than one is present)</td>
+<td style="text-align:left">Deleting it means delete  (undeploy) all diverts in running broker.</td>
+<td style="text-align:left">N/A</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;address&gt;</code></td>
+<td style="text-align:left">A new address will be deployed in the running broker</td>
+<td style="text-align:left">The corresponding address will be undeployed.</td>
+<td style="text-align:left">N/A</td>
+</tr>
+<tr>
+<td style="text-align:left">attribute <code>name</code></td>
+<td style="text-align:left">N/A</td>
+<td style="text-align:left">X</td>
+<td style="text-align:left">After reloading the address of the old name will be undeployed and the new will be deployed.</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;anycast&gt;</code></td>
+<td style="text-align:left">X(no more than one is present)</td>
+<td style="text-align:left">The anycast routing type will be undeployed from this address, as well as its containing queues after reloading</td>
+<td style="text-align:left">N/A</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;queue&gt;</code>(under <code>&lt;anycast&gt;</code>)</td>
+<td style="text-align:left">A anycast queue will be deployed after reloading</td>
+<td style="text-align:left">The anycast queue will be undeployed</td>
+<td style="text-align:left">For updating queues please see next section <code>&lt;queues&gt;</code></td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;multicast&gt;</code></td>
+<td style="text-align:left">X(no more than one is present)</td>
+<td style="text-align:left">The multicast routing type will be undeployed from this address, as well as its containing queues after reloading</td>
+<td style="text-align:left">N/A</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;queue&gt;</code>(under <code>&lt;multicast&gt;</code>)</td>
+<td style="text-align:left">A multicast queue will be deployed after reloading</td>
+<td style="text-align:left">The multicast queue will be undeployed</td>
+<td style="text-align:left">For updating queues please see next section <code>&lt;queues&gt;</code></td>
+</tr>
+</tbody>
+</table>
+<h4 id="parameters-under-queues">Parameters under <code>&lt;queues&gt;</code></h4>
+<p>The <code>&lt;queues&gt;</code> element contains a list <code>&lt;queue&gt;</code> elements. Once changed, all <code>&lt;queue&gt;</code> elements in <code>&lt;queues&gt;</code> will be reloaded.</p>
+<blockquote>
+<p><em>Note:</em>
+Once reloaded, all new queues will be deployed to the running broker and all 
+queues that are missing from the configuration will be undeployed.
+<em>Note:</em>
+Parameters reloaded in this category will take effect immediately after reloading. 
+The effect of deletion of Address&apos;s and Queue&apos;s, not auto created is controlled by 
+parameter <code>config-delete-addresses</code> and <code>config-delete-queues</code> as described in this doc.</p>
+</blockquote>
+<p>Below lists the effects of adding, deleting and updating of an element/attribute within the <code>&lt;queues&gt;</code> element, 
+and whether an change can be done or can&#x2019;t be done.</p>
+<table>
+<thead>
+<tr>
+<th style="text-align:left">Operation</th>
+<th style="text-align:left">Add</th>
+<th style="text-align:left">Delete</th>
+<th style="text-align:left">Update</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td style="text-align:left"><code>&lt;queues&gt;</code></td>
+<td style="text-align:left">X(no more than one is present)</td>
+<td style="text-align:left">Deleting it means delete  (undeploy) all queues from running broker.</td>
+<td style="text-align:left">N/A</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;queue&gt;</code></td>
+<td style="text-align:left">A new queue is deployed after reloading</td>
+<td style="text-align:left">The queue will be undeployed after reloading.</td>
+<td style="text-align:left">N/A</td>
+</tr>
+<tr>
+<td style="text-align:left">attribute <code>name</code></td>
+<td style="text-align:left">N/A</td>
+<td style="text-align:left">X</td>
+<td style="text-align:left">A queue with new name will be deployed and the queue with old name will be updeployed after reloading (see Note above).</td>
+</tr>
+<tr>
+<td style="text-align:left">attribute <code>max-consumers</code></td>
+<td style="text-align:left">If max-consumers &gt; current consumers max-consumers will update on reload</td>
+<td style="text-align:left">max-consumers will be set back to the default <code>-1</code></td>
+<td style="text-align:left">If max-consumers &gt; current consumers max-consumers will update on reload</td>
+</tr>
+<tr>
+<td style="text-align:left">attribute <code>purge-on-no-consumers</code></td>
+<td style="text-align:left">On reload purge-on-no-consumers will be updated</td>
+<td style="text-align:left">Will be set back to the default <code>false</code></td>
+<td style="text-align:left">On reload purge-on-no-consumers will be updated</td>
+</tr>
+<tr>
+<td style="text-align:left">attribute <code>address</code></td>
+<td style="text-align:left">N/A</td>
+<td style="text-align:left">No effect unless starting broker</td>
+<td style="text-align:left">No effect unless starting broker</td>
+</tr>
+<tr>
+<td style="text-align:left">attribute <code>filter</code></td>
+<td style="text-align:left">N/A</td>
+<td style="text-align:left">No effect unless starting broker</td>
+<td style="text-align:left">No effect unless starting broker</td>
+</tr>
+<tr>
+<td style="text-align:left">attribute <code>durable</code></td>
+<td style="text-align:left">N/A</td>
+<td style="text-align:left">No effect unless starting broker</td>
+<td style="text-align:left">No effect unless starting broker</td>
+</tr>
+</tbody>
+</table>
+<h3 id="parameters-in-jms-that-can-be-reloaded-at-runtime-deprecated">Parameters in <code>&lt;jms&gt;</code> that can be reloaded at runtime <em>(Deprecated)</em></h3>
+<h4 id="the-queue-elements">The <code>&lt;queue&gt;</code> elements</h4>
+<p>Changes to any <code>&lt;queue&gt;</code> elements will be reloaded to the running broker. </p>
+<blockquote>
+<p><em>Note:</em>
+Once reloaded, new queues defined in the new changes will be deployed to the running
+broker. However existing queues won&#x2019;t get undeployed even if the matching element is
+deleted/missing. Also new queue elements matching existing queues won&#x2019;t get re-created &#x2013; they remain unchanged.</p>
+</blockquote>
+<table>
+<thead>
+<tr>
+<th style="text-align:left">Operation</th>
+<th style="text-align:left">Add</th>
+<th style="text-align:left">Delete</th>
+<th style="text-align:left">Update</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td style="text-align:left"><code>&lt;queue&gt;</code></td>
+<td style="text-align:left">A new jms queue will be deployed after reloading</td>
+<td style="text-align:left">No effect unless starting broker</td>
+<td style="text-align:left">No effect unless starting broker</td>
+</tr>
+<tr>
+<td style="text-align:left">attribute <code>&lt;name&gt;</code></td>
+<td style="text-align:left">N/A</td>
+<td style="text-align:left">X</td>
+<td style="text-align:left">A jms queue of the new name will be deployed after reloading</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;selector&gt;</code></td>
+<td style="text-align:left">X(no more than one is present)</td>
+<td style="text-align:left">No effect unless starting broker</td>
+<td style="text-align:left">No effect unless starting broker</td>
+</tr>
+<tr>
+<td style="text-align:left"><code>&lt;durable&gt;</code></td>
+<td style="text-align:left">X(no more than one is present)</td>
+<td style="text-align:left">No effect unless starting broker</td>
+<td style="text-align:left">No effect unless starting broker</td>
+</tr>
+</tbody>
+</table>
+<h4 id="the-topic-elements">The <code>&lt;topic&gt;</code> elements</h4>
+<p>Changes to any <code>&lt;topic&gt;</code> elements will be reloaded to the running broker. </p>
+<blockquote>
+<p><em>Note:</em>
+Once reloaded, new topics defined in the new changes will be deployed to 
+the running broker. However existing topics won&#x2019;t get undeployed even if the 
+matching element is deleted/missing. Also any <code>&lt;topic&gt;</code> elements matching
+existing topics won&#x2019;t get re-deployed &#x2013; they remain unchanged.</p>
+</blockquote>
+<table>
+<thead>
+<tr>
+<th style="text-align:left">Operation</th>
+<th style="text-align:left">Add</th>
+<th style="text-align:left">Delete</th>
+<th style="text-align:left">Update</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td style="text-align:left"><code>&lt;topic&gt;</code></td>
+<td style="text-align:left">A new jms topic will be deployed after reloading</td>
+<td style="text-align:left">No effect unless starting broker</td>
+<td style="text-align:left">No effect unless starting broker</td>
+</tr>
+<tr>
+<td style="text-align:left">attribute <code>name</code></td>
+<td style="text-align:left">N/A</td>
+<td style="text-align:left">X</td>
+<td style="text-align:left">A jms topic of the new name will be deployed after reloading</td>
+</tr>
+</tbody>
+</table>
+
+                                
+                                </section>
+                            
+    </div>
+    <div class="search-results">
+        <div class="has-results">
+            
+            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
+            <ul class="search-results-list"></ul>
+            
+        </div>
+        <div class="no-results">
+            
+            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
+            
+        </div>
+    </div>
+</div>
+
+                        </div>
+                    </div>
+                
+            </div>
+
+            
+                
+                <a href="configuring-transports.html" class="navigation navigation-prev " aria-label="Previous page: Configuring Transports">
+                    <i class="fa fa-angle-left"></i>
+                </a>
+                
+                
+                <a href="connection-ttl.html" class="navigation navigation-next " aria-label="Next page: Detecting Dead Connections">
+                    <i class="fa fa-angle-right"></i>
+                </a>
+                
+            
+        
+    </div>
+
+    <script>
+        var gitbook = gitbook || [];
+        gitbook.push(function() {
+            gitbook.page.hasChanged({"page":{"title":"Configuration Reload","level":"1.20","depth":1,"next":{"title":"Detecting Dead Connections","level":"1.21","depth":1,"path":"connection-ttl.md","ref":"connection-ttl.md","articles":[]},"previous":{"title":"Configuring Transports","level":"1.19","depth":1,"path":"configuring-transports.md","ref":"configuring-transports.md","articles":[]},"dir":"ltr"},"config":{"plugins":[],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"highlight":{},"search":{},"lunr":{"maxIndexSize":1000000},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"fontsettings":{"theme":"white","family":"sans","size":2},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css
 ","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"github":"apache/activemq-artemis","theme":"default","githubHost":"https://github.com/","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"ActiveMQ Artemis Documentation","links":{"home":"http://activemq.apache.org/artemis","issues":"https://issues.apache.org/jira/browse/ARTEMIS","contribute":"http://activemq.apache.org/contributing.html"},"gitbook":"3.x.x","description":"ActiveMQ Artemis User Guide and Reference Documentation"},"file":{"path":"config-reload.md","mtime":"2017-09-08T01:26:53.000Z","type":"markdown"},"gitbook":{"version":"3.1.1","time":"2017-09-14T19:42:32.953Z"},"basePath":".","book":{"language":""}});
+        });
+    </script>
+</div>
+
+        
+    <script src="gitbook/gitbook.js"></script>
+    <script src="gitbook/theme.js"></script>
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-search/search.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
+        
+    
+        
+        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
+        
+    
+
+    </body>
+</html>
+