Configuring SNMP on Proteus

8/10/2019 Configuring SNMP on Proteus

1/12

Appendix D

Version 4.0.6 Proteus Administration Guide 975

SNMP Manager Setup and

BlueCat MIB Files

This appendix contains details on setting up the SNMP Manager and a reference list of the BlueCat MIB

files. For details on configuring SNMP, refer to Configuring SNMP on Proteuson page 132.

SNMP Manager SetupWhen the local Proteus settings are complete and the service is activated, some further setup may be

required on the SNMP monitor or trap server. Proteus provides support for the MIB-II SNMP standard

objects and the required MIB files for this are in the directory usr/share/snmp/mibs.

When loaded into the SNMP manager, these files provide object IDs and descriptions for the Proteus

SNMP objects.

BlueCat MIB Files

BlueCat appliances support all of the MIB-II SNMP standard objects. MIB files for these objects are in

the directory /usr/share/snmp/mibs.

There are also Proteus- and Adonis-specific MIB files that you can copy to your SNMP manager. When

these files are loaded into the SNMP manager, they provide object IDs and descriptions for all of the

Proteus and Adonis SNMP objects. You can download the BlueCat MIB files from the Proteus online help.

Proteus Polled Objects

The following table lists the Proteus-specific SNMP polled-objects in the file PROTEUS-IPAM-MIB.txt.

Each Proteus MIB OID (object identifier) begins with the following prefix:

.1.3.6.1.4.1.13315 (iso.org.dod.internet.private.enterprise.BlueCat Networks)

All Proteus object IDs begin with the same prefix, but it is omitted from the OIDcolumn below.

You may need to configure the type of authentication required to log into Proteus and poll it from

an SNMP manager.

SNMP Object OID Description

.proteusObjects .100.200.1 Proteus Objects container

.jboss .100.200.1.1 JBoss Objects container

.jbossDaemon .100.200.1.1.1 Reserved for future use


2/12

976

Appendix D: SNMP Manager Setup and BlueCat MIB Files

Proteus Administration Guide Version 4.0.6

Proteus Traps

The PROTEUS-IPAM-MIB.txt file also contains trap objects. The Proteus-specific traps fall into two

groups:

JBoss

Proteus Application

The following table lists the Proteus SNMP traps in the file PROTEUS-IPAM-MIB.txt.

Each Proteus MIB OID (object identifier) begins with the following prefix:

.jbossStats .100.200.1.1.2 JBoss Statistics container

.activeThreadCount .100.200.1.1.2.1 Number of active JBoss threads

.freeMemory .100.200.1.1.2.2 Amount of free memory in the Java Virtual Machine

.maxMemory .100.200.1.1.2.3 Maximum amount of free memory in the Java Virtual

Machine

.threadPoolQueueSize .100.200.1.1.2.4 Size of the Thread Pool Queue

.txCommitCount .100.200.1.1.2.6 Number of commited transactions

.txRollbackCount .100.200.1.1.2.7 Number of rolled back transactions

.txActiveCount .100.200.1.1.2.8 Number of transactions currently active

.dbInUseCount .100.200.1.1.2.9 Number of database connections currently in use

.jbossHeartBeat .100.200.1.1.3 JBoss Heartbeat Objects container

.heartBeatUptime .100.200.1.1.3.1 Uptime of the JBoss hearbeat

.jbossColdStart .100.200.1.1.4 JBoss Cold Start Objects container

.coldStartTime .100.200.1.1.4.1 Cold start time for JBoss

.jbossCommon .100.200.1.1.5 JBoss Common Objects container

.trapCount .100.200.1.1.5.1 Trap count for JBoss

.notificationMessage .100.200.1.1.5.2 Notification message from JBoss

.notificationSequenceNumber .100.200.1.1.5.3 Notification sequence number from JBoss

.proteusApp .100.200.1.2 Proteus Application Objects container

.proteusDHCPAlert .100.200.1.2.1 DHCP Alert Objects container

.dhcpRange .100.200.1.2.1.1 DHCP Range for the DHCP Usage Alert

.dhcpRangeHDRatio .100.200.1.2.1.2 Host Density Ratio for the DHCP Range

.dhcpRangeHighWatermark .100.200.1.2.1.3 Host Density Ratio High Watermark for the DHCP Range

