TECHNICAL INFORMATION DOCUMENT TITLE: HBA203 - Driver Package DATE: 17NOV95 README FOR: HBA203 PRODUCT and VERSION: UnixWare 2.01 Installation Instructions: DATATYPE: compressedtar 1. Download the hba203.tar.Z, hba203.sh and hba203.txt files to the /tmp directory on your machine. 2. Read the release notes contained in this file. 3. Now become root, and create the hba diskette. (This assumes that hba203.tar.Z is in the /tmp directory, and that /tmp is the working directory.) $su (become the super user) #/tmp/hba203.sh hba203.tar.Z (This script will format and create the HBA diskette for you.) 4. You can now add the patch to your system via the pkgadd command or use the diskette at installation time as an additional hba diskette. #pkgadd -d diskette1 (This will add the package to an existing UnixWare system) ENGINEERING RELEASE NOTES ------------------------- Title ----- HBA 2.03 Driver Package Abstract -------- 1.0 Introduction These notes describe the 2.03 HBA Driver Package for the following Novell (R) UnixWare (R) products: UnixWare Personal Edition (TM) and UnixWare Application Server (TM). The 2.03 HBA package is cumulative. It contains new drivers and quality improvements for UnixWare 2.01 and 2.02 HBA drivers, and the drivers, features, and quality improvements provided in the 2.02 HBA package. For the convenience of the readers who have installed the 2.02 HBA Package, information on the 2.03 package will presented first. The 2.02 release notes are included as an appendix. Prior to installing the HBA package, you should read these release notes. 2.0 Before You Install the 2.03 HBA Package ------------------------------------------- 2.1 UnixWare Versions The 2.03 HBA package is intended for use on systems running UnixWare 2.01 or the UnixWare Update 2.02. 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 with this package. The section entitled ``Program Temporary Fixes (ptfs)'' contains information on ptfs being installed with this package. 2.3 Overlay Installation or HBA Distribution Diskettes You can use the 2.03 HBA package in two ways. As an overlay installation the package installs maintenance, enhancements, and fixes for UnixWare 2.01 and 2.02 HBA Drivers. An overlay installation of the 2.03 HBA package is intended for use on systems running UnixWare 2.01 or the UnixWare 2.02 Update. See the section on "Overlay Installation" below for more information. The HBA package can also be used to create HBA Distribution Diskettes for use during the installation of UnixWare 2.01 systems. The HBA diskettes would contain new drivers to support hardware which was not supported prior to 2.03. See the section below on "Creating HBA Distribution Diskettes" for instructions on creating diskettes manually, and see "Installing from the UnixWare Support CD" for creating Distribution Diskettes via the Update Manager (updmgr). 2.3.1 Overlay Installation During an overlay installation, the HBA package will update all of the HBA related files for a specific HBA except for the system file, that is the file located in the /etc/conf/sdevice.d directory. For example, overlay installation of the c8xx HBA package would install the following files: /etc/conf/pack.d/c8xx/Driver.o /etc/conf/pack.d/c8xx/space.c /etc/conf/pack.d/c8xx/disk.cfg /etc/conf/drvmap.d/c8xx /etc/conf/mdevice.d/c8xx The HBA package installation procedure automatically creates a backup prior to installing the new HBA files. The files that are backed up are those that will be overwritten during the installation. The files are stored in the /var/sadm/hba.save directory. A separate directory is created for each driver that is updated. Although no problems should occur when overlaying the HBA files, you can restore the old versions by copying the saved files back to their original locations and rebuilding the kernel. 2.3.2 Creating HBA Distribution Diskettes This section describes the steps you take to make HBA distribution diskettes from the 2.03 HBA package that you acquired from the Internet. A hbaxxx.txt file, where hbaxxx is the name of the package, contains the release notes that you are reading. The hbaxxx.tar.Z file, contains the drivers, and the hbaxxx.sh file, which contains a script that creates the distribution diskettes. Note: To create distribution diskettes from the command line you must be logged in as root. 1. Insert a 3-1/2" diskette in the drive. 2. Execute the hbaxxx.sh script to create the HBA distribution diskettes. hbaxxx.sh hbaxxx.tar.Z where hbaxxx.tar.Z is the file that contains the HBA drivers and hbaxxx.sh is the file that contins the script 3. Quality Improvements in the 2.03 HBA Package - Null pointer dereferencing when the DPT logger utility is running has been eliminated from the dpt driver. - Interrupts are now attached during HBA initialization to eliminate dpt driver hangs during installation. - The dpt driver now extracts the target ID from the controller. - The controller reset that is issued by the dpt driver is conditional at initialization time. 4. 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. 4.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. 4.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. 4.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. 4.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. 4.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. 4.4 Installing Update Release Packages from the Internet 4.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. 4.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. 5. Appendix A - Features of the 2.02 HBA Package The 2.03 HBA 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 HBA package. This section describes features that were provided in 2.02. The following HBAs were new or enhanced for 2.02: 5.1 Future Domain HBA Driver fdeb The fdeb driver provided by this package has enhanced direct access to the SCSI peripherals (pass-thru) and extended read/write support. The default UnixWare configuration is interrupt 5 and memory address CA000-CBFFF. 5.2 Future Domain HBA Driver fdsb Enhanced direct access to the SCSI peripherals (pass-thru) and extended read/write support are provide in fdsb in this package. Also, support for the Future Domain PNP-1630 adapter has been added to the driver. The default UnixWare configuration is interrupt 11 and I/O address 140-14F. 5.3 Western Digital HBA Driver wd7000 Enhanced direct access (pass-thru) ioctl support is available in this release of the driver. The default UnixWare configuration is interrupt 15, I/O address 350-357, and memory address CE000-CFFFF. 5.4 Media Vision HBA Driver zl5380 Support for the Media Vision Pro Audio Spectrum 16 adapter is provided in the this package. Note that this support is SCSI only, and that support for audio on this adapter is not provided. The default UnixWare configuration is interrupt 10 and I/O address 388-38B. Interrupt and I/O settings should be verified using the Quick Start program provided with the controller (runs under DOS). 5.5 New Advanced Micro Devices HBA driver amd The new amd HBA driver is provided in this update. This driver supports the following adapters: Am53C974 PCscsi Am79C974 PCnet-scsi. Tagged command queuing is supported, and the UnixWare auto- configuration utility is responsible for configuring the adapter for use with the system. 5.6 Bus Logic HBA Driver blc blc has been modified to support the following adapters: BT-956C BT-956CD BT-7942 (RAID) These adapters and the blc driver support "WIDE SCSI," tagged command queuing (if enabled), and hot insert. The UnixWare auto-configuration utility is responsible for configuring the adapter for use with the system. 5.7 Symbios Logic HBA driver c8xx The 2.02 HBA package provides the Symbios Logic HBA c8xx. This driver supports the following PCI to SCSI adapters and controllers: Symbios Logic 8100S (adapter) Symbios Logic 8251S (adapter) Symbios Logic 53c810 (controller) Symbios Logic 53c820 (controller) Symbios Logic 53c825 (controller) Symbios Logic 53c815 (controller) Tagged command queuing, WIDE SCSI and hot insert are supported. The UnixWare auto-configuration utility is responsible for configuring the adapter for use with the system. The driver will support the Symbios Logic (NCR Microelectronics) 53c8xx family. The driver will NOT load on COMPAQ Computer Corporation's 53c8xx host adapters in COMPAQ machines. The user must use the update cpqsc driver for the 53c8xx in COMPAQ machines. 5.8 DPT HBA driver dpt The dpt driver has been enhanced to support WIDE SCSI, hot insertion/removal and EATA direct access to the SCSI peripherals (pass-thru). The Storage Manager utility is supplied by DPT directly. You can monitor the the controller and target devices via the Storage Manager, in addition to performing diagnostic and maintenance tasks. Tagged command queuing is still supported by the controller firmware without driver intervention. EISA and PCI versions of the DPT controllers are completely auto-configured and require no special configuration. ISA versions of the DPT controllers need to be configured as follows: I/O Address - 170 (also called "secondary"), Interrupt 15 and the controller BIOS can be configured at any non-conflicting address. 5.9 The New Adaptec HBA Driver adsl adsl supports the following adapters: AHA-2940 AHA-2940W AHA-3940 AHA-3944 AIC-7870 AIC-7850 WIDE SCSI peripherals may be used with the AHA-2940W adapter. The UnixWare auto-configuration utility is responsible for configuring the adapter for use with the system. 5.10 COMPAQ HBA Driver ida ida has been modified as follows: - support for more than seven disks - support for WIDE SCSI - corrected interaction with CIM agents - corrected operation of ida controllers with IDE compatible interfaces The UnixWare auto-configuration utility is responsible for configuring the adapter for use with the system. 5.11 COMPAQ cpqsc HBA Driver cpqsc The COMPAQ cpqsc HBA driver is updated in this release. The driver supports the following: COMPAQ Integrated 32-bit COMPAQ Integrated 32-bit Fast-SCSI-2 (CPQ4410) COMPAQ 32-bit Fast-SCSI-2 (CPQ4411) COMPAQ Integrated 32-bit Fast-SCSI-2/E (CPQ4430) COMPAQ 32-bit Fast-SCSI-2/E (CPQ4431) COMPAQ Integrated 32-bit Fast-SCSI-2/P (Symbios Logic 53C810) COMPAQ 32-bit Fast-SCSI-2/P (Symbios Logic 53C825) Support for WIDE SCSI peripherals, tagged command queuing, and hot insertion has been added. The driver will support COMPAQS Fast-SCSI-2 family of controllers. The driver will NOT support the Symbios Logic (NCR Microelectronics) c8xx host adapters. 5.12 Program Temporary Fixes in the 2.02 HBA Package The following ptfs are provided in this package: ptf 2004 Support has been added for AMD PC-SCSI and PCNET-SCSI. ptf 2005 The Adaptec 2940 PCI host adapter support is provided in this update. ptf 2007 Support for the AT&T-GIS 53c8xx (PCI) SCSI HBA is available. 5.13 Quality Improvements in the 2.02 HBA Package - The problem with the Online LEDs on the COMPAQ ProLiant storage cabinet remaining lit when Merge is installed but the disk drive is not in use has been fixed. - An enhancement fixes the problem of the blc driver failing as an add-on card when sharing level interrupts. - All disk operation errors will be reported to the user and the file system. - The problem that occurred when the adsc driver is bound has been fixed. - The CCB and QUE locks from an active HBA drive are not reassigned. - fdeb has been modified to work properly with the TMC- 850M's SCSI chip. - An improper pointer dereference in the adsl driver has been fixed to eliminate a panic. - The bus field of the SCSI block device address is now initialized. - The cpqsc has been enhanced to support the 53C810 and the 53C825. - The SCSI cdb is dynamically allocated in the pass-thru code. - Hardware must be installed for the cpqidamon to report a successful startup. - Eliminated the limitation on passthru for HBA drives by providing support for up to 40 terabyte drives. - Changes have been made to cpqsc to support the use of COMPAQ NCR 53c8xx hardware in COMPAQ machines, and NCR 53c8xx hardware in non-COMPAQ machines. - Changes have been made to prevent error messages during hot insert operations. - A panic in cpqsc has been eliminated. - The ida driver has been modified to ignore bit six of the command status register. - The cled driver now works with the WIDE SCSI cabinet. - The cled driver has been updated to extract the ProLiant storage cabinet firmware revision. - Support for additional PCI controllers has been added. - The lock overlap in CIM ioctls has been fixed. - The CIM ioctl that returns hba information has been updated. - The pci slot number is now available for the CIM utilities and agents. - The ida CIM agent now returns all data to the CIM workstation. - The interrupt type is now handled properly for IDA-2 controllers. - A Drvmap file has been added for eisa controllers. - ida_menu now gets MP data for non-existing and existing drives. - Driver support is provided for new Mylex boards. - The -F option, the "Return to First Element" option, has been added to mccntl.c. - Problems with the c8xx driver and SCSI "soft resets" have been fixed.