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 OpenEdge Replication agent names. The comma must be followed by a space. 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.
database db_name Specifies the source database name.
defer-agent-startup minutes Specifies how long, in minutes, the server attempts to connect to an 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.
increment-polling-delay milliseconds Specifies the value, in milliseconds, to increase the polling delay.

By default, the 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 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 a polling delay.

By default, the minimum 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 polling delay starts at the minimum, specified by minimum-polling-delay, and automatically increases, by the amount specified by increment-polling-delay, during periods of inactivity to the maximum delay, specified by maximum-polling-delay. Once activity occurs during polling, the delay is reset to the minimum-polling-delay value.
repl-Keep-Alive seconds Specifies a time-out period for communications between a server and its agents. If a connection between the server and agent is not verified before the time-out expires, failure recovery begins.

The minimum value is 90 seconds; there is no maximum value. The default is 300 seconds.
schema-Lock-Action wait | force Specifies the action an agent takes if an exclusive schema lock is not granted. Possible actions are:
  • wait — The agent waits until the exclusive schema lock is granted. The server blocks until the exclusive schema lock is granted.
  • force — The agent attempts to acquire the exclusive schema lock five times. If the fifth attempt fails, the agent disconnects all users from the target and makes another attempt. If the last attempt fails, the server and all agents terminate. When schema update activity completes, the server and target can be restarted.
Note: Values are case-sensitive. Use wait or force, not Wait or Force.
agent-shutdown-action recovery | normal Specifies the action an agent takes during a shutdown when the replication server ends. Possible actions are:
  • recovery — The agent will remain active but in a standby state waiting for the replication server to reconnect.
  • normal — The agent will terminate; the target database will stay up.
transition auto | manual Specifies how to transition the target database to a normal database.

If a critical agent cannot reconnect with the source database within the time specified in the transition-timeout property, the following occurs:

  • auto —The agent automatically transitions the target database.
  • manual —The agent listens for the server until it reconnects with the source database or until the DSRUTIL db-name -C transition command transitions the target database.
Note: Values are case-sensitive. Use auto or manual, not Auto or Manual.
transition-timeout seconds Specifies the number of seconds the agent waits before it performs auto-transition. This property is ignored when transition=manual.

The value is incremented by the sum of the connect-timeout for all configured agents.
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.