HClusterAddNode (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

Managing databases

Managing HFSQL Cluster

WLanguage functions

HClusterAddNode

Presentation

Example

Operating mode of the nodes in a cluster

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

// Add the HFSQL server installed on host3.mycompany.com into the
// cluster managed by clustermanager.mycompany.com
HClusterAddNode("clustermanager.mycompany.com", "secret", "host3.mycompany.com")

Syntax

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

<Result>: Boolean

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

<Coordinator>: Character string

DNS name of computer where the cluster coordinator is installed.

<Password>: Character string

Password used to connect to the coordinator. This password was given when installing the cluster.

<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: wd270hf.dll