| OID symbolic | OID numeric | Type | Access | Description |
|---|
| xediaTrafficMgmtMIB | 1.3.6.1.4.1.838.3.2 | | | This module defines objects for the management of Xedia's
proprietary Traffic Management capability. This capability is
based on Class-Based Queueing (CBQ).
The purpose of the Xedia Traffic Management (xtm) function is
to share access to an interface's bandwidth based on policies
set up by the administrator. |
| xtmObjects | 1.3.6.1.4.1.838.3.2.1 | | | |
| xtmClassTable | 1.3.6.1.4.1.838.3.2.1.2 | | not-accessible | This table is a 'flattened' version of a hierarchical class
trees that specify the bandwidth allocation for the CBQ
interfaces of the system.
Each tree is rooted at an interface. A class may either be a
leaf, meaning it has no children, or it may be an interior
class which has children. As packets are forwarded out an
interface, they are compared to the 'flow definition' of each
class down the tree until a matching leaf is found or until
all classes are traversed. Once a matching class is found, the
packet is transmitted or not based on the constraints
configured for the class, most importantly the allocated
bandwidth as identified by xtmClassRate. If no matching class
is found, the packet is dropped.
The 'flow definition' for a class can be defined based on
inclusive ranges of the following packet fields:
o Source IP Address (or a domain name)
o Destination IP Address (or a domain name)
o Protocol above layer 3 (e.g., UDP, TCP, ICMP, etc.)
o Source Port (which identifies service, e.g., FTP,
Telnet, SMTP, etc.)
o Destination Port
It is important that packets only match zero or one traffic
class. In order for this to be true, certain rules must be
enforced when classes are defined. Specifically, all 'sibling'
classes must be defined using the same criteria. Also,
children must use criteria not already specified by one of
their ancestors or they must specify a subrange of an already
specified criteria. Therefore, this tree would be legal:
interface 1
subnet A
protocol UDP
port SNMP
protocol TCP
subnet B
But this tree would be illegal:
interface 2
subnet A
subnet B (illegal -- not subrange of parent)
protocol TCP (illegal -- different criteria than sibling) |
| xtmClassEntry | 1.3.6.1.4.1.838.3.2.1.2.1 | | not-accessible | Information about a single traffic class. Traffic classes are
identified by their associated interface's ifIndex and their
name. (Which means class names must be unique for a particular
interface.)
Traffic classes can be created and destroyed using this
table's xtmClassRowStatus object. A class cannot be used by
the run-time system (xtmClassRowStatus = 'active(1)') if it
does not follow the rules listed in the DESCRIPTION of the
previous object. In this case, the xtmClassRowStatus will
remain 'notReady(3)' and the xtmClassOperStatus will be
'downConflict(3)'.
Also, in order to become active, the user must have specified
a valid value for xtmClassParent and xtmClassRate. All other
settable objects may be left at their default values.
Finally, the following objects cannot be modified once the row
is active: xtmClassParent, and xtmClassQueueElasticityFactor. |
| STR xtmClassName | 1.3.6.1.4.1.838.3.2.1.2.1.1 | DisplayString | not-accessible | A user-defined name for the traffic class. This is the unique
identifier for the class within the scope of the
interface. For example, the class that defines the IP address
range for a particular customer might be 'Customer Fred Co.' |
| STR xtmClassParent | 1.3.6.1.4.1.838.3.2.1.2.1.2 | DisplayString | read-create | Prior to version 2.0, this object has one of the following values:
- the value of xtmClassName for the parent class in the
hierarchy,
- the value 'interface' if the class is directly under
the interface, which is the root of the tree, or
- the value 'orphan' if the class is defined but not yet
inserted into the tree.
Software version 2.0 and greater introduced traffic classification
on both input and output. The value of this object has one of
the following values:
- the value of xtmClassName for the parent class in the
hierarchy,
- the value 'input' if the class is the root of the
input classification tree,
- the value 'output' if the class is the root of the
output classification tree, or
- the value 'orphan' if the class is defined but not yet
inserted into the tree.
If a parent name is specified, the row cannot become active
(have its xtmClassRowStatus set to 'active(1)' unless the
parent is valid and is itself active.
Note that an interface may have several traffic classes with
an xtmClassParent of 'interface'.
Note also that an 'orphan' class cannot become 'active(1)' -
it must first have a valid parent specified. |
| XTM xtmClassRate | 1.3.6.1.4.1.838.3.2.1.2.1.13 | XtmBitRate | read-create | A fraction of the bandwidth of the root interface to be
allocated to this traffic class. Note that specifying 0
bits/second effectively filters all traffic that matches this
class' flow specification. Also note that the sum of bit rates
for all classes defined under the same class must be less
than or equal to xtmClassRate of the parent. |
| T/F xtmClassBounded | 1.3.6.1.4.1.838.3.2.1.2.1.14 | TruthValue | read-create | The value of this object is 'true(1)' if the class is bounded
(can't 'borrow' bandwidth from its parent class) and
'false(2)' otherwise. |
| I32 xtmClassPriority | 1.3.6.1.4.1.838.3.2.1.2.1.15 | Integer32 | read-create | The priority for this class. The smaller the value, the
higher the priority. Delay-sensitive flows (such as video or
audio) should be given higher priority values. |
| INT xtmClassOperStatus | 1.3.6.1.4.1.838.3.2.1.2.1.22 | INTEGER | read-only | The actual operational status of the traffic class. The value
'up(1)' means this traffic class is in use, the value
'down(2)' indicates the traffic class is not in use either due
to an internal problem or because it (or an ancestor) is
administratively disabled, and the value 'downConflict(3)'
indicates the class definition conflicts with those of its
siblings. The value autoClassActive(4) means that the class is
a dynamically created AutoClass, which may not be modified in any
way until it is saved to Non-Volatile configuration memory.
After an AutoClass is saved to NVRAM, it's operational status
will transistion to up(1). |
| STR xtmClassOperMsg | 1.3.6.1.4.1.838.3.2.1.2.1.23 | DisplayString | read-only | The operational message associated with the operational
status. The message usually provides additional information
that may not be obvious through the operational status. |
| INT xtmClassBwUse | 1.3.6.1.4.1.838.3.2.1.2.1.24 | INTEGER | read-only | An indication of whether this traffic class has used its
allocated bandwidth (as indicated by xtmClassPercent), has not
used its allocated bandwidth or has used more than its
allocated bandwidth and is therefore 'atLimit(1)',
'underLimit(2)', or 'overLimit(3)' respectively. |
| T/F xtmClassUnsatisfied | 1.3.6.1.4.1.838.3.2.1.2.1.25 | TruthValue | read-only | An indication of whether this traffic class is
'unsatisfied'. The value of this object is 'true(1)' if it is
underLimit and has a persistent backlog, meaning it has
packets waiting in its queue. The value is 'false(1)'
otherwise. Note that a class can be considered satisfied if it
is underLimit and it just hasn't had anything to transmit.
The presence of an unsatisfied class indicates that some other
class is overLimit and 'hogging' bandwidth. Persistently
unsatisfied classes indicate that tuning some of the
parameters (such as xtmClassMaxIdle or xtmClassBounded) may be
necessary. |
| G32 xtmClassQueueSize | 1.3.6.1.4.1.838.3.2.1.2.1.26 | Gauge32 | read-only | The size of the queue associated with this traffic
class. This is the maximum number of packets that can be in
the queue, not the number that are currently queued (see
xtmClassStatsQueuedPkts). |
| ROW xtmClassRowStatus | 1.3.6.1.4.1.838.3.2.1.2.1.27 | RowStatus | read-create | Traffic classes are created and delected using this object
(using the conventions described in RFC1903). |
| XTM xtmClassMaxRate | 1.3.6.1.4.1.838.3.2.1.2.1.28 | XtmBitRate | read-create | The maximum bandwidth the class may achieve, including
bandwidth allocated to this class, and any bandwidth that
may be borrowed. A value of zero (0) indicates that this
feature is not being used. The xtmClassMaxRate must be set
to a value higher than the xtmClassRate, but may also exceed
the parent class's xtmClassRate. |
| I32 xtmClassPeerClassificationOrder | 1.3.6.1.4.1.838.3.2.1.2.1.44 | Integer32 | read-create | A positive integer representing the classification order
of peers within the classification hierarchy. For example,
when creating three children under the 'root' class the
packet classifier checks incoming packets againts classification
parameters from left to right in the order in which the children
were created. Each peer (aka 'sibling') is assigned an xtmClass-
PeerClassificationOrder of 100 by default, as shown below.
+_______+
| root |
| class |
+_______+
/ | \
/ | \
/ | \
/ | \
/ | \
/ | \
+_______+ +_______+ +_______+
| A | | B | | C |
| class | | class | | class |
| 100 | | 100 | | 100 | (peer classification order)
+_______+ +_______+ +_______+
In the figure above, classification order proceeds from A to B
to C. In order to alter this order, this object may be modified.
For example, to change the order to C, B A one might assign
an xtmClassPeerClassificationOrder of 50 to class C, and an
xtmClassPeerClassificationOrder of 150 to class A, resulting in
the ordered tree shown below.
+_______+
| root |
| class |
+_______+
/ | \
/ | \
/ | \
/ | \
/ | \
/ | \
+_______+ +_______+ +_______+
| C | | B | | A |
| class | | class | | class |
| 50 | | 100 | | 150 | (peer classification order)
+_______+ +_______+ +_______+ |
| XTM xtmClassSrcIpAddresses | 1.3.6.1.4.1.838.3.2.1.2.1.45 | XtmRange | read-create | The range of IP source addresses that match this class.
An all zeros value means 'any source address'. |
| XTM xtmClassDestIpAddresses | 1.3.6.1.4.1.838.3.2.1.2.1.46 | XtmRange | read-create | The range of IP destination addresses that match this class.
An all zeros value means 'any destination address'. |
| XTM xtmClassProtocols | 1.3.6.1.4.1.838.3.2.1.2.1.47 | XtmRange | read-create | The range of IP protocols that match this class. The value '0'
'any protocol'.
Numeric strings, character strings, and combinations of the two
may be used. Valid strings include:
Numeric String Character String
______________ ________________
1 icmp
6 tcp
17 udp
50 esp
89 ospf |
| XTM xtmClassSrcPorts | 1.3.6.1.4.1.838.3.2.1.2.1.48 | XtmRange | read-create | The range of UDP or TCP source ports that match this class.
The value '0' 'any port'.
Numeric strings, character strings, and combinations of the two
may be used. Valid strings include, but are not limited to the
following:
Numeric String Character String
______________ ________________
20 ftpdata
21 ftp
23 telnet
25 smtp
53 domain
67 bootps
68 bootpc
69 tftp
70 gopher
79 finger
80 http
110 pop3
119 nntp
123 ntp
161 snmp
162 snmptrap
179 bgp
389 ldap
500 isakmp
636 ldapSsl
1701 l2tp
1812 radius |
| XTM xtmClassDestPorts | 1.3.6.1.4.1.838.3.2.1.2.1.49 | XtmRange | read-create | The range of UDP or TCP destination ports that match this class.
The value '0' 'any port'.
Numeric strings, character strings, and combinations of the two
may be used. Valid strings include, but are not limited to the
following:
Numeric String Character String
______________ ________________
20 ftpdata
21 ftp
23 telnet
25 smtp
53 domain
67 bootps
68 bootpc
69 tftp
70 gopher
79 finger
80 http
110 pop3
119 nntp
123 ntp
161 snmp
162 snmptrap
179 bgp
389 ldap
500 isakmp
636 ldapSsl
1701 l2tp
1812 radius |
| XTM xtmClassApplications | 1.3.6.1.4.1.838.3.2.1.2.1.50 | XtmRange | read-create | The application level protocol of the class.
Application classification allows you to classify based on the
application level protocol. Each application has a corresponding
'Established' enumeration which specifies that communication can
not be initiated through this class. For example, 'telnetEstablished'
specifies that telnet connections can not pass through this class.
'Established' enumerations provide stateful firewall capabily. For
example, in the following configuration, telnet configurations can
only be initiated from Host B. Host A can not initiate a telnet
connection.
+__________________________________+
| |
Host A _____| telnet class telnetEstablished|_____ Host B
| on cbq.1 class on cbq.2 |
+__________________________________+
Numeric strings, character strings, and combinations of the two
may be used. Valid strings include the following:
Numeric String Character String
______________ ________________
1 allTcp
2 allTcpEstablished
3 allUdp
4 allUdpEstablished
5 ftp
6 ftpEstablished
7 telnet
8 telnetEstablished
9 http
10 httpEstablished
11 dns
12 dnsEstablished
13 tftp
14 tftpEstablished
15 snmp
16 snmpEstablished
17 httpSSL
18 httpSSLEstablished
19 smtp
20 smtpEstablished
21 bgp
22 bgpEstablished
23 slaProbe
24 slaProbeEstablished
25 icmp
26 icmpEstablished
27 ldap
28 ldapEstablished
29 ldapSsl
30 ldapSslEstablished
31 nntp
32 nntpEstablished
33 ntp
34 ntpEstablished
35 pop3
36 pop3Established
37 radius
38 radiusEstablished
39 isakmp
40 isakmpEstablished
41 ssh
42 sshEstablished
43 l2tp
44 l2tpEstablished |
| XTM xtmClassClassificationTos | 1.3.6.1.4.1.838.3.2.1.2.1.51 | XtmRange | read-create | The range of IPv4 Tos Octet values that match this class. |
| XTM xtmClassSrcDomainNames | 1.3.6.1.4.1.838.3.2.1.2.1.52 | XtmRange | read-create | A list of domain names which are to be dynamically included
in the range of source IP addresses. |
| XTM xtmClassDestDomainNames | 1.3.6.1.4.1.838.3.2.1.2.1.53 | XtmRange | read-create | A list of domain names which are to be dynamically included
in the range of destination IP addresses. |
| INT xtmClassOperator | 1.3.6.1.4.1.838.3.2.1.2.1.54 | INTEGER | read-create | An operator applied to all classification parameters of this
class. A value of 'and' indicates that packets must match all
classification parameters specified by the class in order to
be classified within the class. A value of 'or' indicates that
packets must match any one of the configured classification
parameters specified by the class in order to be classified
within the class.
For example, consider a class with classification parameters
xtmClassSrcIpAddresses of '198.202.232.10' and xtmClassProtocol
of 'udp'.
When xtmClassOperator is 'and', packets with IP source addresses
of 198.202.232.10 and IP protocol of udp are classified within
this class. Whe xtmClassOperator is 'or', packets with IP source
addresses of 198.202.232.10 or IP protocol or udp are classified
within this class. |
| xtmNotifications | 1.3.6.1.4.1.838.3.2.2 | | | |
| xtmConformance | 1.3.6.1.4.1.838.3.2.3 | | | |
