# Virtualhost Nodes

Virtualhost nodes can only be managed by the HTTP management channel.

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

- Store Path or JDBC URL. Refers the location used to store the configuration of the virtualhost.

- Role (HA only). The role that this node is currently playing in the group.

  - MASTER - Virtualhost node is a master.

  - REPLICA - Virtualhost node is a replica.

  - WAITING - Virtualhost node is awaiting an election result, or may be awaiting more nodes to join in order that an election may be held.

  - DETACHED - Virtualhost node is disconnected from the group.

- 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

- Remote Replication Nodes

## Lifecycle

- Stop. Stops the virtualhost node. This closes any existing messaging connections to the virtualhost and prevents new ones. Any inflight transactions are rolled back. Non durable queues and exchanges are lost. Transient messages or persistent messages on non-durable queues are lost.

  When HA is in use, stopping the virtualhost node stops the virtualhost node from participating in the group. If the node was in the master role, the remaining nodes will try to conduct an election and elect a new master. If the node was in the replica role, the node will cease to keep up to date with later transactions. A stopped node does not vote in elections. Other nodes in the group will report the stopped node as unreachable.

- Start. Activates the virtualhost node.

- 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 removed permanently from the group.