MIBs Depot

CISCO-COPS-CLIENT-MIB

Registered at
1.3.6.1.4.1.9.9.140
Last updated
2005-11-14 00:00
Organization
Cisco Systems Inc.
Revisions
2005-11-14 00:00, 2000-06-11 00:00, 1999-09-16 00:40
Namespace
cisco
Source file
CISCO-COPS-CLIENT-MIB
Digest
sha256:8b7ac52648a5c0902d34db1c9ac0b557108e659fb2679ca93ef9c06cd2af8627

Description

This MIB module is for configuration & statistic query of Common Open Policy Service(COPS) client feature on the Cisco device. COPS is a simple client/server model for supporting policy control over QoS Signaling Protocols and provisioned QoS resource management. COPS is a simple query and response protocol that can be used to exchange policy information between a policy server (Policy Decision Point or PDP) and its clients (Policy Enforcement Points or PEPs).

Contact

Cisco Systems Customer Service Postal: 170 W Tasman Drive San Jose, CA 95134 USA Tel: +1 800 553-NETS E-mail: cs-wbu@cisco.com, cs-snmp@cisco.com

Imports

FromSymbols
CISCO-SMIciscoMgmt
IF-MIBifIndex
SNMPv2-CONFMODULE-COMPLIANCE, NOTIFICATION-GROUP, OBJECT-GROUP
SNMPv2-SMIMODULE-IDENTITY, NOTIFICATION-TYPE, OBJECT-IDENTITY, OBJECT-TYPE, Unsigned32, iso
SNMPv2-TCDisplayString, RowStatus, TEXTUAL-CONVENTION, TruthValue

Imported by

Nothing in this corpus imports this module.

Load order

Every file a consumer needs in order to load this module, dependencies first.

CISCO-COPS-CLIENT-MIB
CISCO-SMI
IANAifType-MIB
IF-MIB
SNMPv2-CONF
SNMPv2-MIB
SNMPv2-SMI
SNMPv2-TC

Textual conventions

NameOIDSyntaxAccessStatus
CopsClientType
TEXTUAL-CONVENTION
An enumerated value for all the supported COPS client type. rsvp(1) Resource Reservation Protocol(RSVP). RSVP is a signaling mechanism that the applications will use to signal parameters to the network, so that network can assign QoS for the application data stream. provisioning(2) Provisioning. A client type for COPS to support policy provisioning. This client type is independent of the type of policy (QoS, VPNs, Security, etc.) and it is based on the concept of PIBs (Policy Information Bases [PIB]).
current
CopsDomainName
TEXTUAL-CONVENTION
A display string where valid letters are a-z, A-Z, 0-9, ., - and _. Name can not start with an '_'. The COPS domain which a COPS client type belongs to. This is so that a COPS server supporting multiple domains can push the correct set of domain policies to a device.
current
CopsRole
TEXTUAL-CONVENTION
A display string where valid letters are a-z, A-Z, 0-9, ., - and _. Name can not start with an '_'. Policies are assigned to a 'role', and one or more 'roles' are assigned to interfaces, such that an interface takes on the policies indirectly as the policies of the roles assigned to that interface.
current
CopsRoleCombination
TEXTUAL-CONVENTION
A display string consisting of a set of roles concatenated with '+' characters where the roles are in lexicographic order from minimum to maximum. Policies are assigned to a 'role', and one or more 'roles' are assigned to interfaces, such that an interface takes on the policies indirectly as the policies of the roles assigned to that interface. When one or more roles assigned to an interface, that set of roles is known as a role-combination.
current

Objects

