Deploying and Managing Apama Applications > Using the Management and Monitoring Console > Managing hosts > Options
Options
The Sentinel Agent’s startup and usage information is as follows:
Usage: sentinel_agent [ options ]
Where options may include any of:
   -V | --version               Print program version info
   -h | --help                  This message
   -p | --port <port>           Listen on alternate port (default is 17903)
   -f | --logfile <file>        Log to named file (default is stderr)
   -v | --loglevel <level>      Set logging verbosity. Available levels
                                are TRACE, DEBUG, INFO, WARN, ERROR CRIT FATAL
                                (default logging level is WARN)
   -t | --truncate              Truncate log file at startup
   -N | --name <name>           Set the component name
   -l | --license <file>        Apama license filename
   -H | --apamahome <dir>       Root of Apama installation
   -W | --apamawork <dir>       Root of Apama work directory
 -Xconfig | --configFile <file> Use service configuration file <file>
The license is assumed to be in APAMA_WORK\license\license.txt 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.
These options can be specified to the Sentinel Agent executable whether it is run as a normal Windows or UNIX executable.
Options
Sentinel Agent options
Option
Description
-h
Display the above usage information. Does not start the Sentinel Agent.
-p
Name of the host on which the Sentinel Agent will listen for connections from EMM (default is 17903).
-l
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
The root directory where the Apama executable files are installed, normally C:\Program Files\Software AG\Apama <rel_num>\bin on Windows or /opt/SoftwareAG/apama_<rel_num>/bin on UNIX.
-W
The root directory where the Apama work files are located, normally C:\Users\username\Software AG\ApamaWork_version on Windows or $HOME/apama-work on UNIX.
-f
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.
-N name
Sets the name of the component to name.
-t
If set, the log file will be emptied at start up, otherwise it will be appended to.
-v
Set 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.
-V
Print out the Sentinel Agent’s version information. Does not start the Sentinel Agent.
-Xconfig file
Use the specified service configuration file. For more information about this configuration file, see Using the Apama Component Extended Configuration File.
Copyright © 2013 Software AG, Darmstadt, Germany and/or Software AG USA Inc., Reston, VA, USA, and/or Terracotta Inc., San Francisco, CA, USA, and/or Software AG (Canada) Inc., Cambridge, Ontario, Canada, and/or, Software AG (UK) Ltd., Derby, United Kingdom, and/or Software A.G. (Israel) Ltd., Or-Yehuda, Israel and/or their licensors.