Starting the Monitoring Agent

For security reasons, you cannot start the monitoring agent by entering a username and password directly in the command-line. Instead, the agent must be started using a keystore file that conceals the username and password.

Before you begin: The username and password used to create the keystore file must be licensed to use the ENOVIA Live Collaboration Server. No specific roles or access are required for this username and password. A keystore file can be created on a different machine than the target production machine to further secure the username and password. After a keystore file is created, there is no way to access the username and password used to create it.
Related Topics
About Setting Up the Monitoring Agent
Monitoring Live Collaboration Server using Monitoring Agent
Maintaining and Monitoring Clients

  1. Run the following command on the command-line to create a keystore file:

    Windows:
    startMonitoringAgent.bat [-keystore PATH] -setkey SERVICE [LOGIN] [PASSWORD]
    UNIX/Linux:
    startMonitoringAgent.sh [-keystore PATH] -setkey SERVICE [LOGIN] [PASSWORD]

    Note: When creating a keystore file, it is recommended not to enter the username and password on the command-line. If a username and password is not entered, you are prompted to enter it in a more secure way using standard Windows or UNIX login procedures, where:

    • PATH is the file path including the filename of the keystore file.
      Windows default path:
      %APPDATA%\DassaultSystemes\MonitoringAgent\conf\MonitoringAgent.ks
      UNIX default path:
      /var/DassaultSystemes/MonitoringAgent/conf/MonitoringAgent.ks.
    • SERVICE is the ENOVIA Live Collaboration Server's URL in the PROTOCOL://HOSTNAME:PORT/ROOT-URI format. For example, http://localhost:9081/enovia. If you are monitoring an RMI server, SERVICE should be in the HOSTNAME:PORT format.

  2. You can configure the monitoring agent by initially starting it with the desired configuration options. You can save these options in the agent's configuration file using the -c option for the next time you need to start the agent (see Options for the startMonitoringAgent Command). Start the monitoring agent by running the following command on the command-line:

    Windows:
    startMonitoringAgent.bat OPTIONS
    UNIX/Linux:
    startMonitoringAgent.sh OPTIONS

    For a list of options available for the startMonitoringAgent command, see Options for the startMonitoringAgent Command.

    Note: There is no command to stop the monitoring agent since it should always be running to be effective. In UNIX environments, if the monitoring agent startup has been integrated using a script similar to /etc/init.d, it is possible to stop the agent by running the script with the stop argument.

Examples

The following are some examples of how to configure and start the monitoring agent.


  • Configures and starts the monitoring agent:
    -l 1870 -e sealedsy.ds 8081 enovia -t Availability Security -s 
Critical Fatal
  • Configures and starts the monitoring agent and saves the specified options to the configuration file:
    -c /tmp/MonitoringConfig.xml -l 1870 -e sealedsy.ds 8081 enovia 
1099 -o /tmp/MonitoringLog.cbe 1024 -t All -s All
  • Configures and starts the monitoring agent using the configuration file:
    -c /tmp/MonitoringConfig.xml -si