Release 10.1B: Progress Fathom Replication
User Guide


Control agent properties

Table 5–2 is a list of control agent properties and their values. Control agent properties define to the server which agents it can contact, where it can contact them, and how the agents should perform.

The properties are specified after the [control-agent.name] directive in the source properties file. The value of name must exactly match one of the names specified for the control-agents property under the [server] directive. If you run two agents, you need a [control.agent.name] directive for each of the agents.

Property names and values are separated by an equals sign. For example:

name=agent1 

Table 5–2: Control agent properties
Property name
Value
Description
connect-timeout 
seconds 
Specifies for how long, in seconds, the server will attempt to connect to its configured agents.
This property is also used by the server while reconnecting to the agent after communication has been lost.
Specifies how many seconds the Fathom Replication agent will wait for connection from the Fathom Replication server before Replication Agent shuts itself down.
seconds is an integer >= 120 and <= 86,400.
Using this property means you do not have to do a forced shutdown on your target database. If the Fathom Replication agent does not receive a connection attempt from the Fathom Replication server before the number of seconds specified has elapsed, the Fathom Replication agent will terminate and allow some limited system-level target database connections.
critical 
0 | 1 
Specifies whether the agent is critical:
  • 1 is critical.
  • 0 is the default value of noncritical.
A critical agent is an asynchronous agent for the target database that can become the source database if the source database becomes unavailable.
database 
db-name 
Specifies the source database name.
host 
IP-address|hostname 
Specifies to the server which host the agent will start on.
name 
agent-name 
Specifies the Fathom Replication agent name. By convention, the agent-name should match the name specified in the target database properties file. This directive is used only by Progress Explorer.
ALL is not allowed as an agent name. Each agent must have a unique name.
port 
service-name | port-num 
Specifies which port the server should use to connect to the target database. The port number specified must be the same port specified with the -S parameter when the target database broker was started.
replication-method 
async | sync 
Specifies the type of replication, either asynchronous (async) or synchronous (sync).

Note: Values are case-sensitive. Use async or sync, but not Async or Sync.


Copyright © 2006 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095