Return-Path: X-Original-To: apmail-qpid-commits-archive@www.apache.org Delivered-To: apmail-qpid-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 3A40310E60 for ; Tue, 11 Mar 2014 22:54:21 +0000 (UTC) Received: (qmail 45440 invoked by uid 500); 11 Mar 2014 22:54:17 -0000 Delivered-To: apmail-qpid-commits-archive@qpid.apache.org Received: (qmail 45206 invoked by uid 500); 11 Mar 2014 22:54:12 -0000 Mailing-List: contact commits-help@qpid.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@qpid.apache.org Delivered-To: mailing list commits@qpid.apache.org Received: (qmail 45099 invoked by uid 99); 11 Mar 2014 22:54:08 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 11 Mar 2014 22:54:08 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 11 Mar 2014 22:53:52 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 21E742388C2A; Tue, 11 Mar 2014 22:52:52 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1576538 [11/13] - in /qpid/site: docs/ docs/components/qpid-jms/ docs/releases/qpid-0.26/ docs/releases/qpid-0.26/java-broker/ docs/releases/qpid-0.26/java-broker/book/ docs/releases/qpid-0.26/jms-client-0-8/ docs/releases/qpid-0.26/jms-cl... Date: Tue, 11 Mar 2014 22:52:45 -0000 To: commits@qpid.apache.org From: kwall@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20140311225252.21E742388C2A@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Modified: qpid/site/docs/releases/qpid-trunk/java-broker/book/index.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-trunk/java-broker/book/index.html?rev=1576538&r1=1576537&r2=1576538&view=diff ============================================================================== --- qpid/site/docs/releases/qpid-trunk/java-broker/book/index.html (original) +++ qpid/site/docs/releases/qpid-trunk/java-broker/book/index.html Tue Mar 11 22:52:42 2014 @@ -107,7 +107,7 @@
-

AMQP Messaging Broker (Java)


Table of Contents

