Using SNMP Traps

This section describes how to set up your system to send and receive traps. It also describes the traps that you can use to receive change notification for logical domains (domains), as well as other traps that you can use.

The Oracle VM Server for SPARC MIB provides the same SNMP traps for both Oracle Solaris 10 and Oracle Solaris 11.

However, the snmptrapd daemon no longer automatically accepts all incoming traps for Oracle Solaris 11. Instead, the daemon must be configured with authorized SNMP v1 and v2c community strings, with SNMPv3 users, or both. Unauthorized traps or notifications are dropped. See the snmptrapd.conf(4) or snmptrapd.conf(5) man page.

Using Oracle VM Server for SPARC MIB Module Traps

Sending and Receiving Traps

The Oracle Solaris 11 MIB provides the same SNMP traps as are provided by the Oracle Solaris 10 MIB. However, the net-snmp versions are different and they must be configured in different ways. In Oracle Solaris 10 MIB, snmptrapd accepts all incoming notifications and automatically logs them. In Oracle Solaris 11 MIB, access control checks are applied to incoming notifications. If snmptrapd runs without a suitable configuration file, or with equivalent access control settings, such traps are not processed. See the snmptrapd.conf(4) or snmptrapd.conf(5) man page.

How to Send Traps

1. Configure the trap.
   • Configure the trap on an Oracle Solaris 10 system.

     Edit the /etc/sma/snmp/snmpd.conf file to add the directives to define the trap, inform version, and destination.

     trapcommunity string --> define community string to be used when sending traps
     trapsink host[community [port]] --> to send v1 traps
     trap2sink host[community [port]] --> to send v2c traps
     informsink host[community [port]] --> to send informs

     For more information, see the snmpd.conf(4) or snmpd.conf(5) man page.

   • Configure the trap on an Oracle Solaris 11 system.

     Edit the /etc/net-snmp/snmp/snmpd.conf SNMP configuration file to add the directives to define the trap, inform version, and destination.

     trapcommunity string --> define community string to be used when sending traps
     trapsink host[community [port]] --> to send v1 traps
     trap2sink host[community [port]] --> to send v2c traps
     informsink host[community [port]] --> to send informs

     For more information, see the snmpd.conf(4) or snmpd.conf(5) man page.

     For example, the following directives use the public string as the community string when sending traps and that the v1 traps are sent to the localhost destination:

     trapcommunity public
     trapsink localhost

2. Configure access control settings by creating or editing the /usr/etc/snmp/snmptrapd.conf SNMP trapd configuration file.

   The following example shows who is authorized to send traps (public) and how incoming traps should be processed (log,execute,net). See the snmptrapd.conf(4) or snmptrapd.conf(5) man page.

   authCommunity log,execute,net public

3. To receive SNMP trap messages, start the SNMP trap daemon utility, snmptrapd.

Example 16-4 Sending SNMP v1 and v2c Traps

This example sends send both v1 and v2c traps to the SNMP trap daemon that runs on the same host. Update the Oracle Solaris 10 /etc/sma/snmp/snmpd.conf file or the Oracle Solaris 11 /etc/net-snmp/snmp/snmpd.conf file with the following directives:

trapcommunity public
trapsink localhost
trap2sink localhost

How to Receive Traps

