UNIXWARE(TM) HOST BUS ADAPTER UPDATE RELEASE NOTES ================================================================== These release notes acquaint you with the contents of software drivers available for new Host Bus adapters that have been certified for UnixWare Release 1.0 of the Application Server and the Personal Edition products, explain undocumented changes, discuss software notes and recommendations, and specify how to get information and support for your UnixWare products. PACKAGE CONTENTS UNIVEL offers UnixWare Host Bus Adapter driver software on the UnixWare Network Support Encyclopedia CD-ROM, and various on-line services. These drivers are also available through UnixWare reseller channels and the hardware vendor. UNIXWARE NETWORK SUPPORT ENCYCLOPEDIA If you received UnixWare Host Bus adapter software on the UnixWare Network Support Encyclopedia CD-ROM, you received IHV format software and UnixWare driver packaging software install scripts. In addition, reseller information and tools are available on this CD-ROM. To load the updates from CD-ROM, follow the instructions in the insert followed by reading the UNIVEL Update Manager Handbook located on the CD-ROM. UNIVEL ON-LINE SERVICES If you retrieved Host Bus adapter software from a Univel on-line service, you should have retrieved one self extracting archive file named IHV[vendor abbreviation].EXE that contains the vendor's HBA driver software, a copy of the Univel Host Bus Adapter Update Release Notes in ASCII and PostScript(R) formats, and the driver software. A sample archive name for the UltraStor ULTRA 24FA driver is denoted as IHVUSC.EXE. Execute IHVUSC through a DOS window on the UnixWare Desktop. This will unpack two documents containing both regular text and PostScript(R) versions of the release notes, a script for creating the IHV diskette denoted as mkIHVflp, and a compressed cpio archive of the HBA software. Please read these notes before attempting to install any drivers. Each driver will require one 3.5-inch 1.44MB floppy diskette or one 5.25-inch 1.2MB floppy diskette. #chmod 544 mkIHVflp The mkIHVflp script can be executed either from the command line or by double clicking on the mkIHVflp icon. #./mkIHVflp Follow the installation instructions in this document for installing your UnixWare Host Bus adapter software from floppy. If you received an IHV HBA Update from a UnixWare authorized reseller, you received either one 3.5-inch 1.44MB floppy diskette or one 5.25-inch 1.2MB floppy diskette for each driver that you wish to install on your UnixWare system. FLOPPY DISKETTE PACKAGE To load a Host Bus driver from floppy, follow the installation instructions located in this document. DOCUMENTATION Contained within each driver package directory is a regular text file and a PostScript(R) file of the release notes. Please read these notes before attempting an installation to note any restrictions or dependencies. The following list of additional support documentation is available on the CD-ROM, or various on-line services: * UNIVEL Update Manager Release Notes, which guides you through the installation, maintenance, and redistribution of UnixWare updates. * UNIVEL UnixWare Hardware Compatibility Handbook, which provides information on any newly supported hardware certified for UnixWare 1.0. * UnixWare LAN Adapter Update Release Notes, which provides information and installation of any new Ethernet adapters certified for UnixWare 1.0. * UnixWare Host Bus Adapter Update Release Notes, which provides information and installation of any new Host Bus Adapters certified for UnixWare 1.0. * UnixWare Application Notes, which provides application instruction requirements for third party software applications. * UnixWare Top Issues, which contains current support information in a Question and Answer format. INSTALLATION INSTRUCTIONS FOR UNIXWARE HOST BUS ADAPTER UPDATE This section provides step-by-step procedures for installing a UnixWare Host Bus Adapter Update. In addition, pre-installation requirements have been provided: INSTALLING A HOST BUS ADAPTER UPDATE FROM THE UNIXWARE DESKTOP This installation process is used for installing driver software to operate with additional controllers that are installed on the system, and are configured as dynamically loadable modules. 1. Double-click on the Application Setup icon. (See "Using Application Setup" in Chapter 11 of the User Handbook for more information.) 2. After the system has finished cataloging the contents of the media, a list of packages is displayed in icon format. In this example the fdtbihvha package is the only icon that is displayed. 3a. Click on the fdtbihvha adapter package icon. 3b. Click on the Application option in the menu bar. 3c. Click on the Install menu item. The Add Application: screen is displayed, and the installation is in progress. INSTALLING A HOST BUS ADAPTER UPDATE FROM THE COMMAND LINE 1. Double-click on the Accessories icon located in the Desktop folder. 2. Double-click on the Terminal icon in the Accessories folder. A terminal window is displayed. 3. Insert the IHV HBA Adapter diskette into a 3.5-inch floppy or 5.25-inch floppy drive. You need to be superuser (id=0) to execute the following command: 4. Mount the diskette as shown below: #mount -r /dev/dsk/f03ht /Disk_A (1st 3.5-inch floppy drive) #mount -r /dev/dsk/f13ht /Disk_B (2nd 3.5-inch floppy drive) #mount -r /dev/dsk/f0hht /Disk_A (1st 5.25-inch floppy drive) #mount -r /dev/dsk/f15ht /Disk_B (2nd 5.25-inch floppy drive) 5. Execute the package installation command: # pkgadd -d /Disk_[A or B] The terminal window will display a list of packages located on the diskette available for installation. 6. Select the package or press the ENTER key to take the default package installation process. INSTALLING A HOST BUS ADAPTER UPDATE FOR NEW UNIXWARE INSTALLATIONS 1. Follow the installation instructions outlined in the UnixWare Installation Guide. 2. The installation mechanism will prompt for an IHV HBA diskette in place of UnixWare boot floppy two. At this point insert the UnixWare IHV HBA update diskette into the floppy drive. The system installation process will configure the adapter board to the default options stated in the description notes located in this document. 3. After UnixWare has been installed, the installation mechanism will re-prompt for the IHV diskette. At this point the driver software will install via the pkgadd command. Insert the diskette once again to complete the IHV HBA installation process. REMOVING A HOST BUS ADAPTER UPDATE FROM THE UNIXWARE DESKTOP The Host Bus adapter package can be removed from the system only if the package is associated with a second controller and the driver is configured as dynamically loadable. The following instructions provide a brief overview on removing UnixWare packages. 1. Double-click on the System_Setup icon located in the desktop folder. 2. Double-click on the Appl-n_Setup icon in the System_Setup folder. 3. The system will catalog the installed applications, and display them in icon format. 4. Click on the IHV HBA package icon, and click on the Application Remove option of the Application Setup: Installed - All menu bar. REMOVING A HOST BUS ADAPTER UPDATE FROM THE COMMAND LINE 1. Double-click on the Accessories icon located in the Desktop folder. 2. Double-click on the Terminal icon in the Accessories folder. A terminal window is displayed. 3. You need to be superuser (id=0) to execute the following command: # pkgrm IHV HOST BUS ADAPTER UPDATE NOTES AND RECOMMENDATIONS The following notes and recommendations apply to IHV HBA updates certified for UnixWare Release 1.0 of the Application Server and the Personal Edition products. Adaptec AHA-1740/1740A/1742A HOST BUS ADAPTER The Adaptec AHA-1740A/1742A EISA-to-Fast SCSi host adapter has been designed to operate as shipped in standard EISA class computers and supports the more common single-ended SCSI interface. The AHA-1744 adapter however, is NOT supported or certified to operate with UnixWare. The following configuration has been certified to operate with UnixWare: NEW INSTALLATION The controller configuration information should be adhered to when installing UnixWare on this board. If the adapter is to be configured for enhanced mode, the card is required to be physically installed in SLOT 1 of your system. The I/O address for SLOT 1 is determined by the software. The IRQ should be set to 9 to install the operating system. This can be modified once the system has been installed. EXISTING INSTALLATION CONFIGURATION 1. If the operating system has already been installed using this controller and it has been configured for 16-bit compatibility mode, the sdevice entry will require a manual edit to accommodate the I/O address changes for enhanced mode operation. You will not need to move the adapter from the current SLOT that it is located, but the following starting and ending I/O address will need to be updated. After the IHV HBA package has been installed via the desktop or through a terminal window using the pkgadd command, edit the /etc/conf/sdevice.d/adse driver configuration file with the appropriate I/O address selected below: slot 1 starting I/O address = 1C80 ending = 1CFF slot 2 starting I/O address = 2C80 ending = 2CFF slot 3 starting I/O address = 3C80 ending = 3CFF slot 4 starting I/O address = 4C80 ending = 4CFF slot 5 starting I/O address = 5C80 ending = 5CFF slot 6 starting I/O address = 6C80 ending = 6CFF slot 7 starting I/O address = 7C80 ending = 7CFF slot 8 starting I/O address = 8C80 ending = 8CFF 2. Edit the /etc/conf/sdevice.d/adse driver which is the NEW driver entry name for the 1740. You will need to remove the 4th line which denotes this driver as a dynamically loadable driver. If you DO NOT remove this entry, error conditions will occur, and your system WILL NOT boot. FROM: #ident "@(#)/etc/conf/sdevice.d/adse.sl 1.0 4.1dt 06/26/92 xxxxx AT&T-USL" #ident "$Header: $" $version 1 $loadable adse #REMOVE THIS LINE!!!!!!!!!!!!!!!!!!!!!!!!!!!! adse Y -1 5 4 9 1c80 1cdc d0000 d3fff -1 TO: #ident "@(#)/etc/conf/sdevice.d/adse.sl 1.0 4.1dt 06/26/92 xxxxx AT&T-USL" #ident "$Header: $" $version 1 adse Y -1 5 4 11 4c80 4cdc d0000 d3fff -1 3. The next step requires a manual edit of the /etc/conf/sdevice.d/adsc driver. You will need to disable the 1540 driver entry by placing an "N" in the second field as shown below: #ident "@(#)/etc/conf/sdevice.d/adsc.sl 1.1 1.0 10/31/92 3987 Univel" #ident "$Header: $" $version 1 adsc N -1 5 1 11 330 333 DC000 DDFFF 5 4. Ensure all manual edits are correct that are outlined in steps 1-3 before you continue. If you miss a step before you rebuild the system kernel, problems WILL occur. If all edits have been made, rebuild the system kernel by changing directory into /etc/conf/bin and issue the following command: #./idbuild -B 5. Reboot the system with the new configuration. Future Domain TMC-7000EX EISA HOST BUS ADAPTER The FDTB HBA Driver supports the Future Domain SCSI TMC-7000EX HBA controller. The following features are provided by the Future Domain TMC-7000EX HBA driver and controller: - Intelligent EISA-SCSI Adapter controller ( 1 interrupt/command) - Intel 80o96 firmware microprocessor - Firmware supports SCSI commands, WD7000 emulation - 32-bit first party DMA (bus master) data transfers - SCSI bus arbitration including disconnects/reconnects - Host Scatter/Gather data transfer (17 entries) - Support for asynchronous, synchronous and fast sync SCSI-2 - Jumperless EISA configuration The Future Domain 7000EX Device Driver has been certified for UnixWare products with the following hardware configuration: Controller Configuration Protocol Mode DACB Protocol BIOS Address Selection DC000H - DFFFFH Interrupt Selection IRQ 10 Preempt Delay Control 32 BCLKS ISA Mode Selection Disable SCSI Control Options Motor Spin Up Sequencing Device Auto Spin Up SCSI Parity Control Enable Controller SCSI ID 7 For more information about the 7000EX controller, contact your local reseller, CompuServe or Future Domain at: Future Domain, Corporation 2801 McGaw Ave. Irvine, CA 92714 (714) 253-0440 (714) 253-0429 (Fax) UltraStor ULTRA 24FA EISA HOST BUS ADAPTER The ULTRA 24FA is a high performance EISA to SCSI controller supporting up to 7 SCSI devices (or up to 56 devices if a SCSI bridge controller is used). This controller is designed to support a variety of SCSI devices such as Hard disk, Tape, CDROM, DAT, WORM. MO rewritable disk, Scanner, Laser printer, etc. A high speed 32 bit microprocessor provides the local intelligence for controller command processing. This intelligent controller features bus master 33MB/sec data transfers, low overhead SCSI command processing, command queuing, multi-threaded operation, scatter/gather, EISA auto-configuration and disk defect management. The ULTRA 24FA EISA SCSI Device Driver has been certified for UnixWare products with the following hardware configuration: UltraStor ULTRA 24FA SCSI Controller Enable Controller Configuration BIOS Address Selection C8000h Interrupt Selection IRQ 14 Preempt Delay Control 64 BCLKS ISA Mode Selection Disable SCSI Control Options Motor Spin Up Sequencing Device Auto Spin Up Synchronous Negotiation Controller Initiated Negotiation Negotiation Starting Range Start Negotiation at 10MByte/Sec SCSI Parity Control Enable Drive Mapping Mode Selection 64HD/32 SCTR,2DRV Controller SCSI ID 7 Floppy Control Option Floppy Disk Controller Disable Third Floppy Drive Cable Select Single Twisted Cable For more information about the ULTRA 24FA controller, contact your local reseller, CompuServe or the vendor for technical assistance. IHV HOST BUS ADAPTER KNOWN PROBLEMS AND RECOMMENDATIONS NEW INSTALLATIONS The post processing mechanism that is executed from the UnixWare third boot floppy inadvertently enables all host bus adapters located in the /etc/conf/sdevice.d directory. This problem causes error messages to be displayed on the console after the system has been rebooted for the first time. The error messages reflect the inability to access any non-used interrupt vectors and/or I/O addresses and shared memory addresses. To eliminate this problem the following work around should be noted: 1. The following sdevice entries located in /etc/conf/sdevice.d should be disabled using the vi editor or by using the desktop text editor located in the Accessories folder. The second field of the driver entry should be changed from a "Y" to a "N" as shown below using the Adaptec 1542B driver as an example: /etc/conf/sdevice.d: adsc athd dpt ict mcesdi mcis mcst wd7000 NOTE: If other HBA drivers exist in the /etc/conf/sdevice.d directory, then these entries will also need to be disabled. Before: #ident "@(#)/etc/conf/sdevice.d/adsc.sl 1.1 1.0 10/31/92 3987 Univel" #ident "$Header: $" $version 1 adsc Y -1 5 1 11 330 333 DC000 DDFFF 5 After: #ident "@(#)/etc/conf/sdevice.d/adsc.sl 1.1 1.0 10/31/92 3987 Univel" #ident "$Header: $" $version 1 adsc N -1 5 1 11 330 333 DC000 DDFFF 5 2. Once all files listed above have been disabled, the Unix system kernel will need to be rebuilt to reflect the changes as shown below: /etc/conf/bin/idbuild 3. Shutdown and reboot the system to automatically rebuild the system kernel. 4. Once the system has been brought up, check the PDI interface by executing a terminal window through the Accessories folder or through the command line. You will need to be root to perform this operation: #cd /etc/scsi #./pdiconfig The following sample out should be displayed: adse "Adaptec SCSI EISA HBA" SCSI Y 0 0x9 0 0 5 9 4 0x1c80 0x1cdc 0xd0000 0xd3fff adsc "Adaptec SCSI HBA" SCSI N -1 0x0 5 0 5 11 1 0x330 0x333 0xdc000 0xddfff athd "ISA (MFM,RLL,ESDI)" DCD N 1 0x0 0 0 5 14 3 0x1f0 0x1ff 0x0 0x0 dpt "DPT SCSI HBA" SCSI N -1 0x0 0 0 5 15 3 0x1170 0x1177 0xc8000 0xc9fff ict "Non-SCSI Cartridge Tape" DCD N 1 0x0 1 0 5 5 1 0x300 0x301 0x0 0x0 mcesdi "Micro Channel ESDI" DCD N 1 0x0 5 0 5 14 3 0x3510 0x351f 0x0 0x0 mcis "IBM MCA SCSI HBA" SCSI N -1 0x0 0 0 5 14 3 0x3540 0x3541 0x0 0x0 mcst "Micro Channel ST-506" DCD N 1 0x0 3 0 5 14 3 0x320 0x32f 0x0 0x0 wd7000 "WD7000 SCSI HBA" SCSI N -1 0x0 6 0 5 15 3 0x350 0x357 0xce000 0xcffff fdtb "Future Domain 7000ex SCSI HBA" SCSI N -1 0x0 0 0 5 10 1 0x0 0x0 0x0 0x0 5. If an error message is displayed indicating that the device cannot be found, the following operation is recommended to try to correct the device entries in the Portable Device Interface. This workaround may not correct some HBA drivers that contains an internal cartridge tape unit such as an IDE controller. Edit the HBA sdevice entry in /etc/conf/sdevice.d. Change the third field from a 1 or a 0 (depending on the device, the entry may vary) to a -1 as shown below: From: #ident "@(#)/etc/conf/sdevice.d/adse.sl 1.0 4.1dt 06/26/92 xxxxx AT&T-USL" #ident "$Header: $" $version 1 adse Y 0 5 4 9 1c80 1cdc d0000 d3fff -1 To: adse Y -1 5 4 9 1c80 1cdc d0000 d3fff -1 6. Rebuild the system kernel and reboot the system. Execute the pdiconfig command again to verify the correction. If an error condition occurs again, contact the reseller or Univel Technical Support for assistance. HOW TO GET MORE INFORMATION AND SUPPORT Most of the information you need is provided on the UnixWare Network Support Encyclopedia CD-ROM or various on-line services. If you need further technical assistance, contact your UNIVEL reseller. If you need applications compatibility information, contact your UNIVEL reseller or the application vendor, or call 1-800-4-UNIVEL and information will be faxed to you. DISCLAIMER UNIVEL makes no representations or warranties with respect to the contents or use of this document, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, UNIVEL reserves the right to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes. Further, UNIVEL makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, UNIVEL reserves the right to make changes to any and all parts of the software, at any time, without obligation to notify any person or entity of such changes. TRADEMARKS UNIVEL has made every effort to supply trademark information about company names, products and services mentioned in these release notes. Trademarks indicated were derived from various sources: UNIVEL and UnixWare are trademarks of UNIVEL NetWare is a registered trademark of Novell PostScript is a registered trademark of Adobe Systems, Inc. UNIX is a registered trademark of UNIX System Laboratories, Inc. UltraStor and ULTRA 24FA are registered trademarks of UltraStor Corporation. Future Domain and EX7000 are registered trademarks of Future Domain. Adaptec is a registered trademark of Adaptec Corporation. Copyright(c) 1993 UNIVEL All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express prior consent of the publisher. These rights are waived for authorized resellers and distributors of UNIVEL products. UNIVEL(TM) 2180 Fortune Dr. San Jose, CA 95131 (408) 473-8788