Cisco VSI Controller MIB File

This chapter describes the individual MIB objects that are used to configure an ATM switch to have Virtual Switch Interface (VSI) Controller information. The VSI Controller resides in the CISCO-VSI-CONTROLLER-MIB.my file.

Contents of this chapter include:

Cisco VSI Controller Terminology

The terms used for the VSI Controller are listed in Table 8-1.

Table 8-1: Terms Used for the VSI Controller

Term Description

VSI

Describes the hardware-independent switch control protocol. This allows a switch, for example, a node, to be controlled by a multiple controllers such as PNNI and Label Switch Controller (LSC). These control planes are internal or external to the switch.

The VSI interface defines the messages, and associated functions that allow communication between the controller and the switch. This interface is expected to support all types of connections, for example, voice, data, Frame Relay, and ATM, used for Permanent Virtual Circuit (PVC), Soft Permanent Virtual Connection (SPVC), and Switched Virtual Circuit (SVC).

VSI Master

Requests connections and receives switch-generic information for the software component, and controls one or more VSI Slaves. This can run on the switch or a dedicated controller platform, which is the master module. It performs the interface to the higher layer networking software and handles all VSI-related functions.

VSI Slave

Converts generic connection requests into hardware-specific requests, and hardware-specific information into generic information for the software component.

VSI Slave runs on the switch. A centralized slave has a single point of control for making connections and controlling interfaces, while a distributed slave allows for multiple slaves to coexist on the same switch.

Controller

Describes the software and hardware that manages topology and network resources. It also performs the VSI Master function.

The Controller performs source routing for end-to-end SVCs, which includes general call acceptance Generic Connection Admission Control (GCAC) and setup calls with other controllers. PNNI and Multiprotocol Label Switching (MPLS) are examples for the Controller.

Controller Shelf

Specifies a controller shelf that is a switch containing at least one VSI Controller, which is controlling a different switch. Also, it will contain local controllers.

Term	Description
VSI	Describes the hardware-independent switch control protocol. This allows a switch, for example, a node, to be controlled by a multiple controllers such as PNNI and Label Switch Controller (LSC). These control planes are internal or external to the switch. The VSI interface defines the messages, and associated functions that allow communication between the controller and the switch. This interface is expected to support all types of connections, for example, voice, data, Frame Relay, and ATM, used for Permanent Virtual Circuit (PVC), Soft Permanent Virtual Connection (SPVC), and Switched Virtual Circuit (SVC).
VSI Master	Requests connections and receives switch-generic information for the software component, and controls one or more VSI Slaves. This can run on the switch or a dedicated controller platform, which is the master module. It performs the interface to the higher layer networking software and handles all VSI-related functions.
VSI Slave	Converts generic connection requests into hardware-specific requests, and hardware-specific information into generic information for the software component. VSI Slave runs on the switch. A centralized slave has a single point of control for making connections and controlling interfaces, while a distributed slave allows for multiple slaves to coexist on the same switch.
Controller	Describes the software and hardware that manages topology and network resources. It also performs the VSI Master function. The Controller performs source routing for end-to-end SVCs, which includes general call acceptance Generic Connection Admission Control (GCAC) and setup calls with other controllers. PNNI and Multiprotocol Label Switching (MPLS) are examples for the Controller.
Controller Shelf	Specifies a controller shelf that is a switch containing at least one VSI Controller, which is controlling a different switch. Also, it will contain local controllers.

VSI Controller Textual Conventions

The names of the textual conventions are specified in the object syntax.

A list of the MIB objects is listed in Table 8-2.

Note Textual conventions do not contain object identifiers.

Table 8-2: VSI Controller Textual Convention MIB Objects

Name Description Syntax Default Value

CvcControllerShelfLocation

Specifies the location of the controller shelf.

The values include:

internal(1)—Specifies that the controller resides on the same shelf as the switch.

external(2)—Specifies that the controller resides on the external platform. The controller shelf is connected to the switch by an ATM link.

Status: current

INTEGER{internal(1), external(2)}

none

CvcControllerType

Describes the type of controller that is a VSI Master.

The values include:

par(1)—Portable Auto Route (PAR). This is a VSI Master controller that implements Cisco Proprietary protocol for network routing and topology in a network, which contains only Cisco switches.

pnni(2)—Private Network-to-Network Interface (PNNI) controller. The PNNI protocol is used between private ATM Switches and between groups of ATM switches. This protocol is defined for distributing topology information between switches and clusters of switches.

lsc(3)—Label Switch Controller (LSC).The LSC implements the MPLS protocol. The LSC is a router, which is capable of controlling the operation of a separate ATM switch so that both of them function as a single ATM-LSR (ATM Label Switch Router).

