Start/notes.ini Parameters/MAILCLUSTERFAILOVER

MAILCLUSTERFAILOVER

🛠️
Parameter: MAILCLUSTERFAILOVER
Short description: Enables automatic mail failover in the Domino cluster – the router delivers mails to the replica of an unreachable cluster mail server.

Profile

Parameter
MAILCLUSTERFAILOVER
Category
Cluster
Component
Server
Available since
9.0
Supported versions
9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI equivalent
Configuration document
Possible values
0 = off, 1 = on (cluster mail failover active)

Description

If the primary mail server of a recipient is unreachable, the router in a Domino cluster can deliver the message directly to the mail.box of a cluster replica instead. MAILCLUSTERFAILOVER=1 activates exactly this behavior. As a result, mails keep flowing even during server outages or maintenance windows, without getting stuck in the hold queue. The recipient sees the mail the next time the Notes Client accesses the cluster replica.

Example configuration

MAILCLUSTERFAILOVER=1

Notes & pitfalls

  • Requires a working Domino cluster with mail replicas (Cluster Replicator, ACLs).
  • Takes effect after a router restart (tell router quit / load router) or a configuration reload.
  • Pairs with Notes Client failover (cluster cache) for continuous availability.
  • For compliance / audit requirements, verify that the failover replica is subject to the same journaling / backup policies.