TECHNICAL INFORMATION DOCUMENT TITLE: NIC202 - UnixWare 2.02 NIC drivers DATE: 29AUG95 README FOR: NIC202 PRODUCT and VERSION: UnixWare 2.01 Installation Instructions: DATATYPE: datastream 1. Download the nic202 and nic202.txt files to the /tmp directory on your machine. 2. Now remove the old nics package from your system by using the following command: $ su # pkgrm nics 3. Reboot your system to get the old nics drivers out of memory. 4. Now become root, and add the package to your system using the following commands: $ su # pkgadd -d /tmp/nic202 5. You can also follow the engineering release notes section 2.2 below to install this package. ENGINEERING REALEASE NOTES -------------------------- 1. Introduction These notes describe the 2.02 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.02 NICS package contains new drivers as well as all maintenance, enhancements, and fixes for UnixWare 2.01 NICS drivers. Prior to installing the NICS package, you should be familiar with these release notes. 2. Installation Requirements 2.1 UnixWare Versions The 2.02 NICS package is intended for use on systems running UnixWare 2.01 or the UnixWare Update 2.02. 2.2 Single User Mode 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 Record the value of ? for use later, where ? is either a 1, 2, or 3. 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 nics 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 2.3 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. 2.4 Program Temporary Fixes (ptfs) You may have ptfs installed on your system that must be removed prior to the installation of the nics package. Please acquire a copy of the release notes for each ptf you have installed to verify that each is compatible with this package. See the section on "Program Temporary Fixes" under "General Improvements" for a list of ptfs that are provided in this package. 3. Features The following describes the new and enhanced NICs support provided by this package: - This package provides the CPQNF3 driver which supports the Compaq Netflex III Ethernet 10/100 MBit card. - The enhanced ee16 driver supports the following: - Intel EtherExpress 16 - Intel EtherExpress 16 - Intel EtherExpress 16TP - Intel EtherExpress 16C - Intel EtherExpress 16 FLASH - Intel EtherExpress 16 MCA Note: To use the controller with UnixWare, use the SOFTSET DOS utility to configure the adapter with an interrupt vector, an I/O address and desired cable type (The SOFTSET utility is on the Configuration/Diagnostic Utility Diskette which comes with the adapter). Additionally, the adapter should be configured with No RAM MAPPED, NO Boot ROM and with default setting of "Force 8-bit Mode". For MCA users, the cable type has to be specificly selected; the "auto-detect" feature is not supported by UnixWare. - 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 4. General Improvements 4.1 Program Temporary Fixes (ptfs) ptf 2030 The system panic when the Unisys Ethernet EISA en596 driver is under heavy NFS and memory load has been eliminated. 4.2 Quality Improvements - 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. 5. Installing the Update Release Packages 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, enhancements, and new device drivers. The 2.02 packages are the 2.02 Update (update202) package, the 2.02 NICS (nics) package, and the 2.02 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. 5.1 Before You Begin Before installing the update release packages, you should be aware of the following information which may affect how you choose to proceed with the installation. 5.1.1 Backing Up the Current System During the installation of the update202 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. The update202 backup will generally take up considerable space on the system's hard disk. Backups in excess of 35,000 blocks (17 MB) are probable. The files will be stored on your hard disk in /var/sadm/bkup/update202, but to save space on your hard disk, you may choose to save the backup on either diskettes or tape. The update202 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.1.2 Rebooting the System After the installation of any of the update release packages, your system should be rebooted. In the case of update202, 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. 5.2 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 decided 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.2.1 Installing the Update Package 1. Respond to the following prompts to install the update202: a. You are given a choice to either read the release notes or install the package. It is recommended to 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/update202. (Requires 35,000 | blocks.) If you select Cartridge Tape or Floppy Disk, and your system has more than one diskette drive, or has one or more diskette drives and one or two cartridge tape drives, you are prompted to select the media you want to use for the backup. 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/202.log. 5.2.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.3 Installing Update Release Packages from the Internet 5.3.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 update202 installation process is presented in the "Installing the UnixWare Support CD" section. 5.3.2 Installing Packages from the Command Line | Type the following to install the 2.02 packages from the command line: pkgadd -d package where package is either update202, 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/update202, the command line would be: pkgadd -d /tmp update202 The package installation script for the package that is being installed takes over at this point. The update202 installation process is presented in the " Installing from the UnixWare Support CD " section.