Cluster Details Panel

The Cluster details panel presents the details of a persistence cluster definition. In edit mode, you can modify the parameter values.

From the left menu, select Clusters, select the three dots above a cluster, then select View Details.

Heartbeats and Timeouts

You can adjust the persistence heartbeat and timeout parameters, which detect persistence service availability. For best results, use the default values, except to resolve specific issues or as directed by TIBCO personnel.

GUI Parameter	JSON Attribute	Description
Persistence Heartbeat (Server to the Client)	`client_pserver_heartbeat`	The leader persistence service sends heartbeats to its clients at this interval, in seconds. The default is 2 seconds.
Timeout Interval (Sever to Client)	`client_timeout_pserver`	When the leader’s heartbeat is silent for this interval, in seconds, its clients seek to connect to a new leader from among the other services in the cluster. The default is 5 seconds. When a client's heartbeat is silent for this interval, the persistence service clears all state associated with the client.
Persistence Heartbeat (Server to Server)	`pserver_pserver_heartbeat`	Persistence services in the cluster exchange heartbeats at this interval, in seconds. The default is 0.5 seconds.
Timeout Interval (Server to Server)	`pserver_timeout_pserver`	When the heartbeat of any service in the cluster is silent for this interval, in seconds, the remaining services attempt to form a new quorum. The default is 3 seconds.
Persistence Heartbeat (Cluster to Cluster)	`inter_cluster_heartbeat`	The leader persistence services of different persistence clusters in a forwarding zone exchange heartbeats at this interval, in seconds. The default is 2 seconds.
Timeout Interval (Cluster to Cluster)	`inter_cluster_timeout`	When the heartbeat from a leader persistence service in a second cluster is silent for this interval, in seconds, the leader of the first cluster will attempt to reconnect. The default is 5 seconds.

Disk Settings

For discussion on these features, see Persistence Concepts and Disk-Based Persistence.

GUI Parameter	JSON Attribute	Description
Message Swapping	`disk_swap`	When enabled, message data is swapped to disk. This allows the persistence service to store more message data than available memory. This setting affects both persistent (replicated) and non-persistent (non-replicated) messages. Note that, if the indexes on disk feature is enabled, persistent messages are always swapped to disk, regardless of this setting. Changing this setting requires a restart of all persistence services in the cluster.
Disk Persistence Mode	`disk_persistence`	Select the disk persistence mode. Only persistent (replicated) messages are persisted on disk. None Disable disk persistence. sync The send-message call returns once the message has been written persistently to a majority of disks. async The send-message call returns once the OS has buffered the write of the message. A tail end of data can be lost if a majority of server hosts crash simultaneously. Changing this setting requires a restart of all persistence services in the cluster.
Automatic compaction	`disk_compact`	Set to enable or disable automatic disk compaction. This setting applies to both non-persistent messages (if swapping is enabled) and persistent messages. Note that, if the indexes on disk feature is enabled, automatic compaction is always enabled for persistent messages, regardless of this setting. Changing the setting does not require a restart.
Compact When In-Use Ratio Below	`disk_compact_settings.min_disk_inuse_ratio`	Set a value between 0 and 1, inclusive. The persistence service attempts to keep the ratio of disk inuse size to disk allocated size at or above the specified value. If the ratio of in-use to allocated size falls below this value, the persistence service can start a compaction. Automatic compaction does not occur if the disk inuse size is extremely small. Automatic compaction must be enabled for this value to take effect. Note that, if the indexes on disk feature is enabled, this threshold is ignored for persistent messages. Automatic compaction is always enabled for persistent messages. Changing the setting does not require a restart.
Indexes on Disk	`disk_index`	When enabled, message data, indexes, and metadata for persistent messages are stored on disk. No memory is consumed to store persistent messages. Also, when the persistence service restarts, it can recover from disk immediately (without having to read message metadata from disk). Changing this setting requires a restart of all persistence services in the cluster.

Cluster Limits and Force Quorum Settings

GUI Parameter JSON Attribute Description

GUI Parameter	JSON Attribute	Description
Force Quorum Delay	`force_quorum_delay`	Automatically force a quorum after this delay, in seconds. Zero is a special value indicating that automatic force formation is disabled. This setting can be used to ensure that the quorum always forms without administrator intervention. A majority of non-empty servers is usually enough to form a quorum, however in some situations (such as DR activation or recovery from a backup file), the quorum can't form unless all members are present. If some servers are still missing, this option forces the quorum to form automatically after the specified delay. Administrators may still manually force a quorum if this setting is configured. See Quorum Behaviors and Before Forcing a Quorum.
Byte Limit	`bytelimit`	This parameter limits the volume of message data in the cluster. If publishing another message would exceed this limit, the cluster rejects that message. The store may grow until it exhausts available memory or disk of any one of its persistence services. Zero is a special value, indicating no limit. The store may grow until it exhausts available memory of any one of its services. When messages are stored on disk, message metadata is still stored in memory. Use this setting to constrain memory for message metadata. See Size Units Reference.
Message Limit	`message_limit`	This parameter limits the number of messages that can be held by the cluster. When this limit is reached, the client receives an exception on `tibPublisher_Send` or `tibPublisher_SendMesages` (when `cluster_confirm_send` mode is set on the cluster). However, the client library retries the sends. To have the exception presented to the user, the client application must specify a finite persistence retry duration. Note that even when messages are stored on disk, message metadata is still stored in memory. Hence, use this setting to constrain memory use. Zero is the default value indicating no limit. The cluster may grow until it exhausts available memory or disk of any one of its persistence services.

Force Quorum Delay

force_quorum_delay

Automatically force a quorum after this delay, in seconds. Zero is a special value indicating that automatic force formation is disabled.

This setting can be used to ensure that the quorum always forms without administrator intervention. A majority of non-empty servers is usually enough to form a quorum, however in some situations (such as DR activation or recovery from a backup file), the quorum can't form unless all members are present. If some servers are still missing, this option forces the quorum to form automatically after the specified delay.

Administrators may still manually force a quorum if this setting is configured. See Quorum Behaviors and Before Forcing a Quorum.

Byte Limit

bytelimit

This parameter limits the volume of message data in the cluster. If publishing another message would exceed this limit, the cluster rejects that message.

The store may grow until it exhausts available memory or disk of any one of its persistence services.

Zero is a special value, indicating no limit. The store may grow until it exhausts available memory of any one of its services.

When messages are stored on disk, message metadata is still stored in memory. Use this setting to constrain memory for message metadata.

See Size Units Reference.

Message Limit

message_limit

This parameter limits the number of messages that can be held by the cluster. When this limit is reached, the client receives an exception on tibPublisher_Send or tibPublisher_SendMesages (when cluster_confirm_send mode is set on the cluster). However, the client library retries the sends. To have the exception presented to the user, the client application must specify a finite persistence retry duration.

Note that even when messages are stored on disk, message metadata is still stored in memory. Hence, use this setting to constrain memory use.

Zero is the default value indicating no limit. The cluster may grow until it exhausts available memory or disk of any one of its persistence services.

Externally Reachable Addresses

When using persistence with zones of clusters that use an auto inter-cluster transport to address the cluster (or to address a load balancer's interface), use this field to identify one or more ports for the core servers of this cluster (or the port for the load balancer).

GUI Parameter	Description
Host	Enter either an IP address or a resolvable hostname.
Port	Enter the port number to use to access this host.

Did you find this helpful?

Yes No