********************************************************************** RSVP over IPv6 Service Provider for Windows NT and 2000 ------------------------------------------------------- Last revision: ver 0.9 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 http://www.dit.upm.es/bti Copyright (c) DIT-UPM, 2000 ********************************************************************** Contents: 1 - Introduction 2 - Requirenments 3 - Files 4 - Installation 5 - Uninstallation 6 - RSVP Daemon Service Operation 7 - Troubleshooting 8 - Other related documents 9 - Acknowledgements and Copyrights 1 - Introduction ---------------- RSVP over IPv6 Service Provider for Windows NT and 2000 is part of the joint development/integration effort made by DIT-UPM and IT-UC3M in ACTS BTI project (www.dit.upm.es/bti). It is a winsock2 based RSVP over IPv6 implementation with the following features: - Access to RSVP services through a standard Winsock2 native RSVP interface, as described in Winsock2 documentation ("Protocol Specific Annex number 10 (Revision 2.0.3, May 10, 1996)"). It uses a slightly modified version of the ws2rsvp.h header file distributed by Intel in their PC-RSVP package. - IPv6 support. (No IPv4 support is provided by now). - Full Traffic Control implementation for ATM subnetworks, supporting IntServ's Controlled Load Reservations with FF and SE styles. - Host implementation (Not tested as a router). - RSVP over native IPv6 (No UDP encapsulation) RSVP over IPv6 Service Provider is based on the well-known ISI's RSVP implementation for UNIX operating system (see www.isi.edu/rsvp), which has been migrated to Windows NT and adapted to offer a winsock2 interface and to interact with a modified version of Microsoft's Research IPv6 stack. The distribution includes: - An RSVP daemon program (Windows Service Executable) - A Standard Winsock2 application interface dll - Two test programs (one with sources) for testing the RSVP functionality. 2 - Requirements ---------------- RSVP over IPv6 implementation requires and/or has been tested over PCs with: - Windows NT 4.0 Workstation with Service Pack 4 or higher, or Windows 2000 Professional or Server. - DIT-UPM modified version of Microsoft Research's IPv6 protocol stack. (MSR-IPv6 v1.4-d0). In addition, to use IPv6 over ATM with RSVP traffic control support you need: - An ATM card (preferible a Forerunner LE card, either 25 Mbps or 155 Mbps) installed with drivers and Winsock2 SPI. - IPv6/ATM Adaptation Module (PATAM driver) developed by DIT-UPM. 3 - Files ---------- The RSVP/IPv6 package includes: - RSVP daemon (Service executable file): rsv.exe - Winsock2 Service Provider DLL: rsvpipv6.dll - Winsock2 Service Provider registration program: regrsvp.exe - Header files for applications: rsvpipv6.h, ws2rsvp.h - Test programs: test3.exe (cmd line) rsvptest.exe (graphic) - (Simple) Installation script: install.bat 4 - Installation ---------------- Using install script: --------------------- To install RSVP over IPv6 package you just have to open a DOS window and type, for example: c:\>install c:\bin Installation script just copies binaries to Windows directories, utilities to the directory specified as parameter (c:\bin, in the example), registers the RSVP service provider in Winsock2 and installs the RSVP daemon as a windows service to be started automatically. (Have a look at the script; it is really simple). After installing the package for the first time, you have to start the daemon manually (next time windows starts it will be launched automatically). Just go to the "Control Panel", option "Services" and start the service named "RSVP over IPv6 Service". By default, the daemon writes traces to "c:\temp" directory. If that directory does not exist, the daemon will not work. See daemon parameters below to change the default directory. Manual installation: -------------------- RSVP over IPv6 package can also be installed manually. To do it, you have to: A. Install the WinSock2 RSVP Service Provider B. Install the RSVP daemon Windows Service A. ** To install the WinSock2 RSVP/IPv6 Service Provider: ** A.1 - Copy the file rsvpipv6.dll to windows' system32 directory (ex. C:\winnt\system32\). A.2 - Copy the installation program regrsvp.exe to any directory (may not be the same as the preceding one) and from a DOS window in that directory type: > regrsvp install Where is the complete path where the rsvpipv6.dll is (ex. 'C:\winnt\system32\rsvpipv6.dll'). If the directory where rsvpipv6.dll has been copied is included in the PATH, may be replaced just by 'rsvpipv6.dll', or even omitted. B. ** To install the RSVP/IPv6 Windows Service: ** B.1 - Copy the Service Executable (rsv.exe) to windows' system32 directory (ex. C:\winnt\system32\). B.2 - From a DOS window in system32 directory type: > rsv -install Important Notes: 1 - Always uninstall an existing RSVP/IPv6 Service before installing a new version. 2 - The installation of IPv6 stack and (optionally) PATAM drivers should be done before installation of any RSVP Winsock2 Service Provider (DIT-UPM's one or any other) in order to avoid conflicts. 5 - Uninstallation ------------------ In order to uninstall RSVP over IPv6 package, you have to: A. Uninstalling the WinSock2 Service Provider B. Removing the Windows Service A. ** To uninstall the Winsock2 RSVP/IPv6 Service Provider: ** Copy the installation program regrsvp.exe (if not available yet) to any directory and from a DOS window, type: > regrsvp uninstall B. ** To remove the Winsock2 RSVP/IPv6 Windows Service: ** From a DOS window in windows' system32 directory type: > rsv -remove 6 - RSVP Daemon Service Operation --------------------------------- As mentioned, after installing the RSVP/IPv6 Service, it can be started following the normal steps to start a Windows daemon: go to "Control Panel->Services" and select the Service line named "RSVP over IPv6 Service" and start it. If necessary, some parameters can be introduced in the 'Startup Parameters' dialog box before starting the service. The parameters that can be introduced are (most of them come from ISI's RSVP daemon, so have a look at their manual pages): -D # Start in Debug mode -d debug_bits # Specify debug bits (see ISI's RSVP daemon manual) -l debug_level # Specify debug levels -t mstat_ttl # TTL for multicasting status info. -R router # Name/address of RSVP router to receive encapsulated # paths -i local_v6 # Force the default local IPv6 interface -a 0|1 # Router alert option: no(0), yes(1) ?: Help -logf [complete path of log file] # Default is c:/temp/rsvpd.log -plogf [complete path of prev. log file] # Default is c:/temp/rsvpd.log.prev -dlogf [complete path of debug log file] # Default is c:/temp/rsvpd_debug.log Options available only in debug versions: -s # max_msg_size -x # Test mode -r # default_refresh_time_in_ms Note: ----- When specifying directory names in the 'Startup Parameters' dialog box (for example, to specify the name of a log file) do not use backslashes. Instead, use double backslashes, or slashes. Examples: -logf c:\temp\logfile WRONG -logf c:\\temp\\logfile OK -logf c:/temp/logfile OK The directory in which the logfile is going to be created must exist beforehand. RSVP daemon can also be executed as a console application. To do it, from a DOS window type: > rsv -debug 7 - Troubleshooting ------------------- For an application to use the RSVP/IPv6 service provider: - The daemon must be running (either in the Service or in the console mode with Administrator rights), before any application opens an RSVP socket. If not started, you will get a WSASYSNOTREADY error. - If the RSVP daemon stops and it is restarted, all applications using RSVP/IPv6 Service Provider must be restarted in order to make use of the Provider again. - If RSVP/IPv6 over ATM Traffic Control functionallity is required, PATAM driver must be running. 8 - Other related documents --------------------------- readme_rsvpipv6_API.txt: Describes the special considerations to be aware of for application programmers using the Winsock2 API of DIT-UPM's RSVP Service Provider. 9 - Acknowledgements and Copyrights ----------------------------------- RSVP over IPv6 package is made of two main parts: - RSVP Winsock2 Service Provider DLL, which is a library that converts from ISI's native RAPI interface to winsock2 RSVP API. It has been written from scratch by DIT-UPM. - RSVP daemon, which has been adapted to Windows NT from the daemon developed by the University of Southern California, Information Sciences Institute (specifically, Version 4.2a4 of ISI).