TECHNICAL INFORMATION DOCUMENT TITLE: NIC203 - UnixWare 2.03 NIC drivers DATE: 06DEC95 README FOR: NIC203 PRODUCT and VERSION: UnixWare 2.01 Installation Instructions: DATATYPE: datastream 1. Download the nic203 and nic203.txt files to the /tmp directory on your machine. 2. Read the release notes contained in the Engineering Release Notes below and follow the instuctions to add the package to your system. ENGINEERING RELEASE NOTES ------------------------- 1. Introduction These notes describe the 2.03 Network Interface Card Support (NICS) Package for the following Novell (R) UnixWare (R) products: UnixWare Personal Edition (TM) and UnixWare Application Server (TM). The 2.03 NICS package is cumulative. It contains quality improvements for UnixWare 2.01 and 2.02 NICS drivers as well as the drivers, features, and quality improvements provided in the 2.02 NICS package. For the convenience of the readers who have installed the 2.02 NICS package, the quality improvements provided in the 2.03 package are presented first. The 2.02 release notes are included as an appendix. Prior to installing the NICS package, you should be familiar with these release notes. 2. Before You Install the 2.03 NICS Package 2.1 UnixWare Versions The 2.03 NICS package is intended for use on systems running UnixWare 2.03. 2.2 Incompatible Program Temporary Fixes (ptfs) You may have ptfs installed on your system that must be removed prior to the installation of this package. Please acquire a copy of the release notes for each ptf you have installed to verify that each is compatible the 2.03 NICS package. The section entitled ``Program Temporary Fixes (ptfs)'' contains information on ptfs being installed with this package. 2.3 Special Instructions for Installing the NICS Package Prior to installing the NICS package, you should reboot your system and bring it up in single user mode. Installing at init levels other than single user could result in collisions between NICs drivers which will cause the system to hang. You should not attempt to take your system down to init level 2 or 3 to install. A reboot into single user mode is required. Follow these steps to reboot and bring your system up in single user mode. 1. Edit /etc/inittab. Modify the line that reads is:?:initdefault where ? is either a 1, 2, or 3. Record the value of ? for use later, then replace the ? with an s (for single user mode.) is:s:initdefault If the value is s prior to you editing the file, skip the next step and go to step 3. 2. Edit /etc/conf/init.d/kernel in the same way you edited /etc/inittab above. 3. Reboot your system in single user mode by executing: init 6 4. Type your root password in response to the following prompt: UX:init: INFO: SINGLE USER MODE Type Ctrl-d to proceed with normal startup, (or give root password for Single User Mode): 5. Set the TERM variable to the type of the terminal that you are working on, for example: TERM=at386 export TERM 6. Install the package using the following command line: pkgadd -d nic203 where device is cdrom?, ctape?, diskette?, or the full path of the directory that you are installing the package from. ? is the number of the device if you have multiple devices of the same type on your machine. 7. Once the package is installed, re-edit the /etc/inittab and /etc/conf/init.d/kernel and replace the s in is:s:initdefault with the original value. 8. Reboot your system again by executing init 6 3. During the Installation of the 2.03 NICS Package 3.1 Warning About Quitting During Installation Avoid quitting out of the installation of the NICS package. During installation, the NICS package removes all network drivers that are currently installed on the system. This happens just before you select the NICS that you want to have installed. Quitting the installation process at this point will not restore the drivers that were originally on the system. At the next reboot, no network drivers will be available, and your machine will not be networked. 4. Quality Improvements in the 2.03 NICS Package - Changes have been made to the IBM token ring driver and IBM164 to make it possible for PC systems running Novell's Lan WorkPlace for DOS (LWP) to communicate with systems running UnixWare via TCP/IP over a token ring network. - The ODI code that forced even packet sizes has been removed. - The ODI framework now supports RAW/LLC2 modes for the Token Ring drivers. - "Pass thru" is enabled for LLC Type 2 for both the Ethernet and Token TSMs. 5. General Installation Instructions A UnixWare Update release includes an update package which enhances the UnixWare base system, and system software packages such as networking device drivers or IHV HBA device drivers that provide maintenance and enhancements for device drivers. The 2.03 packages are the 2.03 Update (update203) package, the 2.03 NICS (nics) package, and the 2.03 HBA (hba) package. The update release packages are available on the UnixWare Support CD and from the Internet. Installation of the packages from UnixWare Support CD should be performed through the Desktop interface to take full advantage of the functionality provided by the Update Manager program. Packages from the Internet can be installed through the Desktop or from the command line. Note: You should not install the nics package through the Desktop Interface. See the instructions in the "Before You Install" section of the nics release notes for details on installing the nics package. 5.1 Backing Up the Current System During the installation of the update203 and the hba packages, a backup of selected files is performed automatically. The files that are backed up are those that will be overwritten by the package. This allows you to remove the package and restore the system to its previous state in the unlikely event that there are problems with the package. Note that there is no automatic backup of files performed during the installation of the nics package. The backup and installation of update203 requires 70,000 blocks of the free disk space. The actual amount of disk space that is required depends on the software that you currently have installed on your system, i.e., AS, PE, SDK and add-ons. The files will be stored on your hard disk in /var/sadm/bkup/update203, but to save space on your hard disk, you may choose to save the backup on either diskettes or tape. The update203 installation procedure will give you the choice. The backup performed by the hba package will require at most 252 blocks (.12 MB). Files which are backed up will be stored in /var/sadm/hba.save. You do not have the option of storing these files on diskette or tape. 5.2 Rebooting the System After the installation of any of the update release packages, your system should be rebooted. In the case of update203, the system is rebooted automatically. You will be prompted early in the installation procedure to warn you of this, and you will have a chance to exit if you are not ready for your system to be rebooted. In some cases, "critical" ptfs must be installed for a system to reboot properly. If critical ptfs are required, you will be prompted by the installation scripts. 5.3 Installing From the UnixWare Support CD If you are installing the update release packages from CD- ROM, and you are reading these release notes, you must have already installed the Update Manager, started the Update Manager through the UnixWare Desktop, and selected to "Read Documentation" for one of the packages available through the Install window. To install one of the update release packages from the CD- ROM, do the following: 1. Navigate to the Update Manager Main Menu. 2. Click on Update Manager. The Install window will be displayed. The Install window lists the packages which are available on the CD-ROM. 3. Click on package you are interested in. 4. Click on the Read Documentation button to read the release notes which are associated with that package. 5. Click on Install to install the package. The package installation script for the package that is being installed takes over at this point. The update package installation process is presented in the next section. 5.3.1 Installing the Update Package 1. Respond to the following prompts to install the Update package: a. You are given a choice to either read the release notes or install the package. It is recommended that you read the release notes initially, and then install the package only when familiar with the release notes. The release notes are mailed to the desktop owners and to root after this menu. b. You are given a warning that, upon successful installation of the update, the system will be rebooted. If you don't want to bring your system down at this time, you can choose to abort the installation. Otherwise, you can proceed with the installation. If you choose to proceed with the installation, the Select Backup Method screen is displayed. 2. Select one of the backup options: - Disk Drive - Cartridge Tape or Floppy Disk If you select Disk Drive, the backup is created in the directory /var/sadm/bkup/update203. If you select Cartridge Tape or Floppy Disk, and your system has multiple diskette or cartridge tape drives, you are prompted to select the drive you want to use. If you are using diskettes, be sure to have formatted diskettes ready for the backup. When the backup is complete, label and store the backup in a safe place. The backup can be used to restore files that were changed during the update should it be necessary to remove the package at a later time. After the backup has completed, the package will be installed. After successful installation, your system will be rebooted automatically. You will notice a brief delay between the completion of the installation and the start of the system shutdown. If errors occurred during the installation, the errors are logged in the file /var/sadm/install/logs/203.log. 5.3.2 Creating Distribution Diskettes The Update Manager can be used to create distribution diskettes for any of the packages in a UnixWare Update. The example below describes how to create HBA Distribution Diskettes. Follow these steps: 1. Return to the Install window of the Update Manager. 2. Click on the hba package. 3. Click on the Make Distributions button. The Update Manager will prompt you to select the media and the drive which you will use to create the distribution. Currently, the only supported media is 3.5 inch floppy diskettes. There are prompts for formatting floppy diskettes, if necessary, and then you are prompted to insert the floppy diskettes for the creation of the HBA Distribution Diskettes. 5.4 Installing Update Release Packages from the Internet 5.4.1 Installing from the Desktop To install packages that you have taken from the Internet perform the following steps from the Desktop: 1. Double-click on the Admin_Tools icon in your UnixWare Desktop window. This displays the Admin_Tools window. 2. Double-click on the App_Installer icon. This displays the Application Installer window. There may be a slight delay due to the cataloging of the applications or software packages which are currently installed on your system. 3. Click on the Install From pull down menu. 4. Click on Network, or Other to install the update from a local or mounted directory. 5. When you click on Network, the Server field is displayed. Type the name of the Install Server that you want to install the package from. If you type the name of a machine that has not been setup as an install server, no applications will be available for you to install. When you click on Other, a Find Folder pop-up menu is displayed. Click on Parent Folder until you reach the root of the path of the software package. Click on the appropriate folders until the full path of the folder that contains the package appears in the Path field. Click on Select. 6. At this point, the packages in the directory are displayed. Click on the package that you want to install. 7. Click on Install to install the package. The package installation script for the package that is being installed takes over at this point. The update203 installation process is presented in the "Installing the UnixWare Support CD" section. 5.4.2 Installing Packages from the Command Line Type the following to install the 2.03 packages from the command line: pkgadd -d where package is either update203, nics or hba, and full pathname is the path from / to the directory, either local or a mounted resource, that contains the package. For example, if the package has been placed in /tmp/update203, the command line would be: pkgadd -d /tmp update203 The package installation script for the package that is being installed takes over at this point. The update203 installation process is presented in the " Installing from the UnixWare Support CD " section. 6. Appendix A - Features of the 2.02 NICS Package The 2.03 NICS package is cumulative. It includes quality improvements which are new for 2.03, and features and quality improvements which were provided in the 2.02 NICS package. This section describes features that were provided in 2.02. The following describes the new and enhanced NICs support provided by the 2.02 NICS package: - This package provides the CPQNF3 driver which supports the Compaq Netflex III Ethernet 10/100 MBit card. - Enhancements to the COMPAQ nflxt driver includes support for the full line of NetFlex Ethernet and Token Ring controllers, including support for the COMPAQ Netflex Token Ring Dual Port. Support is provided for the following: - NetFlex I - NetFlex II - NetFlex-L Enet - NetFlex III 6.1 Program Temporary Fixes in the 2.02 NICS Package ptf 2030 The system panic when the Unisys Ethernet EISA en596 driver is under heavy NFS and memory load has been eliminated. 6.2 Quality Improvements in the 2.02 NICS Package - The problem with npsd not starting consistently has been fixed. - The IRQ 13 interrupt vector table is now set correctly. - A panic in the NetFlex driver has been eliminated. - A user can configure port 1 and port 2 with different media types and both ports will operate properly. - NetFlex dual port NIC no longer panics with heavy loads on both ports. - The NICS package now allows up to eight network ports. - This version of the PCnet driver supports the ddi/dki interface for PCI cards. - The problem of packet loss in the AMD NIC controller has been eliminated. - The AMD PCnet ISA+ board is autoconfigured on plug and play machines. - The problem of slow data transfers after a cable disconnect and reconnect with the NetFlex ethernet/token-ring controller has been fixed. - Recovery time after reconnecting the token-ring cable on NetFlex has been reduced. - Information about physical drive problems on COMPAQ systems is now available. - The NIC agent has been extended to support up to 16 NICs. - Systems with a NetFlex ethernet as the first interface and a NetFlex token ring as the second interface now yield the correct statistics for the token ring controller under CIM. - Due to a fix in the NICS package which enables slot number information to be processed, COMPAQ PCI networking cards now work correctly. - Add support for the pnt PCI embedded network controller. - The configuration screen for ISA cards is now presented on EISA systems allowing the user to provide the proper values for IRQ, IOADDR, and MEMADDR. - Enhancements have been made to enable the installation of multiple NICS boards.