696 lines
19 KiB
Plaintext
696 lines
19 KiB
Plaintext
-- *****************************************************************
|
|
-- CISCO-SERVICE-CONTROLLER-MIB.my
|
|
--
|
|
-- MIB file for Service Controller.
|
|
-- Apr 2009, Or Dubnov-Raz
|
|
--
|
|
-- Copyright (c) 2007-2009, 2011 by Cisco Systems Inc.
|
|
-- All rights reserved.
|
|
--
|
|
-- ***************************************************************
|
|
|
|
CISCO-SERVICE-CONTROLLER-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY,
|
|
OBJECT-TYPE,
|
|
Unsigned32,
|
|
Gauge32
|
|
FROM SNMPv2-SMI
|
|
MODULE-COMPLIANCE,
|
|
OBJECT-GROUP
|
|
FROM SNMPv2-CONF
|
|
entPhysicalIndex
|
|
FROM ENTITY-MIB
|
|
SnmpAdminString
|
|
FROM SNMP-FRAMEWORK-MIB
|
|
ciscoMgmt
|
|
FROM CISCO-SMI;
|
|
|
|
|
|
ciscoServiceControllerMIB MODULE-IDENTITY
|
|
LAST-UPDATED "201103030000Z"
|
|
ORGANIZATION "Cisco Systems, Inc."
|
|
CONTACT-INFO
|
|
"Cisco Systems
|
|
Customer Service
|
|
|
|
Postal: 170 W Tasman Drive
|
|
San Jose, CA 95134
|
|
USA
|
|
|
|
Tel: +1 800 553-NETS
|
|
|
|
E-mail: cs-excelsior-dev@cisco.com"
|
|
DESCRIPTION
|
|
"This MIB module defines objects describing traffic controllers
|
|
used by a service control entity.
|
|
|
|
A service control entity is a network device which monitors and
|
|
controls traffic. The service control enitity is used as a
|
|
platform for different service control applications which may
|
|
perform monitoring operations beyond packet counting and delve
|
|
deeper into the contents of network traffic, such as deep packet
|
|
inspection.
|
|
It provides programmable stateful inspection of bidirectional
|
|
traffic flows, maps these flows to users or subscribers, and can
|
|
control traffic flow according to different attributes.
|
|
|
|
A service control entity traffic controller can act as a rather
|
|
simple policer or implement more complicated logic in
|
|
controlling traffic, up to actual applicative attributes of the
|
|
traffic itself.
|
|
|
|
The global service controller is a controller component
|
|
implemented by the service control entity, which acts as a
|
|
rather simple policer for traffic transiting through the service
|
|
control entity. A global service controller may be configured
|
|
per service control entity interface with a configurable
|
|
bandwidth limitation. The controller is responsible for the
|
|
enforcement of the bandwith limitation configured in the service
|
|
control entity.
|
|
|
|
Aggregative global controller is a mechanism that allows
|
|
dynamic bandwidth allocation between two global controllers
|
|
that reside on the same direction of two links. Regularly, a
|
|
global controller is configured per physical port.
|
|
When aggregative global controller is configured, the relevant
|
|
per-port global controllers are configured dynamically and
|
|
automatically by the aggregative global controller mechanism.
|
|
|
|
Primary bandwidth controller controls the total of subscriber
|
|
traffic and manage the number of bandwidth controller.
|
|
Its main properties are committed information rate,
|
|
peak information rate, and relative priority."
|
|
REVISION "201103030000Z"
|
|
DESCRIPTION
|
|
"Added the following MIB tables:
|
|
cscAggregativeGlobalControllersTable
|
|
cscAggregativeGlobalControllersLinkTable
|
|
|
|
Deprecated following MIB compliance:
|
|
ciscoServiceControlMIBCompliance
|
|
|
|
Added the following new MIB compliance:
|
|
ciscoServiceControlMIBComplianceRev1."
|
|
REVISION "200808040000Z"
|
|
DESCRIPTION
|
|
"Initial version of this MIB module."
|
|
::= { ciscoMgmt 667 }
|
|
|
|
|
|
ciscoServiceControlMIBObjects OBJECT IDENTIFIER
|
|
::= { ciscoServiceControllerMIB 0 }
|
|
|
|
ciscoServiceControlMIBConform OBJECT IDENTIFIER
|
|
::= { ciscoServiceControllerMIB 1 }
|
|
|
|
|
|
cscGlobalControllersTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF CscGlobalControllersEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table contains data for each global service controller in
|
|
the service control entity. The table has an expansion dependent
|
|
relationship on the entPhysicalTable, containing zero or more
|
|
rows for each physical entity."
|
|
::= { ciscoServiceControlMIBObjects 1 }
|
|
|
|
cscGlobalControllersEntry OBJECT-TYPE
|
|
SYNTAX CscGlobalControllersEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This entry contains the operational data for the global service
|
|
controller associated with the service control entity identified
|
|
by its assigned entPhysicalIndex. Each entry uniquely identifies
|
|
a global controller by its index. The"
|
|
INDEX {
|
|
entPhysicalIndex,
|
|
cscGlobalControllersIndex
|
|
}
|
|
::= { cscGlobalControllersTable 1 }
|
|
|
|
CscGlobalControllersEntry ::= SEQUENCE {
|
|
cscGlobalControllersIndex Unsigned32,
|
|
cscGlobalControllersId Unsigned32,
|
|
cscGlobalControllersDescription SnmpAdminString,
|
|
cscGlobalControllersBandwidthUnits INTEGER,
|
|
cscGlobalControllersBandwidth Unsigned32,
|
|
cscGlobalControllersUtilization Unsigned32
|
|
}
|
|
|
|
cscGlobalControllersIndex OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..4294967295)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates an arbitrary integer-value that
|
|
uniquely identifies a global service controller."
|
|
::= { cscGlobalControllersEntry 1 }
|
|
|
|
cscGlobalControllersId OBJECT-TYPE
|
|
SYNTAX Unsigned32
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the unique id assigned to this global
|
|
controller by the service control entity."
|
|
::= { cscGlobalControllersEntry 2 }
|
|
|
|
cscGlobalControllersDescription OBJECT-TYPE
|
|
SYNTAX SnmpAdminString (SIZE (1..255))
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates a human readable string which is the name
|
|
associated with this global service controller."
|
|
::= { cscGlobalControllersEntry 3 }
|
|
|
|
cscGlobalControllersBandwidthUnits OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
kbps(1),
|
|
mbps(2)
|
|
}
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An enumerated value which identifies the units for
|
|
cscGlobalControllersBandwidth value, such as 'kbps' (kilobit per
|
|
second), 'mbps' (megabit per second), etc."
|
|
DEFVAL { kbps }
|
|
::= { cscGlobalControllersEntry 4 }
|
|
|
|
cscGlobalControllersBandwidth OBJECT-TYPE
|
|
SYNTAX Unsigned32 (0..4294967295)
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the bandwidth limitation for this global
|
|
controller to enforce. The units of
|
|
cscGlobalControllersBandwidth are indicated by the value of
|
|
cscGlobalControllersBandwidthUnits."
|
|
::= { cscGlobalControllersEntry 5 }
|
|
|
|
cscGlobalControllersUtilization OBJECT-TYPE
|
|
SYNTAX Unsigned32 (0..100)
|
|
UNITS "percent"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the percentage of utilized bandwidth
|
|
of the controller out of the configured bandwidth limitation by
|
|
the cscGlobalControllersBandwidth. For example, if
|
|
cscGlobalControllersBandwidth = 1000 kbps and
|
|
cscGlobalControllersUtilization = 65%, then the
|
|
current utilization of this controller is 650 kbps."
|
|
::= { cscGlobalControllersEntry 6 }
|
|
|
|
|
|
|
|
cscAggregativeGlobalControllersTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF CscAggregativeGlobalControllersEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table lists the aggregative global controller associated
|
|
with the service controller entity."
|
|
::= { ciscoServiceControlMIBObjects 2 }
|
|
|
|
cscAggregativeGlobalControllersEntry OBJECT-TYPE
|
|
SYNTAX CscAggregativeGlobalControllersEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This entry contains the operational data for the aggregative
|
|
global controller associated with the service control entity.
|
|
Each entry uniquely identifies an aggregative global controller
|
|
by its indices."
|
|
INDEX {
|
|
cscAggregativeGlobalControllersSide,
|
|
cscAggregativeGlobalControllersAgcId
|
|
}
|
|
::= { cscAggregativeGlobalControllersTable 1 }
|
|
|
|
CscAggregativeGlobalControllersEntry ::= SEQUENCE {
|
|
cscAggregativeGlobalControllersSide INTEGER,
|
|
cscAggregativeGlobalControllersAgcId Unsigned32,
|
|
cscAggregativeGlobalControllersLimit Gauge32,
|
|
cscAggregativeGlobalControllersRate Gauge32
|
|
}
|
|
|
|
cscAggregativeGlobalControllersSide OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
subscriber(1),
|
|
network(2)
|
|
}
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the direction of flow (subscriber side or
|
|
network side)."
|
|
::= { cscAggregativeGlobalControllersEntry 1 }
|
|
|
|
cscAggregativeGlobalControllersAgcId OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..4096)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates an arbitrary integer-value that
|
|
uniquely identifies an aggregative global controller."
|
|
::= { cscAggregativeGlobalControllersEntry 2 }
|
|
|
|
cscAggregativeGlobalControllersLimit OBJECT-TYPE
|
|
SYNTAX Gauge32
|
|
UNITS "kbps"
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the bandwidth limit of an aggregative
|
|
global controller."
|
|
::= { cscAggregativeGlobalControllersEntry 3 }
|
|
|
|
cscAggregativeGlobalControllersRate OBJECT-TYPE
|
|
SYNTAX Gauge32
|
|
UNITS "kbps"
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the bandwidth rate of an aggregative
|
|
global controller."
|
|
::= { cscAggregativeGlobalControllersEntry 4 }
|
|
|
|
|
|
|
|
cscAggregativeGlobalControllersLinkTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF CscAggregativeGlobalControllersLinkEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table provides information regarding the aggregative
|
|
global controller related configuration per link."
|
|
::= { ciscoServiceControlMIBObjects 3 }
|
|
|
|
cscAggregativeGlobalControllersLinkEntry OBJECT-TYPE
|
|
SYNTAX CscAggregativeGlobalControllersLinkEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This entry contains the operational data for the aggregative
|
|
global controller associated with the service control
|
|
entity identified by its assigned link number. Each entry
|
|
uniquely identifies an aggregative global controller by its
|
|
indices.
|
|
The link on a service control engine joins subscriber side to
|
|
network side."
|
|
INDEX {
|
|
cscAggregativeGlobalControllersLinkIndex,
|
|
cscAggregativeGlobalControllersLinkSide,
|
|
cscAggregativeGlobalControllersLinkAgcId
|
|
}
|
|
::= { cscAggregativeGlobalControllersLinkTable 1 }
|
|
|
|
CscAggregativeGlobalControllersLinkEntry ::= SEQUENCE {
|
|
cscAggregativeGlobalControllersLinkIndex Unsigned32,
|
|
cscAggregativeGlobalControllersLinkSide INTEGER,
|
|
cscAggregativeGlobalControllersLinkAgcId Unsigned32,
|
|
cscAggregativeGlobalControllersLinkEnforcedRate Gauge32,
|
|
cscAggregativeGlobalControllersCommittedInformationRate Gauge32,
|
|
cscAggregativeGlobalControllersPeakInformationRate Gauge32,
|
|
cscAggregativeGlobalControllersAssuranceLevel Unsigned32
|
|
}
|
|
|
|
cscAggregativeGlobalControllersLinkIndex OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..100)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates an arbitrary integer-value that
|
|
uniquely identifies a link."
|
|
::= { cscAggregativeGlobalControllersLinkEntry 1 }
|
|
|
|
cscAggregativeGlobalControllersLinkSide OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
subscriber(1),
|
|
network(2)
|
|
}
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the direction of flow (subscriber side or
|
|
network side)."
|
|
::= { cscAggregativeGlobalControllersLinkEntry 2 }
|
|
|
|
cscAggregativeGlobalControllersLinkAgcId OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..4096)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates an arbitrary integer-value that
|
|
uniquely identifies an aggregative global controller."
|
|
::= { cscAggregativeGlobalControllersLinkEntry 3 }
|
|
|
|
cscAggregativeGlobalControllersLinkEnforcedRate OBJECT-TYPE
|
|
SYNTAX Gauge32
|
|
UNITS "kbps"
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the enforced rate which is the rate that
|
|
each bandwidth controller, primary bandwidth controller seek to
|
|
attain, taking into account external constraints.
|
|
The types of external constraint are global controller,
|
|
physical port, primary bandwidth controller."
|
|
::= { cscAggregativeGlobalControllersLinkEntry 4 }
|
|
|
|
cscAggregativeGlobalControllersCommittedInformationRate OBJECT-TYPE
|
|
SYNTAX Gauge32
|
|
UNITS "kbps"
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the committed information rate which is
|
|
the aggregate rate that the bandwidth controller is committed
|
|
to supply to its controlled flows. In all cases, the system
|
|
will do its utmost to ensure that committed rate is not harmed.
|
|
This cannot be guaranteed in cases of oversubscription of
|
|
committed rate in the system as a whole."
|
|
::= { cscAggregativeGlobalControllersLinkEntry 5 }
|
|
|
|
cscAggregativeGlobalControllersPeakInformationRate OBJECT-TYPE
|
|
SYNTAX Gauge32
|
|
UNITS "kbps"
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies peak information rate which is the
|
|
peak aggregate rate of the controlled flows. Aggregate rate
|
|
means the total bandwidth of all controlled flows."
|
|
::= { cscAggregativeGlobalControllersLinkEntry 6 }
|
|
|
|
cscAggregativeGlobalControllersAssuranceLevel OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..10)
|
|
MAX-ACCESS read-write
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies assurance level which is the bandwidth
|
|
controller strength in the competition over bandwidth in case
|
|
of congestion. Assured level controls how fast Enforced rate
|
|
would decrease from peak information rate to committed
|
|
information rate as congestion builds, or increase from
|
|
committed information rate to peak information rate as
|
|
congestion decreases.
|
|
A higher assured level ensures a higher enforced rate
|
|
compared to a similar bandwidth controller with a lower assured
|
|
level."
|
|
::= { cscAggregativeGlobalControllersLinkEntry 7 }
|
|
|
|
|
|
-- Conformance
|
|
|
|
ciscoServiceControlMIBCompliances OBJECT IDENTIFIER
|
|
::= { ciscoServiceControlMIBConform 1 }
|
|
|
|
ciscoServiceControlMIBObjectGroups OBJECT IDENTIFIER
|
|
::= { ciscoServiceControlMIBConform 2 }
|
|
|
|
|
|
ciscoServiceControlMIBCompliance MODULE-COMPLIANCE
|
|
STATUS deprecated
|
|
DESCRIPTION
|
|
"The compliance statement for SNMP entities that implement
|
|
version 1 of the Cisco Service Controller MIB."
|
|
MODULE -- this module
|
|
MANDATORY-GROUPS { ciscoServiceControlMIBGlobalControllersObjectGroup }
|
|
::= { ciscoServiceControlMIBCompliances 1 }
|
|
|
|
ciscoServiceControlMIBComplianceRev1 MODULE-COMPLIANCE
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This compliance statement specifies the minimal requirements an
|
|
implementation must meet in order to claim full compliance with
|
|
the definition of the CISCO-SERVICE-CONTROLLER-MIB."
|
|
MODULE -- this module
|
|
MANDATORY-GROUPS {
|
|
ciscoServiceControlMIBGlobalControllersObjectGroup,
|
|
ciscoServiceControlAGCMIBObjectGroups
|
|
}
|
|
|
|
OBJECT cscAggregativeGlobalControllersLimit
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"Write access is not required."
|
|
|
|
OBJECT cscAggregativeGlobalControllersRate
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"Write access is not required."
|
|
|
|
OBJECT cscAggregativeGlobalControllersLinkEnforcedRate
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"Write access is not required."
|
|
|
|
OBJECT cscAggregativeGlobalControllersCommittedInformationRate
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"Write access is not required."
|
|
|
|
OBJECT cscAggregativeGlobalControllersPeakInformationRate
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"Write access is not required."
|
|
|
|
OBJECT cscAggregativeGlobalControllersAssuranceLevel
|
|
MIN-ACCESS read-only
|
|
DESCRIPTION
|
|
"Write access is not required."
|
|
::= { ciscoServiceControlMIBCompliances 2 }
|
|
|
|
ciscoServiceControlMIBGlobalControllersObjectGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
cscGlobalControllersDescription,
|
|
cscGlobalControllersBandwidth,
|
|
cscGlobalControllersUtilization,
|
|
cscGlobalControllersBandwidthUnits,
|
|
cscGlobalControllersId
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This group is a collection of objects that describes the
|
|
global controllers statistics for service control entity."
|
|
::= { ciscoServiceControlMIBObjectGroups 1 }
|
|
|
|
ciscoServiceControlAGCMIBObjectGroups OBJECT-GROUP
|
|
OBJECTS {
|
|
cscAggregativeGlobalControllersLimit,
|
|
cscAggregativeGlobalControllersRate,
|
|
cscAggregativeGlobalControllersLinkEnforcedRate,
|
|
cscAggregativeGlobalControllersPeakInformationRate,
|
|
cscAggregativeGlobalControllersCommittedInformationRate,
|
|
cscAggregativeGlobalControllersAssuranceLevel
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This group is a collection of objects that describes the
|
|
aggregative global controller for service control entity."
|
|
::= { ciscoServiceControlMIBObjectGroups 2 }
|
|
|
|
END
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|