|
|
Understanding VLAN Configuration File Syntax
While installing the Cisco ATM PCI adapter in the system, all the ATM VLAN configuration parameters are stored in Windows NT Registry database. After that, you can define additional VLAN configurations dynamically by using the Cisco ATM Administrator GUI described in Chapter 5. This chapter describes the syntax of files associated with ATM VLAN configuration.
The following configuration files pertain to the Cisco ATM PCI Adapter:
%systemRoot%\system32\csinit.txt
%systemRoot%\system32\csilmi.db
%systemRoot%\system32\drivers\etc\atms
A command-line configuration utility, the Cisco ATM Initializer (CSINIT), enables the Cisco ATM Drivers to recognize a predefined network configuration. Cisco ATM Initializer supports definition of virtual LANs (VLANs) for IP over ATM and ATM Forum LAN Emulation.
By default, Cisco ATM Initializer is invoked when you reboot your system after installation of the PCI Adapter. Cisco ATM Initializer reads the VLAN configuration information from the Windows NT Registry database and creates the
csinit.txt
text file and activates the VLAN configuration specified in that file. The
csinit.txt
text file is not editable, but is provided to show the VLAN configuration in text form and to help Cisco technical support to debug if there are any problems.
The format and syntax of the configuration file can be different depending upon the protocol being used for the VLAN being configured. The following protocol(s) are supported by the Cisco ATM PCI Adapter:
The
PROTOCOL
keyword accepts a value of
IPATM
(IP over ATM) or
LE
(LAN Emulation).
The following three sections illustrate the format of the
csinit.txt
file for IPATM and LE.
The format and syntax of the
csinit.txt
file for an IP over ATM VLAN is:
BEGIN_LINK link_number
BEGIN_VLAN vlan_number
PROTOCOL: IPATM
MYIPADDR: ip_address
IPARPSERVER_CONNECT_METHOD: SVC | PVC | LOCAL
# if IPARPSERVER_CONNECT_METHOD is SVC
IPARPSERVER_CONNECT ATMADDR:atm_addr
IPATM_ADD: IPADDR = ip_address,
ATMADDR = atm_addr
# if IPARPSERVER_CONNECT_METHOD is PVC
IPARPSERVER_CONNECT: VPI=vpi_number, VCI=vci_number
IPATM_ADD: IPADDR = ip_address,
VPI=vpi_number, VCI=vci_number
# if IPARPSERVER_CONNECT_METHOD is LOCAL,no additional info required.
# default VLAN configuration parameters
IPATM_MAXMTU: intvalue
IPATM_VCCTO: intvalue
IPATM_INCOMPTO: intvalue
IPATM_COMPTO: intvalue
IPATM_SRVRIATO: intvalue
IPATM_OPEAKRATE: intvalue
IPATM_OAVGRATE: intvalue
IPATM_OMAXBURST: intvalue
END_VLAN
. . .
END_LINK
. . .
The following parameters are used for the specified IPATM VLAN:
Table 6-1 IPATM Configuration File Parameters (Continued)
| Parameter | Description | Range | Default | Units |
|---|---|---|---|---|
| Link_Number | Identifies which physical adapter the data relates to. | 0-3 | 0 | - |
| VLAN_number | Identifies which VLAN# the data relates to. | 0-255 | - | - |
| VPI | Virtual Path Identifier | 0-3 | 0 | N/A |
| VCI | Virtual Channel Identifier | 0-4095 | 100 | N/A |
| ATMADDR | This value is 20 bytes expressed in hex nibbles delimited by colons (a picture mask assures proper entry). | - | - | - |
| IP Address | This value is required to provide a connection from the local system to the target. The value is expressed as the explicit dotted decimal notation. | - | - | - |
| MAXMTU | Maximum MTU Size. The maximum size of a data packet. | 0-9188 | 9188 | Bytes |
| VCCTO | VCC Timeout. Will delete a VCC entry from the connection table after a time out occurs. | 120-3600 | 1200 | Seconds |
| INCOMPTO | Incomplete Timeout. Indicates that the request for a MAC or ATM address failed to get a response and is therefore unknown. | 5-300 | 60 | Seconds |
| COMPTO | Complete Timeout. Forces the ARP Table for the virtual LAN to verify the MAC or ATM address for each address in the table. | 120-3600 | 1200 | Seconds |
| SRVRIATO | Server Inactive Timeout. Will terminate the connection to the ARP Server if connection is inactive for a specified period. | 15-3600 | 60 | Seconds |
| OPEAKRATE | Peak Data Rate. Maximum rate at which cells are allowed to transfer over the connection. | 1-136 | 136 | Mbps |
| OAVGRATE | Average Data Rate. Average rate at which cells are allowed to transfer over the connection (must be below the peak rate). | 1-136 | 136 | Mbps |
| OMAXBURST | Burst at the Peak Rate in Cells. The maximum number of cells that can be sent over the connection at the peak rate. | 1-255 | 10 | Cells |
The format and syntax of the
csinit.txt
file for a LAN Emulation VLAN is:
BEGIN_LINK link_number
BEGIN_VLAN vlan_number
PROTOCOL: LE
# if using IP protocol
MYIPADDR: ip_address
# if using IPX protocol
MYIPXADDR: ipx_address
# if using NETBUI protocol no need to specify an address
# The connect method for LECS, LES and BUS
LECS_CONNECT_METHOD: SVC | PVC | LOCAL
# if LECS_CONNECT_METHOD is SVC
LECS_CONNECT ATMADDR: atm_addr
# if LECS_CONNECT_METHOD is PVC
LECS_CONNECT: VPI=vpi_number, VCI=vci_number
LES_CONNECT_METHOD = SVC | PVC
# if LES_CONNECT_METHOD is SVC
LES_CONNECT ATMADDR: atm_addr
# if LES_CONNECT METHOD is PVC
LES_CONNECT: CTLDIRECTVPI=vpi_number, CTLDIRECTVCI=vci_number,
CTLDISTRVPI=vpi_number, CTLDISTRVCI=vci_number
# if BUS_CONNECT METHOD is PVC
BUS_CONNECT_METHOD: PVC
BUS_CONNECT: MCSENDVPI=vpi_number, MCSENDVCI=vci_number,
MCFWDVPI= vpi_number, MCFWDVCI=vci_number
# Add SVC LEARP entry in client ARP entry
LEC_ADD: MACADDR=mac_address, ATMADDR: atm_addr
# Add PVC LEARP entry in client ARP entry
LEC_ADD: MACADDR=mac_address, VPI=vpi_number, VCI=vci_number
# Delete client ARP entry
LEC_DELETE: MACADDR=mac_address
# Default VLAN Configuration Parameters
LEC_LANTYPE: intvalue
LEC_MAXMTU: intvalue
LEC_LANNAME: intvalue
LEC_CONTROLTO: intvalue
LEC_MAXUNKNOWNFRAMECNT: intvalue
LEC_MAXUNKNOWNFRAMETIME: intvalue
LEC_VCCTO: intvalue
LEC_MAXRETRYCNT: intvalue
LEC_LECID: intvalue
LEC_ARPAGETIME: intvalue
LEC_FWDDELAYTIME: intvalue
LEC_ARPRESPONSETIME: intvalue
LEC_FLUSHTO: intvalue
LEC_PATHSWTCHTIME: intvalue
LEC_MCASTSENDAVGRATE: intvalue
LEC_MCASTSENDPEAKRATE: intvalue
LEC_CONNCOMPLETIONTIME: intvalue
LEC_OPEAKRATE: intvalue
LEC_OAVGRATE: intvalue
LEC_OMAXBURST: intvalue
END_VLAN
END_LINK
The following parameters are used for the specified LAN Emulation VLAN:
Table 6-2 LE Configuration File Parameters (Continued)
| Parameter | Description | Range | Default | Units |
|---|---|---|---|---|
| Link_Number | Identifies which physical adapter the data relates to. | 0-3 | 0 | - |
| VLAN_number | Identifies which VLAN# the data relates to. | 0-255 | - | - |
| VPI | Virtual Path Identifier | 0-3 | 0 | N/A |
| VCI | Virtual Channel Identifier | 0-4095 | 100 | N/A |
| MACADDR | The value is 6 bytes expressed in hex nibbles, each byte delimited by colons. | - | - | - |
| ATMADDR | This value is 20 bytes expressed in hex nibbles delimited by colons (a picture mask assures proper entry). | - | - | - |
| Protocol Address | This value is required to provide a connection from the local system to the target. The value is expressed in explicit dotted decimal notation. | - | - | - |
| LANTYPE | The type of LAN that the LEC is, or wishes to become, a member of (e.g., Ethernet, Token Ring, FDDI). The following values are currently supported:0 = Undefined1 = Ethernet/802.3 | 0-1 | 1 | - |
| MAXMTU | The maximum size of a data packet. The maximum AAL5 SDU size of a data frame that the LEC wishes to send. | 0-9180 | 1500 | Bytes |
| LANNAME | The unique global name across the networks to denote the particular VLAN. | - | - | - |
| CONTROLTO | Timeout period used for timing out most request/response control frame interactions, as specified elsewhere. | 10-300 | 20 | Secs. |
| MAXUNKNOWN FRAMECNT | Within the period of time specified by Maximum Unknown Frame Time, an LEC will send no more than this number of frames to the BUS for a given unicast LAN Destination. | 1-10 | 1 | Frames |
| MAXUNKNOWN FRAMETIME | Within this period of time, an LEC will send no more than the specified Maximum Unknown Frame Count frames to the BUS for a given unicast LAN Destination. | 1-60 | 1 | Secs. |
| VCCTO | [SVC only] Will delete a VCC entry from the ARP connection table if the VC has not been used to transmit or receive any data frames in the specified period of time. | 0-· | 1200 | Secs. |
| MAXRETRYCNT | After an LEC has sent an LE_ARP_REQUEST to a particular frame's target LEC, the LEC must not attempt another LE_ARP_REQUEST to the same target. | 0-2 | 1 | Retries |
| LECID | Each LEC requires an identifier assigned by the LES for echo suppression on multicast data frames sent by that LEC. | 1-FEFF | - | - |
| ARPAGETIME | The maximum time that an LEC will maintain an entry in its ARP connection table before verifying the relationship. | 10-300 | 300 | Secs. |
| FWDDELAYTIME | The maximum time that an LEC will maintain an entry for a non-local MAC address in its ARP connection table before verifying the relationship. | 4-30 | 15 | Secs. |
| ARPRESPONSE TIME | The maximum time that the LEC expects an LE_ARP_REQUEST and LE_ARP_RESPONSE cycle to take. Used for retries and verifies. | 1-30 | 1 | Secs. |
| FLUSHTO | Time limit to wait to receive an LE_FLUSH_RESPONSE after the LE_FLUSH_REQUEST has been sent before taking recovery action. | 1-4 | 4 | Secs. |
| PATHSWTCHTIME | The time since sending a frame to the BUS after which the LEC may assume that the frame has been either discarded or delivered to the target LEC. May be used to bypass the Flush protocol. | 1-8 | 6 | Secs. |
| MCASTSEND AVGRATE | Forward and Backward Sustained Cell Rate to be requested by the LEC when setting up Multicast Send VCC (if using Variable bit rate codings). | - | - | Mbps |
| MCASTSEND PEAKRATE | Forward and Backward Peak Cell Rate to be requested by the LEC when setting up Multicast Send VCC (if using Variable or Constant bit rate codings). | - | - | Mbps |
| CONNCOMPLETION TIME | The time period (during Connection Establishment) in which data or a READY_IND message is expected from a Calling Party. | 1-10 | 4 | Secs. |
| OAVGRATE | Average rate at which cells are allowed to transfer over the connection. Traffic on this client shall average this value. This value must be at or below the peak data rate. | 1-136 | 136 | Mbps |
| OPEAKRATE | Maximum rate at which cells are allowed to transfer over the connection. Traffic on this client is not to exceed this value. | 1-136 | 136 | Mbps |
| OMAXBURST | The maximum number of cells that can be sent at the peak rate. | 1-255 | 10 | Cells |
The
csilmi.db
file provides a mechanism to configure the network prefix when registering/de-registering ATM addresses with the node. If not obtained from the switch directly, the network prefix will be obtained from this static configuration file.
To mimic an ATM Forum ILMI environment, modify the
csilmi.db
configuration data base using a text editor. Specify the network prefix for your location.
An example of the
csilmi.db
file content is:
BEGIN_LINK 0
NET_PREFIX: 39:00:00:00:00:00:14:12:00:00:00:12:00
END_LINK
The
atms
text file provides a mapping of ATM hostnames to a corresponding ATM address.
An example of the
atms
file content is:
# # ATM address for client # 39:00:00:00:00:00:00:00:00:00:00:00:00:00:00:78:01:01:01:00 ipatm-atm0 39:00:00:00:00:00:00:00:00:00:00:00:00:00:40:0b:24:36:00:00 lec-atm0 39:00:00:00:00:00:00:00:00:00:00:00:00:00:40:0b:20:01:00:01 lecs-atm0
|
Copyright 1988-1996 © Cisco Systems Inc.