server stop

server stop server_name_list [-method method]

Options

-method method
Optionally specifies how dced should stop the server. The method must be one of the following:

· rpc - Have dced use rpc_mgmt_server_stop_listening. This is the default.

· soft - Use a soft local mechanism (for example, SIGTERM).

· hard - Use a hard local mechanism (for example, SIGKILL).

· error - Use a state-preserving mechanism (for example, SIGABRT).

Description
The server stop operation stops the specified running server processes. The argument is a list of names of servers. Returns an empty string on success. Takes an optional -method option to specify how dced should stop the server.

The RPC runtime identifies servers not by name, but by interface, object UUID and endpoints. You should be aware that if you use the rpc method, the command will be unable to distinguish between two or more server instances binding without endpoints to the same interface and using the same object UUID. In this case, the command will stop a randomly selected server, not necessarily the one named in server_name_list.

Privileges Required
You must have s (stop) permission on the execution object.

Examples

dcecp> server stop /.:/hosts/foster/config/srvrexec/try_tserver
dcecp>