HomeGuides
Log In
Guides

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
OptionParameterDescription
-versionDisplays version details.
-ivpPerforms IVP on the current configuration.
DWAgent must not be already started when performing IVP.
-startStarts DWAgent.
-stopStops 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.
-statsPrints 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.
-tracelevelSet 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]]
OptionParameterDescription
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]]
OptionParameterDescription
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.