Continuent Documentation

Search:
Page in Other Manuals

8.9. The connector Command

The connector is the wrapper script that handles the execution of the connector service.

Table 8.18. connector Commands

OptionDescription
client-listReturn a list of the current client connections through this connector.
condrestartRestart only if already running
consoleLaunch in the current console (instead of a daemon)
dumpRequest a Java thread dump (if connector is running)
graceful-stopStops the connector gracefully, allowing outstanding an open connections to finish and close before the connector process is stopped.
installInstall the service to automatically start when the system boots
reconfigureReconfigure the connector by forcing the connector to reread the configuration, including the configuration files and user.map.
removeRemove the service from starting during boot
restartStop connector if already running and then start
startStart in the background as a daemon process
statusQuery the current status
stopStop if running (whether as a daemon or in another console)

These commands and options are described below:

client-list

Return a list of the current client connections through this connector.

condrestart

Restart the connector, only if it is already running. This can be useful to use when changing configuration or performing database management within automated scripts, as the connector will be only be restart if it was previously running.

For example, if the connector is running, connector condrestart operates as connector restart:

shell> connector condrestart
Stopping Tungsten Connector Service...
Waiting for Tungsten Connector Service to exit...
Stopped Tungsten Connector Service.
Starting Tungsten Connector Service...
Waiting for Tungsten Connector Service......
running: PID:26646

However, if not already running, the operation does nothing:

shell> connector condrestart
Stopping Tungsten Connector Service...
Tungsten Connector Service was not running.

console

Launch in the current console (instead of a daemon)

dump

Request a Java thread dump (if connector is running)

graceful-stop

Stops the connector gracefully, allowing outstanding an open connections to finish and close before the connector process is stopped.

install

Installs the startup scripts for running the connector at boot. For an alternative method of deploying these start-up scripts, see deployall.

reconfigure

Reconfigure the connector by forcing the connector to reread the configuration, including the configuration files and user.map.

remove

Removes the startup scripts for running the connector at boot. For an alternative method of removing these start-up scripts, see undeployall.

restart

Warning

Restarting a running connector temporarily stops and restarts replication.

Stops the connector, if it is already running, and then restarts it:

shell> connector restart
Stopping Tungsten Connector Service...
Stopped Tungsten Connector Service.
Starting Tungsten Connector Service...
Waiting for Tungsten Connector Service......
running: PID:26248

start

To start the connector service if it is not already running:

shell> connector start
 Starting Tungsten Connector Service...

status

Checks the execution status of the connector:

shell> connector status
Tungsten Connector Service is running: PID:27015, Wrapper:STARTED, Java:STARTED

If the connector is not running:

shell> connector status
Tungsten Connector Service is not running.

This only provides the execution state of the connector, not the actual state of replication. To get detailed information on the status of replication use trepctl status.

stop

Stops the connector if it is already running:

shell> connector stop
Stopping Tungsten Connector Service...
Waiting for Tungsten Connector Service to exit...
Stopped Tungsten Connector Service.