VME is a user-mode utility that is used by CA 3Tera AppLogic appliances to generate specific events to CA 3Tera AppLogic during the appliance boot process and at runtime. As long as an appliance is not unmanaged, the appliance must use vme during its boot process to tell CA 3Tera AppLogic if the appliance started OK or not. If the appliance is unable to start due to some error (invalid property settings, not enough available memory, and so on), the appliance can use vme to fail the appliance start and also to log an error message to the grid controller's system log (accessed using the grid's list log command). vme can also be used during appliance runtime to log critical error messages to the grid's dashboard.
By default when the appliance kit (APK) is installed in an appliance, vme is used to always send the appliance "started OK" event. This can be overwritten by appliance-specific scripts that are executed during the appliance boot process.
vme id=<event> [msg=<message>] [severity=<severity>] [progress=<readiness>] [cnt_name=<counter name> cnt_value=<counter value>]
vme id=started_ok
vme id=start_failed msg="Missing DNS server address"
vme id=maintenance msg="Database recovery" progress=30
vme id=log msg="SSL certificate loaded OK" severity=info
vme id=alert msg="Corrupted database file detected" severity=fatal
vme id=alert cnt_name=n_db_xact_per_min cnt_value=46 severity=fatal
Notes:
<readiness> is reported in percent, valid values are 1 through 100
Appliances in maintenance mode must report their progress periodically (no less often than 30 seconds).
<counter name> and <counter value> are only used for alerts
If a message is provided with an alert the message is logged to the grid's dashboard
|
Copyright © 2011 CA.
All rights reserved.
|
|