User's Guide - Version UF-2.2.1

CacheGuard Monitoring

CacheGuard services and the machine on which CacheGuard-OS is operarting can be monitored at any time to have a quick look on the status of a CacheGuard appliance. The monitoring allows you to detect failures and dysfunctions soon enough so you can undertake actions to repair them and provide the required service continuity to your users. To monitor the system you can use SNMP (Simple Network Management Protocol) or directly connect to the system and use online commands or equivalent Web administration GUI pages.

Note that essential services are internally monitored by a third service called the "Health Checker". In case of a failure on an essential service, the "Health Checker" tries to restart the failed service. This operation is logged internally and if configured, an SNMP manager can receive a trap on the status of that restart operation.

Direct access

You can use some commands combined with the report keyword to get a report on the underlying command function. As an example, you can use the following commands: You can refer to the Commands Manual to learn more about commands that support reporting.

Using SNMP

A CacheGuard appliance integrates an SNMP agent that can be polled by an SNMP manager. It is also possible to configure the appliance to send SNMP traps to an SNMP receiver. Please note that a CacheGuard appliance uses TCP SNMP traps called SNMP notifications. To allow an SNMP manager having the IP address to poll your CacheGuard appliance and send SNMP notifications version 1 to a receiver having the IP address use the following command: By invoking the "admin snmp trap add v1" command, the administrator is asked to enter a password (SNMP community string) to connect to the SNMP receiver. SNMP v1, v2c and v3 are supported by CacheGuard-OS and the SNMP agent can be configure to work with UDP, TCP and TCP tunnelled over TLS. Well-known MIBs commonly used to monitor Linux systems are supported and a dedicated MIB called CacheGuard-MIB can also be used. You can find the ASN.1 MIB description of CacheGuard-MIB via the Web administration GUI (menu option [NETWORK] > [Monitoring Configuration] > [SNMP Agent Settings]), on the original installation CDROM or the official CacheGuard website.