• Start the SNMP trap daemon utility.
  • Start the Oracle Solaris 10 SNMP trap daemon utility.

    For information about the output format options, see the snmptrapd(1M) man page.

    The snmptrapd utility is an SNMP application that receives and logs SNMP TRAP messages. For example, the following snmptrapd command shows that a new domain was created (ldomTrapDesc = Ldom Created) with a name of ldg2 (ldomName = ldg2).

    # /usr/sfw/sbin/snmptrapd -P -F \
    "TRAP from %B on %m/%l/%y at %h:%j:%k Enterprise=%N Type=%w SubType=%q\n
    with Varbinds: %v\nSecurity info:%P\n\n" localhost:162
    TRAP from localhost on 5/18/2007 at 16:30:10 Enterprise=. Type=0 SubType=0
    with Varbinds: DISMAN-EVENT-MIB::sysUpTimeInstance = Timeticks: (47105)
    0:07:51.05 SNMPv2-MIB::snmpTrapOID.0 = OID: SUN-LDOM-MIB::ldomCreate
    SUN-LDOM-MIB::ldomIndexNotif = INTEGER: 3 SUN-LDOM-MIB::ldomName = STRING: ldg2
    SUN-LDOM-MIB::ldomTrapDesc = STRING: Ldom Created
    Security info:TRAP2, SNMP v2c, community public

    Note that the -F option argument string is broken on to two lines for readability purposes.

  • Start the Oracle Solaris 11 SNMP trap daemon utility.

    For information about the output format options, see the snmptrapd(1M) man page.

    The snmptrapd utility is an SNMP application that receives and logs SNMP TRAP messages. For example, the following snmptrapd command shows that a new domain was created (ldomTrapDesc = Ldom Created) with a name of ldg2 (ldomName = ldg2).

    # /usr/sbin/snmptrapd -f -Le -F \
    "TRAP from %B on %m/%l/%y at %h:%j:%k Enterprise=%N Type=%w SubType=%q\n
    with Varbinds: %v\nSecurity info:%P\n\n" localhost:162
    NET-SNMP version 5.4.1
    TRAP from localhost on 6/27/2012 at 12:13:48
    Enterprise=SUN-LDOM-MIB::ldomMIBTraps Type=6 SubType=SUN-LDOM-MIB::ldomCreate
    with Varbinds: SUN-LDOM-MIB::ldomIndexNotif = INTEGER: 3
    SUN-LDOM-MIB::ldomName = STRING: ldg2   SUN-LDOM-MIB::ldomTrapDesc = STRING:
    Ldom Created
    Security info:TRAP, SNMP v1, community public

    Note that the -F option argument string is broken on to two lines for readability purposes.

Oracle VM Server for SPARC MIB Trap Descriptions

This section describes the Oracle VM Server for SPARC MIB traps that you can use.

Domain Creation (ldomCreate)

This trap notifies you when any domains are created.

Table 16-24 Domain Creation Trap (ldomCreate)

Domain Destroy (ldomDestroy)

This trap notifies you when any domains are destroyed.

Table 16-25 Domain Destroy Trap (ldomDestroy)

Domain State Change (ldomStateChange)

This trap notifies you of any domain operating state changes.

Table 16-26 Domain State Change Trap (ldomStateChange)

Virtual CPU Change (ldomVCpuChange)

This trap notifies you when the number of virtual CPUs in a domain changes.

Table 16-27 Domain Virtual CPU Change Trap (ldomVCpuChange)

Virtual Memory Change (ldomVMemChange)

This trap notifies you when the amount of virtual memory in a domain changes.

Table 16-28 Domain Virtual Memory Change Trap (ldomVMemChange)

Virtual Disk Service Change (ldomVdsChange)

This trap notifies you when a domain's virtual disk service changes.

Table 16-29 Domain Virtual Disk Service Change Trap (ldomVdsChange)

Virtual Disk Change (ldomVdiskChange)

This trap notifies you when a domain's virtual disk changes.

Table 16-30 Virtual Disk Change Trap (ldomVdiskChange)

Virtual Switch Change (ldomVswChange)

This trap notifies you when a domain's virtual switch changes.

Table 16-31 Virtual Switch Change Trap (ldomVswChange)

Virtual Network Change (ldomVnetChange)

This trap notifies you when a domain's virtual network changes.

Table 16-32 Virtual Network Change Trap (ldomVnetChange)

Virtual Console Concentrator Change (ldomVccChange)

This trap notifies you when a domain's virtual console concentrator changes.

Table 16-33 Virtual Console Concentrator Change Trap (ldomVccChange)

Virtual Console Group Change (ldomVconsChange)

This trap notifies you when a domain's virtual console group changes.

Table 16-34 Virtual Console Group Change Trap (ldomVconsChange)