Try OpenEdge Now
skip to main content
User Guide
Setting Up OpenEdge Replication : Configuring the OpenEdge Replication property files : Server properties
 

Server properties

Server properties are found after the [server] directive in the OpenEdge Replication source properties file.
Property names and values are separated by an equal sign (for example, transition=auto).
The following table provides a list of server properties and their values.
Table 5. 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).
minutes is a value of 0, or in the range from 5 to less than or equal to 10080.
maximum-polling-delay
milliseconds
Specifies the maximum value, in milliseconds, for a polling delay.
By default, the polling delay starts at 5 ms and automatically increases during periods of inactivity to a maximum of 500 ms.
milliseconds is a value greater than 500 and less than 1000.
minimum-polling-delay
milliseconds
Specifies the minimum value, in milliseconds, for a polling delay.
By default, the polling delay starts at 5 ms and automatically increases during periods of inactivity to a maximum of 500 ms.
milliseconds is a value greater than or equal to 1 and less than or equal to 10.
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 defaults 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 synchronous agent or 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
.