TECHNICAL INFORMATION DOCUMENT TITLE: TF2094 - TCP/IP Recovery DATE: 01SEP95 README FOR: TF2094 PRODUCT and VERSION: UnixWare 2.01 Installation Instructions: DATATYPE: datastream 1. Download the tf2094.Z and tf2094.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/tf2094.Z # pkgadd -d /tmp/tf2094 ENGINEERING REALEASE NOTES -------------------------- Title ----- PTF2094 - TCP/IP Recovery Product And Version -------------------- UnixWare 2.01, UnixWare 2.02 Abstract -------- During the post-reboot phase of UnixWare 2.01 installation, if the user shuts down the system at any time after the inet menu, TCP/IP-related system files may be truncated and TCP/IP-related drivers may be lost. Symptom -------- During UnixWare 2.01 post-reboot installation, if the user shuts down the system at some point after the inet menu (for example, after entering the wrong mouse type on the mouse menu), when the system reboots, it continues the post-reboot phase starting with the inet menus. The user will see an error, but the installation will continue and complete. TCP/IP-related system files are zero length and TCP/IP-related drivers are missing. At this point, networking still works since the kernel was built before the files were corrupted. When the next idbuild is performed on the system, the kernel will build successfully, but networking will not work. SOLUTION SPECIFICS ------------------ A script that is run in the package postinstall checks all the (possibly) affected files and drivers. Any file that is truncated or driver that is missing is replaced with a correct version of the file/driver. If any file or driver was replaced, the kernel is rebuilt. The TCP/IP-related system files which may be affected are in /etc/conf/sdevice.d, /etc/conf/mdevice.d, and /etc/conf/dtune.d. The files are: app, arp, asyh, icmp, inet, ip, llcloop, ppp, rawip, route, slip, tcp, udp. Directories by the same name are in /etc/conf/pack.d, and contain the associated Driver_atup.o and Driver_mp.o files. General Description. ------------------- During the post-reboot phase of UnixWare 2.01 installation, if after the inet menu the user shuts down the system and then proceeds with the post-reboot, TCP/IP-related system files may be truncated, and TCP/IP-related drivers may be lost. If any files were truncated or drivers lost, the next idbuild yields a kernel for which networking is unusable. This package runs a postinstall script which, among other things, checks each of the relevant system files, as well as the drivers. If a file was truncated or driver lost, it is replaced. If any files were replaced, the kernel is rebuilt. New Features. ------------ None Software Notes and Recommendations. ---------------------------------- This PTF can be installed on UnixWare 2.01 or 2.02 systems. If the fix is installed on UnixWare 2.01, thereby replacing the affected files, the fix does NOT need to be re-installed when the system is upgraded to UnixWare 2.02. However, if files were corrupted during UnixWare 2.01 installation, and the fix is NOT installed on UnixWare 2.01, the very next idbuild performed on this system may happen to be during the update installation of UnixWare 2.02. If this is the case, then the fix will need to be installed on UnixWare 2.02. This is the only scenario for which the fix is needed on UnixWare 2.02. A UnixWare 2.02 installation will not INITIATE the problem, but may carry the problem which would have originated in a prior installation of an earlier UnixWare 2.0X release. It is preferable to install the fix on UnixWare 2.01, prior to the upgrade to UnixWare 2.02, so that the UnixWare 2.02 installation begins cleanly. 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 test 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.