The tpm delete-service command allows you to cleanly remove a dataservice from your cluster, or a single replication service from a standalone replicator installation.
The tpm delete-service command will know if it is being run from the Clustering software or the Replicator software, and will act accordingly
See the table below for a list of valid arguments:
Table 9.20. tpm delete-service Common Options
| Option | Description |
|---|---|
--api | Use the v2 API REST interface instead of the command line when possible |
--auto, -A | Automatically execute any needed commands that it is possible to handle. |
--debug, -d | Debug Mode. |
--i-have-run-tpm-update | For Staging-method installations, pass this flag to confirm that the `tools/tpm update --replace-release` command has already been run from the staging directory |
--help, -h | |
--i-am-sure | Bypass the 'Are You Sure?' prompt when using --auto. |
--info, -i | |
--newini, -n | Pass the fullpath (and filename) to an INI file to be used at the 'Edit INI' step |
-f | Pass the force flag to tpm. |
--path, -p | Pass full path to replicator executables e.g. --path /opt/replicator/tungsten/tungsten-replicator/bin |
--quiet, -q | |
--test, -t | |
--thl | Path and name of thl executable (Ignores --path if also supplied) |
--trepctl | Path and name of trepctl executable (Ignores --path if also supplied) |
-v | Verbose output. |
A number of options determine the behavior of this command and these are outlined below.
Usage for tpm delete-service
shell> tpm delete-service [args] {service_name} [configuration_service_name]
{service_name} is the Replicator service name as seen
in trepctl services.
[configuration_service_name] is the Replicator service
name as seen in tpm reverse, and only needed for
standalone Replicator installations where the service name in the
configuration is not the same as the actual replication service name, i.e.
in cluster-extractor topologies where there is a cluster-alias employed.
The default behavior is to display the needed commands for the admin to execute manually.
To use this tool in a fully automated manner:
specify --auto
include --i-am-sure to bypass most interactive
prompts
include --newini {filename} otherwise you will be
prompted to edit the INI file in the vi editor before proceeding
Use-cases
Tungsten Replicator: i.e. for Standalone, Cluster-Extractor, Fan-In and Multi-Site/Active-Active topologies where there is a discrete Replicator running outside of a Cluster (needs Replicator workflow)
Workflows
Replicator Service
shell> trepctl -all-services offline shell> rm tungsten-replicator/conf/static-SERVICE.properties shell> rm tungsten-replicator/conf/.static-SERVICE.properties.orig shell> replicator restart shell> trepctl -all-services online # Remove the various directories after the restart so that the replicator no longer has the dirs open : shell> rm -rf thl/SERVICE/ shell> rm -rf relay/SERVICE/ shell> trepctl -all-services online
tpm uninstall should also be run as a final optional step if the service being deleted is the only service on any affected hosts.