Kwdistadmin
The kwdistadmin command manages sessions on the Distributed Analysis Server, stops the Distributed Analysis Server and agents, and retrieves agent statistics from the Distributed Analysis Server. kwdistadmin is run on the Distributed Analysis Server Host (where kwdist runs).
kwdistadmin is installed as part of the Distributed Analysis package.
kwdistadmin usage
kwdistadmin <options> [<subcommand>]
where:
- <options> are any of the options from the list below
- <subcommand> is one of the kwdistadmin subcommands, explained in subsequent topics. The --help and --version options do not require a subcommand.
Example
kwdistadmin --host serverXYZ.acme.com list-agents
Common options
| Name | Short name | Description |
|---|---|---|
| --help | display this help | |
| --version | display version information | |
| --verbose | -v | print verbose information about program execution, which can help to troubleshoot errors |
| --host <host> | -h | specify the host name of the machine where the Distributed Analysis Server (kwdist) is running. Default: localhost |
| --port <port> | -p | specify the port number on which the Distributed Analysis Server (kwdist) is running. Default: 3440 |
kwdistadmin list-agents
kwdistadmin list-agents is used to print a list of Distributed Analysis agents. A full list of agents with their IDs is printed. Agent IDs are required for kwdistadmin stop-agent.
Example
kwdistadmin --host serverXYZ.acme.com list-agents
Options
See Common options.
kwdistadmin stat
kwdistadmin stat is used to print statistics on total compilation time for all requests processed by each agent.
Example
kwdistadmin --host serverXYZ.acme.com stat
Options
See Common options.
kwdistadmin result
kwdistadmin result is used to print compilation results for all sessions: status, number of total requests, number of requests processed successfully, number of failed requests, number of requests to be processed, and compilation errors. The command outputs a list of session IDs. Session IDs are integers, starting at 1.
Example
kwdistadmin --host serverXYZ.acme.com result
Options
See Common options.
kwdistadmin stop-agent
kwdistadmin stop-agent is used to stop a specific agent on a remote machine. The agent ID can be retrieved with kwdistadmin list-agents. It is not necessary to specify host and port information, because the Distributed Analysis Server stores this information for each agent ID. Note that an agent can only be stopped by the user who started it.
kwdistadmin stop-agent <ID>
where:
- <ID> is one of the Analysis Agent IDs returned by the kwdistadmin list-agents command
Example
kwdistadmin stop-agent 3
Options
None
kwdistadmin stop-server
kwdistadmin stop-server is used to stop the Distributed Analysis Server. Normally the Distributed Analysis Server and agents run continually. Stopping the Distributed Analysis Server also stops all agents. Use the --host and --port options if the Distributed Analysis Server is running on a non-default host and port (localhost and 3440).
Example
kwdistadmin --host serverXYZ.acme.com stop-server
Options
See Common options.
