System Administration
DWAgent Command Line Interface
dwagent.bat <actionArguments> (on Windows)
or
dwagent.sh <actionArguments> (elsewhere)
Supported actions are:
- -version
- -ivp
- -start
- -stop
- -status [statusPort]
- -stats
- -trace level
- -usrdump [task ]
- -help
- -refreshCfg
| Option | Parameter | Description |
|---|---|---|
| -version | Displays version details. | |
| -ivp | Performs IVP on the current configuration. DWAgent must not be already started when performing IVP. | |
| -start | Starts DWAgent. | |
| -stop | Stops DWAgent. | |
| -status | [statusPort] | Checks whether DWAgent is active. If several instances of DWAgent are present, a port can specified to address a specific instance see also DWAgent.udpPort attribute in DWAgent.properties. |
| -stats | Prints DWAgent statistics to the console | |
| -usrdump | [task ] | Creates a user dump on a file. If the optional parameters task is specified, every intervalSecs and for iterationNumber times a new user dump file will be created User dump files are stored in the DWAgent log directory and comply with this naming convention: DWAgent.dump.usr.uniqueSuffix.log. User dumps contain detailed application, JVM and system state information that might be useful for problem determination purposes. |
| -trace | level | Set trace level to a new value without having to stop and start any runtime component. Possible values are: no|default|verbose|all |
DWAgent Windows Service Command Lines
DWAGENT WINDOWS SERVICE INSTALLER (DWAGENTSERVICE.BAT)
dwagentservice.bat
[install [-service servicename] [-jvmdll path]] |
[ivp [-service servicename]] |
[remove [-service servicename]]
| Option | Parameter | Description |
|---|---|---|
| config | [-service servicename] [-jvmdll path] | Installs a DWAgent Windows Service named DWAgent unless an alternative service name is provided with -service switch. Service names must contain alphanumeric characters only. For some JRE versions and brands, the service installation may fail reporting an error stating that the jvm.dll cannot be located. In this case, a jvm location hint can be given on the command line as an argument via the –jvmdll switch. |
| ivp | [-service servicename] | Performs IVP for a previously installed DWAgent Windows Service named DWAgent unless an alternative service name is provided with the -service switch. |
| remove | [-service servicename] | Removes a previously installed DWAgent Windows Service named DWAgent unless an alternative service name is provided with the -service switch. |
DWAGENT WINDOWS SERVICE MANAGER (DWAGENTSERVICEMGR.BAT)
dwagentservicemgr.bat
[config [-service servicename] |
[monitor[-service servicename]]
| Option | Parameter | Description |
|---|---|---|
| config | [-service servicename] | Starts a GUI application that can be used to change service settings of a previously registered DWAgent Windows Service instance. |
| monitor | [-service servicename] | Starts up a GUI system tray application that can be used to monitor the status of a previously registered DWAgent Windows Service instance. |
Updated 6 months ago