| Anchor | ||||
|---|---|---|---|---|
|
| Include Page | ||||
|---|---|---|---|---|
|
Table of Contents
| Table of Contents | ||
|---|---|---|
|
...
General Description
The Log Monitor & Dispatcher is a special program which monitors a guest LOG file produced by CHARON and executes a customizable custom script when it detects removal of a license.
It runs in the background (as a program or as a service) and periodically scans a specified LOG file. When it It detects a message with the code 00000424 and 0000040B ("the following messages and executes the associated scripts (created manually):
| Error code | Description | Script executed |
|---|---|---|
00000424 | Detected removal of a license |
...
Example:
20180608:090445:INFO :0:00000424:ethane.cxx(3514): session: Detected removal of the license.. | nolicense.bat | |
0000040B | License has changed. License detected and online. | license_changed.bat |
The Log Monitor & Dispatcher service is installed as EmulatorLogMonitor. By default it is installed in such a way that requires explicit actions to be started (either through a command line interface or using the standard ways of service management). For unattended execution, change the service’s configuration so that Windows starts the service automatically.
The tool requires a specific file "NOLICENSE.BAT" containing some the specific files "nolicense.bat" and "license_changed.bat" containing specific instructions to be taken in situation of license absence or change. It is recommended you create this file these files in the folder (presumably) containing the LOG file.
...
| Note |
|---|
The user action file will not invoke interactive applications as it may run in an environment where interactive services do not work, for example: when “Log Monitor & Dispatcher” is installed as a service. |
| Include Page | ||||
|---|---|---|---|---|
|
| Div | ||
|---|---|---|
| ||
Starting in background mode
In order to start the Log Monitor & Dispatcher as a background application:
- Open "cmd.exe" from the "Start" menu.
- Change current directory to the folder (presumably) containing the CHARON configuration file.
- Start the Log Monitor & Dispatcher using the following command line as an example:
For single log file:
...> “C:\Program Files\CHARON\Build_XXX\x64\logmond” C:\my_charon.log |
For rotating log file:
...> “C:\Program Files\CHARON\Build_XXX\x64\logmond” -l <log-directory> -p <log-prefix> |
where:
- <log-directory> is the directory where the rotating log files are stored
- <log-prefix> is the same as the "configuration_name" value in corresponding CHARON configuration file (or "hw_model", if "configuration_name" is not specified).
Example:
|
To stop the Log Monitor & Dispatcher application, open the Task Manager, find the “logmond.exe” process and terminate it.
| Include Page | ||||
|---|---|---|---|---|
|
Installing as a service
In order to install the Log Monitor & Dispatcher as a background application:
Open "cmd.exe" from the "Start" menu in "Run as Administrator" mode.
- Install Log Monitor & Dispatcher service using the following command line as an example:
...> “C:\Program Files\CHARON\Build_XXX\x64\logmond” -r |
As result the "logmond" service has "Manual" service start type. Use Windows service management tools to change this mode to "Automatic" if it is required.
| Note |
|---|
|
| Div | ||
|---|---|---|
| ||
Starting the Log Monitor and Dispatcher service
In order to start the Log Monitor & Dispatcher as a background application:
Open "cmd.exe" from the "Start" menu in "Run as Administrator" mode.
- Start the Log Monitor & Dispatcher service using the following command line as an example:
...> “C:\Program Files\CHARON\Build_XXX\x64\logmond” -u |
It is also possible to use Windows service management tools to start up the service.
As soon as "logmond" service is installed this way, and started, it monitors all CHARON instances (provided that these are installed as services).
It does NOT monitor emulator instances started from Launcher or manually from command line prompt, these cases can still be monitored with "logmond" invoked from command line prompt with name of the log file as an argument (see above).
| Include Page | ||||
|---|---|---|---|---|
|
Stopping the Log Monitor and Dispatcher service
In order to stop the Log Monitor & Dispatcher as a background application:
Open "cmd.exe" from the "Start" menu in "Run as Administrator" mode.
- Stop the Log Monitor & Dispatcher service using the following command line as an example
...> “C:\Program Files\CHARON\Build_XXX\x64\logmond” -d |
It is also possible to use Windows service management tools to stop the service.
Uninstalling the Log Monitor and Dispatcher service
In order to uninstall the Log Monitor & Dispatcher as a background application:
Open "cmd.exe" from the "Start" menu in "Run as Administrator" mode.
- Uninstall the Log Monitor & Dispatcher service using the following command line as an example
...> “C:\Program Files\CHARON\Build_XXX\x64\logmond” -r |
...
...
Log Monitor and Dispatcher best practice
Refer to this article in the Appendixes for proper configuration of the "nolicense.bat" file to establish needed actions on the dongle removal.
| Include Page | ||||
|---|---|---|---|---|
|