LSC controls the operation of the ATM switch using a Switch Control Protocol, which allows the LSC to setup and remove cross-connections on the ATM switch. It is used to discover the configuration and capabilities of the controlled switch, and to gather statistics from the controlled switch.

Status: current

INTEGER {par(1), pnni(2), lsc(3)}

none

Name	Description	Syntax	Default Value
CvcControllerShelfLocation	Specifies the location of the controller shelf. The values include: `internal(1)`—Specifies that the controller resides on the same shelf as the switch. `external(2)`—Specifies that the controller resides on the external platform. The controller shelf is connected to the switch by an ATM link. Status: current	INTEGER{internal(1), external(2)}	none
CvcControllerType	Describes the type of controller that is a VSI Master. The values include: `par(1)`—Portable Auto Route (PAR). This is a VSI Master controller that implements Cisco Proprietary protocol for network routing and topology in a network, which contains only Cisco switches. `pnni(2)`—Private Network-to-Network Interface (PNNI) controller. The PNNI protocol is used between private ATM Switches and between groups of ATM switches. This protocol is defined for distributing topology information between switches and clusters of switches. `lsc(3)`—Label Switch Controller (LSC).The LSC implements the MPLS protocol. The LSC is a router, which is capable of controlling the operation of a separate ATM switch so that both of them function as a single ATM-LSR (ATM Label Switch Router). LSC controls the operation of the ATM switch using a Switch Control Protocol, which allows the LSC to setup and remove cross-connections on the ATM switch. It is used to discover the configuration and capabilities of the controlled switch, and to gather statistics from the controlled switch. Status: current	INTEGER {par(1), pnni(2), lsc(3)}	none

VSI Controller Configuration Table

The object identifiers are listed in Table 8-3.

Table 8-3: VSI Controller Configuration Table Object Identifiers

Name Object Identifier

cvcConfTable

::= { cvcConfController 1 }

cvcConfEntry

::= { cvcConfTable 1 }

cvcConfControllerID

::= { cvcConfEntry 1}

cvcConfControllerType

::= { cvcConfEntry 2}

cvcConfControllerShelfLocation

::= { cvcConfEntry 3}

cvcConfControllerLocation

::= { cvcConfEntry 4}

cvcConfControllerName

::= { cvcConfEntry 5 }

cvcConfVpi

::= { cvcConfEntry 6 }

cvcConfVci

::= { cvcConfEntry 7 }

cvcConfRowStatus

::= { cvcConfEntry 8 }

Name	Object Identifier
cvcConfTable	::= { cvcConfController 1 }
cvcConfEntry	::= { cvcConfTable 1 }
cvcConfControllerID	::= { cvcConfEntry 1}
cvcConfControllerType	::= { cvcConfEntry 2}
cvcConfControllerShelfLocation	::= { cvcConfEntry 3}
cvcConfControllerLocation	::= { cvcConfEntry 4}
cvcConfControllerName	::= { cvcConfEntry 5 }
cvcConfVpi	::= { cvcConfEntry 6 }
cvcConfVci	::= { cvcConfEntry 7 }
cvcConfRowStatus	::= { cvcConfEntry 8 }

A list of the MIB objects is listed in Table 8-4.

Table 8-4: VSI Controller Configuration Table MIB Objects

Name Syntax Description Default Value

cvcConfTable

SEQUENCE OF CvcConfEntry

Contains the entries for the VSI controllers. This table is used to inform the VSI slaves about the existence of the VSI controllers, and how the VSI slaves can reach the controller. When an entry is created and activated, the information in these entries are advertised to all the VSI slaves using a system dependent implementation.

Max-Access: not-accessible

Status: current

none

cvcConfEntry

CvcConfEntry

Provides an entry for a VSI Controller. The entries in this table are created by setting the cvcConfRowStatus object to createAndGo(4).

The entries in this table are deleted by setting thecvcConfRowStatus object to destroy(6). The entries are created, modified, and deleted through the Command Line Interface (CLI).

Max-Access: not-accessible

Status: current

The index is cvcConfControllerID.

none

cvcConfControllerID

Integer32 (1..2147483647)

Specifies the unique value for the VSI Controller, for example, VSI Master. The VSI Slave uses this value in the message to identify the VSI Master Controller.

Max-Access: not-accessible

Status: current

none

cvcConfController
Type

CvcControllerType

Identifies the controller type.This object cannot be modified if the associated cvcConfRowStatus is equal to active(1).

Max-Access: read-create

Status: current

none

cvcConfController
ShelfLocation

CvcControllerShelfLocation

Identifies the location of the controller shelf. This object is set only during row creation.

Max-Access: read-create

Status: current

none

cvcConfController
Location

Integer32 (1..2147483647)

Identifies the location of the controller. cvcConfControllerLocation object can contain the logical slot number of the module where the controller is running on the same shelf as the switch.

