blob: a979070a9817bfd0e82cb5a0c85ae42738d3aeb2 [file] [log] [blame]
<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">2.2.&#160;Prerequisites</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="Java-Broker-Installation.html">Prev</a>&#160;</td><th align="center" width="60%">Chapter&#160;2.&#160;Installation</th><td align="right" width="20%">&#160;<a accesskey="n" href="Java-Broker-Installation-Download.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-Installation-Prerequistes"></a>2.2.&#160;Prerequisites</h2></div></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="Java-Broker-Installation-Prerequistes-Java"></a>2.2.1.&#160;Java Platform</h3></div></div></div><p> The Apache Qpid Broker-J is an 100% Java implementation and as such it can be used on any
operating system supporting Java 1.8 or higher<a class="footnote" href="#ftn.d0e97" id="d0e97"><sup class="footnote">[3]</sup></a>. This includes Linux,
Solaris, Mac OS X, and Windows 7/8/10 etc.</p><p> The broker has been tested with Java implementations from both Oracle and IBM. Whatever
platform you chose, it is recommended that you ensure it is patched with any critical
updates made available from the vendor. </p><p> Verify that your JVM is installed properly by following <a class="link" href="Java-Broker-Miscellaneous.html#Java-Broker-Miscellaneous-JVM-Verification" title="F.1.&#160;JVM Installation verification">these instructions.</a>
</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="Java-Broker-Installation-Prerequistes-Disk"></a>2.2.2.&#160;Disk</h3></div></div></div><p>The Broker installation requires approximately 20MB of free disk space.</p><p>The Broker also requires a working directory. The working directory is used for the
message store, that is, the area of the file-system used to record messages
whilst they are passing through the Broker. The working directory is also used for the
default location of the log file. The size of the working directory will depend on the how
the Broker is used.</p><p>The performance of the file system hosting the work directory is key to the performance
of Broker as a whole. For best performance, choose a device that has low latency and one
that is uncontended by other applications.</p><p>Be aware that there are additional considerations if you are considering hosting the
working directory on NFS.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="Java-Broker-Installation-Prerequistes-Memory"></a>2.2.3.&#160;Memory</h3></div></div></div><p>Qpid caches messages in memory for performance reasons, so in general, the Broker will
benefit from as much memory as possible. However, on a 32bit JVM, the maximum addressable
memory range for a process is 4GB, after leaving space for the JVM's own use this will give
a maximum usable size of approximately ~3.7GB.</p><p>See <a class="xref" href="Java-Broker-Runtime-Memory.html" title="9.11.&#160;Memory">Section&#160;9.11, &#8220;Memory&#8221;</a> for a full description of how memory is
used.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="Java-Broker-Installation-Prerequistes-OperatingSystemAccount"></a>2.2.4.&#160;Operating System Account</h3></div></div></div><p>Installation or operation of Qpid does <span class="emphasis"><em>not</em></span> require a privileged
account (i.e. root on UNIX platforms or Administrator on Windows). However it is suggested
that you use an dedicated account (e.g. qpid) for the installation and operation of the Broker.</p></div><div class="footnotes"><br /><hr style="width:100; text-align:left;margin-left: 0" /><div class="footnote" id="ftn.d0e97"><p><a class="para" href="#d0e97"><sup class="para">[3] </sup></a>Java Cryptography Extension (JCE)
Unlimited Strength extension must be installed or enabled for some features.</p></div></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="Java-Broker-Installation.html">Prev</a>&#160;</td><td align="center" width="20%"><a accesskey="u" href="Java-Broker-Installation.html">Up</a></td><td align="right" width="40%">&#160;<a accesskey="n" href="Java-Broker-Installation-Download.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter&#160;2.&#160;Installation&#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;2.3.&#160;Download</td></tr></table></div></div>