.dhcpRangeLowWatermark .100.200.1.2.1.4 Host Density Ratio Low Watermark for the DHCP Range

.serverCountInQueue .100.200.1.2.2.1 Number of servers that have deployments currently

queued

.executingServerCount .100.200.1.2.2.2 Number of servers that have active deployments



3/12

SNMP Manager Setup and BlueCat MIB Files



All Proteus object IDs begin with the same prefix, but it is omitted from the OIDcolumn below.

Adonis Polled Objects

The following table lists the Adonis-specific SNMP polled-objects in the files BCN-DHCPV4-MIB.mib,BCN-DNS-MIB.mib, BCN-TFTP-MIB.mib, BCN-NTP-MIB.mib, BCN-COMMANDSERVER-MIB.mib, BCN-

SYSTEM-MIB.mib, and BCN-HA-MIB.mib.

Each Adonis MIB OID (object identifier) begins with the following prefix:


All Adonis object IDs begin with the same prefix, but it is omitted from the OIDcolumn below.

SNMP Trap OID Description and SNMP Objects

.proteusObjects .100.200.1 Proteus Objects container

.proteusTraps .100.200.2 Proteus Traps container

.jbossTraps .100.200.2.1 JBoss Traps container

.jbossHeartbeatTrap .100.200.2.1.1 Reports information on the JBoss heartbeat.

jbossHeartbeatTrap sends the following SNMP objects:

heartBeatUptime

trapCount

notificationMessage

notificationSequenceNumber.jbossColdstartTrap .100.200.2.1.2 Reports information on JBoss cold start.

jbossColdstartTrap sends the following SNMP objects:

coldStartTime

trapCount

.proteusAppTraps .100.200.2.2 Proteus Application Traps container

.jbossProteusMsgTrap .100.200.2.2.1 Reports JBoss trap events.

jbossProteusMsgTrap sends the following SNMP objects:

trapCount

notificationMessage

.jbossProteusDHCPAlertTrap .100.200.2.2.2 Reports Proteus DHCP Alert events.

jbossProteusDHCPAlertTrap sends the following SNMP objects:

trapCount

dhcpRange

dhcpRangeHDRatio

dhcpRangeHighWatermark

dhcpRangeLowWatermark

notificationMessage


4/12

978



BCN-DHCPV4-MIB.mib:


.bcnDhcpv4SerOperState .3.1.1.2.1.1 Current running state of the service:

1Running

2Not running

3Starting

4Stopping

5Fault

.bcnDhcpv4FirstAlertIpAddr .3.1.1.2.1.2 Returns the IP address identifying either subnet

or pool for which the available IPs have been

exhausted

.bcnDhcpv4LeaseStatesSuccess .3.1.1.2.1.3 Number of successful DHCP leases issued per

second

.bcnDhcpv4LeaseTable .3.1.1.2.2.1 Current lease table

.bcnDhcpv4LeaseEntry .3.1.1.2.2.1.1 Information about a particular DHCP lease

.bcnDhcpv4LeaseIP .3.1.1.2.2.1.1.1 IP address of the lease

.bcnDhcpv4LeaseStartTime .3.1.1.2.2.1.1.2 Start time of the lease

.bcnDhcpv4LeaseEndTime .3.1.1.2.2.1.1.3 End time of the lease

.bcnDhcpv4LeaseTimeStamp .3.1.1.2.2.1.1.4 Timestamp for the lease

.bcnDhcpv4LeaseMacAddress .3.1.1.2.2.1.1.5 The Hardware address (MAC address) of the

lease

.bcnDhcpv4LeaseHostname .3.1.1.2.2.1.1.6 The client hostname of the lease

.bcnDhcpv4SubnetTable .3.1.1.2.2.2 Current subnet table

.bcnDhcpv4SubnetEntry .3.1.1.2.2.2.1 Information about a particular DHCP subnet

.bcnDhcpv4SubnetIP .3.1.1.2.2.2.1.1 IP address of the subnet

.bcnDhcpv4SubnetMask .3.1.1.2.2.2.1.2 IP mask of the subnet

.bcnDhcpv4SubnetSize .3.1.1.2.2.2.1.3 Size of the subnet

