| Skip Navigation Links | |
| Exit Print View | |
 | man pages section 1M: System Administration Commands Oracle Solaris 11 Information Library |
| Skip Navigation Links | |
| Exit Print View | |
| man pages section 1M: System Administration Commands Oracle Solaris 11 Information Library |
- Sun SNMP Agent
mibiisa [-ar] [-cconfig-dir] [-ddebug-level] [-pport] [-tcache-timer]
Themibiisa utility is an RFC 1157-compliant SNMP agent. It supports MIB-IIas defined inRFC 1213, with Sun extensions under Sun's enterprise number. TheMIB (Management Information Base) is both readable and writable. Themibiisa utility supportsall SNMP protocol operations including GET-REQUEST, GETNEXT-REQUEST, SET-REQUEST, GET-REPLY, and TRAP.
The SMA (Systems Management Agent) is the default SNMP agent in Solaris.MIB-II subagentmibiisa does not run by default. To enablemibiisa, renamethe configuration file from/etc/snmp/conf/mibiisa.rsrc- to/etc/snmp/conf/mibiisa.rsrc. SMA has the capability tohandle any MIB-II requests.
Themibiisa utility supports the coldStart, linkUp, linkDown, and authentication traps. Theauthentication trap may be disabled by a command-line switch, which itself maybe overridden by a management station writing to a MIB variable inthe standard SNMP MIB group.
Themibiisa utility supports four distinct views of the MIB. The viewused for any request is determined by the community string contained inthat request.
To enhance security,mibiisa supports an option to block all writes tothe MIB. You can also limit the set of management stations fromwhich the agent will accept requests in the configuration file used whenstarting themibiisa. See theSecurity section for more information.
Unless overridden,mibiisa uses UDP port 161, the standard SNMP port. Themibiisa utility issues traps through the same port on which it receivesSNMP requests.
Themibiisa utility must run with super-user privileges and is typically startedat system startup via/etc/rc3.d.mibiisa may not be started usinginetd(1M).When started,mibiisa detaches itself from the keyboard, disables all signals exceptSIGKILL,SIGILL,SIGUSR1, andSIGUSR2, and places itself in the background.
The following options are supported bymibiisa:
Disable the generation of authentication traps. However, an SNMP manager may write a value intosnmpEnableAuthenTraps to enable or disable authentication traps.
Specify a directory where it expectssnmpd.conf file, on startup. The default directory is/etc/snmp/conf.
Debug. A value of 0 disables all debug and is the default. Levels 1 through 3 represent increasing levels of debug output. Whenmibiisa receives the signalSIGUSR1, it resets the debug-level to 0. Whenmibiisa receives the signalSIGUSR2, it increments the debug-level by one.
Debug output is sent to the standard output in effect at the timemibiisa is started. No matter what debug level is in effect, certain significant events are logged in the system log.
Define an alternative UDP port on whichmibiisa listens for incoming requests. The default is UDP port 161.
Place the MIB into read-only mode.
By default, information fetched from the kernel is considered to be valid for 45 seconds from the time it is retrieved. This cache lifetime may be altered with this parameter. You cannot setcache-timer to any value less than 1.
Thesnmpd.conf file is used for configuration information. Each entry in thefile consists of a keyword followed by a parameter string. The keywordmust begin in the first position. Parameters are separated from the keywordand from one another by white space. Case in keywords is ignored. Eachentry must be contained on a single line. All text following (andincluding) a pound sign (#) is ignored. Keywords currently supported are:
The value to be used to answer queries for sysDescr.
The value to be used to answer queries for sysContact.
The value to be used to answer queries for sysLocation.
The parameter names one or more hosts to receive traps. Only five hosts may be listed.
The community name to get read access to the system group and Sun's extended system group.
The community name to get write access to the system group and Sun's extended system group.
The community name to get read access to the entire MIB.
The community name to get write access to the entire MIB (implies read access).
The community name to be used in traps.
The name of the file to use for kernel symbols.
The names of hosts that may send SNMP queries. Only five hosts may be listed on any one line. This keyword may be repeated for a total of 32 hosts.
The additional devices which are not built in SNMPD. The format is as follows:newdevicetypespeedname wherenewdevice is the keyword,type is an integer which has to match your schema file,speed is the new device's speed, andname is this new device's name.
An examplesnmpd.conf file is shown below:
sysdescr Sun SNMP Agent, Sun Fire 4800, Company Property Number 123456syscontact Cliff ClavensysLocation Room 1515, building 1#system-group-read-community publicsystem-group-write-community private#read-community all_publicwrite-community all_private#trap localhosttrap-community SNMP-trap##kernel-file /vmunix#managers lvs goldenmanagers swap
Themibiisa utility and its configuration file,snmpd.conf, may be placed inany directory. However for Solaris 2.4 and subseqent releases, use/usr/lib/snmp formibiisa itself and/etc/snmp/conf for the configuration file. You can modify the configurationfile as appropriate. If you make any changes tosnmpd.conf file keywordvalues, you must kill and restartmibiisa for the changes to takeeffect.
Your/etc/services file (or NIS equivalent) should contain the following entries:
|
The following is an example for Solaris 2.x and releases compatible withSolaris 2.x, such as Solaris 9:
## Start the SNMP agent#if [ -f /etc/snmp/conf/snmpd.conf -a -x /usr/lib/snmp/mibiisa ];then/opt/SUNWconn/snm/agents/snmpdecho 'Starting SNMP-agent.'
SNMP, as presently defined, offers relatively little security. Themibiisa utility acceptsrequests from other machines, which can have the effect of disabling thenetwork capabilities of your computer. To limit the risk, the configuration filelets you specify a list of up to 32 manager stations from whichmibiisa will accept requests. If you do not specify any such managerstations,mibiisa accepts requests from anywhere.
Themibiisa utility also allows you to mark the MIB as “read-only”by using the-r option.
mibiisa supports four different community strings. These strings, however, are visible inthe configuration file and within the SNMP packets as they flow onthe network.
The configuration file should be owned by, and readable only by super-user.In other words the mode should be:
-rw------- 1 root 2090 Oct 17 15:04 /etc/snmp/conf/snmpd.conf
Managers can be restricted based on the community strings. This can beconfigured by creating an optional secondary configuration file/etc/snmp/conf/mibiisa.acl. To enable sucha restriction, add the security line in the/etc/snmp/conf/mibiisa.rsrc file.
An examplemibiisa.acl file is as follows:
acl = { { communities = public access = read-only managers = xyz } { communities = private access = read-write managers = abc,pqrs }}An examplemibiisa.rsrc file is as follows:
resource ={ { registration_file = "/etc/snmp/conf/mibiisa.reg" security = "/etc/snmp/conf/mibiisa.acl" policy = "spawn" type = "legacy" command = "/usr/lib/snmp/mibiisa -r -p $PORT" }}This section discusses some of the differences between themibiisa MIB andthe standard MIB-II (as defined in RFC 1213).
The following variables are read-only in themibiisa MIB:
sysNameatIfIndexipDefaultTTL
These variables are read-write in the standard MIB-II.
Themibiisa MIB Address Translation tables support limited write access: only atPhysAddressmay be written, either to change the physical address of an existingentry or to delete an entire ARP table entry.
Themibiisa MIB IP Net to Media table supports limited write access:only ipNetToMediaPhysAddress and ipNetToMediaType may be written, either to change the physicaladdress of an existing entry or to delete an entire ARP tableentry.
The following variables are read-write in themibiisa MIB; however, these variableshave fixed values. Any new values “set” to them are accepted, buthave no effect:
ipRoutIfIndexipRouteMetric1ipRouteMetric2ipRouteMetric3ipRouteMetric4ipRouteTypeipRouteAgeipRouteMaskipRouteMetric5
The followingmibiisa MIB variable reflects the actual state of the relatedtable entry. “Sets” are accepted but have no effect:
tcpConnState
The followingmibiisa MIB variables are readable, but return a fixed value:
|
The following variables return a fixed value of0 for drivers notconforming to the GLD framework (seegld(7D)), including the old LAN drivers onSPARC machines:
|
The following describes the attributes in the group and table definitions inthe/var/snmp/mib/sun.mib file.
Thesystem group reports statistics about a particular system (for example, aworkstation or a printer).
sysDescr - A textual description of the entity. This value should includethe full name and version identification of the system's hardware type, softwareoperating-system, and networking software. This value must only contain printable ASCII characters.(string[255])
sysObjectID - The vendor's authoritative identification of the network management subsystem containedin the entity. This value is allocated within the SMI enterprises subtree(1.3.6.1.4.1) and provides an easy and unambiguous means for determining what typeof equipment is being managed. For example, if vendor “Flintstones, Inc.” was assignedthe subtree 1.3.6.1.4.1.4242, it could assign the identifier 1.3.6.1.4.1.4242.1.1 to its “FredRouter.” (objectid)
sysUpTime - Time (in hundredths of a second) since the network managementportion of the system was last reinitialized. (timeticks)
sysContact - The textual identification of the contact person for this managednode, together with information on how to contact this person. (string[255])
sysName - An administratively-assigned name for this managed node. By convention, thisis the node's fully-qualified domain name. (string[255])
sysLocation - The physical location of this node (for example, “telephone closet,3rd floor” (string[255]))
sysServices - A value indicating the set of services that this entityprimarily offers. (int) The value is a sum. This sum initially takesthe value zero. Then, for each layer L in the range 1through 7 for which this node performs transactions, 2 raised to (L- 1) is added to the sum. For example, a node that performsprimarily routing functions would have a value of 4 (2**(3-1)). In contrast,a node that is a host offering application services would have avalue of 72 (2**(4-1) + 2**(7-1)). Note that in the context ofthe Internet suite of protocols, values should be calculated accordingly:
|
For systems including OSI protocols, Layers 5 and 6 may also becounted.
Theinterfaces group reports the number of interfaces handled by the agent.
ifNumber - The number of network interfaces, regardless of their current state,present on this system. (int)
TheifTable is a table of interface entries. The number of entriesis given by the value of ifNumber.
ifIndex - A unique value for each interface. Its value ranges between1 and the value of ifNumber. The value for each interface mustremain constant at least from one reinitialization of the entity's network managementsystem to the next reinitialization. (int)
ifDescr - A textual string containing information about the interface. This stringshould include the name of the manufacturer, the product name, and theversion of the hardware interface. (string[255])
ifType - The type of interface, distinguished according to the physical/link protocol(s)immediately below the network layer in the protocol stack. (enum)
ifMtu - The size of the largest datagram that can be sent/receivedon the interface, specified in octets. For interfaces used for transmitting networkdatagrams, this is the size of the largest network datagram that canbe sent on the interface. (int)
ifSpeed - An estimate of the interface's current bandwidth in bits-per-second. Forinterfaces that do not vary in bandwidth, or for those where noaccurate estimation can be made, this object should contain the nominal bandwidth.(gauge)
if1hysAddress - The interface's address at the protocol layer immediately below thenetwork layer in the protocol stack. For interfaces without such an address(for example, a serial line), this object should contain an octet stringof zero length. (octet[128])
ifAdminStatus - The desired state of the interface. The testing(3) state indicatesthat no operational packets can be passed. (enum)
ifOperStatus - The current operational state of the interface. The testing(3)state indicates that no operational packets can be passed. (enum)
ifLastChange - The value of sysUpTime at the time the interface enteredits current operational state. If the current state was entered prior tothe last reinitialization of the local network management subsystem, then this objectcontains a zero value. (timeticks)
ifInOctets - The total number of octets received on the interface, includingframing characters. (counter) Returns a fixed value of 0.
ifInUcastPkts - The number of subnetwork-unicast packets delivered to a higher-layer protocol.(counter)
ifInNUcastPkts - The number of non-unicast (that is, subnetwork- broadcast or subnetwork-multicast)packets delivered to a higher-layer protocol. (counter) Returns a fixed value of0.
ifInDiscards - The number of inbound packets chosen to be discarded, eventhough no errors had been detected to prevent their being deliverable toa higher-layer protocol. One possible reason for discarding such a packet couldbe to free up buffer space. (counter) Returns a fixed value of 0.
ifInErrors - The number of inbound packets that contained errors preventing themfrom being deliverable to a higher-layer protocol. (counter)
ifInUnknownProtos - The number of packets received via the interface that werediscarded because of an unknown or unsupported protocol. (counter) Returns a fixedvalue of 0.
ifOutOctets - The total number of octets transmitted out of the interface,including framing characters. (counter) Returns a fixed value of 0.
ifOutUcastPkts - The total number of packets that higher-level protocols requested betransmitted to a subnetwork-unicast address, including those that were discarded or notsent. (counter)
ifOutNUcastPkts - The total number of packets that higher-level protocols requested betransmitted to a non- unicast (that is, a subnetwork-broadcast or subnetwork-multicast) address,including those that were discarded or not sent. (counter) Returns a fixedvalue of 0.
ifOutDiscards - The number of outbound packets that were chosen to bediscarded even though no errors had been detected to prevent their beingtransmitted. One possible reason for discarding such a packet could be tofree up buffer space. (counter) Returns a fixed value of 0.
ifOutErrors - The number of outbound packets that could not be transmittedbecause of errors. (counter)
ifOutQLen - The length of the output packet queue (in packets). (gauge)
ifSpecific - A reference to MIB definitions specific to the particular mediabeing used to realize the interface. For example, if the interface isrealized by an Ethernet, then the value of this object refers toa document defining objects specific to Ethernet. If this information is not present,its value should be set to the OBJECT IDENTIFIER { 0 0 },which is a syntactically valid object identifier. Any conformant implementation of ASN.1and BER must be able to generate and recognize this value. (objectid)
atTable Address Translation tables contain the NetworkAddress to physical address equivalences. Someinterfaces do not use translation tables for determining address equivalences (for example,DDN-X.25 has an algorithmic method). If all interfaces are of this type,then the Address Translation table is empty, that is, has zero entries.
atIfIndex - The interface on which this entry's equivalence is effective. Theinterface identified by a particular value of this index is the sameinterface as identified by the same value of ifIndex. (int)
atPhysAddress - The media-dependent physical address. (octet[128]) Setting this object to anull string (one of zero length) has the effect of invaliding thecorresponding entry in the atTable object. That is, it effectively dissociates theinterface identified with said entry from the mapping identified with said entry. Itis an implementation-specific matter as to whether the agent removes an invalidatedentry from the table. Accordingly, management stations must be prepared to receivetabular information from agents that corresponds to entries not currently in use. Properinterpretation of such entries requires examination of the relevant atPhysAddress object.
atNetAddress - The NetworkAddress (that is, the IP address) corresponding to themedia-dependent physical address. (netaddress)
Theip group reports statistics about the Internet Protocol (IP) group.
ipForwarding - The indication of whether this entity is acting as anIP gateway in respect to the forwarding of datagrams received by, butnot addressed to, this entity. IP gateways forward datagrams. IP hosts donot— except those source-routed via the host. (enum)
Note that for some managed nodes, this object may take on onlya subset of the values possible. Accordingly, it is appropriate for anagent to return a “badValue” response if a management station attempts tochange this object to an inappropriate value.
ipDefaultTTL - The default value inserted into the Time-To-Live field of theIP header of datagrams originated at this entity, whenever a TTL valueis not supplied by the transport layer protocol. (int)
ipInReceives - The total number of input datagrams received from interfaces, includingthose received in error. (counter)
ipInHdrErrors - The number of input datagrams discarded due to errors intheir IP headers, including bad checksums, version number mismatch, other format errors,time-to-live exceeded, errors discovered in processing their IP options, and so on.(counter)
ipInAddrErrors - The number of input datagrams discarded because the IP addressin their IP header's destination field was not a valid address tobe received at this entity. This count includes invalid addresses (for example,0.0.0.0) and addresses of unsupported Classes (for example, Class E). For entities thatare not IP Gateways and therefore do not forward datagrams, this counterincludes datagrams discarded because the destination address was not a local address.(counter)
ipForwDatagrams - The number of input datagrams for which this entity wasnot their final IP destination, as a result of which an attemptwas made to find a route to forward them to that finaldestination. In entities that do not act as IP Gateways, this counter willinclude only those packets that were Source-Routed via this entity, and theSource- Route option processing was successful. (counter)
ipInUnknownProtos - The number of locally-addressed datagrams received successfully but discarded becauseof an unknown or unsupported protocol. (counter)
ipInDiscards - The number of input IP datagrams for which no problemswere encountered to prevent their continued processing, but which were discarded, forexample, for lack of buffer space. Note that this counter does notinclude any datagrams discarded while awaiting reassembly. (counter)
ipInDelivers - The total number of input datagrams successfully delivered to IPuser-protocols (including ICMP). (counter)
ipOutRequests - The total number of IP datagrams that local IP user-protocols(including ICMP) supplied to IP in requests for transmission. Note that thiscounter does not include any datagrams counted in ipForwDatagrams. (counter)
ipOutDiscards - The number of output IP datagrams for which no problemwas encountered to prevent their transmission to their destination, but which werediscarded (for example, for lack of buffer space). Note that this counterwould include datagrams counted in ipForwDatagrams if any such packets met this (discretionary)discard criterion. (counter)
ipOutNoRoutes - The number of IP datagrams discarded because no route couldbe found to transmit them to their destination. Note that this counterincludes any packets counted in ipForwDatagrams which meet this “no-route” criterion. Notethat this includes any datagrams that a host cannot route because all itsdefault gateways are down. (counter)
ipReasmTimeout - The maximum number of seconds that received fragments are heldwhile they are awaiting reassembly at this entity. (int)
ipReasmReqds - The number of IP fragments received that needed to bereassembled at this entity. (counter)
ipReasmOKs - The number of IP datagrams successfully reassembled. (counter)
ipReasmFails - The number of failures detected by the IP reassembly algorithm,for whatever reason: timed out, errors, and the like. Note that thisis not necessarily a count of discarded IP fragments since some algorithms(notably the algorithm in RFC 815) can lose track of the number offragments by combining them as they are received. (counter)
ipFragOKs - The number of IP datagrams that have been successfully fragmentedat this entity. (counter)
ipFragFails - The number of IP datagrams that have been discarded becausethey needed to be fragmented at this entity but could not be,for example, because their “Don't Fragment” flag was set. (counter)
ipFragCreates - The number of IP datagram fragments that have been generatedas a result of fragmentation at this entity. (counter)
ipRoutingDiscards - The number of routing entries that were chosen to bediscarded even though they were valid. One possible reason for discarding suchan entry could be to free-up buffer space for other routing entries.(counter) Returns a fixed value of 0.
ipAddrTable is a table of addressing information relevant to this entity's IPaddresses.
ipAdEntAddr - The IP address to which this entry's addressing information pertains.(netaddress)
ipAdEntIfIndex - The index value that uniquely identifies the interface to whichthis entry is applicable. The interface identified by a particular value ofthis index is the same interface as identified by the same valueof ifIndex. (int)
ipAdEntNetMask - The subnet mask associated with the IP address of thisentry. The value of the mask is an IP address with allthe network bits set to 1, and all the hosts bits setto 0. (netaddress)
ipAdEntBcastAddr - The value of the least-significant bit in the IP broadcastaddress used for sending datagrams on the (logical) interface associated with theIP address of this entry. For example, when the Internet standard all-onesbroadcast address is used, the value will be 1. This value applies toboth the subnet and network broadcasts addresses used by the entity onthis (logical) interface. (int) Returns a fixed value of 1.
ipAdEntReasmMaxSize - The size of the largest IP datagram that this entitycan reassemble from incoming IP fragmented datagrams received on this interface. (int)Returns a fixed value of 65535.
TheipRouteTable is this entity's IP Routing table.
ipRouteDest - The destination IP address of this route. An entry witha value of 0.0.0.0 is considered a default route. Multiple routes toa single destination can appear in the table, but access to suchmultiple entries is dependent on the table- access mechanisms defined by the networkmanagement protocol in use. (netaddress)
ipRouteIfIndex - The index value that uniquely identifies the local interface throughwhich the next hop of this route should be reached. The interfaceidentified by a particular value of this index is the same interfaceas identified by the same value of ifIndex. (int)
ipRouteMetric1 - The primary routing metric for this route. The semantics ofthis metric are determined by the routing-protocol specified in the route's ipRouteProtovalue. If this metric is not used, its value should be setto -1. (int) Returns a fixed value of -1.
ipRouteMetric2 - An alternate routing metric for this route. The semantics ofthis metric are determined by the routing-protocol specified in the route's ipRouteProtovalue. If this metric is not used, its value should be setto -1. (int) Returns a fixed value of -1.
ipRouteMetric3 - An alternate routing metric for this route. The semantics ofthis metric are determined by the routing-protocol specified in the route's ipRouteProtovalue. If this metric is not used, its value should be setto -1. (int) Returns a fixed value of -1.
ipRouteMetric4 - An alternate routing metric for this route. The semantics ofthis metric are determined by the routing-protocol specified in the route's ipRouteProtovalue. If this metric is not used, its value should be setto -1. (int) Returns a fixed value of -1.
ipRouteNextHop - The IP address of the next hop of this route.(In the case of a route bound to an interface that isrealized via a broadcast media, the value of this field is theagent's IP address on that interface.) (netaddress)
ipRouteType - The type of route. Note that the values direct (3)and indirect (4) refer to the notion of direct and indirect routingin the IP architecture. (enum)
Setting this object to the value invalid (2) has the effect ofinvalidating the corresponding entry in the ipRouteTable object. That is, it effectivelydissociates the destination identified with said entry from the route identified withsaid entry. It is an implementation-specific matter as to whether the agent removesan invalidated entry from the table. Accordingly, management stations must be preparedto receive tabular information from agents that corresponds to entries not currentlyin use. Proper interpretation of such entries requires examination of the relevantipRouteType object.
ipRouteProto - The routing mechanism through which this route was learned. Inclusionof values for gateway routing protocols is not intended to imply thathosts should support those protocols. (enum)
ipRouteAge - The number of seconds since this route was last updatedor otherwise determined to be correct. Note that no semantics of “tooold” can be implied except through knowledge of the routing protocol bywhich the route was learned. (int) Returns a fixed value of 0.
ipRouteMask - Indicate the mask to be logical-ANDed with the destination addressbefore being compared to the value in the ipRouteDest field. For thosesystems that do not support arbitrary subnet masks, an agent constructs thevalue of the ipRouteMask by determining whether the value of the correspondent ipRouteDestfield belongs to a class-A, B, or C network, and then usingone of:
|
If the value of the ipRouteDest is 0.0.0.0 (a default route), thenthe mask value is also 0.0.0.0. It should be noted that allIP routing subsystems implicitly use this mechanism. (netaddress)
ipRouteMetric5 - An alternate routing metric for this route. The semantics ofthis metric are determined by the routing-protocol specified in the route's ipRouteProtovalue. If this metric is not used, its value should be setto -1. (int) Returns a fixed value of -1.
ipRouteInfo - A reference to MIB definitions specific to the particular routingprotocol responsible for this route, as determined by the value specified inthe route's ipRouteProto value. If this information is not present, its valueshould be set to the OBJECT IDENTIFIER { 0 0 }, which isa syntactically valid object identifier. Any conformant implementation of ASN.1 and BERmust be able to generate and recognize this value. (objectid)
TheipNetToMediaTable is the IP Address Translation table used for mapping fromIP addresses to physical addresses.
ipNetToMediaIfIndex - The interface on which this entry's equivalence is effective. Theinterface identified by a particular value of this index is the sameinterface as identified by the same value of ifIndex. (int)
ipNetToMediaPhysAddress - The media-dependent physical address. (octet[128])
ipNetToMediaNetAddress - The IpAddress corresponding to the media- dependent physical address. (netaddress)
ipNetToMediaType - The type of mapping. (enum) Returns a fixed value of(3)dynamic. Setting this object to the value invalid(2) has the effect ofinvalidating the corresponding entry in the ipNetToMediaTable. That is, it effectively dissociatesthe interface identified with said entry from the mapping identified with said entry.It is an implementation-specific matter as to whether the agent removes aninvalidated entry from the table. Accordingly, management stations must be prepared toreceive tabular information from agents that corresponds to entries not currently in use.Proper interpretation of such entries requires examination of the relevant ipNetToMediaType object.
Theicmp group reports statistics about the ICMP group.
icmpInMsgs - The total number of ICMP messages that the entity received.Note that this counter includes all those counted by icmpInErrors. (counter)
icmpInErrors - The number of ICMP messages that the entity received butdetermined as having ICMP-specific errors (bad ICMP checksums, bad length, and thelike.). (counter)
icmpInDestUnreachs - The number of ICMP Destination Unreachable messages received. (counter)
icmpInTimeExcds - The number of ICMP Time Exceeded messages received. (counter)
icmpInParmProbs - The number of ICMP Parameter Problem messages received. (counter)
icmpInSrcQuenchs - The number of ICMP Source Quench messages received. (counter)
icmpInRedirects - The number of ICMP Redirect messages received. (counter)
icmpInEchos - The number of ICMP Echo (request) messages received. (counter)
icmpInEchoReps - The number of ICMP Echo Reply messages received. (counter)
icmpInTimestamps - The number of ICMP Timestamp (request) messages received. (counter)
icmpInTimestampReps - The number of ICMP Timestamp Reply messages received. (counter)
icmpInAddrMasks - The number of ICMP Address Mask Request messages received. (counter)
icmpInAddrMaskReps - The number of ICMP Address Mask Reply messages received. (counter)
icmpOutMsgs - The total number of ICMP messages that this entity attemptedto send. Note that this counter includes all those counted by icmpOutErrors.(counter)
icmpOutErrors - The number of ICMP messages that this entity did notsend due to problems discovered within ICMP, such as a lack ofbuffers. This value should not include errors discovered outside the ICMP layer,such as the inability of IP to route the resultant datagram. Insome implementations there may be no types of errors that contribute tothis counter's value. (counter)
icmpOutDestUnreachs - The number of ICMP Destination Unreachable messages sent. (counter)
icmpOutTimeExcds - The number of ICMP Time Exceeded messages sent. (counter)
icmpOutParmProbs - The number of ICMP Parameter Problem messages sent. (counter)
icmpOutSrcQuenchs - The number of ICMP Source Quench messages sent. (counter)
icmpOutRedirects - The number of ICMP Redirect messages sent. For a host,this object will always be zero, since hosts do not send redirects.(counter)
icmpOutEchos - The number of ICMP Echo (request) messages sent. (counter)
icmpOutEchoReps - The number of ICMP Echo Reply messages sent. (counter)
icmpOutTimestamps - The number of ICMP Timestamp (request) messages sent. (counter)
icmpOutTimestampReps - The number of ICMP Timestamp Reply messages sent. (counter)
icmpOutAddrMasks - The number of ICMP Address Mask Request messages sent. (counter)
icmpOutAddrMaskReps - The number of ICMP Address Mask Reply messages sent. (counter)
Thetcp group reports statistics about the TCP group.
tcpRtoAlgorithm - The algorithm used to determine the timeout value used forretransmitting unacknowledged octets. (enum)
tcpRtoMin - The minimum value permitted by a TCP implementation for theretransmission timeout, measured in milliseconds. More refined semantics for objects of thistype depend upon the algorithm used to determine the retransmission timeout. Inparticular, when the timeout algorithm is rsre(3), an object of this type hasthe semantics of the LBOUND quantity described in RFC 793. (int)
tcpRtoMax - The maximum value permitted by a TCP implementation for theretransmission timeout, measured in milliseconds. More refined semantics for objects of thistype depend upon the algorithm used to determine the retransmission timeout. Inparticular, when the timeout algorithm is rsre(3), an object of this type hasthe semantics of the UBOUND quantity described in RFC 793. (int)
tcpMaxConn - The limit on the total number of TCP connections thatthe entity can support. In entities where the maximum number of connectionsis dynamic, this object should contain the value –1. (int)
tcpActiveOpens - The number of times that TCP connections have made adirect transition to the SYN-SENT state from the CLOSED state. (counter)
tcpPassiveOpens - The number of times that TCP connections have made adirect transition to the SYN-RCVD state from the LISTEN state. (counter)
tcpAttemptFails - The number of times that TCP connections have made adirect transition to the CLOSED state from either the SYN-SENT state orthe SYN-RCVD state, plus the number of times TCP connections have made adirect transition to the LISTEN state from the SYN-RCVD state. (counter)
tcpEstabResets - The number of times TCP connections have made a directtransition to the CLOSED state from either the ESTABLISHED state or theCLOSE-WAIT state. (counter)
tcpCurrEstab - The number of TCP connections for which the current stateis either ESTABLISHED or CLOSE-WAIT. (gauge)
tcpInSegs - The total number of segments received, including those received inerror. This count includes segments received on currently established connections. (counter)
tcpOutSegs - The total number of segments sent, including those on currentconnections but excluding those containing only retransmitted octets. (counter)
tcpRetransSegs - The total number of segments retransmitted - that is, thenumber of TCP segments transmitted containing one or more previously transmitted octets.(counter)
tcpInErrs - The total number of segments received in error (for example,bad TCP checksums). (counter)
tcpOutRsts - The number of TCP segments sent containing the RST flag.(counter)
ThetcpConnTable is a table containing TCP connection-specific information.
tcpConnState - The state of this TCP connection. (enum)
The only value that may be set by a management station isdeleteTCB(12). Accordingly, it is appropriate for an agent to return a “badValue”response if a management station attempts to set this object to anyother value.
If a management station sets this object to the value deleteTCB(12), thenthis has the effect of deleting the TCB (as defined in RFC793) of the corresponding connection on the managed node. This results inimmediate termination of the connection.
As an implementation-specific option, an RST segment may be sent from themanaged node to the other TCP endpoint. (Note, however, that RST segmentsare not sent reliably.)
tcpConnLocalAddress - The local IP address for this TCP connection. For aconnection in the listen state that is willing to accept connections forany IP interface associated with the node, the value 0.0.0.0 is used.(netaddress)
tcpConnLocalPort - The local port number for this TCP connection. (int)
tcpConnRemAddress - The remote IP address for this TCP connection. (netaddress)
tcpConnRemPort - The remote port number for this TCP connection. (int)
Theudp group reports statistics about the UDP group.
udpInDatagrams - The total number of UDP datagrams delivered to UDP users.(counter) Returns a fixed value of 0.
udpNoPorts - The total number of received UDP datagrams for which therewas no application at the destination port. (counter) Returns a fixed valueof 0.
udpInErrors - The number of received UDP datagrams that could not bedelivered for reasons other than the lack of an application at thedestination port. (counter)
udpOutDatagrams - The total number of UDP datagrams sent from this entity.(counter) Returns a fixed value of 0.
TheudpTable is a table containing UDP listener information.
udpLocalAddress - The local IP address for this UDP listener. For aUDP listener that is willing to accept datagrams for any IP interfaceassociated with the node, the value 0.0.0.0 is used. (netaddress)
udpLocalPort - The local port number for this UDP listener. (int)
Thesnmp group reports statistics about the SNMP group.
snmpInPkts - The total number of Messages delivered to the SNMP entityfrom the transport service. (counter)
snmpOutPkts - The total number of SNMP Messages passed from the SNMPprotocol entity to the transport service. (counter)
snmpInBadVersions - The total number of SNMP Messages delivered to the SNMPprotocol entity that were for an unsupported SNMP version. (counter)
snmpInBadCommunityNames - The total number of SNMP Messages delivered to the SNMPprotocol entity that used a SNMP community name not known to saidentity. (counter)
snmpInBadCommunityUses - The total number of SNMP Messages delivered to the SNMPprotocol entity, which represented an SNMP operation not allowed by the SNMPcommunity named in the Message. (counter)
snmpInASNParseErrs - The total number of ASN.1 or BER errors encountered bythe SNMP protocol entity when decoding received SNMP Messages. (counter)
snmpInTooBigs - The total number of SNMP PDUs delivered to the SNMPprotocol entity for which the value of the error-status field is “tooBig.”(counter)
snmpInNoSuchNames - The total number of SNMP PDUs delivered to the SNMPprotocol entity for which the value of the error-status field is “noSuchName.”(counter)
snmpInBadValues - The total number of SNMP PDUs delivered to the SNMPprotocol entity for which the value of the error-status field is “badValue.”(counter)
snmpInReadOnlys - The total number valid SNMP PDUs delivered to the SNMPprotocol entity for which the value of the error-status field is “readOnly.”It should be noted that it is a protocol error to generatean SNMP PDU that contains the value “readOnly” in the error-status field. Thisobject is provided as a means of detecting incorrect implementations of theSNMP. (counter)
snmpInGenErrs - The total number of SNMP PDUs delivered to the SNMPprotocol entity for which the value of the error-status field is “genErr.”(counter)
snmpInTotalReqVars - The total number of MIB objects successfully retrieved by theSNMP protocol entity as the result of receiving valid SNMP Get-Request andGet-Next PDUs. (counter)
snmpInTotalSetVars - The total number of MIB objects successfully altered by theSNMP protocol entity as the result of receiving valid SNMP Set-Request PDUs.(counter)
snmpInGetRequests - The total number of SNMP Get-Request PDUs accepted and processedby the SNMP protocol entity. (counter)
snmpInGetNexts - The total number of SNMP Get-Next PDUs accepted and processedby the SNMP protocol entity. (counter)
snmpInSetRequests - The total number of SNMP Set-Request PDUs accepted and processedby the SNMP protocol entity. (counter)
snmpInGetResponses - The total number of SNMP Get-Response PDUs accepted and processedby the SNMP protocol entity. (counter)
snmpInTraps - The total number of SNMP Trap PDUs accepted and processedby the SNMP protocol entity. (counter)
snmpOutTooBigs - The total number of SNMP PDUs generated by the SNMPprotocol entity for which the value of the error-status field is “tooBig.”(counter)
snmpOutNoSuchNames - The total number of SNMP PDUs generated by the SNMPprotocol entity for which the value of the error-status is “noSuchName.” (counter)
snmpOutBadValues - The total number of SNMP PDUs generated by the SNMPprotocol entity for which the value of the error-status field is “badValue.”(counter)
snmpOutGenErrs - The total number of SNMP PDUs generated by the SNMPprotocol entity for which the value of the error-status field is “genErr.”(counter)
snmpOutGetRequests - The total number of SNMP Get-Request PDUs which have beengenerated by the SNMP protocol entity. (counter)
snmpOutGetNexts - The total number of SNMP Get-Next PDUs generated by theSNMP protocol entity. (counter)
snmpOutSetRequests - The total number of SNMP Set-Request PDUs generated by theSNMP protocol entity. (counter)
snmpOutGetResponses - The total number of SNMP Get-Response PDUs generated by theSNMP protocol entity. (counter)
snmpOutTraps - The total number of SNMP Trap PDUs generated by theSNMP protocol entity. (counter)
snmpEnableAuthenTraps - Indicates whether the SNMP agent process is permitted to generateauthentication-failure traps. The value of this object overrides any configuration information. Assuch, it provides a means whereby all authentication-failure traps may be disabled. (enum)
Note that this object must be stored in non-volatile memory, so thatit remains constant between reinitializations of the network management system.
The following are Sun-specific group and table definitions.
ThesunSystem group reports general system information.
agentDescr - The SNMP agent's description of itself. (string[255])
hostID - The unique Sun hardware identifier. The value returned is fourbyte binary string. (octet[4])
motd - The first line of/etc/motd. (string[255])
unixTime - The UNIX system time. Measured in seconds since January 1,1970 UTC. (counter)
ThesunProcessTable table reports UNIX process table information.
psProcessID - The process identifier for this process. (int)
psParentProcessID - The process identifier of this process's parent. (int)
psProcessSize - The combined size of the data and stack segments (inkilobytes.) (int)
psProcessCpuTime - The CPU time (including both user and system time) consumedso far. (int)
psProcessState - The run-state of the process. (octet[4])
|
psProcessWaitChannel - Reason process is waiting. (octet[16])
psProcessTTY - Terminal, if any, controlling this process. (octet[16])
psProcessUserName - Name of the user associated with this process. (octet[16])
psProcessUserID - Numeric form of the name of the user associated withthis process. (int)
psProcessName - Command name used to invoke this process. (octet[64])
psProcessStatus - Setting this variable will cause a signal of the setvalue to be sent to the process. (int)
ThesunHostPerf group reports hostperf information.
rsUserProcessTime - Total number of timeticks used by user processes since thelast system boot. (counter)
rsNiceModeTime - Total number of timeticks used by “nice” mode since thelast system boot. (counter)
rsSystemProcessTime - Total number of timeticks used by system processes since thelast system boot. (counter)
rsIdleModeTime - Total number of timeticks in idle mode since the lastsystem boot. (counter)
rsDiskXfer1 - Total number of disk transfers since the last boot forthe first of four configured disks. (counter)
rsDiskXfer2 - Total number of disk transfers since the last boot forthe second of four configured disks. (counter)
rsDiskXfer3 - Total number of disk transfers since the last boot forthe third of four configured disks. (counter)
rsDiskXfer4 - Total number of disk transfers since the last boot forthe fourth of four configured disks. (counter)
rsVPagesIn - Number of pages read in from disk. (counter)
rsVPagesOut - Number of pages written to disk. (counter)
rsVSwapIn - Number of pages swapped in. (counter)
rsVSwapOut - Number of pages swapped out. (counter)
rsVIntr - Number of device interrupts. (counter)
rsIfInPackets - Number of input packets. (counter)
rsIfOutPackets - Number of output packets. (counter)
rsIfInErrors - Number of input errors. (counter)
rsIfOutErrors - Number of output errors. (counter)
rsIfCollisions - Number of output collisions. (counter)
configuration information
access control file
standard SNMP MIBII file
Seeattributes(5) for descriptions of the following attributes:
|
inetd(1M),select(3C),recvfrom(3SOCKET),sendto(3SOCKET),attributes(5),gld(7D)
The proxy cannot dispatch the request. The rest of the message indicates the cause of the failure.
Aselect(3C) call failed. The rest of the message indicates the cause of the failure.
Asendto(3SOCKET) call failed. The rest of the message indicates the cause of the failure.
Arecvfrom(3SOCKET) call failed. The rest of the message indicates the cause of the failure.
The SNMP agent on the target system does not respond to SNMP requests. This error might indicate that the SNMP agent is not running on the target system, the target system is down, or the network containing the target system is unreachable.
The agent could not fit the results of an operation into a single SNMP message. Split large groups or tables into smaller entities.
An attribute is missing from the requested group.
An object attribute type received from the SNMP agent that does not match the attribute type specified by the proxy agent schema. The rest of the message indicates the expected type and received type.
The proxy agent cannot get the variablesysUpTime from the SNMP agent.
The variablesysUpTime received from the SNMP agent has the wrong data type.
An unknown SNMP error was received.
The requested specified an incorrect syntax or value for a set operation.
The SNMP agent did not perform the set request because a variable to set may not be written.
A general error was received.
An error occurred building a request PDU.
An error occurred building a request variable binding list.
An error occurred parsing a response PDU.
The response ID does not match the request ID.
A displayable string contains non-displayable characters.
An error occurred opening the proxy agent schema file.
The proxy agent couldn't parse the proxy agent schema file.
An error occurred opening the file associated with thena.snmp.hostfile keyword in/etc/snmp/conf/snmpd.conf
The proxy agent was unable to parse the file associated with thena.snmp.hostfile keyword in/etc/snmp/conf/snm.conf.
The set could not be completed because the attribute was not available for set operations.
Themibiisa utility returns the wrong interface speed for the SBUS FDDIinterface (for example, “bf0”).
Themibiisa utility does not return a MAC address for the SBUSFDDI interface (for example, “bf0”).
Process names retrieved frommibiisa contain a leading blank space.
When you change attribute values in the system group with an SNMPset request, the change is effective only as long asmibiisa isrunning.mibiisa does not save the changes to/etc/snmp/conf/snmpd.conf.
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.Legal Notices |   |