http://git-wip-us.apache.org/repos/asf/qpid-site/blob/6e5b75e1/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Initial-Configuration.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Initial-Configuration.html b/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Initial-Configuration.html new file mode 100644 index 0000000..91e3ec2 --- /dev/null +++ b/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Initial-Configuration.html @@ -0,0 +1,154 @@ + + + + + Chapter 5. Initial Configuration - Apache Qpid™ + + + + + + + + + + + + + +
+
+ Menu + + Search + + +
+ + + + + +
+ + +
+
Chapter 5. Initial Configuration
Prev   Next

Chapter 5. Initial Configuration

Table of Contents

5.1. Introduction
5.2. Co nfiguration Store Location
5.3. 'Initial Configuration' Location
5.4. Creating an 'Initial Configuration' JSON File
5.5. Overwriting An Existing Configuration Store
5.6. Configuration Store Type
5.7. Customising Configuration using Configuration Properties
5.8. Example of JSON 'Initial Configuration'
< div class="titlepage">

5.1. Introduction

This section describes how to perform initial configuration on the command line. Once + the Broker is started, subsequent management is performed using the Management interfaces

The configuration for each component is stored as an entry in the broker + configuration store, currently implemented as a JSON file which persists changes to + disk, BDB or Derby database or an in-memory store which does not. The following + components configuration is stored there:

  • Broker

  • Virtual Host Nodes

  • Loggers

  • Ports

  • Authentication Providers (optionally with Users for managing users Authentication Providers)

  • Access Control Providers

  • Group Providers (optionally with Groups and GroupMembers for managing groups Group Providers)

  • Key stores

  • Trust stores

  • Plugins

+

Broker startup involves two configuration related items, the 'Initial Configuration' + and the Configuration Store. When the broker is started, if a Configuration Store does + not exist at the current store location then one will be initialised with the current 'Initial + Configuration'. Unless otherwise requested to overwrite the configuration + store then subsequent broker restarts will use the existing configuration + store and ignore the contents of the 'Initial Configuration'.

Prev   Next
4.10. Other Services Home 5.2. Configuration Store Location
+ +
+ + + +

+ Apache Qpid, Messaging built on AMQP; Copyright © 2015 + The Apache Software Foundation; Licensed under + the Apache + License, Version 2.0; Apache Qpid, Qpid, Qpid Proton, + Proton, Apache, the Apache feather logo, and the Apache Qpid + project logo are trademarks of The Apache Software + Foundation; All other marks mentioned may be trademarks or + registered trademarks of their respective owners +

+
+
+ + + http://git-wip-us.apache.org/repos/asf/qpid-site/blob/6e5b75e1/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-Download.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-Download.html b/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-Download.html new file mode 100644 index 0000000..67d08cf --- /dev/null +++ b/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-Download.html @@ -0,0 +1,146 @@ + + + + + 2.3. Download - Apache Qpid™ + + + + + + + + + + + + + +
+
+ Menu + + Search + + +
+ + + + + +
+ + +
+
2.3. Download
Prev Chapter 2. Installation Next

2.3. Download

2.3.1. Broker Release

You can download the latest Broker package from the Download Page .

It is recommended that you confirm the integrity of the download by verifying the PGP + signature matches that available on the site. Instructions are given on the download page. +

Prev Up Next
2.2. Prerequisites Home 2.4. Installation on Windows
+ +
+ + + +

+ Apache Qpid, Messaging built on AMQP; Copyright © 2015 + The Apache Software Foundation; Licensed under + the Apache + License, Version 2.0; Apache Qpid, Qpid, Qpid Proton, + Proton, Apache, the Apache feather logo, and the Apache Qpid + project logo are trademarks of The Apache Software + Foundation; All other marks mentioned may be trademarks or + registered trademarks of their respective owners +

+
+
+
+ + http://git-wip-us.apache.org/repos/asf/qpid-site/blob/6e5b75e1/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-InstallationUnix.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-InstallationUnix.html b/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-InstallationUnix.html new file mode 100644 index 0000000..e8ae670 --- /dev/null +++ b/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-InstallationUnix.html @@ -0,0 +1,168 @@ + + + + + 2.5. Installation on UNIX platforms - Apache Qpid™ + + + + + + + + + + + + + +
+
+ Menu + + Search + + +
+ + + + + +
+ + +
+
2.5. Installation on UNIX platforms
Prev Chapter 2. Installation Next