1. Introduction
2. Installation
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
< dt>2.3.2. Optional Dependencies
2.4. Installation on Windows
2.4.1. Setting the working directory
2.4.2. Optional Dependencies
2.5. Installation on UNIX platforms
2.5.1. Setting the working directory
2.5.2. Optional Dependencies
3. Getting Started
3.1. Introduction
3.2. Starting/Stopping the broker on Windows
3.3. Starting/Stopping the broker on Unix
3.4. Log file
3.5. Using the command line
4. Concepts
4.1. Broker
4.2. Virtual Hosts
4.3. Exchanges
4.3.1. Predeclared Exchanges
4.3.2. Exchange Types
4.3.3. Binding Arguments
4.3.4. Unrouteable Messages
4.4. Queues
4.5. Ports
4.6. Authentication Providers
4.7. Other Services
4.7.1. Access Control Providers
4.7.2. Group Providers
4.7.3. Keystores
4.7.4. Truststores
5. Configuring And Managing
5.1. Broker Configuration Store
5.1.1. Introduction
5.1.2. Configuration Store Location
5.1.3. 'Initial Configuration' Location
5.1.4. Creating an 'Initial Configuration' JSON File
5.1.5. Overwriting An Existing Configuration Store
5.1.6. Configuration Store Type
5.1.7. Customising Configuration using Configuration Properties
5.1.8. Example of JSON 'Initial Configuration'
5.1.9. Configuring Broker Attributes
5.2. HTTP Management
5.2.1. Introduction
5.2.2. Web Management Console
5.2.3. HTTP Management Plugin Configuration
5.2.4. REST API
5.3. JMX Management
5.3.1. Introduction
5.3.2. Default Configuration
5.3.3. Connecting to JMX
5.3.4. Example JMX Client
5.3.5. The MBeans
5.4. Other Tooling
6. Broker Ports
6.1. Configuring Broker Ports
7. Virtual Hosts
7.1. Configuring And Managing
8. Exchanges
8.1. Configuring Virtual Host Exchanges
9. Queues
9.1. Queue Types
9.1.1. Introduction
9.1.2. Priority Queues
9.1.3. Sorted Queues
9.1.4. Last Value Queues (LVQ)
9.1.5. Creating a Priority, Sorted or LVQ Queue
9.1.6. Binding queues to exchanges
9.1.7. +
2.4. Installation on Windows
2.4.1. Setting the working directory
2.4.2. Optional Dependencies
2.5. Installation on UNIX platforms
2.5.1. Setting the working directory
2.5.2. Optional Dependencies
3. Getting Started
3.1. Introduction
3.2. Starting/Stopping the broker on Windows
3.3. Starting/Stopping the broker on Unix
3.4. Log file
3.5. Using the command line
4. Concepts
4.1. Broker
4.2. Virtual Hosts
4.3. Exchanges
4.3.1. Predeclared Exchanges
4.3.2. Exchange Types
4.3.3. Binding Arguments
4.3.4. Unrouteable Messages
4.4. Queues
4.5. Ports
4.6. Authentication Providers
4.7. Other Services
4.7.1. Access Control Providers
4.7.2. Group Providers
4.7.3. Keystores
4.7.4. Truststores
5. Configuring And Managing
5.1. Broker Configuration Store
5.1.1. Introduction
5.1.2. Configuration Store Location
5.1.3. 'Initial Configuration' Location
5.1.4. Creating an 'Initial Configuration' JSON File
5.1.5. Overwriting An Existing Configuration Store
5.1.6. Configuration Store Type
5.1.7. Customising Configuration using Configuration Properties
5.1.8. Example of JSON 'Initial Configuration'
5.1.9. Configuring Broker Attributes
5.2. HTTP Management
5.2.1. Introduction
5.2.2. Web Management Console
5.2.3. HTTP Management Plugin Configuration
5.2.4. REST API
5.3. JMX Management
5.3.1. Introduction
5.3.2. Default Configuration
5.3.3. Connecting to JMX
5.3.4. Example JMX Client
5.3.5. The MBeans
5.4. Other Tooling
6. Broker Ports
6.1. Configuring Broker Ports
7. Virtual Hosts
7.1. Configuring And Managing
8. Exchanges
8.1. Configuring Virtual Host Exchanges
9. Queues
9.1. Queue Types
9.1.1. Introduction
9.1.2. Priority Queues
9.1.3. Sorted Queues
9.1.4. Last Value Queues (LVQ)
9.1.5. Creating a Priority, Sorted or LVQ Queue
9.1.6. Binding queues to exchanges
9.1.7. Messaging Grouping
9.1.8. Using low pre-fetch with special queue types
10. Virtual Host Message Stores
10.1. Memory Message Store
10.2. Derby Message Store
10.3. SQL Message Store
10.3.1. JDBC driver
10.4. BDB Message Store
10.4.1. Oracle BDB JE download
10.4.2. Oracle BDB JE jar installation
10.5. High Availability BDB Message Store
10.5.1. Oracle BDB JE download
10.5.2. Oracle BDB JE jar installation
10.5.3. Configuration
11. Security
11.1. Authentication Providers
11.1.1. Simple LDAP Authentication Provider
11.1.2. Kerberos
11.1.3. External (SSL Client Certificates)
11.1.4. Anonymous
11.1.5. Plain Password File
11.1.6. Base64MD5 Password File
11.2. Group Providers
11.2.1. GroupFile Provider
11.3. Access Control Lists
11.3.1. Writing .acl files @@ -115,8 +115,8 @@ Syntax
11.3.3. Worked Examples -
11.4. SSL
11.4.1. Keystore Configuration
11.4.2. Truststore / Client Certificate Authentication
12. Runtime
12.1. Log Files
12.2. Alerts
12.3. Disk Space Management
12.3.1. Producer Flow Control
12.4. Producer Transaction Timeout
12.4.1. General Information
12.4.2. Purpose
12.4.3. Scope
12.4.4. Effect
12.4.5. Configuration
12.5. Handing Undeliverable Messages
12.5.1. Introduction
12.5.2. Maximum Delivery Count
12.5.3. Dead Letter Queues (DLQ)
12.5.4. Configuration
12.6. Closing client connections on unroutable mandatory messages
12.6.1. Summary
12.6.2. Configuring closeWhenNoRoute
13. High Availability
13.1. General Introduction
13.2. HA offerings of the Java Broker
13.3. Two Node Cluster
13.3.1. Overview
13.3.2. Depictions of cluster operation
13.4. Multi Node Cluster
13.5. Configuring a Virtual Host to be a node
13.5.1. Passing BDB environment and replication configuration options
13.6. Durability Guarantees
13.6.1. BDB Durability Controls
13.6.2. Coalescing-sync
13.6.3. Default
13.6.4. Examples
13.7. Client failover configuration
13.8. Qpid JMX API for HA
13.9. Monitoring cluster
13.10. Disk space requirements
13.11. Network Requirements
13.12. Security
13.13. Backups
13.14. Migration of a non-HA stor e to HA
13.15. Disaster Recovery
13.16. Performance
14. Virtual Host XML configuration file
14.1. Introduction
14.2. Configuring ACL
14.3. Configuring MemoryMessageStore
14.4. Configuring BDBMessageStore
14.4.1. Passing BDB environment configuration options
14.5. Configuring BDBHAMessageStore
14.6. Configuring DerbyMessageStore
14.7. Configuring JDBCMessageStore
14.8. Configuring Exchanges
14.9. Configuring Queues
14.9.1. Simple
14.9.2. Priority
14.9.3. Sorted
14.9.4. LVQ
14.9.5. Configuring queue with arguments
14.10. Queue Binding
14.11. Configuring o f Producer Flow Control
14.12. Configuring of Disk Quota-based Flow Control
14.13. Configuring Transaction Timeouts
14.14. Configuring DLQs/Maximum Delivery Count
14.15. An example of virtual host configuration file
15. Miscellaneous
15.1. JVM Installation verification
15.1.1. Verify JVM on Windows
15.1.2. Verify JVM on Unix
A. Environment Variables
B. System Properties
C. Operational Logging

