blob: 59d776fb01b5359797dfbd95afc99c8dd6afc18c [file] [log] [blame]
<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">7.2.&#160;Broker</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="Java-Broker-Management-Managing-Entities.html">Prev</a>&#160;</td><th align="center" width="60%">Chapter&#160;7.&#160;Managing Entities</th><td align="right" width="20%">&#160;<a accesskey="n" href="Java-Broker-Management-Managing-Virtualhost-Nodes.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="Java-Broker-Management-Managing-Broker"></a>7.2.&#160;Broker</h2></div></div></div><p>The <a class="link" href="Java-Broker-Concepts-Broker.html" title="4.2.&#160;Broker">Broker</a> is the principal entity. It is
composed of a number of other entities that collaborate to provide message broker
facilities.</p><p>The Broker can only be managed via the HTTP management channel.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="Java-Broker-Management-Managing-Broker-Attributes"></a>7.2.1.&#160;Attributes</h3></div></div></div><p>
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><span class="emphasis"><em>Name the Broker</em></span>. This helps distinguish between Brokers in
environments that have many.</p></li><li class="listitem"><p><span class="emphasis"><em>Confidential configuration encryption provider</em></span>. The name of the
provider used to encrypt passwords and other secrets within the configuration. See <a class="xref" href="Java-Broker-Security-Configuration-Encryption.html" title="8.4.&#160;Configuration Encryption">Section&#160;8.4, &#8220;Configuration Encryption&#8221;</a>.</p></li></ul></div><p>
</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="Java-Broker-Management-Managing-Broker-Context"></a>7.2.2.&#160;Context</h3></div></div></div><p>
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p><span class="emphasis"><em>broker.flowToDiskThreshold</em></span> Controls the <a class="link" href="Java-Broker-Runtime-Flow-To-Disk.html" title="9.6.&#160;Flow to Disk">flow to disk</a> feature.</p></li><li class="listitem"><p><span class="emphasis"><em>broker.messageCompressionEnabled</em></span> Controls the <a class="link" href="Java-Broker-Runtime-Message-Compression.html" title="9.9.&#160;Message Compression">message compression</a> .</p></li><li class="listitem"><p><a id="Java-Broker-Management-Managing-Broker-Context-StoreFilesystemMaxUsagePercent"></a><span class="emphasis"><em>store.filesystem.maxUsagePercent</em></span> Maximum percentage of space
that may be utilised on a filesystem hosting a virtualhost's message store before
producer flow control is automatically imposed.</p><p>This defaults to 90%.</p></li><li class="listitem"><p><a id="Java-Broker-Management-Managing-Broker-Context-BrokerDefaultSupportedProtocolVersionReply"></a><span class="emphasis"><em>qpid.broker_default_supported_protocol_version_reply</em></span> Used
during protocol negotiation. If set, the Broker will offer this AMQP version to a client
requesting an AMQP protocol that is not supported by the Broker. If not set, the Broker
offers the highest protocol version it supports. </p></li><li class="listitem"><p>
<span class="emphasis"><em>qpid.broker_msg_auth</em></span> If set true, the Broker ensures that the user
id of each received message matches the user id of the producing connection. If this
check fails, the message is returned to the producer's connection with a 403 (Access
Refused) error code.</p><p>This value can be overridden for each Virtual Host by setting the context value on the Virtual Host or
Virtual Host Node.
</p><p>Defaults to false.</p></li></ul></div><p>
</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="Java-Broker-Management-Managing-Broker-Children"></a>7.2.3.&#160;Children</h3></div></div></div><p>
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
<a class="link" href="Java-Broker-Management-Managing-Virtualhost-Nodes.html" title="7.3.&#160;Virtualhost Nodes">Virtualhost
nodes</a>
</p></li><li class="listitem"><p>
<a class="link" href="Java-Broker-Management-Managing-Ports.html" title="7.9.&#160;Ports">Ports</a>
</p></li><li class="listitem"><p>Authentication Providers</p></li><li class="listitem"><p>Key Stores / Trust Stores</p></li><li class="listitem"><p>Group Providers</p></li><li class="listitem"><p>Access Control Providers</p></li></ul></div><p>
</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="Java-Broker-Management-Managing-Broker-Lifecycle"></a>7.2.4.&#160;Lifecycle</h3></div></div></div><p>Not supported</p></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="Java-Broker-Management-Managing-Entities.html">Prev</a>&#160;</td><td align="center" width="20%"><a accesskey="u" href="Java-Broker-Management-Managing-Entities.html">Up</a></td><td align="right" width="40%">&#160;<a accesskey="n" href="Java-Broker-Management-Managing-Virtualhost-Nodes.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter&#160;7.&#160;Managing Entities&#160;</td><td align="center" width="20%"><a accesskey="h" href="Apache-Qpid-Broker-J-Book.html">Home</a></td><td align="right" valign="top" width="40%">&#160;7.3.&#160;Virtualhost Nodes</td></tr></table></div></div>