2.5. Installation on UNIX platforms

Firstly, verify that your JVM is installed properly by following these instructions. +

Now chose a directory for Qpid broker installation. This directory will be used for the + Qpid JARs and configuration files. It need not be the same location as the work directory used + for the persistent message store or the log file (you will choose this location later). For + the remainder this example we will assume that location /usr/local/qpid has been + chosen.

Next extract the qpid-broker-6.1.1-bin.tgz package into the directory.

mkdir /usr/local/qpid
+cd /usr/local/qpid
+tar xvzf qpid-broker-6.1.1-bin.tgz

The extraction of the broker package will have created a directory + qpid-broker/6.1.1 within /usr/local/qpid

ls -la qpid-broker/6.1.1/
+total 56
+drwxrwxr-x. 5 alex alex  4096 Nov 25 11:43 .
+drwxrwxr-x. 3 alex alex  4096 Nov 25 11:43 ..
+drwxr-xr-x. 2 alex alex  4096 Nov 24 23:38 bin
+drwxr-xr-x. 2 alex alex  4096 Nov 24 23:38 etc
+drwxrwxr-x. 2 alex alex  4096 Nov 25 11:43 lib
+-rw-r--r--. 1 alex alex 28143 Nov 24 23:38 LICENSE
+-rw-r--r--. 1 alex alex  3409 Nov 24 23:38 NOTICE
+-rw-r--r--. 1 alex alex   116 Nov 24 23:38 README.txt
+

2.5.1. Setting the working directory

Qpid requires a work directory. This directory is used for the default location of the + Qpid log file and is used for the storage of persistent messages. The work directory can be + set on the command-line (for the lifetime of the current shell), but you will normally want + to set the environment variable permanently the user's shell profile file (~/.bash_profile + for Bash etc).

export QPID_WORK=/var/qpidwork
+

If the directory referred to by QPID_WORK does not + exist, the Broker will attempt to create it on start-up.

Prev Up Next
2.4. Installation on Windows Home 2.6. Optional Dependencies
+ +
+ + + +

+ Apache Qpid, Messaging built on AMQP; Copyright © 2015 + The Apache Software Foundation; Licensed under + the Apache + License, Version 2.0; Apache Qpid, Qpid, Qpid Proton, + Proton, Apache, the Apache feather logo, and the Apache Qpid + project logo are trademarks of The Apache Software + Foundation; All other marks mentioned may be trademarks or + registered trademarks of their respective owners +

+
+
+
+ + http://git-wip-us.apache.org/repos/asf/qpid-site/blob/6e5b75e1/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-InstallationWindows.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-InstallationWindows.html b/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-InstallationWindows.html new file mode 100644 index 0000000..b2fad32 --- /dev/null +++ b/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-InstallationWindows.html @@ -0,0 +1,169 @@ + + + + + 2.4. Installation on Windows - Apache Qpid™ + + + + + + + + + + + + + +
+
+ Menu + + Search + + +
+ + + + + +
+ + +
+
2.4. Installation on Windows
Prev Chapter 2. Installation Next

2.4. Installation on Windows

Firstly, verify that your JVM is installed properly by following these instructions. +

Now chose a directory for Qpid broker installation. This directory will be used for the + Qpid JARs and configuration files. It need not be the same location as the work directory used + for the persistent message store or the log file (you will choose this location later). For + the remainder this example we will assume that location c:\qpid has been chosen.

Next extract the qpid-broker-6.1.1-bin.zip package into the directory, using either + the zip file handling offered by Windows (right click the file and select 'Extract All') or a + third party tool of your choice.

The extraction of the broker package will have created a directory + qpid-broker\\6.1.1 within c:\qpid

+ Directory of c:\qpid\qpid-broker\\6.1.1
+
+25/11/2015  11:29    <DIR>          .
+25/11/2015  11:29    <DIR>          ..
+25/11/2015  10:56    <DIR>          bin
+03/07/2015  08:06    <DIR>          etc
+25/11/2015  11:25    <DIR>          lib
+25/11/2015  10:56            28,143 LICENSE
+25/11/2015  10:56             3,409 NOTICE
+29/04/2015  09:13               116 README.txt
+3 File(s)         31,668 bytes
+5 Dir(s)  25,981,767,680 bytes free
+