.bcnDhcpv4SubnetFreeAddresses .3.1.1.2.2.2.1.4 Number of IP addresses available in the subnet

.bcnDhcpv4SubnetLowThreshold .3.1.1.2.2.2.1.5 Low threshold for available free addresses in the

subnet

.bcnDhcpv4SubnetHighThreshold .3.1.1.2.2.2.1.6 High threshold for available free addresses in

the subnet

.bcnDhcpv4PoolTable .3.1.1.2.2.3 Current pool table

.bcnDhcpv4PoolEntry .3.1.1.2.2.3.1 Information about a particular DHCP pool

.bcnDhcpv4PoolStartIP .3.1.1.2.2.3.1.1 Start IP address in the pool

.bcnDhcpv4PoolEndIP .3.1.1.2.2.3.1.2 End IP address in the pool

.bcnDhcpv4PoolSubnetIP .3.1.1.2.2.3.1.3 Subnet IP address of the pool


5/12



BCN-DNS-MIB.mib:

.bcnDhcpv4Poolsize .3.1.1.2.2.3.1.4 The size of the pool

.bcnDhcpv4PoolFreeAddresses .3.1.1.2.2.3.1.5 The number of IP addresses available in the pool

.bcnDhcpv4FixedIPTable .3.1.1.2.2.4 Current DHCP subnet tables in configuration

.bcnDhcpv4FixedIPEntry .3.1.1.2.2.4.1 Information about a particular DHCP subnet

.bcnDhcpv4FixedIP .3.1.1.2.2.4.1.1 One of the current fixed IP addresses in the

DHCPv4 configuration

.bcnDhcpv4AlarmSeverity .3.1.1.3.1.1 Severity classification for the alarm

.bcnDhcpv4AlarmInfo .3.1.1.3.1.2 Descriptive information about the alarm event

.bcnDhcpv4SubnetAlertIpAddr .3.1.1.3.1.4 Returns the IP address identifying a subnet for

which the available IPs have been exhausted


.bcnDnsSerOperState .3.1.2.2.1.1 Current running state of the service:

1Running

2Not running

3Starting

4Stopping

5Fault

.bcnDnsSerNumberOfZones .3.1.2.2.1.2 Number of zones loaded

.bcnDnsSerTransfersRunning .3.1.2.2.1.3 Number of zone transfers currently in progress

.bcnDnsSerTransfersDeferred .3.1.2.2.1.4 Number of zone transfers currently deferred

.bcnDnsSerSOAQueriesInProgress .3.1.2.2.1.5 Number of SOA queries in progress

.bcnDnsSerQueryLogging .3.1.2.2.1.6 State of query logging:

1On

2Off

.bcnDnsSerDebugLevel .3.1.2.2.1.7 Debug log level. Ranges from 0 to 99:

0No logging

99Maximum level of logging

.bcnDnsStatSrvQrySuccess .3.1.2.2.2.1.1 Queries resulted in a successful answer

.bcnDnsStatSrvQryReferral .3.1.2.2.2.1.2 Queries resulted in referral answer

.bcnDnsStatSrvQryNXRRSet .3.1.2.2.2.1.3 Queries resulted in non-existent record

responses with no data

.bcnDnsStatSrvQryNXDomain .3.1.2.2.2.1.4 Queries resulted in non-existent domain

responses with no data

.bcnDnsStatSrvQryRecursion .3.1.2.2.2.1.5 Queries which caused the server to perform

recursion lookups to find the final answer



6/12

980



BCN-TFTP-MIB.mib:

BCN-NTP-MIB.mib:

.bcnDnsStatSrvQryFailure .3.1.2.2.2.1.6 Number of failed queries that did not result in

non-existent domain or record


.bcnTftpSerOperState .3.1.3.2.1.1 Current running state of the service:

1Running

2Not running

3Starting

4Stopping

5Fault

.bcnTftpSerDirs .3.1.3.2.2.1 Number of directories on the TFTP sub-tree

.bcnTftpSerFiles .3.1.3.2.2.2 Number of files on the TFTP sub-tree

.bcnTftpSerFilesSize .3.1.3.2.2.3 The sum of the size of all files in kilobytes

.bcnTftpSerPartialList .3.1.3.2.2.4 The TFTP information is partial


