Each Replication Agent instance can be started and shut down independently of all other components in a replication system, and independently of other Replication Agent instances.
For information about how to start a instance, see “Starting the Sybase Replication Agent”.
Shutting down the Replication Agent instance terminates its process on the host machine.
You can stop all replication processing in the Replication Agent without shutting
down the instance. For more information, see “Stopping replication in the Replication Agent”.
To shut down a Replication Agent instance, you must log in to the administration port and invoke the shutdown command. The shutdown command gives you two options:
Normal shutdown – first quiesces the Replication Agent instance, and then shuts down the instance, terminating its process.
Immediate shutdown – shuts down the Replication Agent instance and terminates its process immediately, without first quiescing. To use this method, use the immediate keyword when you invoke the shutdown command.
If the Replication Agent instance is in state transition, it
ignores the shutdown command with no option (normal
shutdown). It does not ignore shutdown
immediate when it is in any state, including transition
from one state to another.
When a Replication Agent instance is shut down normally, it does the following:
Stops reading the transaction log
Drops its connection to the primary database
Finishes processing any transactions it already has in its internal queues
Drops its connection to the Replication Server after successfully sending LTL for any transactions in its internal queues
Terminates its process
To shut down a Replication Agent instance
Log in to the Replication Agent instance with the administrator login.
Invoke the shutdown command as follows:
Use the following command to shut down the Replication Agent instance normally:
shutdown
This command first quiesces the Replication Agent instance before shutting it down. If the Replication Agent instance is in Replicating state, and the internal queues are full when you invoke shutdown, the processing may take a while to complete. Also, there may be a delay before the process terminates.
For more information, see “Quiescing the Replication Agent”.
Use the following command to force an immediate shutdown, regardless of the state of the Replication Agent instance:
shutdown immediate
This command shuts down and terminates the Replication Agent instance immediately, without first quiescing.
For more detailed information about the shutdown command, see the Sybase Replication Agent Reference Manual.
