trepctl Options

Option	Description
-all-services	Execute command against all available services
-host	Host name of the replicator. Defaults to localhost if not supplied.
-port	RMI Port number of the replicator. Defaults to 10000
-retry	Number of times to retry the connection. Pass integer value.
-service	Name of the replicator service. Mandatory if more than one service available.
-verbose	Enable verbose messages for operations.

Global command-line options enable you to select specific hosts and services. If available, trepctl will read the active configuration to determining the host, service, and port information. If this is unavailable or inaccessible, the following rules are used to determine which host or service to operate upon:

• If no host is specified, then trepctl defaults to the host on which the command is being executed.
• If no service is specified:
  • If only one service has been configured, then trepctl defaults to showing information for the configured service.
  • If multiple services are configured, then trepctl returns an error, and requests a specific service be selected.

To use the global options:

trepctl -all-services

When multiple services are available, you can perform actions against all services at the same time, for example:

shell> trepctl -all-service offline

trepctl -host

Specify the host for the operation. The replicator service must be running on the remote host for this operation to work.

trepctl -port

Specify the base TCP/IP port used for administration. The default is port 10000; port 10001 is also used. When using different ports, port and port+1 is used, i.e. if port 4996 is specified, then port 4997 will be used as well. When multiple replicators are installed on the same host, different numbers may be used.

trepctl -retry

Retry the request operation the specified number of times. The default is 10.

trepctl -service

The servicename to be used for the requested status or control operation. When multiple services have been configured, the servicename must be specified, otherwise the operation will fail and you will be presented with examples of commands to use, for example:

shell> trepctl status
Processing status command...
Operation failed: You must specify a service name with the -service flag because there is more than one 
service available. The currently available status commands are:
trepctl -service north status
trepctl -service north_from_east status
trepctl -service north_from_west status

trepctl -verbose

Turns on verbose reporting of the individual operations. This includes connectivity to the replicator service and individual operation steps. This can be useful when diagnosing an issue and identifying the location of a particular problem, such as timeouts when access a remote replicator.