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.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. Configuring Group Providers

2.3.1. FileGroupManager

2.4. Configure Java Qpid to use a SSL connection.

2.4.1. Using SSL connection with Qpid Java.
2.4.2. Setup
2.4.3. Performing the connection.

2.5. Configure Log4j CompositeRolling Appender

2.5.1. How to configure the CompositeRolling log4j Appender

2.6. Configure the Broker via config.xml

2.6.1. Broker config.xml Overview
2.6.2. Qpid Version

2.7. Configure the Virtual Hosts via virtualhosts.xml

2.7.1. virtualhosts.xml Overview

2.8. Configuring Authentication Mechanisms

2.8.1. Password File
2.8.2. LDAP
2.8.3. Kerberos
2.8.4. SSL Client Certificates
2.8.5. Anonymous

2.9. Debug using log4j

2.9.1. Debugging with log4j configurations

2.10. How to Tune M3 Java Broker Performance

2.10.1. Problem Statement
2.10.2. Successful Tuning Options
2.10.3. Next Steps

2.11. Qpid Java Build How To

2.11.1. Build Instructions - General
2.11.2. Build Instructions - Trunk

2.12. Other Queue Types

2.12.1. Introduction
2.12.2. Priority Queues
2.12.3. Sorted Queues
2.12.4. Last Value Queues (LVQ)
2.12.5. Creating a Priority, Sorted or LVQ Queue
2.12.6. Low pre-fetch

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.
2.11.

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
2.1. Configuring a priority queue
2.2. Configuring a priority queue with fewer priorities
2.3. Configuring a sorted queue
2.4. Configuring a LVQ queue
2.5. Configuring a LVQ queue with custom message property name
2.6. Creation of an LVQ using the Qpid extension to JMS
2.7. Creation of a sorted queue using JMX

		Next
		Introduction