NameOIDSyntaxAccessStatus
ccopsMIBObjects
OBJECT-IDENTITY
1.3.6.1.4.1.9.9.140.1
ccopsGlobalObjects
OBJECT-IDENTITY
1.3.6.1.4.1.9.9.140.1.1
ccopsServerMax
OBJECT-TYPE
Maximum number of configurable COPS servers allowed for each client type. A value of zero indicates no limitation on the number of configurable COPS servers.
1.3.6.1.4.1.9.9.140.1.1.1Unsigned32 (0..65535)read-onlycurrent
ccopsMaxRole
OBJECT-TYPE
Indicates the maximum number of roles supported by this device. A value of zero indicates no limitation on the number of roles.
1.3.6.1.4.1.9.9.140.1.1.2Unsigned32read-onlycurrent
ccopsMaxRoleCombination
OBJECT-TYPE
Indicates the maximum number of role-combinations supported by this device. A value of zero indicates no limitation on the number of role-combinations. Each CopsRoleCombination may contain up to ccopsMaxRole roles.
1.3.6.1.4.1.9.9.140.1.1.3Unsigned32read-onlycurrent
ccopsServerConfigTable
OBJECT-TYPE
A list of possible COPS servers that the COPS client will try to connect to in order of ccopsServerConfigPriority.
1.3.6.1.4.1.9.9.140.1.1.4not-accessiblecurrent
ccopsServerConfigEntry
OBJECT-TYPE
A set of configuration information regarding a single COPS server from the point of view of a COPS client. The entry is created and deleted by using ccopsServerConfigStatus. An entry may not exist in the active state unless all objects in the entry have an appropriate value. Each client type can have its own COPS servers. By creating, deleting or modifying an entry in this table, users can add, delete or modify a COPS server for a particular client type for the device. In order to get policies from COPS server for a client type, user has to create an entry for such client type.
1.3.6.1.4.1.9.9.140.1.1.4.1not-accessiblecurrent
ccopsServerConfigClientType
OBJECT-TYPE
The type of policies to be retrieved from this server.
1.3.6.1.4.1.9.9.140.1.1.4.1.1CopsClientTypenot-accessiblecurrent
ccopsServerConfigName
OBJECT-TYPE
The IP address or the hostname of a COPS server. If a hostname is used, it will be resolved to an address prior to each attempt to setup a connection to a PDP. If the PEP cannot resolve the hostname, the connection attempt will fail. Use of IP address values is preferred, except in cases where a hostname must/should be used (e.g. if the PDP has a dynamic address)
1.3.6.1.4.1.9.9.140.1.1.4.1.2DisplayString (SIZE(1..64))not-accessiblecurrent
ccopsServerConfigPriority
OBJECT-TYPE
The priority of this entry relative to other entries. The COPS client will attempt to contact COPS servers for the appropriate Client-Type in the order of their priority values. COPS servers designated by the COPS protocol PDP-Redirect mechanism are always used in preference to any entries in this table. When ccopsServerMax mib object is not zero, the valid value for ccopsServerConfigPriority ranges from zero to ccopsServerMax minus one. When the ccopsServerMax mib object is zero, any valid unsigned value may be used. For servers with different value of ccopsServerConfigPriority, the server with lowest value has highest priority. For servers with same value of ccopsServerConfigPriority and ccopsServerConfigClientType, the relative priority of Servers is determined by a numerical comparison of their IP addresses, with the lowest address having higher priority.
1.3.6.1.4.1.9.9.140.1.1.4.1.3Unsigned32 (0..255)read-createcurrent
ccopsServerConfigPort
OBJECT-TYPE
The destination port number to which COPS server messages should be sent. By default the COPS service will be provided on the well-known COPS protocol port number 3288.
1.3.6.1.4.1.9.9.140.1.1.4.1.4Unsigned32 (0..65535)read-createcurrent
ccopsServerConfigStatus
OBJECT-TYPE
The status of COPS server configuration for a client type. An entry may not exist in the active state unless all objects in the entry have an appropriate value. Once a row becomes active, value in any other column within such row cannot be modified except by setting ccopsServerConfigStatus to notInService(2) for such row.
1.3.6.1.4.1.9.9.140.1.1.4.1.5RowStatusread-createcurrent
ccopsInitialTimeout
OBJECT-TYPE
If the device can not connect to the last connected COPS server, it uses this value for the initial retry time-out and then retries to connect after this time-out period. This value is re-used for the first retry after every successful connection. When the device is connecting to COPS server the first time or the last connected COPS server is no longer available, it will attempt to contact COPS servers existing in ccopsServerConfigTable for the appropriate Client-Type in the order of their priority values.
1.3.6.1.4.1.9.9.140.1.1.5Unsigned32 (0..65535)read-writecurrent
ccopsTimeoutIncrement
OBJECT-TYPE
On every consecutive failure to connect to all existing COPS server for a client type, the COPS client increases the retry time-out by ccopsTimeoutIncrement but not greater than ccopsTimeoutMax.
1.3.6.1.4.1.9.9.140.1.1.6Unsigned32 (0..65535)read-writecurrent
ccopsTimeoutMax
OBJECT-TYPE
The maximum retry time-out that the COPS client allows. On every consecutive failure to connect to all COPS servers, the COPS client increases the retry time-out up to ccopsTimeoutMax.
1.3.6.1.4.1.9.9.140.1.1.7Unsigned32 (0..65535)read-writecurrent
ccopsDomainTable
OBJECT-TYPE
A list of COPS domains for each client type supported in the device.
1.3.6.1.4.1.9.9.140.1.1.8not-accessiblecurrent
ccopsDomainEntry
OBJECT-TYPE
A set of domain configuration information regarding a single COPS client type. An entry will exist for each COPS client type which is supported in the device. For each COPS client type supported in the device, a domain name should be specified if the COPS server for that client type has multiple domains defined in its database.
1.3.6.1.4.1.9.9.140.1.1.8.1not-accessiblecurrent
ccopsDomainClientType
OBJECT-TYPE
The type of COPS client.
1.3.6.1.4.1.9.9.140.1.1.8.1.1CopsClientTypenot-accessiblecurrent
ccopsDomainName
OBJECT-TYPE
The COPS domain which this client type belongs to. This is so that a COPS server supporting multiple domains can push the correct set of domain policies to this device. Zero length name is default. COPS server have a default set of policies for clients who have zero length domain names. Changing the COPS domain name while qosPolicySource is cops(2) will result in requesting new policies from the cops server and configuring the device with those new policies. The value of ccopsDomainName is ignored if qosPolicySource is local(1).
1.3.6.1.4.1.9.9.140.1.1.8.1.2CopsDomainNameread-writecurrent
ccopsRoleTable
OBJECT-TYPE
A list of roles. The number of entries is determined by ccopsMaxRole.
1.3.6.1.4.1.9.9.140.1.1.9not-accessiblecurrent
ccopsRoleEntry
OBJECT-TYPE
Entry containing COPS-PR role information. The entry is created, deleted and modified by using ccopsRoleStatus. There is a maximum on the number of roles which may be configured per device. In order to make a role available for interface to construct its role combination, such role must exist in the role table. Deleting a role in ccopsRoleTable also removes that role from all role combinations for all interfaces. Therefore, a particular role can not be added into the role combination for any interface if it is removed from this table.
1.3.6.1.4.1.9.9.140.1.1.9.1not-accessiblecurrent
ccopsRoleName
OBJECT-TYPE
The name of the role. Only roles which were defined in COPS server should be used. COPS server will only supply the policies for those roles defined in its database.
1.3.6.1.4.1.9.9.140.1.1.9.1.1CopsRolenot-accessiblecurrent
ccopsRoleStatus
OBJECT-TYPE
This object is used to manage creation, deletion and modification of rows in this table. An entry may not exist in the active state unless all objects in the entry have an appropriate value. Once a row becomes active, value in any other column within such row cannot be modified except by setting ccopsRoleStatus to notInService(2) for such row. Deleting a row results in removing this ccopsRoleName from all role combinations in the ccopsIfTable
1.3.6.1.4.1.9.9.140.1.1.9.1.2RowStatusread-createcurrent
ccopsIfTable
OBJECT-TYPE
A list of interface entries. An entry will exist for each interface which supports COPS-PR feature.
1.3.6.1.4.1.9.9.140.1.1.10not-accessiblecurrent
ccopsIfEntry
OBJECT-TYPE
Entry containing COPS status for a particular interface. By default each interface has no roles. It then has a role combination that is the zero length string. Roles in a role combination for an interface are reported to the PDP by the PEP. An interface may have multiple roles. Adding/deleting roles results in changes to the role combination for an interface. Therefore, a new set of QoS policies will be used for the interface with the new role combination.
1.3.6.1.4.1.9.9.140.1.1.10.1not-accessiblecurrent
ccopsIfRoleCombination
OBJECT-TYPE
A display string, role combination, that is associated with an interface. This is the administratively-desired role combination which represents roles that are currently set by the administrator for a particular interface in the COPS domain. If copsMaxRoleCombination is one, the new role will be applied to all interfaces which support COPS feature on the device. Agent returns inconsistentValue if this role does not exist in ccopsRoleTable, resourceUnavailable if the role combination exceeds copsMaxRoleCombination in the device, wrongValue if a non-lexicographically-ordered value is written to it. On some platforms, roles may be assigned per port group rather than per port. If multiple ports belong to a port group, the role combination assigned to any of the ports in such group will apply to all ports in the same group. On some platforms, there can be a single role combination for the entire device. The role combination assigned to any of the interfaces will apply to all interfaces which support COPS feature in the device.
1.3.6.1.4.1.9.9.140.1.1.10.1.1CopsRoleCombinationread-writecurrent
ccopsRoleConfigSupported
OBJECT-TYPE
Indicates whether this device supports the ccopsMaxRole and ccopsRoleTable, and thereby, whether a role must be present in the ccopsRoleTable before it can be used within a value of ccopsIfRoleCombination.
1.3.6.1.4.1.9.9.140.1.1.11TruthValueread-onlycurrent
ccopsMIBNotifications
OBJECT-IDENTITY
1.3.6.1.4.1.9.9.140.2
ccopsMIBConformance
OBJECT-IDENTITY
1.3.6.1.4.1.9.9.140.3
ccopsMIBCompliances
OBJECT-IDENTITY
1.3.6.1.4.1.9.9.140.3.1
ccopsMIBGroups
OBJECT-IDENTITY
1.3.6.1.4.1.9.9.140.3.2

Conformance

NameOIDStatus
ccopsMIBCompliance
MODULE-COMPLIANCE
The compliance statement for the CISCO-COPS-CLIENT-MIB.
1.3.6.1.4.1.9.9.140.3.1.1deprecated
ccopsMIBComplianceRev2
MODULE-COMPLIANCE
The compliance statement for the CISCO-COPS-CLIENT-MIB.
1.3.6.1.4.1.9.9.140.3.1.2current
ccopsGlobalGroup
OBJECT-GROUP
A collection of objects providing the COPS ability on the device. Devices implementing the COPS client feature should support this group.
1.3.6.1.4.1.9.9.140.3.2.1deprecated
ccopsGlobalGroupRev2
OBJECT-GROUP
A collection of objects providing the COPS ability on the device.
1.3.6.1.4.1.9.9.140.3.2.2current
ccopsRoleGroup
OBJECT-GROUP
A collection of objects which allow an agent to require a limited set of allowed roles be specified, and to reject any role-combination containing any other role.
1.3.6.1.4.1.9.9.140.3.2.3current