# @(#)READMEFIRST - INTERPHASE CORPORATION - UnixWare PCI ATM ************************************************************************* **** Please read this document in its entirety prior to product **** **** installation. Note that this document supersedes the **** **** Installation Guide if differences arise. **** ************************************************************************* 1. Introduction This README file describes the new features in the Integrated Driver 1 (ID1) release of the ATM adapter software. This file should be read carefully before the ID1 software is installed on your system. The ID1 driver provides the following functions in the same driver. All these functions can be enabled and used simultaneously. - LAN Emulation client (SVC). o Ethernet o Token Ring - LAN Emulation services (LES, BUS and LECS). o Ethernet o Token Ring - IP-ATM (RFC-1577) client (SVC) - IP-ATM (RFC-1577) server - Bridged PVCs based on RFC-1483 o LLC Encapsulated Ethernet/802.3 o LLC Encapsulated 802.5 o Null Encapsulated Ethernet/802.3 o Null Encapsulated 802.5 - Routed PVCs based on RFC-1483 o LLC Encapsulated o Null Encapsulated The configuration and the statistics display of the driver software is done with a GUI based utility called CellView. New Features: o This driver supports multiple LECs on the same ELAN. 2. Installation of Software: If the adaptor(s) have not been installed in the system already refer the chapter X for instructions. NOTE: The package can also be installed with out having the Adaptor(s) already installed in the system. In this case, run the command "shutdown -y -g0 -i0" to power down the system and install the adaptor(s). The procedure to install the software package is as follows: 1. Login as root. NOTE: A. Disk space availability can be checked by running the command "df -k". B. Existing software package can be checked by running the command "pkginfo INPHatm". 2. Run the command "init S" to bring the system to Single-User mode. NOTE: A. If the package already exists in the system, remove the package by running the command "pkgrm INPHatm". 3. Installing software from CD-ROM. 3a. Insert the Interphase ID1.0 CD-ROM in to your CD-ROM drive and mount it. mount -F cdfs -r /dev/cdrom/ For example: mount -F cdfs -r /dev/cdrom/c0b0t0l0 /CD-ROM_1 3b. Install the ID1.0 package. pkgadd -d /CD-ROM_1/UnixWare/SX00220-C02 INPHatm The installation of the package will take few minutes to complete. 4. Installing a down-loaded copy of the software. "pkgadd -d complete_path_name_of_downloaded_package" The installation of the package will take few minutes to complete. 5. Installation promts for information such as a. Number of adaptors to be configured. b. IP address, Broadcast address, netmask and ifconfig options for each client. The defaults can be taken by pressing the "ENTER" Key. 6. After the installation of software is successful, "CellView" graphical utility can be used to configure LANE and IP 1577 clients, PVCs and other LANE services. Refer to Chapter 5 of installation guide for more information. NOTE: A. This step can also be defered until after reboot of the system. 7. Run the command "Shutdown -y -g0 -i6" to reboot the system. 3. De-installation of software. The procedure to de-install the software package is as follows: 1. Login as root. 2. Run the command "init S" to bring the system to Single-User mode. 3. Run the command "pkgrm INPHatm" to remove the package from the system. 4. Configuration After the software is installed on a system, CellView graphical utility is used to configure ATM (LANE, IP1577, PVC). The system should be rebooted to load the drivers and take the configuration effect. In the ID1 release, all the configuration data is stored in a single configuration file, /etc/atm/cvconf. There is an on-line man page for cvconf that describes the format of this file. The users are strongly encouraged to use the graphical utility to modify the configuration. 5. CellView CellView is a GUI based utility for ATM software configuration and statistics display. When an entity such as LECS is configured with CellView the configuration information is stored in the configuration file so that upon subsequent system reboots the software configuration can be restored without having to configure the software manually again. At the system boot time all the software entities are initialized per the configuration information in the configuration file. In addition to CellView command line configuration utilities such as les, lecs, etc. are also avilable. However their usage is not recommended unless for some reason you can not run CellView on your system. Command line configuration utilities configure the software based on the options specified, but do not update the configuration file. In the "Setup" mode, CellView displays the configuration stored in the configuration file. In the "Stats" mode, CellView displays the actual configuration of the software. Normally the configuration file mirrors the software configuration. If the command line configuration utilities are used, the configuration file and the software configuration may get out of synchronization. This can cause subsequent configuration changes from CellView to not work properly. 6. PVCs The LAN Emulation and IP-ATM clients can use both SVCs and PVCs simultaneously. In LAN Emulation clients, SVC capabilities are based on ATM Forum's "LAN Emulation Over ATM Specification - Version 1.0". The PVCs supported are bridged PVCs as described in RFC-1483. Clients can be enabled in PVC only or PVC and SVC mode. A 6 byte unicast MAC address and a VCI number is associated with each PVC. Packets received from the upper layers whose destination MAC address match the MAC address of a PVC are transmitted on that PVC. Each PVC can be individually enabled as "Broadcast PVC". If enabled as "Broadcast PVC", all the broadcast/multicast packets received by that client from the upper layers are transmitted on that PVC. A maximum of 16 PVCs can be enabled as "Broadcast PVCs". In IP-ATM clients, SVC capabilities are based on RFC-1577. The PVCs supported are routed PVCs as described in RFC-1483. Clients can be enabled in PVC only or PVC and SVC mode. An IP address and a VCI number is associated with each PVC. Packets received from the upper layers whose first hop (an end-station or a router) match the IP address of a PVC are transmitted on that PVC. Per RFC-1577, IP-ATM PVCs do not support transmission of broadcast/multicast packets. MAC address for Bridged PVCs should be entered in the natural order of the emulated LAN. i.e For Ethernet LANE, the MAC address should be entered in the conical format and for Token Ring LANE, MAC address should be entered in the non-conical format. 7. Other Notes - If the signalling parameters are changed from CellView, the changes will not take effect until the signalling deamon is restarted or system is rebooted. Signalling deamon can be restarted by entering the command "restart_signald". - The mapping of IP interface number to LANE and IP-ATM clients is as follows: LANE clients: IP interface number = (board number * 4) + client number IP-ATM clients: IP interface number = 32 + board number If there are two adapters installed in the system, IP interface number for all the clients that can be enabled is shown below. 'li' is the IP interface prefix for Interphase ATM adapters. li0 Board 0, LAN Emulation client 0 li1 Board 0, LAN Emulation client 1 li2 Board 0, LAN Emulation client 2 li3 Board 0, LAN Emulation client 3 li4 Board 1, LAN Emulation client 0 li5 Board 1, LAN Emulation client 1 li6 Board 1, LAN Emulation client 2 li7 Board 1, LAN Emulation client 3 li32 Board 0, IP-ATM client li33 Board 1, IP-ATM client - MAC address for Bridged PVCs should be entered in the natural order of the emulated LAN. For Ethernet emulation, the MAC address should be entered in the conical format. For Token Ring emulation, MAC address should be entered in the non-conical format. - All the entities including the LAN Emulation and IP-ATM clients are initially configured as disabled. Run CellView or edit the file /etc/atm/cvconf to enable and configure desired entities before rebooting the system. - Set "Enable Advanced Settings" in the "Global" dialog box in CellView to access LAN Emulation services from CellView. 8. Bug/missing features list - CellView 1. CellView may coredump and exit when a warning window comes up if the environment variable XMODIFIERS is set. If this happens unset XMODIFIERS and restart CellView. 2. Running CellView for longer periods of time may cuase memory leakage. If this happens close the CellView and restart it. - On certain systems, for example Compaq Desk Pro XL-5120 with BIOS revision older than 96.03.09, a soft reboot may cause scrolling screen with message "Warning: ia_proc_rcv_excpt: unknown exception 0". If this happens check with your system vendor for a latest BIOS.