Kbase P78073: Unable to start replication agent using dsrutil dbname ?C startagent ALL command
| Autor |
Progress Software Corporation - Progress |
| Acesso |
Público |
| Publicação |
14/04/2008 |
|
Status: Verified
FACT(s) (Environment):
Fathom Replication
SYMPTOM(s):
dsrutil dbname ?C startagent ALL does not start replication agent
defer-agent-startup option with source.repl.properties is not used
Unable to start replication agent using dsrutil dbname ?C startagent ALL command
dsrutil command hangs when trying to restart replication agent
Stopped source database using normal shutdown to take an offline backup
CAUSE:
Since OpenEdge 10.1A the naming of this command has been changed from 'startagent' to 'connectagent' to remove the parameter ambiguity. This is still refered to as 'startagent' in this Solution.
The startAgent parameter doesn't start an agent, it instructs the replication server to retry *connection* to one/all agents while in defered mode.The dsrutil dbname ?C startagent is designed to work only when using defer-agent-startup option.
FIX:
The only way to restart the Replication Agent is to restart the target database. To start a Replication Agent (RPLA), stop and then restart the target database with syntax similar to:
$ proserve <dbname> -DBService replagent -S <control-agent-port>The startagent command should only be used to connect to an agent during defer-agent-startup period. Without the deferred-agent-startup option set, any dsrutil command or client connection for that matter will block until all agents are connected to by the replication server and synchronisation has completed.
If the deferred-agent-startup option was defined when the source database was started and both the replication server and agent are still running, this command can be used to instruct the replication server to connect to the replication agent outside of the retry time intervals while replication is in deferred mode.
$ dsrutil db-name -C startagent database [name| ALL]
Note: "startagent" is "connectagent" since OpenEdge 10.1A, the functionality of these commands is the same.
Please refer to Progress Solution P109682, "How does defer agent startup work?" for further information.