PCI/ATM 5515/5575 ID1 driver for AIX version 4.1.2/4.1.4 18 September 1997 Driver revision / date ---------------------- Version SX00181-C01 / 18 September 1997 Latest Revisions ---------------- Latest versions of this driver and documentation will be made available on Interphase's ftp server. Contact Interphase for details of location. Operating system revision(s) supported -------------------------------------- AIX 4.1.2 and 4.1.4 Hardware compatibility ---------------------- Host: Tested in IBM PowerPC 601 system model 40P, IBM PowerPC 604e system 43P-240 (dual-processor), and Motorola PowerStack 604. Functions supported ------------------- Client and Services functions for LAN Emulation and RFC1577. Installation and Configuration ------------------------------ NOTE: If you are installing from a CD then skip these 2 steps and proceed with the SMIT instructions below. 1. Create a temporary directory to hold the driver and utility files. 2. Extract the following files from the media (file or tarfile on diskette), using "tar -xvf /dev/rfd0" or "tar -xvf tarfile": README devices.ip5515x.4.1.4.0 The driver software can be installed through SMIT as follows: 1. As superuser execute SMIT 2. Select: Software Installation and Maintenance 3. Select: Install and Update Software 4. Select: Install/Update Selectable Software 5. Select: Install Additional Device Software 6. Enter the directory path and the device file name. For example if you placed devices.ip5515x.4.1.4.0 in directory "/devdir", enter "/devdir" 7. Select: Do 8. Select: SOFTWARE to install List Box 9. Select: 4.1.4.0 devices.ip5515x ALL@@devices.ip5515x 10. Select: OK 11. Select: Do 12. Select: OK from the "Are you Sure" Dialog Box 13. Select: Done 14. Select: Return to: System Management 15. Select: Devices 16. Select: Install/Configure Devices Added After IPL 17. Select: Do 18. Exit SMIT This will distribute the files packaged in the devices.pci* file and populate the ODM database. It does not change the contents of this temporary directory. After installation, the driver must be configured. Determine the IP address of the ATM adapter. Note that if there are other IP nodes on the host system (e.g. an Ethernet interface), the IP address used for each ATM interface must be in a totally separate network segment. If the same segment as the Ethernet is used (for example), then routing and broadcast problems will occur as the network layer will assume that both devices are physically on the same segment. The current driver allows four LAN Emulation (LANE) clients and one RFC1577 client per board and allows up to eight boards per system. The interface numbers are allocated such that interfaces 0-3 (li0 - li3) are the LANE clients for board zero, interfaces 4-7 are the LANE clients for board one, up through interfaces 28-31, which are the LANE clients for board seven. The RFC1577 clients are allocated as li32 through li39, li32 being the client for board 0, li33 for board 1, through li39 for board 7. To configure the initial li0 driver interface through SMIT 1. Select: Devices/Communication/Interphase 5515/5575 ATM Adapter 2. Select: Interphase 5515/5575 ATM Interface 3. Select: Change/Show Interphase 5515/5575 ATM Interface Parameters 4. Select li0 5. Enter your HostName, Internet Address and your Network MASK in the appropriate fields. 6. Verify that Interface Status is set to "up" 7. Select: Do 8. Exit SMIT To manually configure the driver do the following as superuser: 1. Create the file /etc/atm/hostname.liX, where X is the client number. This file should contain one line, which is the IP address that the client will use. This may be either a dotted-decimal address or a symbolic address. This address will be assigned to the interface that the client uses. For example, if the file /etc/atm/hostname.li0 contains the IP address 1.2.3.4, then LANE client 0 will be assigned that IP address on the interface li0. 2. Execute /etc/atm/leconfig. 3. Execute /etc/atm/start_signald & Installation Verification ------------------------- To manually verify that the driver is installed and operational, use lsdev -C which should show the device ia0 (hardware driver) in the ODM database. Confirm the configuration with ifconfig li0 which should show the driver as UP with the correct address, netmask and MTU. Confirm that a specific client is enabled with ledbg. For example to verify that the client defined in cvconf is enabled: ledbg -a0 -u0 Note that results may be misleading if signald is not running. Verify signald is running as follows: ps -e | grep signald De-configuration and deinstallation ------------------------------------ To de-configure and deinstall the interface 1. As superuser execute SMIT 2. Select: Devices/Communication/Interphase 5515/5575 ATM Adapter 3. Select: Interphase 5515/5575 ATM Adapter 4. Select: Remove an Interphase 5515/5575 ATM Adapter 5. Select: ia0 6. Select: Done 7. Select: Return to: System Management 8. Select: Software Installation and Maintenance 9. Select: Maintain Installed Software 10. Select: Remove Software Products 11. Select: Software name List Box 12. Select: devices.ip5515x.rte 13. Select: OK 14. Select: "no" for PREVIEW only 15. Select: Do 16. Select: OK in the "Are You Sure" Dialog box 17. Exit SMIT 18. Reboot the system. This will remove the software package from the system, but does not delete the contents of the temporary installation directory. Re-installation is possible through SMIT. Changing the Framing Type: -------------------------- To change the framing type from the default: SONET to STM-1 do the following: 1. As superuser execute SMIT 2. Select: Devices 3. Select: Communication 4. Select: Interphase 5515/5575 ATM Adapter 5. Select: Adapter 6. Select: Change/Show Characteristics of an Interphase ATM Adapter 7. Select: ia0 8. Select: Framing Type List Box 9. Select the appropriate framing type from the list. 10. Select: Do 11. Exit SMIT Known Deficiencies and Limitations ---------------------------------- Setting up Additional Clients ----------------------------- The Interphase 5515/5575 ATM SVC/LANE driver allows 4 LANE clients per adapter. LANE clients are identified by a number between 0 and 31, since there is a limit of 8 boards per system. Clients 0-3 are for board 0, clients 4-7 are for board 1, etc. To enable a LANE client through SMIT, the following steps should be performed: 1. As superuser execute SMIT 2. Select: Devices/Communication/Interphase 5515/5575 ATM Adapter 3. Select: Interphase 5515/5575 ATM Services 4. Select: Change/Show Interphase ATM LEC Parameters 5. Select: Adapter/Board Number and LEC number 6. Verify or change LEC parameters as necessary. 7. Select: Return to Devices/Communication/Interphase 5515/5575 ATM Adapter 8. Select: Interphase 5515/5575 ATM Interface 9. Select: Add an Interphase 5515/5575 ATM Interface 10. Select from available interfaces 11. Verify or change network interface parameters as necessary. 12. Select appropriate value in "Set Interface Status" box 13. Select: Do 14. Exit SMIT To disable a LANE client through SMIT, the following steps should be performed: 1. As superuser execute SMIT 2. Select: Devices/Communication/Interphase 5515/5575 ATM Adapter 3. Select: Interphase 5515/5575 ATM Interface 4. Select: Change/Show an Interphase 5515/5575 ATM Interface 5. Select from available interfaces 6. Select "down" in the "Set Interface Status" box 7. Select: Do 8. Exit SMIT To remove a LANE client through SMIT, the following steps should be performed: 1. As superuser execute SMIT 2. Select: Devices/Communication/Interphase 5515/5575 ATM Adapter 3. Select: Interphase 5515/5575 ATM Interface 4. Select: Remove an Interphase 5515/5575 ATM Interface 5. Select from available interfaces 6. Select: Do 7. Exit SMIT To enable a LANE client manually, the following steps should be performed: 1. Edit the file /etc/atm/cvconf. In this file, select the Maximum Frame Size for the client. This is done by setting the maxframesz line to a number between 1 and 3, where 1 is a 1516 byte frame, 2 is a 4544 byte frame, and 3 is a 9234 byte frame. Note that all clients on an Emulated LAN must have the same frame size. See the cvconf man page for more information on the fields in this file. 2. Create the file /etc/atm/hostname.liX, where X is the client number. This file should contain one line, which is the IP address that the client will use. This may be either a dotted-decimal address or a symbolic address. This address will be assigned to the interface that the client uses. For example, if the file /etc/atm/hostname.li1 contains the IP address 1.2.3.4, then LANE client 1 will be assigned that IP address on the interface li1. 3. Reboot the system. This will cause the LANE configuration script /etc/atm/leconfig to be run, which will enable the LANE clients specified by the /etc/atm/cvconf file and the corresponding /etc/atm/hostname.li? files. Cellview or SMIT may be used to perform the following functions: --------------------------------------------------------------- Setup or reconfigure PVC's on LANE clients Setup LANE Servers Setup LANE Configuration Servers Enable/disable LECS Enable/disable RFC-1577 Clients (and Servers if configured as a server) Setup PVCs on RFC-1577 Setting up PVCs on LANE Clients ------------------------------- To setup or reconfigure PVC's on LANE clients through SMIT, the following steps should be performed: 1. As superuser execute SMIT 2. Select: Devices/Communication/Interphase 5515/5575 ATM Adapter 3. Select: Interphase 5515/5575 ATM Services 4. Select: Interphase ATM LEC PVC Configuration 5. Select: List, Change/Show, Add, or Remove Menu option 6. Select appropriate Adapter/Board Number and LEC Number if requested 7. Verify parameters in resulting dialog panel and change as necessary 8. Exit SMIT 9. New settings will take effect following next machine reboot.??? Setting up LANE Servers ----------------------- To enable/disable LES through SMIT, the following steps should be performed: 1. As superuser execute SMIT 2. Select: Devices/Communication/Interphase 5515/5575 ATM Adapter 3. Select: Interphase 5515/5575 ATM Services 4. Select: Change/Show Interphase 5515/5575 ATM LES Parameters 5. Select appropriate Adapter/Board Number and LES Number 6. Verify parameters in resulting dialog panel and change as necessary 7. Set "Enable" option to appropriate value. 8. Select: Do 9. Exit SMIT 10. New settings will take effect following next machine reboot. Setting up LANE Configuration Servers ------------------------------------- To enable/disable LECS through SMIT, the following steps should be performed: 1. As superuser execute SMIT 2. Select: Devices/Communication/Interphase 5515/5575 ATM Adapter 3. Select: Interphase 5515/5575 ATM Services 4. Select: Change/Show Interphase 5515/5575 ATM LECS Parameters 5. Select appropriate Adapter/Board number. 6. Verify parameters in resulting dialog panel and change as necessary 7. Select appropriate value from "Enable LECS" option to enable or disable. 8. Select: Do 9. Exit SMIT 10. New settings will take effect following next machine reboot. Setting up RFC-1577 Clients --------------------------- To enable/disable RFC-1577 Clients (and Servers if configured as a server) through SMIT, the following steps should be performed: 1. As superuser execute SMIT 2. Select: Devices/Communication/Interphase 5515/5575 ATM Adapter 3. Select: Interphase 5515/5575 ATM Services 4. Select: Change/Show Interphase 5515/5575 ATM 1577 Parameters 5. Select appropriate Adapter/Board number. 6. Verify parameters in resulting dialog panel and change as necessary 7. Select appropriate value from "Enable 1577" option to enable or disable. 8. Select: Do 9. Exit SMIT 10. New settings will take effect following next machine reboot. Setting up PVCs on RFC-1577 --------------------------- To setup or reconfigure PVC's on LANE clients, the following steps should be performed: 1. As superuser execute SMIT 2. Select: Devices/Communication/Interphase 5515/5575 ATM Adapter 3. Select: Interphase 5515/5575 ATM Services 4. Select: Interphase ATM 1577 PVC Configuration 5. Select: List, Change/Show, Add, or Remove Menu option 6. Select appropriate Adapter/Board Number if requested 7. Verify parameters in resulting dialog panel and change as necessary 8. Exit SMIT 9. New settings will take effect following next machine reboot. Message Logging --------------- Messages from the signald are logged to a file named /var/adm/signald.log. If problems are encountered setting up LAN Emulation Clients, this file should be consulted. Status and error messages are also printed to the system console. To view these messages while running the Common Desktop Environment, run the program /usr/bin/X11/aixconsole. Fix History ----------- C00-RC07 - 4/21/1997 - added code to fix 1577 initialization problem. C00-RC08 - 4/24/1997 - fixed problem when dropping packets with no demux filter; added delay in DAI request to give AIX time to expand pools. C00-RC09 - 4/30/1997 - fixed netmask retention when configuring interfaces through SMIT; added interface number explanation to README; fixed slow PVC problem. C00-RC10 - 5/06/1997 - fixed LLC/SNAP encapsulation problem for bridged PVCs. C01-RC01 - 8/06/1997 - added 5575 support. C01-RC02 - 8/11/1997 - fixed mbuf allocation problem. C01-RC03 - 8/15/1997 - fixed SMP problems and mbuf depletion problems. C01-RC04 - 9/03/1997 - fixed problem with token-ring framed PVCs