2.4.1. Setting the working directory

Qpid requires a work directory. This directory is used for the default location of the + Qpid log file and is used for the storage of persistent messages. The work directory can be + set on the command-line (for the lifetime of the command interpreter), but you will normally + want to set the environment variable permanently via the Advanced System Settings in the + Control Panel.

set QPID_WORK=C:\qpidwork

If the directory referred to by QPID_WORK does not + exist, the Broker will attempt to create it on start-up.

Prev Up Next
2.3. Download Home 2.5. Installation on UNIX platforms
+ +
+ + + +

+ Apache Qpid, Messaging built on AMQP; Copyright © 2015 + The Apache Software Foundation; Licensed under + the Apache + License, Version 2.0; Apache Qpid, Qpid, Qpid Proton, + Proton, Apache, the Apache feather logo, and the Apache Qpid + project logo are trademarks of The Apache Software + Foundation; All other marks mentioned may be trademarks or + registered trademarks of their respective owners +

+
+
+
+ + http://git-wip-us.apache.org/repos/asf/qpid-site/blob/6e5b75e1/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-OptionalDependencies.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-OptionalDependencies.html b/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-OptionalDependencies.html new file mode 100644 index 0000000..9f95201 --- /dev/null +++ b/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-OptionalDependencies.html @@ -0,0 +1,146 @@ + + + + + 2.6. Optional Dependencies - Apache Qpid™ + + + + + + + + + + + + + +
+
+ Menu + + Search + + +
+ + + + + +
+ + +
+
2.6. Optional Dependencies
Prev Chapter 2. Installation Next

2.6. Optional Dependencies

If you wish to utilise storage options using Oracle BDB JE or an External Database, see + Section E.3, “Installing Oracle BDB JE” and Section E.2, “Installing External JDBC Driver” for details of + installing their dependencies.

Prev Up Next
2.5. Installation on UNIX platforms Home Chapter 3. Getting Started
+ +
+ + + +

+ Apache Qpid, Messaging built on AMQP; Copyright © 2015 + The Apache Software Foundation; Licensed under + the Apache + License, Version 2.0; Apache Qpid, Qpid, Qpid Proton, + Proton, Apache, the Apache feather logo, and the Apache Qpid + project logo are trademarks of The Apache Software + Foundation; All other marks mentioned may be trademarks or + registered trademarks of their respective owners +

+
+
+
+ + http://git-wip-us.apache.org/repos/asf/qpid-site/blob/6e5b75e1/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-Prerequistes.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-Prerequistes.html b/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-Prerequistes.html new file mode 100644 index 0000000..c7ab747 --- /dev/null +++ b/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation-Prerequistes.html @@ -0,0 +1,163 @@ + + + + + 2.2. Prerequisites - Apache Qpid™ + + + + + + + + + + + + + +
+
+ Menu + + Search + + +
+ + + + + +
+ + +
+
2.2. Prerequisites
Prev Chapter 2. Installation Next

2.2. Prerequisites

2.2.1. Java Platform

The Apache Qpid Broker for Java is an 100% Java implementation and as such it can be used on any + operating system supporting Java 1.7 or higher[4]. This includes Linux, Solaris, Mac OS X, and + Windows XP/Vista/7/8.

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.

Verify that your JVM is installed properly by following these instructions. +

2.2.2. Disk

The Broker installation requires approximately 20MB of free disk space.

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.

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.

Be aware that there are additional considerations if you are considering hosting the + working directory on NFS.

2.2.3. Memory

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.

See Section 9.11, “Memory” for a full description of how memory is + used.

2.2.4. Operating System Account

Installation or operation of Qpid does not 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.


[4] Java Cryptography Extension (JCE) + Unlimited Strength policy file are required for some features

Prev Up Next
Chapter 2. Installation Home 2.3. Download
+ +
+ + + +

+ Apache Qpid, Messaging built on AMQP; Copyright © 2015 + The Apache Software Foundation; Licensed under + the Apache + License, Version 2.0; Apache Qpid, Qpid, Qpid Proton, + Proton, Apache, the Apache feather logo, and the Apache Qpid + project logo are trademarks of The Apache Software + Foundation; All other marks mentioned may be trademarks or + registered trademarks of their respective owners +