List of Examples

5.1. JSON 'Initial configuration' File
5.2. Examples of queue creation using curl (authenticating as user admin):
5.3. Example of binding a queue to an exchange using curl
5.4. JMX Client illustrating the creation of a new queue
9.1. Creation of an LVQ using the Qpid extension to JMS
9.2. Creation of a sorted queue using JMX
9.3. Binding a queue using JMS
9.4. Binding a queue using JMX
12.1. Disable feature to close connection on unroutable messages with client URL
13.1. Configuring a VirtualHost to use the BDBHAMessageStore
13.2. Example of connection URL for the HA Cluster
13.3. Example of java code to get the node state value
13.4. Using DbPing utility for monitoring HA nodes.
13.5. Performing store backup by using BDBBackup class directly
13.6. Performing store backup by using backup.sh bash script
13.7. Enabling re plication
13.8. Example of XML configuration for HA message store
13.9. Reseting of replication group with DbResetRepGroup
14.1. Configuring a VirtualHost to use the MemoryMessageStore
14.2. Configuring a VirtualHost to use the BDBMessageStore
14.3. Configuring BDB Environment Configuration
14.4. Configuring a VirtualHost to use the DerbyMessageStore
14.5. Configuring a VirtualHost to use the JDBCMessageStore
14.6. Configuring Exchanges on VirtualHost
14.7. Configuring a simple queue
14.8. Configuring a priority queue
14.9. Configuring a priority queue with fewer priorities
14.10. Configuring a sorted queue
14.11. Configuring a LVQ queue
14.12. Configuring a LVQ queue with custom message property name
14.13. Setting arbitrary queue argumen ts
14.14. Queue Binding Example
14.15. Configuring a queue depth limit
14.16. Configuring of default queue depth limit on virtualhost
14.17. Configuring a limit on a store
14.18. Configuring producer transaction timeout
14.19. Enabling DLQs and maximum delivery count at virtualhost and queue level within - virtualhosts.xml
14.20. An example of virtual host configuration file
+
11.4. SSL
11.4.1. Keystore Configuration
11.4.2. Truststore / Client Certificate Authentication
12. Runtime
12.1. Log Files
12.2. Alerts
12.3. Disk Space Management
12.3.1. Producer Flow Control
12.4. Producer Transaction Timeout
12.4.1. General Information
12.4.2. Purpose
12.4.3. Scope
12.4.4. Effect
12.4.5. Configuration
12.5. Handing Undeliverable Messages
12.5.1. Introduction
12.5.2. Maximum Delivery Count
12.5.3. Dead Letter Queues (DLQ)
12.5.4. Configuration
12.6. Closing client connections on unroutable mandatory messages
12.6.1. Summary
12.6.2. Configuring closeWhenNoRoute
13. High Availability
13.1. General Introduction
13.2. HA offerings of the Java Broker
13.3. Two Node Cluster
13.3.1. Overview
13.3.2. Depictions of cluster operation
13.4. Multi Node Cluster
13.5. Configuring a Virtual Host to be a node
13.5.1. Passing BDB environment and replication configuration options
13.6. Durability Guarantees
13.6.1. BDB Durability Controls
13.6.2. Coalescing-sync
13.6.3. Default
13.6.4. Examples
13.7. Client failover configuration
13.8. Qpid JMX API for HA
13.9. Monitoring cluster
13.10. Disk space requirements
13.11. Network Requirements
13.12. Security
13.13. Backups
13.14. Migration of a non-HA stor e to HA
13.15. Disaster Recovery
13.16. Performance
14. Virtual Host XML configuration file
14.1. Introduction
14.2. Configuring ACL
14.3. Configuring MemoryMessageStore
14.4. Configuring BDBMessageStore
14.4.1. Passing BDB environment configuration options
14.5. Configuring BDBHAMessageStore
14.6. Configuring DerbyMessageStore
14.7. Configuring JDBCMessageStore
14.8. Configuring Exchanges
14.9. Configuring Queues
14.9.1. Simple
14.9.2. Priority
14.9.3. Sorted
14.9.4. LVQ
14.9.5. Configuring queue with arguments
14.10. Queue Binding
14.11. Configuring o f Producer Flow Control
14.12. Configuring of Disk Quota-based Flow Control
14.13. Configuring Transaction Timeouts
14.14. Configuring DLQs/Maximum Delivery Count
14.15. An example of virtual host configuration file
15. Miscellaneous
15.1. JVM Installation verification
15.1.1. Verify JVM on Windows
15.1.2. Verify JVM on Unix
A. Environment Variables
B. System Properties
C. Operational Logging

