Server properties are found after the [server] directive in the OpenEdge Replication source properties file. A properties file can only have one [server] section.

Property names and values are separated by an equal sign (for example, transition=auto).

Note: When you add comments to a properties file, place them on a new line that begins with the pound sign (#). Do not specify a comment on the same line as a property value definition.

The following table provides a list of server properties and their values.

Table 1. Server properties
Property name Value Description
control-agents agent_name[, agent_name] Specifies a comma-separated list of replication agent names.

The agent name must match the control agent name specified in the [control-agent] properties section head.

ALL is not allowed as an agent name. Each agent must have a unique name.
Note: agent-name has a 15-character maximum limit.
database db_name Specifies the replication source database name.
defer-agent-startup minutes Specifies how long, in minutes, the replication server attempts to connect to a replication agent if the first connection attempt is unsuccessful.

The default value is 0 (not active).

Set minutes to 0, or a value between 5 and 10080, inclusive.

For more information, see Use the deferred agent startup mode.
increment-polling-delay milliseconds Specifies the value, in milliseconds (ms), to increase the message polling delay.

By default, the message polling delay increment is 5 ms. For configurations with AI Streaming enabled, the default is 1 ms.1

Set milliseconds to a value between 1 and 1000, inclusive. The value must be less than maximum-polling-delay.
maximum-polling-delay milliseconds Specifies the maximum value, in milliseconds, for the message polling delay.

By default, the maximum polling delay is 500 ms.

Set milliseconds to a value between 500 and 1000, inclusive.
minimum-polling-delay milliseconds Specifies the minimum value, in milliseconds, for the message polling delay.

By default, the minimum message polling delay is 5 ms. For configurations with AI Streaming enabled, the default is 20 ms.1

Set milliseconds to a value between 1 and 30, inclusive.

The message polling delay starts at the minimum, specified by minimum-polling-delay. During periods of inactivity the message polling delay increases by the amount specified by increment-polling-delay to the maximum delay, specified by maximum-polling-delay. Once activity occurs during message polling, the message polling delay is reset to the minimum-polling-delay value.
repl-keep-alive seconds Specifies a time-out period for network communication between a replication server and its connected replication agents. If a connection between the replication server and replication agent is not verified before the time-out expires, failure recovery begins.

The minimum value is 90 seconds, and the default is 300 seconds.
schema-lock-action wait | force Specifies the action a replication agent takes if there is a conflict in acquiring the exclusive schema lock on the target database.

Possible values are:

  • wait—The replication agent waits until the exclusive schema lock is granted. The replication server blocks until the exclusive schema lock is acquired by the replication agent. This is the default value.
  • force—The replication agent attempts to acquire the exclusive schema lock five times, with a fifteen second interval between each attempt. If the fifth attempt fails, the replication agent disconnects all users from the target database and makes another attempt. If the last attempt fails, the replication server and all replication agents terminate. When source database schema update activity completes, the replication server and replication agent can be restarted.
Note: Values are case-sensitive. Use wait or force, not Wait or Force.
agent-shutdown-action recovery | normal Specifies the action a replication agent takes when the replication server is shutdown.

Poosible values are:

  • recovery—The replication agent will remain active but in a standby state waiting for the replication server to reconnect.
  • normal—The replication agent will terminate; the target database will stay up. This is the default value.
transition auto | manual Specifies how recovery transition is performed on the replication target databases.

Recovery transition is performed to transition a replication target database to a replication source database following a loss of network connection between the replication agent and replication server.

Possible values are:

  • auto—If the critical replication agent is not reconnected with the replication server within the time specified in the transition-timeout property, the replication agent automatically transitions the target database.
  • manual—The replication agent listens indefinitely for the replication server to reconnect, or transitions when the DSRUTIL db-name -C transition command is run manually. This is the default value.
Note:
  • Values are case-sensitive. Use auto or manual, not Auto or Manual.
  • The replication server may adjust the transition property value for a particular replication agent at startup. If transition=auto and the replication agent is not critical, the replication server automatically resets the replication agent's transition=manual.
  • The replication agent may adjust the method it uses to perform recovery transition when receiving a connection message from the replication server: If transition=auto and agent-shutdown-action=recovery, the replication agent automatically resets its recovery transition method to manual.
transition-timeout seconds Specifies the number of seconds the replication agent waits for the replication server to reconnect before automatically transitioning the target database to its new role.

This property is ignored when transition=manual.

The value is incremented by the sum of the connect-timeout for all configured agents.

Set seconds to a value greater than or equal to 0 and less than or equal to 86,400; the default value is 1200.
1 The connect message between the agent and server informs the server when AI Streaming is enabled. In response, the server sets the minimum-polling-delay to 20 ms, and the increment-polling-delay to 1 ms. These values override any previous setting, including values set in the properties file. The change to the property settings is written to the server's database log file when the first AI Streaming agent is connected.