.bcnNtpSerOperState .3.1.4.2.1.1 Current running state of the service:

1Running 2Not running

3Starting

4Stopping

5Fault

.bcnNtpSysLeap .3.1.4.2.2.1 Two-bit warning of an impending leap second to

be inserted in the NTP timescale

.bcnNtpSysStratum .3.1.4.2.2.2 Indicating the stratum of the local clock:

0Unspecified

1Primary reference

2 to 255Secondary reference

.bcnNtpSysPrecision .3.1.4.2.2.3 Signed integer indicating the precision of the

various clocks, in seconds to the nearest power

of two

.bcnNtpSysRootDelay .3.1.4.2.2.4 The total roundtrip delay to the primary

reference source at the root of the

synchronization subnet, in seconds.

.bcnNtpSysRootDispersion .3.1.4.2.2.5 The maximum error relative to the primary


synchronization subnet, in seconds

.bcnNtpSysRefld .3.1.4.2.2.6 The particular reference clock



7/12



.bcnNtpSysRefTime .3.1.4.2.2.7 The local time when the local clock was last

updated

.bcnNtpSysPoll .3.1.4.2.2.8 The minimum interval between transmitted

messages, in seconds as a power of two

.bcnNtpSysPeer .3.1.4.2.2.9 The current synchronization source

.bcnNtpSysFreq .3.1.4.2.2.10 The clock frequency offset

.bcnNtpSysclock .3.1.4.2.2.11 The current local time

.bcnNtpSysSystem .3.1.4.2.2.12 The type of the local operating system

.bcnNtpSysProcessor .3.1.4.2.2.13 The type of the local processor

.bcnNtpSysJitter .3.1.4.2.2.14 Indicates how much the individual pulses vary

from second to second

.bcnNtpPeersVarTable .3.1.4.2.3.1 A table listing the peers known to the server as

well as summary information of their state

.bcnNtpPeersVarEntry .3.1.4.2.3.1.1 A logical row in the bcnNtpPeersVarTable

.bcnNtpPeersAssocId .3.1.4.2.3.1.1.1 Assocation ID of the peer

.bcnNtpPeersConfigured .3.1.4.2.3.1.1.2 A bit indicating that the association was created

from configuration information and should not

be demobilized if the peer becomes

unreachable

.bcnNtpPeersPeerAddressType .3.1.4.2.3.1.1.3 The internet address type of the peer

.bcnNtpPeersPeerAddress .3.1.4.2.3.1.1.4 The internet address of the peer

.bcnNtpPeersPeerPort .3.1.4.2.3.1.1.5 16-bit port number of the peer

.bcnNtpPeersHostAddressType .3.1.4.2.3.1.1.6 The internet address type of the host

.bcnNtpPeersHostAddress .3.1.4.2.3.1.1.7 The internet address of the host

.bcnNtpPeersHostPort .3.1.4.2.3.1.1.8 16-bit port number of the host

.bcnNtpPeersLeap .3.1.4.2.3.1.1.9 Two-bit code warning of an impending leap

second to be inserted in the NTP timescale

.bcnNtpPeersMode .3.1.4.2.3.1.1.10 The association mode:

0Unspecified

1Symmetric active

2Symmetric passive

3Client

4Server

5Broadcast

6Reserved for NTP control messages

7Reserved for private use



8/12

982



.bcnNtpPeersStratum .3.1.4.2.3.1.1.11 Indicates the stratum of the peer clock:

0Unspecified 1Primary reference

2 to 255secondary reference

.bcnNtpPeersPeerPoll .3.1.4.2.3.1.1.12 Poll interval of the peer

.bcnNtpPeersHostPoll .3.1.4.2.3.1.1.13 Poll interval of the host

.bcnNtpPeersPrecision .3.1.4.2.3.1.1.14 Signed integer indicating the precision of the

various clocks, in seconds to the nearest power

of two

.bcnNtpPeersRootDelay .3.1.4.2.3.1.1.15 The total roundtrip delay to the primary



.bcnNtpPeersRootDspersion .3.1.4.2.3.1.1.16 The maximum error relative to the primary



.bcnNtpPeersRefId .3.1.4.2.3.1.1.17 The particular reference clock

.bcnNtpPeersRefTime .3.1.4.2.3.1.1.18 The local time when the local clock was last

