415 lines
14 KiB
Plaintext
415 lines
14 KiB
Plaintext
-- *****************************************************************
|
|
-- CADANT-REMOTE-QUERY-MIB: Cadant C4 Remote Query MIB file
|
|
--
|
|
-- August 2004
|
|
--
|
|
-- Copyright (c) 2004 by ARRIS International
|
|
-- All rights reserved.
|
|
-- *****************************************************************
|
|
|
|
|
|
CADANT-REMOTE-QUERY-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY,
|
|
OBJECT-TYPE,
|
|
NOTIFICATION-TYPE,
|
|
Integer32,
|
|
IpAddress,
|
|
Unsigned32
|
|
FROM SNMPv2-SMI
|
|
TruthValue,
|
|
TimeStamp,
|
|
DisplayString,
|
|
MacAddress
|
|
FROM SNMPv2-TC
|
|
InetAddressType,
|
|
InetAddress
|
|
FROM INET-ADDRESS-MIB
|
|
OBJECT-GROUP,
|
|
MODULE-COMPLIANCE
|
|
FROM SNMPv2-CONF
|
|
TenthdBmV,
|
|
TenthdB
|
|
FROM DOCS-IF-MIB
|
|
cadCmRemoteQuery
|
|
FROM CADANT-PRODUCTS-MIB
|
|
cadIfCmtsCmStatusEntry
|
|
FROM CADANT-CMTS-MAC-MIB;
|
|
|
|
cadCmRemoteQueryMib MODULE-IDENTITY
|
|
LAST-UPDATED "200901200000Z"
|
|
ORGANIZATION "Arris International"
|
|
CONTACT-INFO
|
|
" Arris Support
|
|
Postal: ARRIS
|
|
Phone: +1 770 622 8530
|
|
E-mail: support@arrisi.com"
|
|
DESCRIPTION
|
|
"This MIB module provides the management of
|
|
the Cadant C4 Cable Modem Termination Systems
|
|
(CMTS) Remote Query feature.
|
|
|
|
This feature, implemented on a CMTS, facilitates
|
|
SNMP polling of remote cable modems (CMs).
|
|
|
|
This MIB includes the configuration and
|
|
status objects of the CMTS CM Poller and
|
|
remote CMs that polled by the CMTS CM Poller"
|
|
|
|
REVISION "200408310000Z"
|
|
DESCRIPTION
|
|
"Initial version of this MIB. "
|
|
REVISION "200609270000Z"
|
|
DESCRIPTION
|
|
"Added IPaddressType and IPaddress. "
|
|
REVISION "200901150000Z"
|
|
DESCRIPTION
|
|
"Fixed start/stop time for upTime rollover. "
|
|
REVISION "200901200000Z"
|
|
DESCRIPTION
|
|
"Fixed poll time for upTime rollover. "
|
|
|
|
::= { cadCmRemoteQuery 1}
|
|
|
|
--
|
|
-- Poller Group
|
|
--
|
|
-- Allows to configure and monitor the CMTS CM Poller
|
|
--
|
|
|
|
-- CMTS CM Poller
|
|
--
|
|
|
|
cadCmRemoteQueryPoller OBJECT IDENTIFIER ::= { cadCmRemoteQueryMib 1 }
|
|
|
|
cadCmRemoteQueryPollerEnable OBJECT-TYPE
|
|
SYNTAX TruthValue
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An indication of whether the CMTS CM Poller is running.
|
|
|
|
When the poller is enabled, it polls the remote CMs
|
|
periodically specified in the cadCmRemoteQueryPollerInterval
|
|
mib object.
|
|
|
|
The operation can be expensive depending on how many CMs
|
|
that the poller would be polling. It is suggested to
|
|
have it disabled when not needed."
|
|
DEFVAL { false }
|
|
::= { cadCmRemoteQueryPoller 1 }
|
|
|
|
cadCmRemoteQueryPollerInterval OBJECT-TYPE
|
|
SYNTAX Unsigned32(30..86400)
|
|
UNITS "seconds"
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An interval between two polling cycles of the CMTS CM
|
|
Poller.
|
|
|
|
The poller will not start the next cycle until it
|
|
finished polling for the last CM , even though the
|
|
time has expired. If the cadCmRemoteQueryPollerInterval is
|
|
too small with a large number of CMs, the poller would
|
|
tie up the CPU and resources and possibly degrade the
|
|
system's performance."
|
|
DEFVAL { 1800 }
|
|
::= { cadCmRemoteQueryPoller 2 }
|
|
|
|
cadCmRemoteQueryPollerStartTime OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
UNITS "seconds"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of sysUpTime in seconds when the last polling
|
|
cycle started.
|
|
|
|
cadCmRemoteQueryPollerStartTime is set to 0 when the CMTS
|
|
is first restarted and doesn't get reset after the
|
|
poller is disabled."
|
|
::= { cadCmRemoteQueryPoller 3 }
|
|
|
|
cadCmRemoteQueryPollerStopTime OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
UNITS "seconds"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of sysUpTime in seconds when the last polling
|
|
cycle finished.
|
|
|
|
cadCmRemoteQueryPollerStopTime is set to 0 when the CMTS
|
|
is first restarted and doesn't get reset after the poller
|
|
is disabled."
|
|
::= { cadCmRemoteQueryPoller 4 }
|
|
|
|
cadCmRemoteQueryPollerCommunity OBJECT-TYPE
|
|
SYNTAX OCTET STRING (SIZE(0..32))
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The read community string is used for polling the CMs.
|
|
|
|
Any change in the cadCmRemoteQueryPollerCommunity may not
|
|
be reflected if the poller has already been enabled."
|
|
DEFVAL { "public" }
|
|
::= { cadCmRemoteQueryPoller 5 }
|
|
|
|
cadCmRemoteQueryMacAddress OBJECT-TYPE
|
|
SYNTAX MacAddress
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The object is used to trigger an immediate poll of a
|
|
specific CM. This object always read back as a value
|
|
of 0. The value of sysUpTime should be read and saved
|
|
before writing this object. Then, the value of
|
|
cadCmRemoteQueryPollTime can be read and compared to the
|
|
saved sysUpTime to determine when the immediate poll of
|
|
retmoe query data has been completed."
|
|
DEFVAL { '000000000000'h }
|
|
::= { cadCmRemoteQueryPoller 6 }
|
|
|
|
cadCmRemoteQuerySourceIpAddrType OBJECT-TYPE
|
|
SYNTAX InetAddressType
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The type of internet address of cadCmRemoteQuerySourceIpAddr."
|
|
DEFVAL { ipv4 }
|
|
::= { cadCmRemoteQueryPoller 7 }
|
|
|
|
cadCmRemoteQuerySourceIpAddr OBJECT-TYPE
|
|
SYNTAX InetAddress
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The source IP address of the SNMP remote queries to the CMs.
|
|
This value is changed from the Poller when the ifIndex of the
|
|
cadSysSourceInterfaceRemoteQuery in the CADANT-CMTS-SYSTEM-MIB
|
|
is changed due to using the cli command ..
|
|
configure cable modem remote-query source-interface .."
|
|
DEFVAL { '00000000'h }
|
|
::= { cadCmRemoteQueryPoller 8 }
|
|
|
|
|
|
--
|
|
-- CM Group
|
|
--
|
|
-- Allows to monitor the status of CM
|
|
--
|
|
--
|
|
-- CMTS Remote Cable modem (CM) Table
|
|
--
|
|
--
|
|
|
|
cadCmRemoteQueryStatusTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF CadCmRemoteQueryStatusEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table contains the status of the cable modems that
|
|
are polled by the CMTS CM Poller. The information will be
|
|
overwritten when a new polling cycle starts.
|
|
|
|
Depending on how many CMs that the poller is polling,
|
|
polling this table constantly can be quite expensive;
|
|
Excessive polling could degrade performance."
|
|
::= { cadCmRemoteQueryMib 2 }
|
|
|
|
cadCmRemoteQueryStatusEntry OBJECT-TYPE
|
|
SYNTAX CadCmRemoteQueryStatusEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A list of the cable modem's attributes
|
|
that are polled by a CMTS. "
|
|
AUGMENTS { cadIfCmtsCmStatusEntry }
|
|
::= { cadCmRemoteQueryStatusTable 1 }
|
|
|
|
CadCmRemoteQueryStatusEntry ::= SEQUENCE {
|
|
cadCmRemoteQueryPollTime Unsigned32,
|
|
cadCmRemoteQueryDownChannelPower TenthdBmV,
|
|
cadCmRemoteQueryStatusTxPower TenthdBmV,
|
|
cadCmRemoteQueryUpChnlTxTimingOffset Unsigned32,
|
|
cadCmRemoteQuerySigQSignalNoise TenthdB,
|
|
cadCmRemoteQuerySigQMicroreflections Integer32,
|
|
cadCmRemoteQuerySysDescr DisplayString
|
|
}
|
|
|
|
cadCmRemoteQueryPollTime OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
UNITS "seconds"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of sysUpTime when this CM entry was polled.
|
|
|
|
If this value is larger than the cadCmRemoteQueryPollerStopTime,
|
|
it indicates that the status has already been
|
|
overwritten by a new polling cycle. To avoid this
|
|
happening, the NMS can increase the cadCmRemoteQueryPollInterval
|
|
so that the cadCmRemoteQueryPollTime
|
|
would fall in between the cadCmRemoteQueryPollerStartTime and
|
|
the cadCmRemoteQueryPollerStopTime."
|
|
::= { cadCmRemoteQueryStatusEntry 1 }
|
|
|
|
cadCmRemoteQueryDownChannelPower OBJECT-TYPE
|
|
SYNTAX TenthdBmV
|
|
UNITS "dBmV"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The CM's received power level. This object
|
|
may be set to zero if the CM does not support
|
|
power level measurement.
|
|
|
|
If the CM downstream interface is down, this object
|
|
either returns the most current value or the value of 0."
|
|
REFERENCE
|
|
"DOCSIS Radio Frequency Interface Specification,
|
|
Table 4-12 and Table 4-13."
|
|
::={ cadCmRemoteQueryStatusEntry 2 }
|
|
|
|
cadCmRemoteQueryStatusTxPower OBJECT-TYPE
|
|
SYNTAX TenthdBmV
|
|
UNITS "dBmV"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The operational transmit power for the CM upstream
|
|
channel."
|
|
REFERENCE
|
|
"DOCSIS Radio Frequency Interface specification,
|
|
Section 4.2.8."
|
|
::= { cadCmRemoteQueryStatusEntry 3 }
|
|
|
|
cadCmRemoteQueryUpChnlTxTimingOffset OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A measure of the current round trip time. Used for
|
|
timing of CM upstream transmissions to ensure
|
|
synchronized arrivals at the CMTS."
|
|
REFERENCE
|
|
"DOCSIS Radio Frequency Interface Specification,
|
|
Section 6.5."
|
|
::= { cadCmRemoteQueryStatusEntry 4 }
|
|
|
|
cadCmRemoteQuerySigQSignalNoise OBJECT-TYPE
|
|
SYNTAX TenthdB
|
|
UNITS "dB"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Signal/Noise ratio as perceived for the CM downstream
|
|
channel."
|
|
REFERENCE
|
|
"DOCSIS Radio Frequency Interface specification,
|
|
Table 2-1 and 2-2"
|
|
::= { cadCmRemoteQueryStatusEntry 5 }
|
|
|
|
cadCmRemoteQuerySigQMicroreflections OBJECT-TYPE
|
|
SYNTAX Integer32 (0..255)
|
|
UNITS "dBc"
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Total microreflections including in-channel
|
|
response as perceived on the CM downstream,
|
|
measured in dBc below the signal level.
|
|
|
|
This object is not assumed to return an absolutely
|
|
accurate value, but is meant to give a rough indication
|
|
of microreflections received on this interface.
|
|
It is up to the implementor to provide information
|
|
as accurate as possible."
|
|
REFERENCE
|
|
"DOCSIS Radio Frequency Interface specification,
|
|
Table 2-1 and 2-2"
|
|
::= { cadCmRemoteQueryStatusEntry 6 }
|
|
|
|
cadCmRemoteQuerySysDescr OBJECT-TYPE
|
|
SYNTAX DisplayString (SIZE (0..255))
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A textual description of the entity."
|
|
::= { cadCmRemoteQueryStatusEntry 7 }
|
|
|
|
|
|
--
|
|
-- The Remote Query MIB Conformance Statements
|
|
--
|
|
|
|
--
|
|
-- Conformance statement
|
|
--
|
|
|
|
cadCmRemoteQueryConformance OBJECT IDENTIFIER
|
|
::= { cadCmRemoteQueryMib 3 }
|
|
cadCmRemoteQueryDocsRemoteQueryCompliances OBJECT IDENTIFIER
|
|
::= { cadCmRemoteQueryConformance 1 }
|
|
cadCmRemoteQueryDocsRemoteQueryGroups OBJECT IDENTIFIER
|
|
::= { cadCmRemoteQueryConformance 2 }
|
|
|
|
|
|
-- compliance statements
|
|
|
|
cadCmRemoteQueryDocsRemoteQueryCompliance MODULE-COMPLIANCE
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The compliance statement for entities which
|
|
implement the Remote Query MIB"
|
|
MODULE -- this module
|
|
MANDATORY-GROUPS {
|
|
cadCmRemoteQueryPollerGroup,
|
|
cadCmRemoteQueryStatusGroup
|
|
}
|
|
|
|
::= { cadCmRemoteQueryDocsRemoteQueryCompliances 1 }
|
|
|
|
|
|
-- MIB groupings
|
|
|
|
cadCmRemoteQueryPollerGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
cadCmRemoteQueryPollerEnable,
|
|
cadCmRemoteQueryPollerInterval,
|
|
cadCmRemoteQueryPollerStartTime,
|
|
cadCmRemoteQueryPollerStopTime,
|
|
cadCmRemoteQueryPollerCommunity
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Group of objects implemented in Cable Modem
|
|
Termination Systems (CMTS) for configuring and
|
|
monitoring the CMTS CM Poller."
|
|
|
|
::= { cadCmRemoteQueryDocsRemoteQueryGroups 1 }
|
|
|
|
cadCmRemoteQueryStatusGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
cadCmRemoteQueryPollTime,
|
|
cadCmRemoteQueryDownChannelPower,
|
|
cadCmRemoteQueryStatusTxPower,
|
|
cadCmRemoteQueryUpChnlTxTimingOffset,
|
|
cadCmRemoteQuerySigQSignalNoise,
|
|
cadCmRemoteQuerySigQMicroreflections,
|
|
cadCmRemoteQuerySysDescr
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"Group of objects implemented in Cable Modem
|
|
Termination Systems (CMTS) for monitoring cable
|
|
modems via CMTS CM Poller."
|
|
|
|
::= { cadCmRemoteQueryDocsRemoteQueryGroups 2 }
|
|
|
|
|
|
END
|