[ https://issues.apache.org/jira/browse/QPID-8409?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Alex Rudyy updated QPID-8409: ----------------------------- Fix Version/s: (was: Future) qpid-java-broker-8.0.0 > [Broker-J]Misleading Documentation of "Node Priority" for the initial > configuration > ----------------------------------------------------------------------------------- > > Key: QPID-8409 > URL: https://issues.apache.org/jira/browse/QPID-8409 > Project: Qpid > Issue Type: Improvement > Components: Broker-J > Affects Versions: qpid-java-broker-7.1.7 > Reporter: Ansgar Sachs > Priority: Minor > Labels: documentation > Fix For: qpid-java-broker-8.0.0 > > > h3. User Story > {quote}As a developer, I want to easily create a HA cluster by just reading > the documentation.{quote} > h3. State of Play > In order to configure a Qpid Cluster, you got the following hints: > 1) Create it in the web UI - it requires a lot of clicking and is (in my > opinion) not the way as devOps guy would want to setup a cluster > 2) Use the initial configuration > Besides all the missing information of what can be actually configured in > this initial configuration, > the following property is completely miscommunicated: *Node Priority*. > The following [page|#Java-Broker-High-Availability-Behaviour-NodePriority]] > states, that this configuration property can be represented by the values > "_Highest_", "_High", "__Normal", "__Never"._ > And yes, this configuration can be set in the web UI - however, it is rather > hidden. And of course, these values don't work inside the initial > configuration. > So let's take a look into the actual API documentation, which is > unfortunately only available, when you have already a running broker > available > ([http://localhost:8080/apidocs/latest/virtualhostnode|http://localhost:8082/apidocs/latest/virtualhostnode]): > h3. BDB_HA Specific Attributes > ||Attribute Name||Type||Properties|| > |priority|number|read/write| > > This API doc states that the priority is of type number - and again: setting > a number as priority is not working. > However, the actual configuration (that works) looks as follows: > > {code:java} > { > ... > virtualhostnodes: [{ > ..., > priority: "2" > ... > }] > ... > }{code} > As you can see, it is a *stringified* number ("2") whereas a pure number > isn't working (2). > h3. Steps to achieve victory > (x) Add a subchapter in the initial configuration that states *how to > configure a HA cluster* by just using the initial config file. > (x) Add a complete documenation of any configuration property > > > -- This message was sent by Atlassian Jira (v8.3.4#803005) --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@qpid.apache.org For additional commands, e-mail: dev-h...@qpid.apache.org