Apama Documentation : Deploying and Managing Apama Applications : Using the Management and Monitoring Console : Managing hosts : Using the sentinel_agent tool
Using the sentinel_agent tool
The executable for this tool is located in the bin directory of the Apama installation. Running the tool in the Apama Command Prompt (see Setting up the environment using the Apama Command Prompt) ensures that the environment variables are set correctly.
Synopsis
To start the Sentinel Agent, run the following command:
sentinel_agent [ options ]
When you run this command with the –h option, the usage message for this command is shown.
Description
The license is assumed to be in APAMA_WORK\license\ApamaServerLicense.xml unless overridden on the command line. The Apama work directory is set from the -W argument or from the APAMA_WORK environment variable if -W is not specified.
If the license is not found at the above location, the correlator will also search Apama/etc/ApamaServerLicense.xml in the installation directory.
Options
The sentinel_agent tool takes the following command line options:
Option
Description
-V | --version
Prints out the Sentinel Agent's version information. Does not start the Sentinel Agent.
-h | --help
Displays usage information. Does not start the Sentinel Agent.
-p port | --port port
Name of the host on which the Sentinel Agent will listen for connections from EMM. The default is 17903.
-f file | --logfile file
The file where to output logging information from the Sentinel Agent. If a log file is not specified and the Sentinel Agent was run as a normal executable from a Command Prompt or a Terminal window, it will log to the system configured stderr. If the Sentinel Agent was run as a Windows service, a log file must be specified; otherwise the Agent will not start.
-v level | --loglevel level
Sets the logging level. The log levels possible, in increasing order, are TRACE, DEBUG, INFO, WARN, ERROR, CRIT, and FATAL, where each level includes all subsequent ones. For example, WARN includes all WARN level, all ERROR level, all CRIT level, and all FATAL level log messages. If not specified, the default log level is WARN.
-t | --truncate
If set, the log file will be emptied at start up, otherwise it will be appended to.
-N name | --name name
Sets the name of the component to name.
-l file | --license file
A reference to an Apama license file. If provided, the Sentinel Agent will be able to pass this license file's location on to the Apama components that it starts. Alternatively, a license file can be sent to the Sentinel Agent dynamically via EMM.
-H dir | --apamahome dir
The root directory where the Apama executable files are installed, as selected during installation.
-W dir | --apamawork dir
The root directory where the Apama work files are located, as selected during installation.
-Xconfig file | --configFile file
Uses the specified service configuration file. For more information about this configuration file, see Using the Apama component extended configuration file.
Copyright © 2013-2016 Software AG, Darmstadt, Germany.
Product LogoContact Support   |   Community   |   Feedback