Broker Log Messages

Modified: qpid/trunk/qpid/doc/book/src/java-broker/management/channels/Java-Broker-Management-Channel-JMX.xml URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/java-broker/management/channels/Java-Broker-Management-Channel-JMX.xml?rev=1631195&r1=1631194&r2=1631195&view=diff ============================================================================== --- qpid/trunk/qpid/doc/book/src/java-broker/management/channels/Java-Broker-Management-Channel-JMX.xml (original) +++ qpid/trunk/qpid/doc/book/src/java-broker/management/channels/Java-Broker-Management-Channel-JMX.xml Sun Oct 12 15:48:18 2014 @@ -31,7 +31,7 @@ Introduction The JMX management plugin provides a series of managed beans (MBeans) allowing you to control and monitor the Broker via an industry compliant interface. This provides a - convenient intergration point for a variety of Infrastructure Monitoring Solutions, + convenient integration point for a variety of Infrastructure Monitoring Solutions, tools such as Jconsole and VisualVM, as well as custom Java programs and scripts. The following sections describe how to connect to JMX, the configuration of the JMX plugin covering topis including securing with SSL, programmatically interacting with @@ -174,7 +174,7 @@ managedBroker.createNewQueue("myqueue", MBean corresponding to the named virtualhost. Allows operations such as the creation/deletion of queues and exchanges on that - virtualhost and virtualhost levell statistics. + virtualhost and virtualhost level statistics. Modified: qpid/trunk/qpid/doc/book/src/java-broker/management/channels/Java-Broker-Management-Channel-REST-API.xml URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/java-broker/management/channels/Java-Broker-Management-Channel-REST-API.xml?rev=1631195&r1=1631194&r2=1631195&view=diff ============================================================================== --- qpid/trunk/qpid/doc/book/src/java-broker/management/channels/Java-Broker-Management-Channel-REST-API.xml (original) +++ qpid/trunk/qpid/doc/book/src/java-broker/management/channels/Java-Broker-Management-Channel-REST-API.xml Sun Oct 12 15:48:18 2014 @@ -30,7 +30,7 @@ configured object, PUT to create or update the configured object and POST to perform the configured objects updates not available with the PUT requests. The REST API is versioned with the version number built into the URL. The general form of - the the URL is /api/<version>. For convience the alias + the URL is /api/<version>. For convenience the alias latest signifies the latest supported version. There are also some ancillary service prefixed by /service. Modified: qpid/trunk/qpid/doc/book/src/java-broker/management/channels/Java-Broker-Management-Channel-Web-Console.xml URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/java-broker/management/channels/Java-Broker-Management-Channel-Web-Console.xml?rev=1631195&r1=1631194&r2=1631195&view=diff ============================================================================== --- qpid/trunk/qpid/doc/book/src/java-broker/management/channels/Java-Broker-Management-Channel-Web-Console.xml (original) +++ qpid/trunk/qpid/doc/book/src/java-broker/management/channels/Java-Broker-Management-Channel-Web-Console.xml Sun Oct 12 15:48:18 2014 @@ -23,7 +23,8 @@

Web Management Console The Web Management Console provides a simple and intuitive interface for the Management - and Control of the Broker. From here, all aspects of the Broker can be controled, including: + and Control of the Broker. From here, all aspects of the Broker can be controlled, + including: add, remove and monitor queues @@ -34,86 +35,195 @@ add, remove and monitor virtualhosts - configure and control high availabiliy + configure and control high availability - The remainder of the section provides an introduction to the web managemnet console and + The remainder of the section provides an introduction to the web management console and its use.

Accessing the Console The Web Management Console is provided by the HTTP Management Plugin. Providing the HTTP Management Plugin is in its default configuration, the Web Management Console can - be accessed by pointing a brower at the following URL: - http://myhost.mydomain.com:8080 + be accessed by pointing a browser at the following URL: + + http://myhost.mydomain.com:8080 + The Console will prompt you to login using a username and password. - +

Web Management Console - Authentication - - - - + + + + + + Web Console Authentication + + +

Orientation After you have logged on you will see a screen similar to the following. The elements of the screen are now explained. - +

Web Management Orientation - Console - - - - + + + + + + The Web Console + + + - A - Hierarchy view. Expandable/collapsable view showing all entities - within the Broker. Double click on an entity name to cause its tab to be - opened. + A - Hierarchy view. Expandable/collapsible view + showing all entities within the Broker. Double click on an entity name to + cause its tab to be opened. - B - Tab. Shows the details of an entity including its attributes and its - child entities. + B - Tab. Shows the details of an entity including its + attributes and its child entities. - C - Occluded tab. Click tab name to bring the tab to the front. + C - Occluded tab. Click tab name to bring the tab to + the front. - D - Auto restore check box. Checked tabs will be automatically restored on - subsequent login. + D - Auto restore check box. Checked tabs will be + automatically restored on subsequent login. E - Close. Click to close the tab. - F - User Menu. Access to Preferences, Logout and Help. + F - User Menu. Access to Preferences, Logout and + Help. - +

Web Management Orientation - Tab - - - - + + + + + + A tab within the Web Consle + + + The elements of a tab are now explained: - 1 - Attribute Panel. Shows the attributes of the entity. Click the panel - title bar opens/closes the panel. + 1 - Attribute Panel. Shows the attributes of the + entity. Click the panel title bar opens/closes the panel. - 2 - Child Panels. Panels containing a table listing the children of the entity. Click the panel - title bar opens/closes the panel. + 2 - Child Panels. Panels containing a table listing + the children of the entity. Click the panel title bar opens/closes the + panel. - 3 - Child Row. Row summarizing a child entity. Double click to open the - child tab. + 3 - Child Row. Row summarizing a child entity. Double + click to open the child tab. - 4 - Child Operations. Buttons to add a new child or perform operations on existing children. + 4 - Child Operations. Buttons to add a new child or + perform operations on existing children.

+ Managing Entities + All the Entities of the Broker of can be managed through the Web Console. +

+ Adding Entities + To add a new entity, click the Add button + on the Child Panel on the Parent's tab. Clicking the Add button causes an add + dialogue to be displayed. + Add dialogues allow you to set the attributes of the new child, and set context + variables. Most fields on the add dialogue have field level help that give more + details about the attribute and any default value that will take effect if you leave + the attribute unset. An example add dialogue is shown in the figure that + follows. +

+ Web Management Orientation - Add Dialogue + + + + + + Example add dialogue + + + +

+ Editing Entities + To edit an existing entity, click the Edit + button on the tab corresponding to the Entity itself. Editing an entity lets you + change some of its attributes and modify its context variables. Most fields on the + edit dialogue have field level help that give more details about the attribute and + any default value. An example edit dialogue is shown in the figure that + follows. +

+ Web Management Orientation - Edit Dialogue + + + + + + Example edit dialogue + + + +

+ Deleting Entities + To remove an existing entity, click the + Delete button on the tab corresponding to the Entity itself. + For some child types, you can select many children from the parent's type and delete + many children at once. +

+ Context Variables + All Entities within the Broker have the ability to have context + variables associated with them. + Most add and edit dialogues have the ability to make context variable assignments. + To add/change/remove a context variable, click the Context Variable panel to expand + it. +

+ Web Management Orientation - Context Variables + + + + + + Editting Context Variables + + + + You will see any context varaiables already associated with the object, called + local context variables in bold, and any inherited from above in normal face. + Since context variables can be defined in terms of other context variables, the + display has two value columns: actual and effective. Actual shows the value truely + associated with the variable, where as effective shows the resulting value, after + variable expansion has taken place. + The + button allows new variables to be added. The + - button removes existing one. + You change an existing local variables defintion by clicking on the actual value. + You can also provide a local definition for an inherited value + by clicking on the actual value and typing its new value. +

Modified: qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Broker.xml URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Broker.xml?rev=1631195&r1=1631194&r2=1631195&view=diff ============================================================================== --- qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Broker.xml (original) +++ qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Broker.xml Sun Oct 12 15:48:18 2014 @@ -23,7 +23,7 @@

Broker The Broker is the principal entity. It is - composed on a number of other entities that colabrate together to provide message broker + composed on a number of other entities that collaborate to provide message broker facilities. The Broker can only be managed via the HTTP management channel.

@@ -49,7 +49,9 @@ broker.flowToDiskThreshold Controls the flow to disk feature. + broker.messageCompressionEnabled Controls the message compression feature (co-operative feature with some Qpid clients). +

Modified: qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Plugins-HTTP.xml URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Plugins-HTTP.xml?rev=1631195&r1=1631194&r2=1631195&view=diff ============================================================================== --- qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Plugins-HTTP.xml (original) +++ qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Plugins-HTTP.xml Sun Oct 12 15:48:18 2014 @@ -22,8 +22,8 @@

HTTP Plugin - The HTTP Plugin provides the HTTP managenenent channel comprising of the Web - Managemnt Console and the REST API. + The HTTP Plugin provides the HTTP management channel comprising of the Web + Management Console and the REST API.

Attributes Modified: qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Plugins-JMX.xml URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Plugins-JMX.xml?rev=1631195&r1=1631194&r2=1631195&view=diff ============================================================================== --- qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Plugins-JMX.xml (original) +++ qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Plugins-JMX.xml Sun Oct 12 15:48:18 2014 @@ -23,7 +23,7 @@

JMX Plugin - The JMX Plugin provides the JMX managenenent channel. + The JMX Plugin provides the JMX management channel. TODO

Modified: qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Queues.xml URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Queues.xml?rev=1631195&r1=1631194&r2=1631195&view=diff ============================================================================== --- qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Queues.xml (original) +++ qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Queues.xml Sun Oct 12 15:48:18 2014 @@ -113,7 +113,7 @@ Maximum/Minimum TTL. Defines a maximum and minimum time-to-live. Messages arriving with ttl larger than the maximum will be overridden by - the maximum. Similarly, messages arriving with tll less than the miniumum (or no ttl at + the maximum. Similarly, messages arriving with tll less than the minimum (or no ttl at all), will be overridden by the minimum. Changing these values affects only new arrivals, existing messages already on the queue are not affected. @@ -130,7 +130,7 @@ Alerting Thresholds. Queues have the ability to alert on a - variety of conditions: totol queue depth exceeded a number or size, message age exceeded + variety of conditions: total queue depth exceeded a number or size, message age exceeded a threshold, message size exceeded a threshold. These thresholds are soft. See Modified: qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-RemoteReplicationNodes.xml URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-RemoteReplicationNodes.xml?rev=1631195&r1=1631194&r2=1631195&view=diff ============================================================================== --- qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-RemoteReplicationNodes.xml (original) +++ qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-RemoteReplicationNodes.xml Sun Oct 12 15:48:18 2014 @@ -24,7 +24,7 @@ Remote Replication Nodes Used for HA only. A remote replication node is a representation of another virtualhost node in the group. Remote replication nodes are not created directly. Instead the system - automatically creates a remote replciation node for every node in the group. It serves to + automatically creates a remote replication node for every node in the group. It serves to provide a view of the whole group from every node in the system.

Attributes @@ -43,7 +43,7 @@ REPLICA - Remote node is a replica. - UNREACHABLE - Remote node unreachanble from this node. + UNREACHABLE - Remote node unreachable from this node. This remote note may be down, or an network problem may prevent it from being contacted. @@ -96,7 +96,7 @@ The current master awaits the proposed master to become up to date. - The mastership is transfered. This will automatically disconnect messaging + The mastership is transferred. This will automatically disconnect messaging clients from the old master, and in-flight transactions are rolled back. Messaging clients reconnect to the new master. Modified: qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Truststores.xml URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Truststores.xml?rev=1631195&r1=1631194&r2=1631195&view=diff ============================================================================== --- qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Truststores.xml (original) +++ qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Truststores.xml Sun Oct 12 15:48:18 2014 @@ -58,10 +58,8 @@ Peers only. When "Peers Only" option is selected for - the Truststore it will allow logging in for the clients with the certificate - exactly matching the certificate loaded in the Truststore database, thus, - authenticating the connections with self signed certificates not nessesary - signed by CA. + the Truststore it will allow authenticate only those clients that present a certificate + exactly matching a certificate contained within the Truststore database.

Modified: qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-VirtualHostNodes.xml URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-VirtualHostNodes.xml?rev=1631195&r1=1631194&r2=1631195&view=diff ============================================================================== --- qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-VirtualHostNodes.xml (original) +++ qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-VirtualHostNodes.xml Sun Oct 12 15:48:18 2014 @@ -26,24 +26,26 @@

Types The following virtualhost nodes types are supported. - BDB - Node backed with Oracle BDB - Oracle BDB JE is optional. See . - - BDB HA - Node backed with Oracle BDB utilising High Availablity - DERBY - Node backed with Apache Derby - JDBC - Node backed with an external database - JDBC 4.0 compatible drivers must be available. See - - JSON - Node backed with a file containing json - Memory - In-memory node (changes lost on Broker restart) - + BDB - Node backed with Oracle BDB + Oracle BDB JE is optional. See . + + BDB HA - Node backed with Oracle BDB utilising High + Availability + DERBY - Node backed with Apache Derby + JDBC - Node backed with an external database + JDBC 4.0 compatible drivers must be available. See + + JSON - Node backed with a file containing json + Memory - In-memory node (changes lost on Broker restart) +

Attributes - + + Name the virtualhost node. @@ -52,8 +54,8 @@ configuration of the virtualhost. - Role (HA only). The role that this node is currently playing in the - group. + Role (HA only). The role that this node is currently playing in + the group. MASTER - Virtualhost node is a master. @@ -69,26 +71,40 @@ - - Priority (HA only). The priority of this node when elections occurs. The attribute can be used to make it more likely for a node to be elected than other nodes, or disallow the node from never being elected at all. See - - - Minimum Number Of Nodes (HA only - groups of three or more). Allows the number of nodes required to hold an election to be reduced in order that service can be restore when less than quorum nodes are present. See - - - Designated Primary (HA only - groups of two). Allows a single node in a two node group to operate solo. See - - + + Priority (HA only). The priority of this node when elections + occurs. The attribute can be used to make it more likely for a node to be elected than + other nodes, or disallow the node from never being elected at all. See + + + Minimum Number Of Nodes (HA only - groups of three or more). + Allows the number of nodes required to hold an election to be reduced in order that + service can be restore when less than quorum nodes are present. See + + + Designated Primary (HA only - groups of two). Allows a single + node in a two node group to operate solo. See + + +

Children - Virtualhost + + Virtualhost + - Remote Replication Nodes + + Remote + Replication Nodes + @@ -115,8 +131,8 @@ Delete. Deletes the virtualhost node and the virtualhost contained within it. All exchanges and queues, any the messages contained within it are - removed. In the HA case, deleting the virtualhost node causes it be be removed - permantently from the group. + removed. In the HA case, deleting the virtualhost node causes it be removed + permanently from the group. Modified: qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Virtualhosts.xml URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Virtualhosts.xml?rev=1631195&r1=1631194&r2=1631195&view=diff ============================================================================== --- qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Virtualhosts.xml (original) +++ qpid/trunk/qpid/doc/book/src/java-broker/management/managing/Java-Broker-Management-Managing-Virtualhosts.xml Sun Oct 12 15:48:18 2014 @@ -35,7 +35,7 @@ - BDB HA - Virtualhost backed with Oracle BDB utilising High Availablity + BDB HA - Virtualhost backed with Oracle BDB utilising High Availability DERBY - Virtualhost backed with Apache Derby @@ -50,7 +50,7 @@ Memory - In-memory node (changes lost on Broker restart) - Provided - Virtualhost that colocates message data within the parent virtualhost + Provided - Virtualhost that co-locates message data within the parent virtualhost node Not available if Virtualhost Node type is JSON. . @@ -93,6 +93,10 @@ transactions. See + + Synchronization policy. HA only. See +

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