Kbase P54810: How to restart the Replication Server using the DSRUTIL Utility
| Autor |
Progress Software Corporation - Progress |
| Acesso |
Público |
| Publicação |
22/04/2011 |
|
Status: Verified
GOAL:
How to restart the Replication Server using the DSRUTIL Utility
GOAL:
Why the DSRUTIL command should be used to Restart the Replication Server, when the database was not stopped.
FACT(s) (Environment):
All Supported Operating Systems
Progress 9.1D
Progress 9.1E
OpenEdge 10.x
Fathom Replication
FIX:
DSRUTIL Utility should be used once Fathom Replication has been initially set up, enabled, and started.
The DSRUTIL Utility is used to perform specific Fathom Replication server, Fathom Replication agent, source, and target database requests.
dsrutil <database-name> -C restart <Fathom-Replication-server-name>
The syntax for this utility is as follows:
DSRUTIL database -C ACTION [Server|Agent] [name]
database
Database is the name of the database to perform the action on. The name of the database must be the first argument or it must be preceded with -db.
-db database
The name of the database to perform the action on. When the database name is specified after the -db argument, the -db database argument group can appear anywhere on the command line.
-C ACTION [modifier] [name]
The -C argument is used to specify the action to be performed on the database. Details of this argument are described in Table 5?2.
Server | Agent
The action will be performed on the Fathom Replication server or the Fathom Replication agent.
name
The name of the Fathom Replication agent to perform the action on. Each Fathom Replication server maintains a list of named Fathom Replication agents that it is communicating with.
RESTART Server:
The Fathom Replication server is restarted. The action will not be performed if the Fathom Replication server is currently running. The advantage to using this command is that you do not have to restart the database.
Although the documented syntax implies that you can restart a replication agent (target side process), this is not possible via this command. You can only restart a replication server (source side process) using dsrutil. To restart the replication agent you must stop and restart the target database.
Typical example to restart the replication server process on the source database:
dsrutil <dbname> -C restart server
For additional information on the DRSUTIL please see the Progress Fathom High Availability Replication User?s Guide