|
|
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_LINKlink_numberBEGIN_VLANvlan_numberPROTOCOL: IPATM MYIPADDR:ip_addressIPARPSERVER_CONNECT_METHOD: SVC | PVC | LOCAL # if IPARPSERVER_CONNECT_METHOD is SVC IPARPSERVER_CONNECT ATMADDR:atm_addrIPATM_ADD: IPADDR =ip_address, ATMADDR =atm_addr# if IPARPSERVER_CONNECT_METHOD is PVC IPARPSERVER_CONNECT: VPI=vpi_number, VCI=vci_numberIPATM_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:intvalueIPATM_VCCTO:intvalueIPATM_INCOMPTO:intvalueIPATM_COMPTO:intvalueIPATM_SRVRIATO:intvalueIPATM_OPEAKRATE:intvalueIPATM_OAVGRATE:intvalueIPATM_OMAXBURST:intvalueEND_VLAN . . . END_LINK . . .
The following parameters are used for the specified IPATM VLAN:
| 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_LINKlink_numberBEGIN_VLANvlan_numberPROTOCOL: 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_numberLES_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:intvalueLEC_MAXMTU:intvalueLEC_LANNAME:intvalueLEC_CONTROLTO:intvalueLEC_MAXUNKNOWNFRAMECNT:intvalueLEC_MAXUNKNOWNFRAMETIME:intvalueLEC_VCCTO:intvalueLEC_MAXRETRYCNT:intvalueLEC_LECID:intvalueLEC_ARPAGETIME:intvalueLEC_FWDDELAYTIME:intvalueLEC_ARPRESPONSETIME:intvalueLEC_FLUSHTO:intvalueLEC_PATHSWTCHTIME:intvalueLEC_MCASTSENDAVGRATE:intvalueLEC_MCASTSENDPEAKRATE:intvalueLEC_CONNCOMPLETIONTIME:intvalueLEC_OPEAKRATE:intvalueLEC_OAVGRATE:intvalueLEC_OMAXBURST:intvalueEND_VLAN END_LINK
The following parameters are used for the specified LAN Emulation VLAN:
| 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 = Undefined 1 = 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
|
|