HClusterAddNode (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / Managing databases / HFSQL Cluster / WLanguage functions

Operating mode of the nodes in a cluster

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HClusterAddNode (Function)

In french: HClusterAjouteNoeud

Available only with this kind of connection

Enables a node in an HFSQL cluster.

Notes:

HClusterAddNode is automatically called when installing a new node. This function is reserved for an advanced use.
HClusterAddNode does not install the HFSQL server and it does not add any DNS record to allow the access to the new node.

Example

// Ajout du serveur HFSQL installé sur host3.masociete.com dans le
// cluster administré par clustermanager.masociete.com
HClusterAddNode("clustermanager.masociete.com", "secret", "host3.masociete.com")

Syntax

<Result> = HClusterAddNode(<Coordinator> , <Password> , <New node>)

<Result>: Boolean

True if the addition was successful,
False otherwise. For more details on the error, use ErrorInfo.

<Coordinator>: Character string

DNS name of the cluster coordinator's machine.

<Password>: Character string or Secret string

Password used to connect to the coordinator. This password was given when installing the cluster.
New in version 2025
Secret strings: If you use the secret string vault, the type of secret string used for this parameter must be "ANSI or Unicode string".
To learn more about secret strings and how to use the vault, see Secret string vault.

<New node>: Character string

Name of the node to add. This parameter corresponds to the DNS name of the computer on which the new HFSQL server was installed.

Remarks

Operating mode of the nodes in a cluster

The address of the cluster coordinator is written into the configuration file of each one of the nodes when they are installed. Therefore, when starting the HFSQL Server service, the node is automatically connected to the cluster.

Then, HClusterAddNode and HClusterDeleteNode can be used to include or exclude a node to/from the list of active cluster nodes.

When a node is enabled by HClusterAddNode, this node synchronizes its databases with the ones of the other nodes and it processes the connection requests from the clients.

When a node is disabled by HClusterDeleteNode, this node stops synchronizing its databases and it does no longer accept any connection from the client applications.

Business / UI classification: Business Logic

Component: wd300hf.dll