470 lines
17 KiB
Plaintext
470 lines
17 KiB
Plaintext
-- *****************************************************************
|
|
-- CISCO-IPSLA-VIDEO-PROFILE-MIB.my: IP SLA Video Profile MIB file
|
|
--
|
|
-- October 2010, Cheng-Jia Lai
|
|
--
|
|
-- Copyright (c) 2010-2011 by cisco Systems Inc.
|
|
-- All rights reserved.
|
|
--
|
|
-- *****************************************************************
|
|
|
|
CISCO-IPSLA-VIDEO-PROFILE-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY,
|
|
OBJECT-TYPE,
|
|
Unsigned32
|
|
FROM SNMPv2-SMI
|
|
MODULE-COMPLIANCE,
|
|
OBJECT-GROUP
|
|
FROM SNMPv2-CONF
|
|
StorageType,
|
|
RowStatus
|
|
FROM SNMPv2-TC
|
|
SnmpAdminString
|
|
FROM SNMP-FRAMEWORK-MIB
|
|
CvcVideoProfile
|
|
FROM CISCO-VIDEO-SESSION-MIB
|
|
CvcVideoResolution
|
|
FROM CISCO-VIDEO-TC
|
|
ciscoMgmt
|
|
FROM CISCO-SMI;
|
|
|
|
|
|
ciscoIpslaVideoProfileMIB MODULE-IDENTITY
|
|
LAST-UPDATED "201101240000Z"
|
|
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-ipsla@cisco.com"
|
|
DESCRIPTION
|
|
"IP SLA is a capability which utilizes active monitoring for
|
|
network performance. It can be used for network
|
|
troubleshooting, network assessment and health
|
|
monitoring.
|
|
|
|
This MIB defines the following table as the collection of IP
|
|
SLA video traffic profiles that are used when generating
|
|
synthetic video traffic by configured IP SLA video operations.
|
|
|
|
cipslaVideoProfileTable
|
|
|
|
To run an IP SLA Video Operation, the MIB user should do the
|
|
following configurations:
|
|
|
|
1. Create a new or reuse the existing rttMonEchoAdminEntry with
|
|
valid rttMonEchoAdminProtocol, rttMonEchoAdminTargetAddress,
|
|
rttMonEchoAdminTargetPort, rttMonEchoAdminSourceAddress,
|
|
rttMonEchoAdminSourcePort, rttMonEchoAdminVideoTrafficProfile,
|
|
rttMonEchoAdminDscp, rttMonEchoAdminReserveDsp,
|
|
rttMonEchoAdminInputInterface, and other applicable objects (if
|
|
any) in rttMonEchoAdminTable of CISCO-RTTMON-MIB.
|
|
|
|
2. Schedule the operation to run immediately or at some
|
|
scheduled time(s) with optional recurrence(s) if desirable, by
|
|
configuring with rttMonCtrlAdminTable of CISCO-RTTMON-MIB.
|
|
|
|
3. Each occurrance of the scheduled operation generates a report
|
|
for the IP SLA VO statistics which are populated and available
|
|
in cipslaLatestVideoStatsTable and cipslaVideoAggStatsTable of
|
|
CISCO-IPSLA-VIDEO-MIB.
|
|
|
|
Glossary:
|
|
IP SLA - Cisco IOS IP Service Level Agreements
|
|
IP SLA operation - Refers to the 'video'
|
|
operation supported by IP SLA.
|
|
RTT - Round Trip Time"
|
|
REVISION "201101240000Z"
|
|
DESCRIPTION
|
|
"initial version of the MIB"
|
|
::= { ciscoMgmt 766 }
|
|
|
|
|
|
ciscoIpslaVideoProfileMIBNotifs OBJECT IDENTIFIER
|
|
::= { ciscoIpslaVideoProfileMIB 0 }
|
|
|
|
ciscoIpslaVideoProfileMIBObjects OBJECT IDENTIFIER
|
|
::= { ciscoIpslaVideoProfileMIB 1 }
|
|
|
|
ciscoIpslaVideoProfileMIBConform OBJECT IDENTIFIER
|
|
::= { ciscoIpslaVideoProfileMIB 2 }
|
|
|
|
ciscoIpslaVideoProfileMIBCompliances OBJECT IDENTIFIER
|
|
::= { ciscoIpslaVideoProfileMIBConform 1 }
|
|
|
|
cipslaVideoProfile OBJECT IDENTIFIER
|
|
::= { ciscoIpslaVideoProfileMIBObjects 1 }
|
|
|
|
|
|
cipslaVideoProfileTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF CipslaVideoProfileEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This table lists the definitions of IP SLA video profiles
|
|
that contain descriptive parameters for synthetic video traffic
|
|
patterns which can be used when generating synthetic video
|
|
packets by IP SLA Video Operation."
|
|
::= { cipslaVideoProfile 1 }
|
|
|
|
cipslaVideoProfileEntry OBJECT-TYPE
|
|
SYNTAX CipslaVideoProfileEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A conceptual row in the cipslaVideoProfileTable"
|
|
INDEX { cipslaVideoProfileID }
|
|
::= { cipslaVideoProfileTable 1 }
|
|
|
|
CipslaVideoProfileEntry ::= SEQUENCE {
|
|
cipslaVideoProfileID Unsigned32,
|
|
cipslaVideoProfileRowStatus RowStatus,
|
|
cipslaVideoProfileStorageType StorageType,
|
|
cipslaVideoProfileName SnmpAdminString,
|
|
cipslaVideoProfileDescription SnmpAdminString,
|
|
cipslaVideoProfileEndpointType INTEGER,
|
|
cipslaVideoProfileCodec CvcVideoProfile,
|
|
cipslaVideoProfileVideoContents INTEGER,
|
|
cipslaVideoProfileFrameRate Unsigned32,
|
|
cipslaVideoProfileResolution CvcVideoResolution,
|
|
cipslaVideoProfileAvgBitrate Unsigned32,
|
|
cipslaVideoProfileMaxBitrate Unsigned32,
|
|
cipslaVideoProfileMinBitrate Unsigned32,
|
|
cipslaVideoProfileBitrateWindowSize Unsigned32,
|
|
cipslaVideoProfileIframeMaxSize Unsigned32,
|
|
cipslaVideoProfileIframeRefreshInterval Unsigned32,
|
|
cipslaVideoProfileRtpAvgSize Unsigned32,
|
|
cipslaVideoProfileRtpJitterPattern INTEGER
|
|
}
|
|
|
|
cipslaVideoProfileID OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..4294967295)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"An arbitrary index that uniquely identifies a video profile"
|
|
::= { cipslaVideoProfileEntry 1 }
|
|
|
|
cipslaVideoProfileRowStatus OBJECT-TYPE
|
|
SYNTAX RowStatus
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object is used to create a new row or modify or delete an
|
|
existing row in this table."
|
|
::= { cipslaVideoProfileEntry 2 }
|
|
|
|
cipslaVideoProfileStorageType OBJECT-TYPE
|
|
SYNTAX StorageType
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the storage type for this conceptual row.
|
|
The following columnar objects are allowed to be writable
|
|
when the storageType of this conceptual row is permanent(4):
|
|
cipslaVideoProfileDescription
|
|
cipslaVideoProfileEndpointType
|
|
cipslaVideoProfileCodec
|
|
cipslaVideoProfileVideoContents
|
|
cipslaVideoProfileFrameRate
|
|
cipslaVideoProfileResolution
|
|
cipslaVideoProfileAvgBitrate
|
|
cipslaVideoProfileMaxBitrate
|
|
cipslaVideoProfileMinBitrate
|
|
cipslaVideoProfileBitrateWindowSize
|
|
cipslaVideoProfileIframeMaxSize
|
|
cipslaVideoProfileIframeRefreshInterval
|
|
cipslaVideoProfileRtpAvgSize
|
|
cipslaVideoProfileRtpJitterPattern"
|
|
::= { cipslaVideoProfileEntry 3 }
|
|
|
|
cipslaVideoProfileName OBJECT-TYPE
|
|
SYNTAX SnmpAdminString
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the name of an IP SLA video profile."
|
|
::= { cipslaVideoProfileEntry 4 }
|
|
|
|
cipslaVideoProfileDescription OBJECT-TYPE
|
|
SYNTAX SnmpAdminString
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the detailed description string of this
|
|
video profile."
|
|
::= { cipslaVideoProfileEntry 5 }
|
|
|
|
cipslaVideoProfileEndpointType OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
custom(1),
|
|
cts1k(21),
|
|
cts3k(22),
|
|
cp99xx(31),
|
|
unknown(9999)
|
|
}
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the sender endpoint type which determines
|
|
the traffic pattern according to the encoder's characteristics
|
|
while generating and sending video packets.
|
|
|
|
custom - Allows flexibile endpoint behavior
|
|
cts1k - Cisco Telepresence System CTS-1000
|
|
cts3k - Cisco Telepresence System CTS-3000
|
|
cp99xx - Cisco CP-9900 series video IP phones
|
|
unknown - unknown endpoint type"
|
|
::= { cipslaVideoProfileEntry 6 }
|
|
|
|
cipslaVideoProfileCodec OBJECT-TYPE
|
|
SYNTAX CvcVideoProfile
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the video codec and codec profile for how
|
|
the video contents are encoded in byte streams."
|
|
DEFVAL { h264ProfileBaseline }
|
|
::= { cipslaVideoProfileEntry 7 }
|
|
|
|
cipslaVideoProfileVideoContents OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
conferenceRoom(1),
|
|
singlePerson(2),
|
|
presentation(3),
|
|
sports(4),
|
|
streetView(5),
|
|
other(255)
|
|
}
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the video contents that determine the
|
|
amount of information to be encoded by the video sender and thus
|
|
have effects on the peak rate and frame size in the video
|
|
traffic generation. This gives a high level description of the
|
|
traffic patterns, and can be overwritten by the detailed
|
|
parameters such as cipslaVideoProfileIframeRefreshInterval.
|
|
|
|
The supported video contents are as follows.
|
|
conferenceRoom - conference room scene
|
|
singlePerson - single person in video conferencing
|
|
presentation - presentation video
|
|
sports - sports activities video
|
|
streetView - video scene from street views
|
|
other - other scenes"
|
|
DEFVAL { singlePerson }
|
|
::= { cipslaVideoProfileEntry 8 }
|
|
|
|
cipslaVideoProfileFrameRate OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..120000)
|
|
UNITS "fpks"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the video frame rates in the generated
|
|
video traffic, in unit of 'frames per 1K seconds' or fpks. For
|
|
example, 30000 means 30 frames per second (fps), and 7500 means
|
|
7.5 fps. The maximum frame rate is 120 fps or 120000 fpks."
|
|
::= { cipslaVideoProfileEntry 9 }
|
|
|
|
cipslaVideoProfileResolution OBJECT-TYPE
|
|
SYNTAX CvcVideoResolution
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the video frame resolution of the
|
|
generated video traffic."
|
|
::= { cipslaVideoProfileEntry 10 }
|
|
|
|
cipslaVideoProfileAvgBitrate OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..24000)
|
|
UNITS "kbps"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the average bit rate of a video traffic
|
|
pattern in kilo-bits per second. It is used by the sender's
|
|
encoder to upper-limit the generated video packets."
|
|
::= { cipslaVideoProfileEntry 11 }
|
|
|
|
cipslaVideoProfileMaxBitrate OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..240000)
|
|
UNITS "kbps"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the maximum bit rate or peak rate of the
|
|
video traffic that can be generated by the sender's encoder, in
|
|
kilo-bits per second.
|
|
|
|
This value is valid only in the range from the average bit rate
|
|
to 10 times the average bit rate, where the average bit rate is
|
|
specified in cipslaVideoProfileAvgBitrate object."
|
|
::= { cipslaVideoProfileEntry 12 }
|
|
|
|
cipslaVideoProfileMinBitrate OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..24000)
|
|
UNITS "kbps"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the minimum bit rate in kilo-bits per
|
|
second, at which the video traffic can be generated even when
|
|
the video contents are still.
|
|
|
|
This value is valid only in the range from 1 to the average bit
|
|
rate as specified in cipslaVideoProfileAvgBitrate object."
|
|
::= { cipslaVideoProfileEntry 13 }
|
|
|
|
cipslaVideoProfileBitrateWindowSize OBJECT-TYPE
|
|
SYNTAX Unsigned32 (0..10000)
|
|
UNITS "ms"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the rate control window size which is
|
|
used by the video encoder to calculate the running average bit
|
|
rate.
|
|
|
|
The smaller the value of this bit rate window size, less bursty
|
|
of the traffic; this bitrate control window size is specified
|
|
in milliseconds.
|
|
|
|
Value 0 indicates no bitrate window control."
|
|
DEFVAL { 500 }
|
|
::= { cipslaVideoProfileEntry 14 }
|
|
|
|
cipslaVideoProfileIframeMaxSize OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..1000)
|
|
UNITS "kB"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the maximum size of an I-frame that the
|
|
video encoder can generate, in kilo-bytes."
|
|
DEFVAL { 50 }
|
|
::= { cipslaVideoProfileEntry 15 }
|
|
|
|
cipslaVideoProfileIframeRefreshInterval OBJECT-TYPE
|
|
SYNTAX Unsigned32 (0..100000)
|
|
UNITS "ms"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the refresh-rate of video intra-frames,
|
|
in seconds.
|
|
|
|
Value 0 indicates that only the first frame is an intra-frame,
|
|
i.e no refresh."
|
|
DEFVAL { 0 }
|
|
::= { cipslaVideoProfileEntry 16 }
|
|
|
|
cipslaVideoProfileRtpAvgSize OBJECT-TYPE
|
|
SYNTAX Unsigned32 (500..1600)
|
|
UNITS "byte"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the average RTP packet size in generated
|
|
video traffic, in bytes."
|
|
DEFVAL { 1000 }
|
|
::= { cipslaVideoProfileEntry 17 }
|
|
|
|
cipslaVideoProfileRtpJitterPattern OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
bursty(1),
|
|
shaped(2),
|
|
other(99)
|
|
}
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the output buffering control mechanism of
|
|
the video encoder when generating packets.
|
|
|
|
bursty - send packets all out at once, no buffering
|
|
shaped - send packets evenly in a frame interval, with
|
|
buffering
|
|
other - other patterns"
|
|
DEFVAL { bursty }
|
|
::= { cipslaVideoProfileEntry 18 }
|
|
|
|
|
|
ciscoIpslaVideoProfileMIBGroups OBJECT IDENTIFIER
|
|
::= { ciscoIpslaVideoProfileMIBConform 2 }
|
|
|
|
|
|
ciscoIpslaVideoProfileMIBCompliance MODULE-COMPLIANCE
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This is the module-compliance for ISR G2 with PVDM3 platforms,
|
|
containing object groups and notification groups."
|
|
MODULE -- this module
|
|
MANDATORY-GROUPS {
|
|
ciscoIpslaVideoProfileBaseGroup,
|
|
ciscoIpslaVideoProfileIsrg2Pvdm3Group
|
|
}
|
|
::= { ciscoIpslaVideoProfileMIBCompliances 1 }
|
|
|
|
-- Units of Conformance
|
|
|
|
ciscoIpslaVideoProfileBaseGroup OBJECT-GROUP
|
|
OBJECTS {
|
|
cipslaVideoProfileRowStatus,
|
|
cipslaVideoProfileStorageType,
|
|
cipslaVideoProfileDescription,
|
|
cipslaVideoProfileName
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The is the base group to include those objects for all
|
|
platforms implementations."
|
|
::= { ciscoIpslaVideoProfileMIBGroups 1 }
|
|
|
|
ciscoIpslaVideoProfileIsrg2Pvdm3Group OBJECT-GROUP
|
|
OBJECTS {
|
|
cipslaVideoProfileEndpointType,
|
|
cipslaVideoProfileCodec,
|
|
cipslaVideoProfileVideoContents,
|
|
cipslaVideoProfileFrameRate,
|
|
cipslaVideoProfileResolution,
|
|
cipslaVideoProfileAvgBitrate,
|
|
cipslaVideoProfileMaxBitrate,
|
|
cipslaVideoProfileMinBitrate,
|
|
cipslaVideoProfileBitrateWindowSize,
|
|
cipslaVideoProfileIframeMaxSize,
|
|
cipslaVideoProfileIframeRefreshInterval,
|
|
cipslaVideoProfileRtpAvgSize,
|
|
cipslaVideoProfileRtpJitterPattern
|
|
}
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This is the object group to include those objects that are only
|
|
applicable to Cisco ISR G2 platforms with PVDM3."
|
|
::= { ciscoIpslaVideoProfileMIBGroups 2 }
|
|
|
|
END
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|