Options for the startMonitoringAgent Command

This topic describes the options that are available for the startMonitoringAgent command.You can save these options in the Monitoring Agent's configuration file using the -c option for the next time you need to start the agent.

Related Topics
Starting the Monitoring Agent
About Setting Up the Monitoring Agent
Monitoring Live Collaboration Server using Monitoring Agent
Option Description
[-help|-h] Shows the help.
[-verbose|-v] Activates verbose mode.
[-enoviaServer|-e] [PROTOCOL] HOSTNAME PORT ROOT_URI [DEBUG_PORT] Defines the ENOVIA Live Collaboration Server to monitor.
  • PROTOCOL is the server protocol: http, https, or RMI server. The default value is http.
  • HOSTNAME is the server host name.
  • PORT is the server port.
  • ROOT_URI is the server root URI. This attribute is not required if the protocol is RMI server.
  • DEBUG_PORT is the server debug port (MX_DEBUG_PORT).
[-pullPeriod|-p] PERIOD Sets the amount of time between each request for monitoring information sent by the agent.
  • PERIOD is the amount of time in seconds. The default value is 300.
-thematic|-t NAME [NAME ...] Specifies the categories of events to monitor. The impact of the agent on ENOVIA Live Collaboration Server processes can be minimized by choosing to only monitor the needed categories.

NAME is the list of categories using a space as a separator. The default value is All. Valid values are:

  • Availability—Monitors information such as failure (core dump, errors) and the health of the system.
  • Security—Monitors connected users, accessed documents, and other information related to security.
  • Performance—Monitors events and provides information on the performance of the application.
  • Usage—Monitors the amount of time spent in a session, operations performed by end-users, and operations and requests processed by the server.
  • All—Monitors all of the items above.

-severity|-s NAME [NAME ...] Specifies the severity levels to monitor. The impact of the agent on ENOVIA Live Collaboration Server processes can be minimized by choosing to only monitor the needed severity levels.

NAME is the list of severity levels using a space as a separator. The default value is Critical and Fatal. Valid values are:


  • Information—Monitors general information.
  • Harmless—Monitors errors that have no effect on normal operations.
  • Warning—Monitors errors that require the user to decide if action is needed.
  • Minor—Monitors errors that require action but are not currently serious.
  • Critical—Monitors errors that require immediate action.
  • Fatal—Monitors errors that are too late for action.
  • All—Monitors all of the items above.
[-outputFile|-o] PATH [MAX_SIZE] Sets the path for the output file used to save monitoring information.

PATH is the file path including the filename. The default value on Windows is C:\Documents and Settings\ave\Application Data\DassaultSystemes\MonitoringAgent\Repository\MonitoringLog.cbe.


  • MAX_SIZE is the maximum size in megabytes of the output file. The default value is 1024.
[-keystore|-ks] PATH Sets the path to the keystore file created in Creating a keystore File.
  • PATH is the file path including the file name.
[-setkey|-sk] SERVICE [LOGIN] [PASSWORD] Sets a key in the keystore file.

SERVICE is the name of the service associated with the key. For example, the URL of the ENOVIA Live Collaboration Server.


  • LOGIN is the username associated with the key.
  • PASSWORD is the password associated with the key.
[-delkey|-dk] SERVICE Deletes a key in the keystore file.
  • SERVICE is the name of the service associated with the key. For example, the URL of the ENOVIA Live Collaboration Server.
[-configFile|-c] PATH

Sets the path to the configuration file that contains the settings for silent mode.


  • PATH is the file path including the file name.
[-silent|-si] Uses the settings from the configuration file to start the agent.
[-dslicsrv|-dsls] PID_FILE_PATH Activates DS License Server monitoring.
  • PID_FILE_PATH is the path to the DS License Server .pid file.