Apache Qpid

Documentation

Community

Developers

About AMQP

What is AMQP?

About Apache

AMQP Messaging Broker (Implemented in Java)

Table of Contents

Introduction

1. General User Guides

1.1. Java Broker Feature Guide

1.1.1. The Qpid pure Java broker currently supports the following features:

1.2. Qpid Java FAQ

1.2.1. Purpose

1.3. Java Environment Variables

1.3.1. Setting Qpid Environment Variables

1.4. Qpid Troubleshooting Guide

1.4.1. I'm getting a java.lang.UnsupportedClassVersionError when I try to start the broker. What does this mean ?
1.4.2. I'm having a problem binding to the required host:port at broker startup ?
1.4.3. I'm having problems with my classpath. How can I ensure that my classpath is ok ?
1.4.4. I can't get the broker to start. How can I diagnose the problem ?
1.4.5. When I try to send messages to a queue I'm getting a error as the queue does not exist. What can I do ?

1.5. Broker Configuration Guide

1.5.1. Producer Flow Control
1.5.2. Topic Configuration on Java Broker

1.6. High Availability

1.6.1. General Introduction
1.6.2. HA offerings of the Java Broker
1.6.3. Two Node Cluster
1.6.4. Multi Node Cluster
1.6.5. Configuring a Virtual Host to be a node
1.6.6. Durability Guarantees
1.6.7. Client failover configuration
1.6.8. Qpid JMX API for HA
1.6.9. Monitoring cluster
1.6.10. Disk space requirements
1.6.11. Network Requirements
1.6.12. Security
1.6.13. Backups
1.6.14. Migration of a non-HA store to HA
1.6.15. Disaster Recovery
1.6.16. Performance

2.1. Add New Users

2.1.1. Available Password file formats
2.1.2. Dynamic changes to password files.
2.1.3. How password files and PrincipalDatabases relate to authentication mechanisms

2.2. Configuring ACLs

2.2.1. Enabling ACLs
2.2.2. Writing .acl files
2.2.3. Syntax
2.2.4. Worked Examples

2.3. Configure Java Qpid to use a SSL connection.

2.3.1. Using SSL connection with Qpid Java.
2.3.2. Setup
2.3.3. Performing the connection.

2.4. Configure Log4j CompositeRolling Appender

2.4.1. How to configure the CompositeRolling log4j Appender

2.5. Configure the Broker via config.xml

2.5.1. Broker config.xml Overview
2.5.2. Qpid Version

2.6. Configure the Virtual Hosts via virtualhosts.xml

2.6.1. virtualhosts.xml Overview

2.7. Debug using log4j

2.7.1. Debugging with log4j configurations

2.8. How to Tune M3 Java Broker Performance

2.8.1. Problem Statement
2.8.2. Successful Tuning Options
2.8.3. Next Steps

2.9. Qpid Java Build How To

2.9.1. Build Instructions - General
2.9.2. Build Instructions - Trunk

2.10. Use Priority Queues

2.10.1. General Information
2.10.2. Defining Priority Queues
2.10.3. Client configuration/messaging model for priority queues

2.11. Slow Consumer Disconnect - User Guide

2.11.1. Introduction
2.11.2. What can it do?
2.11.3. Frequency of SCD Checking
2.11.4. Client Exceptions
2.11.5. Disconnection Thresholds
2.11.6. Important Points To Note

3. Qpid JMX Management Console

3.1. Qpid JMX Management Console

3.1.1. Overview

4. Management Tools

4.1. Qpid Java Broker Management CLI

4.1.1. How to build Apache Qpid CLI

List of Figures

1.1. Key for figures
1.2. Normal operation of a two-node cluster
1.3. Failure of master and recovery sequence
1.4. Failure of replica and subsequent recovery sequence
1.5. Partition of the network separating master and replica
1.6. Split Brain
1.7. BDBHAMessageStore view from jconsole.
1.8. Test results

List of Tables

1.1. Command Line Options
1.2. Effect of different durability guarantees
1.3. Mbean BDBHAMessageStore attributes
1.4. Mbean BDBHAMessageStore operations
1.5. Number of producers/consumers in performance tests
1.6. Performance Comparison
2.1. File Format and Principal Database
2.2. ACL Rules: permission
2.3. ACL Rules:action
2.4. ACL Rules:object
2.5. ACL Rules:property
2.6. ACL rules:components (Java Broker only)
2.7.
2.8.
2.9.
2.10.

List of Examples

1.1. Example of connection URL for the HA Cluster
1.2. Example of java code to get the node state value
1.3. Using DbPing utility for monitoring HA nodes.
1.4. Performing store backup by using BDBBackup class directly
1.5. Performing store backup by using backup.sh bash script
1.6. Enabling replication
1.7. Example of XML configuration for HA message store
1.8. Reseting of replication group with DbResetRepGroup

		Next
		Introduction