epadmin-availabilityzone

epadmin availabilityzone target — Manages StreamBase Runtime availability zones.

SYNOPSIS

epadmin [globalparameters] command availabilityzone [commandparameters]

DESCRIPTION

Use the availabilityzone target to display, rebalance, or restore an availabilityzone, which is a high availability feature of a TIBCO Streaming cluster. Configure availability zones in a node deployment configuration file; there is a default zone if not configured. See availabilityzone in the Architecture Guide.

The availabilityzone target has three commands:

The designation [sn|ad] in syntax examples is a reminder that this command requires either the global parameter ‑‑servicename or the ‑‑adminport and ‑‑hostname combination to identify the node or cluster of interest.

epadmin display availabilityzone

Displays basic information about the availabilityzone structure of a cluster. For example, for a cluster named sbuser with two nodes running:

epadmin --servicename=sbuser display availabilityzone

Returns:

[B.sbuser] Availability Zone = default-cluster-wide-availability-zone
[B.sbuser] Data Distribution Policy = default-dynamic-data-distribution-policy
[B.sbuser] Nodes = A.sbuser,B.sbuser
[B.sbuser] Quorum State = Not Enabled
[B.sbuser] Re-balancing = false
[A.sbuser] Availability Zone = default-cluster-wide-availability-zone
[A.sbuser] Data Distribution Policy = default-dynamic-data-distribution-policy
[A.sbuser] Nodes = B.sbuser,A.sbuser
[A.sbuser] Quorum State = Not Enabled
[A.sbuser] Re-balancing = false
Command Parameter Description Required
name Specifies the name of a particular availabilityzone for large clusters with more than one. No. The default is to display all availability zones.

epadmin rebalance availabilityzone

If the data distribution policy for a zone allows it, you can dynamically rebalance the distribution of data across an availabilityzone. You might need to do this if a node fails or is taken out of service, or in a multi-master situation (described in the Node Quorum section of the High Availability page of the Architecture Guide).

epadmin [sn|ad] rebalance availabilityzone
epadmin [sn|ad] rebalance availabilityzone --wait
epadmin [sn|ad] rebalance availabilityzone --name=cluster-availzone
epadmin [sn|ad] rebalance availabilityzone --threads=4 --chunksize=500
Command Parameter Description Required
chunksize The number of objects to lock per transaction when sending data to remote nodes. No. Default value is set in data distribution policy.
name The name of an availability zone to rebalance No. Default is to rebalance all availability zones.
threads The number of threads to use when sending data to remote nodes. No. Default value is set in data distribution policy.
wait Boolean value controlling whether to wait for the rebalance to complete before returning. A value of false causes the command to return immediately with the rebalance completing asynchronously. A value of true causes the command to block until the rebalance completes. No. Default value is false.

epadmin restore availabilityzone

Use this command to restore an availabilityzone after a multi-master event, as described in the Node Quorum section of the High Availability page of the Architecture Guide).

epadmin [sn|ad] restore availabilityzone
epadmin [sn|ad] restore availabilityzone --name=cluster-availzone
epadmin [sn|ad] restore availabilityzone --threads=4 --chunksize=500
epadmin [sn|ad] restore availabilityzone --action=replace --from=B.X
Command Parameter Description Required
action One of combine, replace, or merge.
  • combine copies all data from a remote node to the local node, and any data conflicts causes the restore to fail.

  • replace removes all data on the local node and replaces it with data from the remote node.

  • merge compares the data on the local and remote nodes and resolves any conflicts.

No. Default is merge.
chunksize The number of objects to lock per transaction when sending data to remote nodes. No. Default value is set in the data distribution policy.
from Restore data from this node. No. Default is determined using a cluster wide broadcast to locate an active node to restore from.
name The name of the availability zone being restored. No. Default is to restore all availability zones.
threads The number of threads to use when sending data to remote nodes. No. Default value is set in the data distribution policy.