Table of Contents
The section Section 5.1, “Introduction” provides an introduction into Broker-J initial configuration and how broker configuration can be created from initial configuration on first broker start-up. This appendix illustrates how to create a BDB HA group from an initial configuration file. For creation of BDB HA group using Web Management Console please refer Section 6.2, “Web Management Console”.
The BDB HA group usually consists of two or more nodes hosting a distributed virtual host.
When BDB HA node is created the following attributes has to be provided
groupName; a name of BDB HA group
nodeName; a name of BDB HA node
address; a node address as colon-separated pair of host name and port
helperAddress; an address of existing helper node. It is required when node joins an existing group.
helperNodeName; a name of existing helper node. It is required when node joins an existing group.
permittedNodes; an array containing all addresses of nodes allowed to join the group.
A node priority can be optionally specified for the node to influence master election among nodes with the most current set of data. An attribute priority is used to specify a priority as an integer number.
Apart from a group name and permitted nodes, the rest of node attribute values varies from node to node.
In order to use the same initial configuration for creation of BDB HA nodes, the context variable can be used for varying attribute values.
In the example of initial configuration illustrated in this apendix, the following context variables are defined.
${ha.group_name}; used to pass an HA group name
${ha.node_name}; used to pass a node name
${ha.node_address}; used to pass a node address
${ha.helper_address}; used to pass an address of helper node.
${ha.helper_node_name}; used to pass an address of helper node.
${ha.permitted_nodes}; used to pass a stringified json array containing permitted nodes for the group.
${ha.priority}; used to pass a node priority.
An example of 'Initial Configuration' for BDB HA:
Example H.1. BDB HA 'Initial configuration'
{
"name": "${broker.name}",
"modelVersion" : "9.0",
"authenticationproviders" : [ {
"name" : "plain",
"type" : "Plain",
"users" : [ {
"name" : "guest",
"type" : "managed",
"password" : "guest"
} ]
} ],
"brokerloggers" : [ {
"name" : "logfile",
"type" : "File",
"fileName" : "${qpid.work_dir}${file.separator}log${file.separator}qpid.log",
"brokerloginclusionrules" : [ {
"name" : "Root",
"type" : "NameAndLevel",
"level" : "WARN",
"loggerName" : "ROOT"
}, {
"name" : "Qpid",
"type" : "NameAndLevel",
"level" : "INFO",
"loggerName" : "org.apache.qpid.*"
}, {
"name" : "Operational",
"type" : "NameAndLevel",
"level" : "INFO",
"loggerName" : "qpid.message.*"
}, {
"name" : "Statistics",
"type" : "NameAndLevel",
"level" : "INFO",
"loggerName" : "qpid.statistics.*"
} ]
}, {
"name" : "memory",
"type" : "Memory",
"brokerloginclusionrules" : [ {
"name" : "Root",
"type" : "NameAndLevel",
"level" : "WARN",
"loggerName" : "ROOT"
}, {
"name" : "Qpid",
"type" : "NameAndLevel",
"level" : "INFO",
"loggerName" : "org.apache.qpid.*"
}, {
"name" : "Operational",
"type" : "NameAndLevel",
"level" : "INFO",
"loggerName" : "qpid.message.*"
}, {
"name" : "Statistics",
"type" : "NameAndLevel",
"level" : "INFO",
"loggerName" : "qpid.statistics.*"
} ]
} ],
"ports" : [ {
"name" : "AMQP",
"port" : "${qpid.amqp_port}",
"authenticationProvider" : "plain",
"virtualhostaliases" : [ {
"name" : "nameAlias",
"type" : "nameAlias"
}, {
"name" : "defaultAlias",
"type" : "defaultAlias"
}, {
"name" : "hostnameAlias",
"type" : "hostnameAlias"
} ]
}, {
"name" : "HTTP",
"port" : "${qpid.http_port}",
"authenticationProvider" : "plain",
"protocols" : [ "HTTP" ]
}],
"virtualhostnodes" : [ {
"name" : "${ha.node_name}",
"type" : "BDB_HA",
"address" : "${ha.node_address}",
"groupName" : "${ha.group_name}",
"helperAddress" : "${ha.helper_address}",
"helperNodeName" : "${ha.helper_node_name}",
"permittedNodes" : "${ha.permitted_nodes}",
"priority" : "${ha.priority}",
"defaultVirtualHostNode" : "true",
"virtualHostInitialConfiguration" : "${qpid.initial_config_virtualhost_config}"
} ],
"plugins" : [ {
"type" : "MANAGEMENT-HTTP",
"name" : "httpManagement"
} ]
}
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