Start/notes.ini Parameters/Server_Cluster_Default_Port

Server_Cluster_Default_Port

Parameter: Server_Cluster_Default_Port
Short description: Specifies the Notes port used for intracluster network traffic.

Profile

Parameter
Server_Cluster_Default_Port
Category
Cluster
Available since
At least 10.0.1 (HCL documentation)
GUI equivalent
According to HCL, no direct GUI option. Configurable in the Configuration document on the NOTES.INI Settings tab.
Possible values
Notes port name (e.g. TCPIP, custom cluster port)

Description

According to the HCL product documentation, Server_Cluster_Default_Port specifies the port that is used for intracluster network traffic.
Verbatim from the HCL help page Improving server availability in a cluster (admn_improvingserveravailabilityinacluster_c.html):
  • To configure a Domino server for clustering, specify a default port in the server's NOTES.INI file by using the following setting: Server_Cluster_Default_Port=portname.
  • When you specify a port, you limit cluster replication to that specific port even if the port has failed.
  • If the setting Server_Cluster_Default_Port= is not defined, the standard server search algorithm is used and all ports are tried. If the designated port fails, that is, the port specified in the Server_Cluster_Default_Port= setting, the server may be accessible from another port.
To nevertheless allow additional ports, the related parameter Server_Cluster_Auxiliary_Ports=portname can be set (HCL help page Improving server availability in a cluster).
Addition from HCL Domino 14.5.1 (dedicated reference page for this parameter): The value should be a port name, for example TCP, as specified in the Ports tab of the Server document. — So the port name must correspond to a Notes port defined on the Ports tab of the Server document.
The HCL help page Setting up a private LAN for a cluster (conf_settingupaprivatelanforacluster_t.html) additionally describes the typical use case: define a dedicated cluster port for a private LAN and pin it down as the cluster port via Server_Cluster_Default_Port.
The HCL Customer Support article KB0034324 (Improve server port availability in a cluster) refers to the same parameter.

Example configuration

Server_Cluster_Default_Port=ClusterPort
In the example, ClusterPort is a Notes port previously configured in the notes.ini (e.g. for a private cluster LAN).

Notes & pitfalls

  • Important according to HCL: if the configured port is unreachable, the server does not fall back to other ports — cluster replication and communication can therefore fail completely.
  • Without the parameter, all ports are tried (default search algorithm).
  • The related parameter Server_Cluster_Auxiliary_Ports allows additional cluster ports.
  • According to HCL there is no direct GUI equivalent.

Sources (HCL Product Documentation & Customer Support)