TECHNICAL INFORMATION DOCUMENT TITLE: Ultrastor ULTRA 24, 14 & 34 driver support DOCUMENT ID: TID300094 DOCUMENT REVISION: B DATE: 25JAN95 ALERT STATUS: Yellow INFORMATION TYPE: Symptom Solution README FOR: USC PRODUCT and VERSION: UnixWare 1.0 UnixWare 1.1 ABSTRACT: The usc.tar.Z file contains usc - Ultrastor host Adapters (ULTRA 24, ULTRA 14 & ULTRA 34) under UnixWare 1.0. The Architecture of "USC IHV HB" complies both portable device interface(PDI) and SCSI device Interface(SDI) as SCSI Host Bus Adapter(HBA) Driver. The driver is dynamically loadable without rebuilding kernel. The driver supports mutiple ULTRA SCSI host adapters with Scatter-Gather capability. The Driver can be installed either at installation time or on existing system. SYMPTOM Support needed for Ultrastor host Adapters (ULTRA 24, ULTRA 14 & ULTRA 34) under UnixWare 1.x. SOLUTION Apply the usc.tar.Z file. DATATYPE: compressedtar 1. Download the usc.tar.Z and usc.txt files to the /tmp directory on your machine. 2. Read the release notes contained in this file. 3. Now become root, and add the package to your system using the following commands: (This assumes that usc.tar.Z is in the /tmp directory, and that /tmp is the working directory.) $su (become the super user) #mkdir ihv (make a directory to hold the files) #cp usc.tar.Z ihv (copy file into ihv directory) #cd ihv (make ihv the working directory) #uncompress usc.tar.Z (uncompress the file) #tar xvf usc.tar (un tar the file) #rm usc.tar (remove the tar file) #/usr/sbin/format /dev/rfd0 (format diskette1)* #mkfs -F s5 /dev/dsk/f0t 2844:711 2 36 (make file system on diskette1)* #mount -F s5 /dev/dsk/f03ht /mnt (mount diskette)* #find . -print | /bin/cpio -pmud /mnt (copy files to diskette) Solution Specifics Release Notes for "USC IHV HBA" 1. Driver Definition * "USC IHV HBA" is a device driver to support ULTRA SCSI host Adapters (ULTRA 24, ULTRA 14 & ULTRA 34) under UNIX System V/386 Release 4.2. * The Architecture of "USC IHV HB" complies both portable device interface(PDI) and SCSI device Interface(SDI) as SCSI Host Bus Adapter(HBA) Driver. * The driver is dynamically loadable without rebuilding kernel. * The driver supports mutiple ULTRA SCSI host adapters with Scatter-Gather capability. * The Driver can be installed either at installation time or on existing system. 2. Minimum Hardware Requirement * Intel-based PC with 80386, 80486, or compatible CPU. * At least 4 MB RAM. * One ULTRASTOR SCSI host adapter. - ULTRA 24 or ULTRA 24B SCSI host Adapter for computer with EISA BUS. - ULTRA 14 SCSI host Adapter for computer with ISA BUS. - ULTRA 34 SCSI host Adapter for computer with VESA VL-BUS. * A floppy diskette drive. * A hard disk drive with minimum 60 MB capacity. * Optional: A quarter-inch SCSI cartridge tape drive or SCSI CD-ROM drive. 3. Known problems and workarounds None. 4. Installation Notes: 4.1 ULTRA 14F AT SCSI Controller ADDENDUM TO THE ULTRA 14 SCSI HOST ADAPTER REFERENCE MANUAL Device Driver Installation for UNIX System V Release 4.2 This addendum describe the installation procedure for running ULTRA 14 SCSI Host Adapter in an EISA or ISA system under UNIX System Labs UNIX System V Release 4.2. Part I. Installing the ULTRA 14 as a Primary Bootable Controller There are two ways of installing the ULTRA 14 USC IHV HBA device driver. First is installing UNIX SVR4.2 to a new drive. Second, if the UNIX SVR4.2 operating system has been installed using another vendor's host adapter, AHA-154X, the installation procedure will replace the existing IHV HBA such as device driver with USC IHV HBA for ULTRA 14 device driver, and then re-boot the system with ULTRA 14 host adapter. A. Installing UNIX SVR4.2 using the ULTRA 14 SCSI Host Adapter NOTE: Refer to ULTRA 14 SCSI Host Adapter Reference Manual for congfiguring the ULTRA 14 in an EISA or ISA system. Certain configuartion options should be setup as follows for installing UNIX SVR4.2: BIOS Address Selection : C8000 or CC000/D0000/D4000/D8000/DC000 IRQ Selection : IRQ 14 ISA Mode Selection : Disable Drive Mapping Mode : 64HD/32SCTR, 2DRV Other configruation options are user selectable and should be set based on the system requirements. The system CMOS drive type need to be set to None (or Not Installed) for drive 0 or drive 1. After the configuration is done, connect the hard disks and SCSI tape drives or CD-ROM to the ULTRA 14. Insert the "UNIX SVR4.2 Desktop Boot Floppy 1 of 3" and power up the system. After booting from diskette, insert the "ULTRA 14 ISA SCSI Host Adapter USC IHV HBA Device Driver for UNIX System V Release 4.2" into the floppy drive when the following message appears: Remove the diskette labeled "Boot Floppy 1 of 3". If you have a diskette labeled "Host Bus Adapter Drivers", insert that diskette now. ..................... Continue the installation following the standard installation procedure of UNIX SVR4.2, either installing from floppy, catridge tape or CD-ROM. After all the packages are installed, re-insert the "USC IHV HBA for UNIX Sytem V Release 4.2" diskette when the following message appears: You must now reinsert the HBA diskette(s) that you used before. Please insert the diskette labeled: USC IHV HBA into the drive and press 'ENTER'. At the completion of the installation, a new UNIX kernel will be generated with ULTRA 14 USC IHV HBA device driver. The installaion is complete. B.Replaceing an Existing UNIX SVR4.2 System with ULTRA 14 The following procedure is for replacing the host adapter driver in a UNIX SVR4.2 system that was installed with another vendor's adapter. Step 1. Installing the ULTRA 14 USC IHV HBA device driver: Re-Boot the system wsing the installed host adapter. After the system boots up: 1. Login as a superuser (root). 2. Insert the "USC IHV HBA Device Driver for UNIX System V Release 4.2" disk in drive A: and type # pkgadd -d diskette1 3. After the installation, re-build the kernel and shutdown the system by typing: # /etc/conf/bin/idbuild -B # cd # shutdown -y -i0 -g0 Step 2. Configuring the ULTRA 14 Host Adapter in the system. After shutting the system down, replace the existing host adapter with with ULTRA 14. Refer to the ULTRA 14 SCSI Host Adapter Reference Manual for configuring the ULTRA 14 in an EISA system. Certain configuration options should be setup as follows for using UNIX SVR4.2: BIOS Address Selection : C8000 or CC000/D0000/D4000/D8000/DC000 IRQ Selection : IRQ 14 ISA Mode Selection : Disable Drive Mapping Mode : 64HD/32SCTR, 2DRV Other configuration options are user selectable and should be set based on the system requirements. After the configuration is complete, re-boot the system. The system will will boot which include the ULTRA 14 USC IHV HBA device driver. Part II. Installing the ULTRA 14 as a Secondary Controller. The following procedure applies to a system configured with an ULTRA 24, ULTRA 14, or ULTRA 34 as the primary bootable controller. The procedure adds the ULTRA 4 as the secondary controller. Configure the ULTRA 14 as follows: BIOS Address Selection : Any address higher than the primary controller IRQ Selection : IRQ 15 ISA Mode Selection : Disable Drive Mapping Mode : 64HD/32SCTR, 2DRV 1. Boot the operating system from the primary controller and log in as a superuser (root). 2. Change to the system device configuration directory by typing: # cd /etc/conf/sdevice.d 3. Open the usc file by typing: # vi usc 4. Change the N in the second field of the fourth line in this file to Y as follows: change usc N -1 5 3 15 0 0 0 0 -1 to usc Y -1 5 3 15 0 0 0 0 -1 5. Rebuild the kernel by typing: # /etc/conf/bin/idbuild -B 6. Re-Boot the system by typing: # shutdown -y -i6 -g0 7. Refer to Part III of the addendum for instructions on adding drives to the second controller. Part III. Configuring Additional Drive. 1. Boot the system as superuser. 2. Type "diskadd cCtLd0" to configure drive L to an Controller C. NOTE: C represents the global contorller number on the sysem. For primary controller, you would specify C as 0. For secondary controller, you would specify C as 1. 3. Continue to follow the instructions displayed on the screen to initialize the drive with a new file system. 4.2 ULTRA 24F EISA SCSI Controller ADDENDUM TO THE ULTRA 24 EISA SCSI HOST ADAPTER REFERENCE MANUAL Device Driver Installation for UNIX System V Release 4.2 This addendum describe the installation procedure for running ULTRA 24 EISA SCSI Host Adapter in an EISA system under UNIX System Labs UNIX System V Release 4.2. Part I. Installing the ULTRA 24 as a Primary Bootable Controller There are two ways of installing the ULTRA 24 USC IHV HBA device driver. First is installing UNIX SVR4.2 to a new drive. Second, if the UNIX SVR4.2 operating system has been installed using another vendor's host adapter, such as AHA-154X, the installation procedure will replace the existing IHV HBAd evice driver with USC IHV HBA for ULTRA 24 device driver, and then re-boot the system with ULTRA 24 host adapter. A. Installing UNIX SVR4.2 using the ULTRA 24 SCSI Host Adapter NOTE: Refer to ULTRA 24 SCSI Host Adapter Reference Manual for congfiguring the ULTRA 24 in an EISA system. Certain configuartion options should be setup as follows for installing UNIX SVR4.2: Enable/Disable Host Adapter : Enable BIOS Address Selection : C8000 or CC000/D0000/D4000/D8000/DC000 IRQ Selection : IRQ 14 ISA Mode Selection : Disable Drive Mapping Mode : 64HD/32SCTR, 2DRV Other configruation options are user selectable and should be set based on the system requirements. The system CMOS drive type need to be set to None (or Not Installed) for drive 0 or drive 1. After the EISA configuration is done, connect the hard disks and SCSI tape drives or CD-ROM to the ULTRA 24. Insert the "UNIX SVR4.2 Desktop Boot Floppy 2 of 1" and power up the system. After booting from diskette, insert the "ULTRA 24 EISA SCSI Host Adapter USC IHV HBA Device Driver for UNIX System V Release 4.2" into the floppy driver when the following message appears: Remove the diskette labeled "Boot Floppy 1 of 3". If you have a diskette labeled "Host Bus Adapter Drivers", insert that diskette now. ..................... Continue the installation following the standard installation procedure of UNIX SVR4.2, either installing from floppy, catridge tape or CD-ROM. After all the packages are installed, re-insert the "USC IHV HBA for UNIX Sytem V Release 4.2" diskette when the following message appears: You must now reinsert the HBA diskette(s) that you used before. Please insert the diskette labeled: USC IHV HBA into the drive and press 'ENTER'. At the completion of the installation, a new UNIX kernel will be generated with ULTRA 24 USC IHV HBA device driver. The installaion is complete. B.Replaceing an Existing UNIX SVR4.2 System with ULTRA 24 The following procedure is for replacing the host adapter driver in a UNIX SVR4.2 system that was installed with another vendor's adapter. Step 1. Installing the ULTRA 24 USC IHV HBA device driver: Re-Boot the system wsing the installed host adapter. After the system boots up: 1. Login as a superuser (root). 2. Insert the "USC IHV HBA Device Driver for UNIX System V Release 4.2" disk in drive A: and type # pkgadd -d diskette1 3. After the installation, re-build the kernel and shutdown the system by typing: # /etc/conf/bin/idbuild -B # cd # shutdown -y -i0 -g0 Step 2. Configuring the ULTRA 24 Host Adapter in the system. After shutting the system down, replace the existing host adapter with with ULTRA 24. Refer to the ULTRA 24 SCSI Host Adapter Reference Manual for configuring the ULTRA 24 in an EISA system. Certain configuration options should be setup as follows for using UNIX SVR4.2: Enable/Disable Host Adapter : Enable BIOS Address Selection : C8000 or CC000/D0000/D4000/D8000/DC000 IRQ Selection : IRQ 14 ISA Mode Selection : Disable Drive Mapping Mode : 64HD/32SCTR, 2DRV Other configuration options are user selectable and should be set based on the system requirements. After the EISA configuration is complete, re-boot the system. The system will boot which include the ULTRA 24 USC IHV HBA device driver. Part II. Installing the ULTRA 24 as a Secondary Controller. The following procedure applies to a system configured with an ULTRA 24, ULTRA 14, or ULTRA 34 as the primary bootable controller. The procedure adds the ULTRA 24 as the secondary controller. Configure the ULTRA 24 as follows: Enable/Disable Host Adapter : Enable BIOS Address Selection : Any address higher than the primary controller IRQ Selection : IRQ 15 ISA Mode Selection : Disable Drive Mapping Mode : 64HD/32SCTR, 2DRV 1. Boot the operating system from the primary controller and log in as a superuser (root). 2. Change to the system device configuration directory by typing: # cd /etc/conf/sdevice.d 3. Open the usc file by typing: # vi usc 4. Change the N in the second field of the fourth line in this file to Y as follows: change usc N -1 5 3 15 0 0 0 0 -1 to usc Y -1 5 3 15 0 0 0 0 -1 5. Rebuild the kernel by typing: # /etc/conf/bin/idbuild -B 6. Re-Boot the system by typing: # shutdown -y -i6 -g0 7. Refer to Part III of the addendum for instructions on adding drives to the second controller. Part III. Configuring Additional Drive. 1. Boot the system as superuser. 2. Type "diskadd cCtLd0" to configure drive L to an Controller C. NOTE: C represents the global controller number on the sysem. For primary controller, you would specify C as 0. For secondary controller, you would specify C as 1. 3. Continue to follow the instructions displayed on the screen to initialize the drive with a new file system. 4.3 ULTRA 34F VL-Bus SCSI Controller ADDENDUM TO THE ULTRA 34 VL-BUS HOST ADAPTER REFERENCE MANUAL Device Driver Installation for UNIX System V Release 4.2 This addendum describe the installation procedure for running ULTRA 34 VL- BUS SCSI Host Adapter in a local bus system under UNIX System Labs UNIX System V Release 4.2. Part I. Installing the ULTRA 34 as a Primary Bootable Controller There are two ways of installing the ULTRA 34 USC IHV HBA device driver. First is installing UNIX SVR4.2 to a new drive. Second, if the UNIX SVR4.2 operating system has been installed using another vendor's host adapter, such as AHA-154X, the installation procedure will replace the existing IHV HBA device driver with USC IHV HBA for ULTRA 34 device driver, and then re-boot the system with ULTRA 34 host adapter. A. Installing UNIX SVR4.2 using the ULTRA 34 SCSI Host Adapter NOTE: Refer to ULTRA 34 SCSI Host Adapter Reference Manual for congfiguring the ULTRA 34 in a local bus system. Certain configuartion options should be setup as follows for installing UNIX SVR4.2: BIOS Address Selection : C8000 or CC000/D0000/D4000/D8000/DC000 IRQ Selection : IRQ 14 Drive Mapping Mode : 64HD/32SCTR, 2DRV Other configruation options are user selectable and should be set based on the system requirements. The system CMOS drive type need to be set to None (or Not Installed) for drive 0 or drive 1. After the configuration is done, connect the hard disks and SCSI tape drives or CD-ROM to the ULTRA 34. Insert the "UNIX SVR4.2 Desktop Boot Floppy 1 of 3" and power up the system. After booting from diskette, insert the "ULTRA 34 VL-BUS SCSI Host Adapter USC IHV HBA Device Driver for UNIX System V Release 4.2" into the floppy drive when the following message appears: Remove the diskette labeled "Boot Floppy 1 of 3". If you have a diskette labeled "Host Bus Adapter Drivers", insert that diskette now. ..................... Continue the installation following the standard installation procedure of UNIX SVR4.2, either installing from floppy, catridge tape or CD-ROM. After all the packages are installed, re-insert the "USC IHV HBA for UNIX Sytem V Release 4.2" diskette when the following message appears: You must now reinsert the HBA diskette(s) that you used before. Please insert the diskette labeled: USC IHV HBA into the drive and press 'ENTER'. At the completion of the installation, a new UNIX kernel will be generated with ULTRA 34 USC IHV HBA device driver. The installaion is complete. B.Replaceing an Existing UNIX SVR4.2 System with ULTRA 34 The following procedure is for replacing the host adapter driver in a UNIX SVR4.2 system that was installed with another vendor's adapter. Step 1. Installing the ULTRA 34 USC IHV HBA device driver: Re-Boot the system wsing the installed host adapter. After the system boots up: 1. Login as a superuser (root). 2. Insert the "USC IHV HBA Device Driver for UNIX System V Release 4.2" disk in drive A: and type # pkgadd -d diskette1 3. After the installation, re-build the kernel and shutdown the system by typing: # /etc/conf/bin/idbuild -B # cd # shutdown -y -i0 -g0 Step 2. Configuring the ULTRA 34 Host Adapter in the system. After shutting the system down, replace the existing host adapter with with ULTRA 34. Refer to the ULTRA 34 SCSI Host Adapter Reference Manual for configuring the ULTRA 34 in an local bus system. Certain configuration options should be setup as follows for using UNIX SVR4.2: BIOS Address Selection : C8000 or CC000/D0000/D4000/D8000/DC000 IRQ Selection : IRQ 14 Drive Mapping Mode : 64HD/32SCTR, 2DRV Other configuration options are user selectable and should be set based on the system requirements. After the configuration is complete, re-boot the system. The system will will boot which include the ULTRA 34 USC IHV HBA device driver. Part II. Installing the ULTRA 34 as a Secondary Controller. The following procedure applies to a system configured with an ULTRA 14 or ULTRA 34 as the primary bootable controller. The procedure add the ULTRA 34 as the secondary controller. Configure the ULTRA 34 as follows: BIOS Address Selection : Any address higher than the primary controller IRQ Selection : IRQ 15 Drive Mapping Mode : 64HD/32SCTR, 2DRV 1. Boot the operating system from the primary controller and log in as a superuser (root). 2. Change to the system device configuration directory by typing: # cd /etc/conf/sdevice.d 3. Open the usc file by typing: # vi usc 4. Change the N in the second field of the fourth line in this file to Y as follows: change usc N -1 5 3 15 0 0 0 0 -1 to usc Y -1 5 3 15 0 0 0 0 -1 5. Rebuild the kernel by typing: # /etc/conf/bin/idbuild -B 6. Re-Boot the system by typing: # shutdown -y -i6 -g0 7. Refer to Part III of the addendum for instructions on adding drives to the second controller. Part III. Configuring Additional Drive. 1. Boot the system as superuser. 2. Type "diskadd cCtLd0" to configure drive L to an Controller C. NOTE: C represents the global contorller number on the sysem. For primary controller, you would specify C as 0. For secondary controller, you would specify C as 1. 3. Continue to follow the instructions displayed on the screen to initialize the drive with a new file system.