Pools definition#

Introduction#

A cluster pool defines the credentials and configuration shared by one or more SFTPPlus nodes. Pools are configured on the cluster controller. Every node in a pool connects to the controller using the same pool name and password.

SFTPPlus cluster nodes are managed using the node-sync resource. Configure each node with role_in_cluster = node, the controller URL, the pool_name, and the shared pool password.

Adding a new pool via Web Manager#

Open the node-sync resource and configure it with role_in_cluster = controller. Use Add cluster pool to define the pool name, password, and source IP access rules. Configure each node that belongs to the pool with these shared credentials.

Adding a new pool via text configuration#

Create a new section in the controller's configuration file. Prefix the section name with cluster-pools/, followed by the pool's UUID.

The UUID can be any unique string used to identify the pool. Once defined, the UUID should not be changed.

For example, to add a pool named pool-A:

[cluster-pools/a904e3a6-a59b-4bbf-8abd-edcae4d3774f]
name = pool-A
enabled = Yes
description = Nodes operating in data center A.
password = $5$DfjfEI8R1.fpGQg9$ADD-PASSWORD-IN-SECURE-STORE-FORMAT
source_ip_filter =
    allow 10.0.0.0/8
    allow 172.16.0.0/12

The configuration options below apply to all nodes in the pool. Their names and values are unchanged from the former cluster node configuration.

enabled#

Default value:

Yes

Optional:

Yes

From version:

5.13.0

Values:

  • Yes

  • No

Description:

Specifies whether nodes in this pool can connect to the controller.

Disabling the pool prevents its nodes from authenticating to the controller. Nodes continue to operate using their last synchronized configuration.

name#

Default value:

Empty

Optional:

No

From version:

5.13.0

Values:

  • Any text.

Description:

A short name that identifies this pool.

Configure this value as the pool_name of the node-sync resource on every node in the pool.

description#

Default value:

Empty

Optional:

Yes

From version:

5.13.0

Values:

  • Any text.

Description:

Text that describes the purpose of this pool.

source_ip_filter#

Default value:

Empty

Optional:

Yes

From version:

5.13.0

Values:

  • Source IP/CIDR access control rules

  • Empty

Description:

Defines the source IP addresses from which nodes in this pool can connect.

Leave empty to allow connections from any source IP address. For the access rule syntax, see the group configuration documentation.

failover_interval#

Default value:

600

Optional:

Yes

From version:

5.13.0

Values:

  • Number of seconds

Description:

Number of seconds added to the stable_interval configuration option for all transfers and filesystem monitors on nodes in this pool.

Use separate pools to configure different failover delays for primary and secondary nodes. Set this to 0 for a pool containing the primary node. All nodes in the same pool use the same delay.

For more details, see the transfers cluster documentation.

node_variables#

Default value:

Empty

Optional:

Yes

From version:

5.13.0

Values:

  • INI text

Description:

Configuration overrides applied to every node in this pool.

The option retains the name node_variables for compatibility.