List of Examples

5.1. JSON 'Initial configuration' File
5.2. Examples of queue creation using curl (authenticating as user admin):
5.3. Example of binding a queue to an exchange using curl
5.4. JMX Client illustrating the creation of a new queue
9.1. Creation of an LVQ using the Qpid extension to JMS
9.2. Creation of a sorted queue using JMX
9.3. Binding a queue using JMS
9.4. Binding a queue using JMX
12.1. Disable feature to close connection on unroutable messages with client URL
13.1. Configuring a VirtualHost to use the BDBHAMessageStore
13.2. Example of connection URL for the HA Cluster
13.3. Example of java code to get the node state value
13.4. Using DbPing utility for monitoring HA nodes.
13.5. Performing store backup by using BDBBackup class directly
13.6. Performing store backup by using backup.sh bash script
13.7. Enabling re plication
13.8. Example of XML configuration for HA message store
13.9. Reseting of replication group with DbResetRepGroup
14.1. Configuring a VirtualHost to use the MemoryMessageStore
14.2. Configuring a VirtualHost to use the BDBMessageStore
14.3. Configuring BDB Environment Configuration
14.4. Configuring a VirtualHost to use the DerbyMessageStore
14.5. Configuring a VirtualHost to use the JDBCMessageStore
14.6. Configuring Exchanges on VirtualHost
14.7. Configuring a simple queue
14.8. Configuring a priority queue
14.9. Configuring a priority queue with fewer priorities
14.10. Configuring a sorted queue
14.11. Configuring a LVQ queue
14.12. Configuring a LVQ queue with custom message property name
14.13. Setting arbitrary queue arguments
14.14. Queue Binding Example
14.15. Configuring a queue depth limit
14.16. Configuring of default queue depth limit on virtualhost
14.17. Configuring a limit on a store
14.18. Configuring producer transaction timeout
14.19. Enabling DLQs and maximum delivery count at virtualhost and queue level within + virtualhosts.xml
14.20. An example of virtual host configuration file