+
+
+
+ + http://git-wip-us.apache.org/repos/asf/qpid-site/blob/6e5b75e1/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation.html b/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation.html new file mode 100644 index 0000000..ed008c1 --- /dev/null +++ b/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Installation.html @@ -0,0 +1,145 @@ + + + + + Chapter 2. Installation - Apache Qpid™ + + + + + + + + + + + + + +
+
+ Menu + + Search + + +
+ + + + + +
+ + +
+
Chapter 2. Installation
Prev   Next

Chapter 2. Installation

Table of Contents

2.1. Introduction
2.2. Prerequisites
2.2.1. Java Platform
2.2.2. Disk
2.2.3. Memory
2.2.4. Operating System Account
2.3. Download
2.3.1. Broker Release
2.4. Inst allation on Windows
2.4.1. Setting the working directory
2.5. Installation on UNIX platforms
2.5.1. Setting the working directory
2.6. Optional Dependencies

2.1. Introduction

This document describes how to install the Apache Qpid Broker for Java on both Windows and UNIX + platforms.

Prev   Next
Chapter 1. Introduction Home 2.2. Prerequisites
+ +
+ + + +

+ Apache Qpid, Messaging built on AMQP; Copyright © 2015 + The Apache Software Foundation; Licensed under + the Apache + License, Version 2.0; Apache Qpid, Qpid, Qpid Proton, + Proton, Apache, the Apache feather logo, and the Apache Qpid + project logo are trademarks of The Apache Software + Foundation; All other marks mentioned may be trademarks or + registered trademarks of their respective owners +

+
+
+
+ + http://git-wip-us.apache.org/repos/asf/qpid-site/blob/6e5b75e1/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Introduction.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Introduction.html b/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Introduction.html new file mode 100644 index 0000000..64f068d --- /dev/null +++ b/content/releases/qpid-java-6.1.1/java-broker/book/Java-Broker-Introduction.html @@ -0,0 +1,150 @@ + + + + + Chapter 1. Introduction - Apache Qpid™ + + + + + + + + + + + + + +
+
+ Menu + + Search + + +
+ + + + + +
+ + +
+
Chapter 1. Introduction
Prev   Next

Chapter 1. Introduction

The Apache Qpid Broker for Java is a powerful open-source message broker that implements all versions of the + Advanced Message Queuing Protocol (AMQP). The Apache Qpid Broker for Java + is actually one of two message brokers provided by the Apache Qpid project: Broker for Java and the C++ + Broker.

This document relates to the Apache Qpid Broker for Java. The C++ Broker is + described separately.

Headline features

  • 100% Java implementation - runs on any platform supporting Java 1.7 or higher

  • Messaging clients support in Java, C++, Python.

  • JMS 1.1 compliance (Java client).

  • Persistent and non-persistent (transient) message support

  • Supports for all common messaging patterns (point-to-point, publish/subscribe, fan-out + etc).

  • Transaction support including XA[1]

  • Supports for all versions of the AMQP protocol

  • Automatic message translation, allowing clients using different AMQP versions to communicate with each other.

  • Pluggable authentication architecture with out-of-the-box support for Kerberos, LDAP, + External, OAuth2, and file-based authentication mechanisms.

  • Support for message compression

  • Client support for end to end message encryption

  • Pluggable storage architecture with implementations including Apache Derby, Oracle BDB JE[2], and External Database

  • Web based management interface and programmatic management interfaces via REST.

  • SSL support

  • High availability (HA) support.[3]


[1] XA provided when using AMQP 0-10

[2] Oracle BDB JE must be downloaded separately.

[3] HA currently only available to users of the optional BDB JE HA based message store.

Prev   Next
Apache Qpid Broker for Java Home Chapter 2. Installation
+ +
+ + + +

+ Apache Qpid, Messaging built on AMQP; Copyright © 2015 + The Apache Software Foundation; Licensed under + the Apache + License, Version 2.0; Apache Qpid, Qpid, Qpid Proton, + Proton, Apache, the Apache feather logo, and the Apache Qpid + project logo are trademarks of The Apache Software + Foundation; All other marks mentioned may be trademarks or + registered trademarks of their respective owners +

+
+
+
+ + --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org For additional commands, e-mail: commits-help@qpid.apache.org