TITLE: TF2112 - Point-to-Point Protocol(PPP) Upgrade README FOR: TF2112 PRODUCT AND VERION: UnixWare 2.01, UnixWare 2.02, and UnixWare 2.03. ************************************************************** *** *** IMPORTANT NOTICE: *** *** PTF2112 Conflicts with UnixWare Update 2.02 and 2.03 and MUST *** be removed from the system before the Update is installed! *** *** If this is NOT done, the kernel rebuild at the end of *** the Update will FAIL. To recover your system: *** *** 1) Remove UnixWare Update 2.02 or 2.03 *** 2) Remove PTF2112 *** 3) Install UnixWare Update 2.02 or 2.03 *** 4) Install PTF2112 *** ************************************************************** Abstract -------- This PTF is a replacement for PTF2038 with additional fixes for problems found with PTF2038. It is for installation on UnixWare 2.01, 2.02, and 2.03 systems. The features included in this PTF are: - Dynamic PPP address negotiation - CHAP authentication - Packet filtering - Proxy ARP support - IP address pooling Symptom -------- The PPP did not have the capability to: - Allocate/negotiate IP addresses - Authenticate using CHAP - Filter packets for PPP links - Create proxy ARP entries for PPP connections IP did not remove PPP routes when then PPP interface was brought down. IP addresses not freed properly when the interface was brought down. PPP deamon dies when connections are dropped. TCP mis-handles sequence numbers under extreme network load. Memory leak in the PPP Daemon. System hangs during heavy PPP usage, 25-50 connections. SOLUTION SPECIFICS ------------------ Installation Instructions: DATATYPE: datastream 1. Download the tf2112.Z and tf2112.txt files to the /tmp directory on your machine. 2. Read the release notes contained in this file and follow the instuctions to add the package to your system. 3. Now become root, uncompress the file and add the package to your system using the following commands: $ su # uncompress /tmp/tf2112.Z # pkgadd -d /tmp/tf2112 General Description. ------------------- The following features of PPP are implemented: - IP address pooling to assign IP addresses dynamically(server side) - Negotiate IP addresses - Create PPP interfaces dynamically - Authenticate using CHAP - Packet filtering - Ability to create Proxy ARP entries PPP deamon no longer dies when connections are dropped or terminated by the user. The memory leak was fixed by freeing allocated connection information during connection termination. The system hang was due to a race condition in the Stream I/O Driver caused by PPP re-allocating an already used minor number. New Features. ------------ Most of the items in the "General Description" are new. Software Notes and Recommendations. ---------------------------------- This PTF can ONLY installed on UnixWare 2.01, 2.02 and 2.03 systems which have the Internet Utilities (inet) package installed. If PTF2038 is installed, it MUST first be removed before PTF2112 can be installed. If installed on UnixWare 2.01 [2.02] system, PTF2112 must be removed from the system before UnixWare Update 2.02 [2.03] can be applied. If not removed, the Update kernel rebuild will FAIL. After UnixWare Update 2.02 [2.03] has successfully been installed, PTF2112 can be re-installed on the system. REMEMBER to save your configuration files before removing PTF2112 so that they can be restored following the re-installation of this PTF after UnixWare Update 2.02 [2.03]. It is highly recommended that PTF2117, the TTY Port Monitor Patch, be installed as well. The new configuration files are installed as: /etc/inet/ppphosts.samp /etc/inet/pppauth.samp /etc/inet/pppfilter.samp /etc/addrpool.samp Please copy these files into their current directory, /etc/inet or /etc, without the ".samp" extension. Please read the comment sections of the files /etc/inet/ppphosts.samp, /etc/inet/pppauth.samp, /etc/inet/pppfilter.samp, and /etc/addrpool.samp for the new format of these files. If your system is already configured to use PPP: - move and convert the information from the old /etc/inet/ppphosts.ptf2112 and /etc/inet/pppauth.ptf2112 files to the new ones. - PPP entries in /etc/confnet.d/inet/interface have been commented out by this PTF installation. These entries are no longer needed and must be converted to the new format and placed in the /etc/inet/ppphosts file instead. The following man pages are upgraded if the Traditional Manual Pages package, manpages, is present on the system: cu.1c cs.1m ppp.1m pppattach.1m pppconf.1m pppd.1m pppstat.1m pppfilter.4 pppauth.4 ppphosts.4 addrpool.4 asyhdlc.7 ipf.7 ppp.7 The following new Basic Networking Utilities man pages for UUCP are installed if the Traditional Manual Pages package, manpages, is present on the system: Config_uucp.4 Devconfig.4 Devices.4 Dialcodes.4 Dialers.4 Grades.4 Limits_uucp.4 Permissions.4 Poll.4 Sysfiles.4 Systems.4 Testing of the modified software contained in this package has been conducted only to the extent necessary to confirm that it resolves the problem(s) stated above ("Symptom"). Such testing consists of recreating the problem conditions and verifying that the problem no longer occurs. No other testing of this software has been done. Hardware Notes and Recommendations. ---------------------------------- This PTF is targeted for the i386, i486 and Pentium CPU's. Installation Instructions. ------------------------- If PTF2038 is installed, it must be removed from the system before this PTF can be installed. PTF2112 Conflicts with UnixWare Update 2.02 and 2.03, and it MUST be removed from the system before the Update is installed! If this is NOT done, the kernel rebuild at the end of the Update will FAIL. To recover your system: 1) Remove UnixWare Update 2.02 or 2.03 2) Remove PTF2112 3) Install UnixWare Update 2.02 or 2.03 4) Install PTF2112 PTF2112 includes PTF2214, TCP Driver Timeout Upgrade. Therefore, there is no need to install after PTF2112 has successfully been installed. If PTF2214 is currently on the system there is no need to remove before installing this PTF. For additional information on PTF2214 see its release notes.