Skip to main content
Common Reference

Service Commands

The trepctl service commands operate per-service, that is, when there are multiple services in a configuration, the service name on which the command operates must be explicitly stated. For example, when a backup is executed, the backup executes on an explicit, specified service.

The individuality of different services is critical when dealing with the replicator commands. Services can be placed into online or offline states independently of each other, since each service will be replicating information between different hosts and environments.

OptionDescriptionVersion
backupShow the replicator version number and build.
capabilitiesList the configured replicator capabilities.
checkGenerate consistency check.
clearClear one or all dynamic variables.
clientsList clients connected to this replicator.
errorWill output full stack trace of the last error, if any. If no error, response will be empty.7.0.0
flushSynchronize transaction history log to database.
heartbeatInsert a heartbeat event with optional name.
loadLoad the replication service.
offlineSet replicator to the OFFLINE state.
offline-deferredSet replicator to the OFFLINE state at a future point in the replication stream.
onlineSet replicator to the ONLINE state with optional start and stop points.
pausePause the replicator.
perfPrint detailed performance information.
perflogAdds real-time performance monitoring to track and identify slow database operations during replication.7.2.1
propertiesDisplay a list of all internal properties.
purgePurge non-Tungsten logins on database.
qsPrint a simplified quick replicator status.
resetDeletes the replicator service.
restoreRestore the database on specified host.
resumeResume a paused replicator.
setdynamicSet dynamic properties.6.1.17
setroleSet replicator role.
shardList, add, update, and delete shards.
statusPrint replicator status information.
unloadUnload the replication service.
waitWait for the replicator to reach a specific state, time or applied sequence number.

The following sections detail each command individually, with specific options, operations and information.