updated

.bcnNtpPeersOrgTime .3.1.4.2.3.1.1.19 The local time at the peer when its lastest NTP

message was sent

.bcnNtpPeersReceiveTime .3.1.4.2.3.1.1.20 The local time when the latest NTP message

from the peer arrived

.bcnNtpPeersTransmitTime .3.1.4.2.3.1.1.21 The local time at which the NTP message

departed the sender

.bncNtpPeersReach .3.1.4.2.3.1.1.22 A shift register of NTP.WINDOW bits used to

determine the reachability status of the peer

.bcnNtpPeersOffset .3.1.4.2.3.1.1.23 Filter offset

.bcnNtpPeersDelay .3.1.4.2.3.1.1.24 Filter delay

.bcnNtpPeersDispersion .3.1.4.2.3.1.1.25 Filter dispersion

.bcnNtpPeersJitter .3.1.4.2.3.1.1.26 Indicates how much the individual pulses vary

from second to second



9/12



BCN-HA-MIB.mib:

BCN-COMMANDSERVER-MIB.mib:

BCN-SYSTEM-MIB.mib:


.bcnHaSerOperState .3.1.5.2.1.1 Current running state of the service:

1Standalone

2Active

3Passive

4Stopped

5Stopping

6BecomingActive

7BecomingPassive

8Fault


.bcnCommandServerSerOperState .3.1.7.2.1.1 Current running state of the service:

1Running

2Not running

3Starting

4Stopping

5Fault


.bcnSysIdProduct .3.2.2.1.1 OIDs for the object obtained from BCN-

PRODUCTS-MIB

.bcnSysIdOSRelease .3.2.2.1.2 The BlueCat Networks running OS release

.bcnSysIdSerial .3.2.2.1.3 Serial number usually assigned to a hardware

platform

.bcnSysIdServiceTag .3.2.2.1.4 Manufacturer service tag

.bcnSysIdPlatform .3.2.2.1.5 Platform identification

.bcnSysIdVendorPlatform .3.2.2.1.6 Platform vendor identification

.bcnSysIdServicesTable .3.2.2.1.7 Enumerates the services available on the system

.bcnSysIdServicesEntry .3.2.2.1.7.1 A logical row in the bcnSysIdServicesTable

object

.bcnSysIdServicesIndex .3.2.2.1.7.1.1 Table index

.bcnSysIdServicesOID .3.2.2.1.7.1.2 The OID of the service available on the system

.bcnSysIdServicesStateTS .3.2.2.1.7.1.3 Last time this particular service changed state


10/12

984



Adonis Traps

The BCN-DHCPV4-MIB.mib, BCN-DNS-MIB.mib, BCN-TFTP-MIB.mib, BCN-NTP-MIB.mib, BCN-

COMMANDSERVER-MIB.mib, and BCN-SYSTEM-MIB.mib. files also contain trap objects. The Adonis-

specific traps fall into the following groups:

DNS

High Availability

Command Server

DHCP

Replication

TFTP

NTP

The following table lists the Adonis SNMP traps in the file BCN-DHCPV4-MIB.mib, BCN-DNS-MIB.mib,

BCN-TFTP-MIB.mib, BCN-NTP-MIB.mib, BCN-COMMANDSERVER-MIB.mib, BCN-SYSTEM-MIB.mib, andBCN-HA-MIB.mib.

Each Adonis MIB OID (object identifier) begins with the following prefix:


All Adonis object IDs begin with the same prefix, but it is omitted from the OIDcolumn below.


.bcnDhcpv4AlarmNotif .3.1.1.3.0.1 Returns when the DHCPv4 service has transitioned state or a

particular event has been detected on the service

.bcnDhcpv4FailOverState .3.1.1.3.1.3 Current state of the DHCP failover:

1Startup

2Normal

3Communications interrupted

4Partner down

5Potential conflict

6Recover

7Paused

8Shutdown

9Recover done

254Recover wait

.bcnDnsAlarmNotif .3.1.2.3.0.1 Returns when the DNS service has transitioned state or a


.bcnTftpAlarmNotif .3.1.3.3.0.1 Returns when the TFTP service has transitioned state or a


.bcnNtpAlarmNotif .3.1.4.3.0.1 Returns when the NTP service has transitioned state or a