This object can contain the value of the interface on the module where the controller is running on an external shelf connected to the switch. If the associated cvcConfRowStatus is equal to active(1), this object cannot be modified.

Max-Access: read-create

Status: current

none

cvcConfController
Name

DisplayString

Specifies the name chosen by the user for the VSI Controller. If the user does not set the value for this object, it contains an octet string of length zero.

cvcConfControllerName object cannot be modified if the associated cvcConfRowStatus is equal to active(1).

Max-Access: read-create

Status: current

none

cvcConfVpi

Integer32 (0..4095)

Specifies the Virtual Path Identifier (VPI) that is used for connecting to the controller, which is external to the switch. This object has significance only if cvcConfControllerShelfLocation is external(2).

cvcConfVpi object cannot be modified if the associated cvcConfRowStatus is equal to active(1).

Max-Access: read-create

Status: current

none

cvcConfVci

Integer32 (32..65535)

Specifies the start value of Virtual Channel Identifier (VCI) that is used for connecting to the controller which is external to the switch.

This object has significance only if cvcConfControllerShelfLocation is external(2). cvcConfVci object cannot be modified if the associated cvcConfRowStatus is equal to active(1).

Max-Access: read-create

Status: current

none

cvcConfRowStatus

RowStatus

Adds, deletes, and modifies the controller configuration. The row is created by setting this object to createAndGo(4).

The row is deleted by setting this object to destroy(6).

When this object contains value active(1), the objects in the row are not modified.

Max-Access: read-create

Status: current

none

Name	Syntax	Description	Default Value
cvcConfTable	SEQUENCE OF CvcConfEntry	Contains the entries for the VSI controllers. This table is used to inform the VSI slaves about the existence of the VSI controllers, and how the VSI slaves can reach the controller. When an entry is created and activated, the information in these entries are advertised to all the VSI slaves using a system dependent implementation. Max-Access: not-accessible Status: current	none
cvcConfEntry	CvcConfEntry	Provides an entry for a VSI Controller. The entries in this table are created by setting the `cvcConfRowStatus` object to `createAndGo(4)`. The entries in this table are deleted by setting the`cvcConfRowStatus` object to `destroy(6)`. The entries are created, modified, and deleted through the Command Line Interface (CLI). Max-Access: not-accessible Status: current The index is `cvcConfControllerID`.	none
cvcConfControllerID	Integer32 (1..2147483647)	Specifies the unique value for the VSI Controller, for example, VSI Master. The VSI Slave uses this value in the message to identify the VSI Master Controller. Max-Access: not-accessible Status: current	none
cvcConfController Type	CvcControllerType	Identifies the controller type.This object cannot be modified if the associated `cvcConfRowStatus` is equal to `active(1)`. Max-Access: read-create Status: current	none
cvcConfController ShelfLocation	CvcControllerShelfLocation	Identifies the location of the controller shelf. This object is set only during row creation. Max-Access: read-create Status: current	none
cvcConfController Location	Integer32 (1..2147483647)	Identifies the location of the controller. `cvcConfControllerLocation` object can contain the logical slot number of the module where the controller is running on the same shelf as the switch. This object can contain the value of the interface on the module where the controller is running on an external shelf connected to the switch. If the associated `cvcConfRowStatus` is equal to `active(1)`, this object cannot be modified. Max-Access: read-create Status: current	none
cvcConfController Name	DisplayString	Specifies the name chosen by the user for the VSI Controller. If the user does not set the value for this object, it contains an octet string of length zero. `cvcConfControllerName` object cannot be modified if the associated `cvcConfRowStatus` is equal to `active(1)`. Max-Access: read-create Status: current	none
cvcConfVpi	Integer32 (0..4095)	Specifies the Virtual Path Identifier (VPI) that is used for connecting to the controller, which is external to the switch. This object has significance only if `cvcConfControllerShelfLocation` is `external(2)`. `cvcConfVpi` object cannot be modified if the associated `cvcConfRowStatus` is equal to `active(1)`. Max-Access: read-create Status: current	none
cvcConfVci	Integer32 (32..65535)	Specifies the start value of Virtual Channel Identifier (VCI) that is used for connecting to the controller which is external to the switch. This object has significance only if `cvcConfControllerShelfLocation` is `external(2)`. `cvcConfVci` object cannot be modified if the associated `cvcConfRowStatus` is equal to `active(1)`. Max-Access: read-create Status: current	none
cvcConfRowStatus	RowStatus	Adds, deletes, and modifies the controller configuration. The row is created by setting this object to `createAndGo(4)`. The row is deleted by setting this object to `destroy(6)`. When this object contains value `active(1)`, the objects in the row are not modified. Max-Access: read-create Status: current	none

Table of Contents