Operating Modes

Modes

command

Runs a command on an interval and updates cached license data.

license-monitor --mode command --execute "lmstat -a" --interval 300

By default this also runs the API server; use --no-api to disable it.

tail

Watches a log file and parses entries.

license-monitor --mode tail --file "/var/log/lmstat.log" --regex ".*"

tail starts the API server only when API is enabled in config and --no-api is not set. This differs from command and both, which run with API by default unless you pass --no-api.

api

Runs API only.

license-monitor --mode api --api-host 127.0.0.1 --api-port 8080

both

Runs command and tail processing together and starts the integrated API server.

license-monitor --mode both --execute "lmstat -a" --file "/var/log/lmstat.log"

Use this mode when you want command execution, file tail processing, and API serving in one process.

Test mode

For validation runs during onboarding:

license-monitor --test --execute "lmstat -a"

--test runs one command cycle and prints JSON output.