Start/notes.ini Parameters/Repl_Push_Retries

Repl_Push_Retries

Parameter: Repl_Push_Retries
Short description: Number of attempts to perform a push replication to a Domino server — helpful when several users access the same replica simultaneously.

Profile

Parameter
Repl_Push_Retries
Category
General (replication)
Available since
At least 9.0.1 (HCL documentation)
GUI equivalent
According to HCL, no direct GUI option. Configurable in the Configuration document on the NOTES.INI Settings tab.
Wait time between attempts
30 seconds (fixed, not changeable)

Description

According to the HCL product documentation, Repl_Push_Retries specifies the number of attempts to perform a push replication to a Domino server.
Verbatim from the HCL docs: When you see the message Database is currently being replicated or copied elsewhere, use this setting to make sure the replication occurs. You usually see this message when several Notes users are replicating to the same replica copy of a database on the same server.
Important: The default retry wait period of 30 seconds cannot be changed. (The wait time between retries is a fixed 30 seconds and cannot be adjusted.)
HCL recommendation: You should use the Replicators setting to specify multiple replicators rather than using this setting. (HCL primarily recommends configuring multiple replicators instead of increasing the retry count.)

Example configuration

Repl_Push_Retries=3
The value serves as a placeholder. HCL gives no recommended numeric value in the product documentation.

Notes & pitfalls

  • The retry wait time (30 seconds) is, according to HCL, not configurable.
  • HCL primarily recommends using multiple replicators (Replicators=N) instead of a higher retry count.
  • According to HCL there is no direct GUI equivalent; the value can be maintained via the NOTES.INI Settings tab of a Configuration document.
  • The typical symptom message is: Database is currently being replicated or copied elsewhere.

Sources (HCL Product Documentation)