********************************************************************** PATAM: IPv6 over ATM Adaptation Module for Windows NT ----------------------------------------------------- Last revision: ver 0.9 alpha / March 29th, 2000 Developed by: Telematics Engineering Department (DIT-UPM) Technical University of Madrid http://www.dit.upm.es Area of Telematics Engineering (IT-UC3M) Carlos III University of Madrid http://www.it.uc3m.es See more information in: WWW: www.dit.upm.es/bti E-mail: bti@dit.upm.es Copyright (c) DIT-UPM, 2000 ********************************************************************** Contents: --------- 1 - Introduction 2 - System Requirements 3 - Installing PATAM driver 4 - Uninstalling PATAM driver 5 - Configuring PATAM driver 6 - InfoPATAM Application 7 - Troubleshooting 8 - Release notes APPENDIX A: Installation of ForeRunnerLE ATM card drivers APPENDIX B: Telebit Router Configuration as a MARS server 1 - Introduction ---------------- PATAM is an iPv6 over ATm Adaptaptation Module for windows NT developped and integrated by DIT-UPM (www.dit.upm.es) and IT-UC3M (www.it.uc3m.es) as part of their contribution to Broadband Trial Integration (BTI) ACTS project. PATAM is a user-mode multithreaded driver that implements all the necessary functions to carry IPv6 packets over ATM networks using dynamic circuits (SVCs) and with full multicast support. PATAM implements IPv6 over ATM support according to [RFC2491] ("IPv6 over NBMA networks") and [RFC 2492] ("IPv6 over ATM networks"), including IPv6 multicast support by means of MARS client functionality according to RFC2022] ("Support for Multicast over ATM networks"). PATAM driver works with a modified version of Microsofts Research's IPv6 stack. Basically the stack has been modified to include a pseudo ATM network interface to access PATAM driver. The communication between IPv6 stack and PATAM driver is made using the "Microsoft Research Proxy driver kit" developed by Galen C. Hunt. (see http://research.microsoft.com/users/galenh/proxy). MARS client functionality of PATAM driver has been based on NIST's MARS implementation for LINUX operating system (see http://snad.ncsl.nist.gov/~hendaz/NIST-MARS). 2 - System Requirements ----------------------- PATAM driver works over standard PCs with: * Windows NT 4.0 and Service Pack 4.0 or higher installed (you can check out the service pack version you have in the blue screen showed at startup). * ForeRunnerLE ATM card (either 25 Mbps or 155 Mbs) installed with drivers and Winsock2 native SPI (PATAM driver uses winsock2 native ATM socket interface). IMPORTANT: PATAM has been tested and used with version 5.0.2(43015) of FORE drivers. Other versions (older and newer) have been tested but some problems have been detected. To avoid problems we recomend to use version 5.0.2 (43015). See more details about FORE cards installation in Appendix A. * Microsoft Research's IPv6 v1.4 stack modified by DIT-UPM (v14-d0), included in PATAM protocol stack distribution. * RSVP over IPv6 Service Provider by DIT-UPM, also distributed with PATAM protocol stack. * An IPv6 router implementing MARS server functionallity. PATAM has been developped and tested with ERICSSON-TELEBIT routers (www.tbit.dk) PATAM driver does not work on Windows 2000 (do not test it; it crashes the machine). Migration to Windows 2000 is underway. 3 - Installing PATAM driver --------------------------- After installing ATM card and drivers (see APPENDIX A), you can install PATAM driver by unzipping the "patam-v09.zip" file to a temporary directory and follow the procedure bellow. Please, read the complete procedure before you try it. All installation must be done from an account with administrator priviledges. 3.1 - Install MSR-IPv6 v1.4-d0 stack in your machine from the IPv6kit-v14-d0 ditribution package following the MSR-IPv6 installation guide included (in readme.htm file). IMPORTANT: If you have previously installed any other version of MSR-IPv6 you have to completely desinstall it before installing this new version. It is also recomended to uninstall any RSVP protocol (from Intel or from PATAM distribution) to avoid conflics. 2.2 - Edit "patam.reg" file and change the ATM addresses (your own and MARS server) to the correct ones. Once modified, double click on "patam.reg" to save the information on Windows Registry. IMPORTANT!!: to avoid problems, the ATM selector (last byte of the ATM address) used should different from "00", which is the selector used by default by FORE IPv4 CLIP driver. Choose "05", for example. Check that the information has been successfully copied to the registry by running regedit.exe and checking the variables set at: HKEY_LOCAL_MACHINE\SOFTWARE\BTI\PATAM (Alternatively, you can check that information in the traces sent to DebugView when PATAM starts). 2.3 - Run the install.bat script. It copies some files to windows directory and registers the drivers in the system. NOTE: you must run install.bat script from the directory where you have unzipped the distribution (that is, "cd" to that directory and then run install.bat). Alternatevely, you can just double click on it from Explorer. 2.4 - Restart the system for the changes to take effect. 2.5 - Start PATAM driver by clicking on the PATAM Desktop icon or by typing the following from the command line: c:\> \winnt\system32\drivers\prx_srv -console 4 - Uninstalling PATAM driver ----------------------------- To uninstall PATAM driver, just run the uninstall.bat script on the distribution script. 5 - Configuring PATAM driver ---------------------------- By now, there are only four configuration parameters located in windows registry under the HKEY_LOCAL_MACHINE\SOFTWARE\BTI\PATAM: + "AtmEnable": Enables/Disables ATM interface (1 = Enabled; 0 = Disabled) + "LocalAtmAddress": is the ATM address (including selector) where PATAM will listen. IMPORTANT: The selector should be different from 0 to avoid conflicts with IPv4 driver. + "MarsServerAtmAddress": MARS Server Atm address including selector. + "DebugVerbosity": Debug trace level (DEBUG3=5, DEBUG2=4, DEBUG1=3, INFO=2, WARN=1, ERROR=0, FATAL=-1) All the parameters but DebugVerbosity are read at startup, so, if you change anything, you should restart the machine for the changes to take effect. To change DebugVerbosity of PATAM driver you just have to restart PATAM (not windows). 6 - InfoPATAM Application ------------------------- InfoPATAM is a helper control application that shows information and statistics about PATAM active ATM circuits. In particular, it shows: + Best Effort flows, + Input and output Controled Load flows, and + ATM Sockets database, showing point to point and multipoint circuits info. It is also possible to config some PATAM parameters from InfoPATAM application. By now, the debug traces level (DebugVerbosity parameter) can be changed dinamically from InfoPATAM. To run InfoPATAM, just double click on it once PATAM is running. IMPORTANT: do not start InfoPATAM till the driver is running. It could crash the driver. Wait until you see some messages in the small window showed when PATAM is started. 7 - Troubleshooting ------------------- The basic source of information to solve problems are the traces generated by PATAM driver. To see the debug traces you have to: * Install and start some program to see standard Windows debugger traces. For example, you can use DebugView program. It is located under the utils directory of PATAM distribution directory. Just unzip the dbgvnt.zip and execute the Dbgview.exe program. * Change the "DebugVerbosity" parameter in the registry to 3, 4 or 5 depending on the debugging level required. In case of troble, save the traces generated and send them to us to analize the problem (bti@dit.upm.es). 8 - Release Notes ----------------- Changes from version 0.8 to 0.9: - Migration from MSR-IPv6 1.3 to 1.4 Changes from version 0.7 to 0.8: - Some bugs related to multipoint ATM circuits corrected Changes from version 0.6 to 0.7: - New Parameter added to registry (MinimumPCR) to limit the minimum Peak Cell Rate of CBR circuits. It must be set to 13 in 25 Mbps cards and to 73 in 155 Mbps cards to avoid the bug in FORE's drivers when establishing low bandwith CBR circuits. - New debug levels added - Some bugs related with multicast BE circuits corrected Changes from version 0.5 to 0.6: - Revalidation of multicast circuits in MARS client - Reliability of traffic control module improved - VPI/VCI and cellrate added to InfoPATAM Changes from version 0.4 to 0.5: - Corrected a bug that prevented multicast to work through the router (Multicast ATM leafs directed to the routed were not accepted due to an ATM parameter problem) - Traffic statistics added to InfoPATAM Changes from version 0.3 to 0.4: - Some bugs that caused the driver to crash under heavy traffic have been corrected. - InfoPATAM application included. APPENDIX A: Installation of ForeRunnerLE ATM card drivers --------------------------------------------------------- To install ForeRunnerLE ATM card you have to get version 5.0.2(43015) of FORE drivers either from FORE ftp server or from www.dit.upm.es/bti/fore. Once you have the drivers files: 1 - ATM card Drivers Install the card drivers (in pc-nt_i386_5.0.2_43015.zip file) following the steps in the card manual. You have to install first the adapter driver ("ForeRunner (PCI) ATM Adapter") and second the CLIP over ATM driver ("ForeRunnerLE IP Over ATM Adapter"). After installation, you can check that the card is correctly installed by having a look at the information showed in the "InFOREmation center" (in Windows Control Panel), or by defining, for example, an IPv4 PVC with the router or other PC and test the IPv4 connectivity. If your ATM switch provides ILMI support you can activate ILMI to allow the cards autoconfigure their own ATM address from the switch. If ILMI is not supported, you have to configure the ATM address by hand. ILMI and ATM addresses can be configured from the "ForeRunner (PCI) ATM Adapter" properties window. IMPORTANT: If the card is connected to the BTI access network, you must configure the "Rate Shapping" parameter in "ForeRunner (PCI) ATM Adapter" properties window (go to "Control Panel|Network|Adapters"). to the appropiate value. 2 - FORE ATM sockets Service Provider Install FORE ATM sockets Service provider (in pc-spi_5.0.2_43015.zip file). Just unzip the file, execute the Setup program and follow the instructions. The installation creates a file on WINNT directory named ATMHOSTS. You should modify this file to include the addresses in your network (see the format of entries in the example created after the installation). Do not forget to Include a "localhost" entry with the local ATM address. Although ATMHOSTS file is not used directly by PATAM driver, it is used by some of the test programs mentioned below. To test that the FORE ATM Service Provider has been properly installed you can use SPORDER.EXE application of Winsock2 SDK. It shows all the service providers installed under WInsock2. You should see a line saying "ATM Protocol Provider: FORE Systems, Inc." in the list of Service Providers. 3 - ATM Switch configuration Configure (if not using ILMI) the ATM routes in your ATM switch, in order to be able to stablish SVCs between PCs and the router. 4 - Final Test Use the connect.exe and accept.exe applications to make a test connection. For example, to maek a test loopback connection: * Start two DOS windows * Start the receiving program in one of the windows by typing: C:\> accept 09 You should see two lines saying: Winsock2.0 DLL started... [39.01.02.03.04.05.06.07.08.09.0a.0b.0c.00.20.48.0e.aa.7b.09] the second line is the ATM address asigned to your card + the selector byte given in the commeand line. * Start the transmitting program in the other window by typing: C:\> connect localhost 09 1 1 1 1 1000 be After doing that, you should see several lines in both windows indicating the sending and reception of data. Ignore the last line showed by accept.exe program saying "Error Receiving data : 10054". It is caused by the close of the connection. APPENDIX B: Telebit Router Configuration as a MARS server --------------------------------------------------------- Telebit router (or any other router) should be correctly configured as a MARS server for PATAM driver to work. Below you can read the Telebit's configuration used at DIT-UPM for the development of PATAM (only related lines included; deleted lines marked with "..."): # Complete configuration dump of # Dump is produced at 1999-08-01 19:02:35 from ta profile define basic 19990601beta atm router atm nexthop 39.0102.0304.0506.0708.090a.0b -ntc 4:0/5 atm nexthop 39.0102.0304.0506.0708.090a.0b0c.0020.4806.6196.00 atm nexthop 47.0083 -ntc 4:0/5 ... interface Serial 3 encapsulation atm -rcv-interrupt-freq 1 -max-no-users 10 atm traffic -rate 80000 atm traffic -rate 4716 atm traffic -rate 11792 interface Cells 4 ntc ntc atm -hecerror-correction 1 ntc line -transmit-clock 1 start ntc atm pvc -alc 3:5 -ntc 4:0/5 atm signal atmresolv enable atmresolv enable mars2 39.0102.0304.0506.0708.090a.0b0c.0020.4806.6196.00 ... ip enable 3 interface Serial 3 use encapsulation atm ... ip access lis.upm.v6 -local 3ffe:3328:4:1::2 -send-router-advert 1 ip atmlis -ownaddr 39.0102.0304.0506.0708.090a.0b0c.0020.4806.6196.01 \ -atmarp 39.0102.0304.0506.0708.090a.0b0c.0020.4806.6196.00 \ -mars 39.0102.0304.0506.0708.090a.0b0c.0020.4806.6196.00 -mars-relay 1 ...