.bcnHaAlarmNotif .3.1.5.3.0.1 Returns when the HA service has transitioned state or


.bcnCommandServerAlarmNo

tif

.3.1.7.3.0.1 Returns when the COMMANDSERVER service has transitioned

state or a particular event has been detected on the service


11/12



Linux Polled Objects

The following table lists the Linux system-specific SNMP polled-objects in the HOST-RESOURCES-

MIB.mib,UCD-SNMP-MIB.mib, andIF-MIB.mib files. Proteus uses these MIBs to report memory, CPU,

network, and Disk utilization.

UCD-SNMP-MIB:

The memory usage metric describes the real and swap memory counters of an Adonis server.

The CPU usage metric describes CPUs system, user, nice, and idle counters of an Adonis server.

.bcnSysAlarmNotif .3.2.3.0.1 Returns when the system starts, reboots or shouts down


.memTotalSwap .1.3.6.1.4.1.2021.4.3.0 Total swap size

.memAvailSwap .1.3.6.1.4.1.2021.4.4.0 Available swap size

.memTotalReal .1.3.6.1.4.1.2021.4.5.0 Total RAM in machine

.memAvailReal .1.3.6.1.4.1.2021.4.6.0 Total RAM used

.memTotalFree .1.3.6.1.4.1.2021.4.11.0 Total RAM free

.memShared .1.3.6.1.4.1.2021.4.13.0 Total RAM shared

.memBuffer .1.3.6.1.4.1.2021.4.14.0 Total RAM buffered

.memCached .1.3.6.1.4.1.2021.4.15.0 Total cached memory


.ssCpuUser .1.3.6.1.4.1.2021.11.9.0 Percentage of user CPU time

.ssCpuSystem .1.3.6.1.4.1.2021.11.10.0 Percentages of system CPU time

.ssCpuIdle .1.3.6.1.4.1.2021.11.11.0 Percentage of idle CPU time

.ssCpuRawUser .1.3.6.1.4.1.2021.11.50.0 Raw user CPU time

.ssCpuRawNice .1.3.6.1.4.1.2021.11.51.0 Raw nice CPU time

.ssCpuRawSystem .1.3.6.1.4.1.2021.11.52.0 Raw system CPU time

.ssCpuRawIdle .1.3.6.1.4.1.2021.11.53.0 Raw idle CPU time

The values for these objects vary depending on the number of CPU cores on Adonis server. In order

to obtain the accurate value, divide the value by the number of CPU cores which can be obtained

using .hrProcessorTable object in HOST-RESOURCES-MIB.mibfile.



12/12

986



IF-MIB:

The NIC utilization metric describes inbound and outbound traffics of an Adonis server.

HOST-RESOURCES-MIB:

The disk utilization metric describes the percentage usage of disk root on an Adonis server.


.ifTable.ifEntry.ifDescr .1.3.6.1.2.1.2.2.1.2 Statistics for all network interfaces

.ifTable.ifEntry.ifInOctets .1.3.6.1.2.1.2.2.1.10 Total number of octets received on the

interface including framing characters

.ifTable.ifEntry.ifInUcastPkts .1.3.6.1.2.1.2.2.1.11 Number of packets not addressed to a

multicast or broadcast address

.ifTable.ifEntry.ifOutOctets .1.3.6.1.2.1.2.2.1.16 Total number of octets transmitted out of

the interface, including framing

characters

.ifTable.ifEntry.ifOutUcastPkts .1.3.6.1.2.1.2.2.1.17 Total number of packets not addressed to

a multicast or broadcast address,

including packets discarded or not sent


.hrStorageTable.hrStorageEntry.hr

StorageDescr

.1.3.6.1.2.1.25.2.3.1.3 Description of the type and instance of

the storage


StorageSize

.1.3.6.1.2.1.25.2.3.1.5 The size of the storage


StorageUsed

.1.3.6.1.2.1.25.2.3.1.6 The amount of the storage allocated

.hrProcessorTable .1.3.6.1.2.1.25.3.3 Total number of CPU cores on Adonis

server

Date post:	02-Jun-2018
Category:	Documents
Upload:	aijaz-mirza
View:	317 times
Download:	1 times

Configuring SNMP on Proteus

Documents