PXS Monitoring with SNMP

The PXS supports monitoring using the Internet standard SNMPv1 protocol. Advanced Relay's assigned private enterprise number is 18325 with the ARC's private MIB rooted at:

{ iso org dod internet private enterprises 18325 }

The current version of the Advanced Relay MIB file is ARC-MIB.txt. The ARC-MIB defines an extensible set of both objects and traps (which may vary depending on the running application).

To enable the SNMP agent, use the agent command:

RedBoot> agent enable
SNMP agent: enabled

The default PXS community is laygopxs. You can change the community with the RedBoot community command:

RedBoot> community ourcommunity
SNMP community: ourcommunity

The PXS-specific information group is:

{ iso org dod internet private enterprises 18325 2 }

It includes the following objects:

Object Description
pxsSerial Hardware serial number of the PXS.
pxsApplication Name and version of the currently executing application.
pxsTrapCount Number of SNMP traps generated since startup.
pxsTrapHistory The last 5 traps sent by the PXS.

The trap count and trap history enable a monitor to poll periodically for missed traps and the last 5 traps sent. The trap history is an ASCII string with the format:

traps [generic(g):specific(s):interface:uptime] ...

where

By default, the PXS also supports the MIB-II System Group:

{ iso org dod internet mgmt mib-2 system }

This enables a remote entity to identify the PXS.

Object Description
sysDescr LayGO Protocol eXchange Server version 1.0 (c) 2004 Advanced Relay Corporation
sysObjectID1.3.6.1.4.1.18325.1.1
sysUpTime PXS up time in hundredths of seconds
sysContact Configurable with RedBoot contact command.
sysName Configurable with RedBoot host command.
sysLocationConfigurable with RedBoot location command.
sysServices72

SNMP Traps

The PXS supports sending SNMP traps as a means of notifying an SNMP monitor of events that may require human intervention. To enable sending SNMP traps, use the snmp command to configure the address of the SNMP server and the trap command to enable traps:

RedBoot> snmp 192.168.250.2
SNMP server: 192.168.250.2
RedBoot> trap enable
SNMP trap: enabled

When traps are enabled, the PXS will always send a coldStart trap (as described in Section 2.2.2 of RFC 1215) on startup. Other traps are generated based on the specific application running on the PXS.