Modified: qpid/site/docs/releases/qpid-trunk/java-broker/java-broker-book.pdf URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-trunk/java-broker/java-broker-book.pdf?rev=1576538&r1=1576537&r2=1576538&view=diff ============================================================================== Binary files - no diff available. Modified: qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Appendix-Exceptions.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Appendix-Exceptions.html?rev=1576538&r1=1576537&r2=1576538&view=diff ============================================================================== --- qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Appendix-Exceptions.html (original) +++ qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Appendix-Exceptions.html Tue Mar 11 22:52:42 2014 @@ -111,7 +111,7 @@ (#getMessage()) summarises the error condition, with contextual information being provided by the messages of linked exception(s). To understand the problem, it is important to read the messages associated with all the linked exceptions.

The following table describes some of the more common exceptions linked to JMSException - thrown by JMS methods whilst using the client:

Table A.1. Exceptions linked to JMSExceptions thrown by JMS methods

Linked ExceptionMessageExplanation/Common Causes
AMQUnresolvedAddressExceptionmessage varies

Indicates that the hostname included in the Connection URL's brokerlist, could not be resolved, . This could mean that the hostname is + thrown by JMS methods whilst using the client:

Table A.1. Exceptions linked to JMSExceptions thrown by JMS methods

Linked ExceptionMessageExplanation/Common Causes
AMQUnresolvedAddressExceptionmessage varies

Indicates that the hostname included in the Connection URL's brokerlist, could not be resolved, . This could mean that the hostname is mispelt, or there is name resolution problem.

AMQConnectionFailureConnection refused

Indicates that the host included in the Connection URL's brokerlist, actively refused the connection. This could mean that the hostname and/or port number is incorrect, or the Broker may not be running.

AMQConnectionFailureconnect timed out

Indicates that the host included in the Connection URL's brokerlist, could not be contacted within the connecttimeout. This could mean that the host is shutdown, or a networking @@ -125,7 +125,7 @@ unexpected manner. Check the broker and the host on which it runs and performance of its storage.


The following table describes some of the more common exceptions linked to JMSException sent to ExceptionListener - instances.

Table A.2. Exceptions linked to JMSExceptions received by ExceptionListeners

Linked ExceptionMessageExplanation/Common Causes
AMQNoRouteExceptionNo Route for message [Exchange: exchange name, Routing key: + instances.

Table A.2. Exceptions linked to JMSExceptions received by ExceptionListeners

Linked ExceptionMessageExplanation/Common Causes
AMQNoRouteExceptionNo Route for message [Exchange: exchange name, Routing key: routing key] [error code 312: no route]

Indicate that the named exchange is unable to route a message to at least one queue.

This will occur if a queue has been improperly bound to an exchange. Use the Modified: qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Appendix-Maven.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Appendix-Maven.html?rev=1576538&r1=1576537&r2=1576538&view=diff ============================================================================== --- qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Appendix-Maven.html (original) +++ qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Appendix-Maven.html Tue Mar 11 22:52:42 2014 @@ -109,7 +109,7 @@

Appendix B. Minimal Maven POM

The following is a minimal Maven POM required to use the Qpid Client. It is suitable for use with the examples included in this - book.

Example B.1. Minimal Maven POM

+    book.

Example B.1. Minimal Maven POM

     
 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">



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