Adaptec 7800 Family Manager V1.02 for OS/2 2.X ============================================== (Supports AHA-2940 and AIC-78xx) Installation instructions for the AIC-7870 OS/2 2.x driver: =========================================================== Installing the driver on a system containing OS/2 2.x ----------------------------------------------------- 1) Open the OS/2 System Folder, then open the System Setup folder. 2) Double-click on Device Driver Install. 3) Insert the Manager Set floppy in the appropriate drive. 4) Change to the directory where the driver is located, usually OS2\2_X. 5) When you find the driver (AIC7870.ADD), select INSTALL. 6) After the install finishes, a message will appear to report the status. An error will be displayed if no host adapters are found. ** NOTE: If you are using OS/2 2.0 GA, the above method will not work. To install under 2.0 GA, open a full-screen OS/2 session. Change to the drive and directory on the floppy where the drivers are located. Type DDINSTAL and press ENTER. You may also install the driver manually. Copy AIC7870.ADD to C:\OS2. Add a line to your CONFIG.SYS that says BASEDEV=AIC7870.ADD . Intel Errata #8511 lists known data integrity issues with the processor cache on the Saturn-1 chipset (82424TX). For this reason Adaptec recommends that processor cache be disabled via the CMOS setup to avoid data corruption. For more information, see Intel Errata #8511. You may get this from Intel's FaxBack system at 800.628.2283 or 916.356.3105. For more detailed information see Errata #8512 and 8513. Installing OS/2 2.1 and higher from floppy diskette --------------------------------------------------- 1) Make backup copies of the Installation Diskette and Disk #1. 2) Using the backup copies of the Installation Diskette and Disk #1 do the following: a) Copy OS2LDR from the 7800 Manager Set onto the Installation Diskette. b) Copy IBMINT13.I13 from the 7800 Manager Set onto Disk #1. 3) Install OS/2 using the backup diskettes and the remainder of the standard OS/2 diskettes. 4) When installation has completed, reboot the system. 5) After the system has rebooted, follow the instructions for installing the driver on a system containing OS/2. ***** IMPORTANT ***** There is currently no support for installing OS/2 2.0 on a hard drive attached to an AIC-7870, due to limitations in the installation procedure. Upgrading to OS/2 2.1 or higher is recommended. Installing OS/2 2.x from CD-ROM ------------------------------- 1) Make a backup copy of Disk #1. 2) Copy the file AIC7870.ADD to the backup copy of Disk #1. 3) Using a text editor, add the following line to the CONFIG.SYS found on Disk #1 : BASEDEV=AIC7870.ADD 4) When installation has completed, reboot the system. General Installation Notes -------------------------- OS/2 2.x currently does not identify PCI systems and handles them in the same way it would an ISA system. This can cause several different problems: trouble installing OS/2 2.x and an inability to share a single interrupt between multiple PCI adapters. IBM is aware of these problems and has open APARs (PJ14230 and PJ14710) tracking them. They will be fixed in a future release of OS/2; please check the list of closed APARs accompanying each future release. Currently, we have files which can be used as interim fixes for both these problems: OS2LDR - A new PCI aware version of the loader. This file can be used during installation or installed after the installation of OS/2 has completed. IBMINT13.I13 - A new PCI aware version of the generic INT 13H driver that is used during installation from floppy disk. If you update Disk #1 of the CD-ROM installation to include OS2LDR, please be aware that this file will be overwritten from the CD-ROM. It may have to be updated again on the boot drive when the installation has completed. Configuration: ============== Generic command line switches for Adaptec drivers and OS/2 2.X =============================================================== OS/2 adapter device drivers (.ADD files) are normally installed automatically and require no further information from the user. However, in certain situations the user may wish to modify the behavior of the driver to meet their specific needs. ***** IMPORTANT ***** Please proceed cautiously with the following information. If you have purchased software which requires you to use switches, it should include instructions on how to use them. Most software requires no switches and you do not need to concern yourself with the information about switch settings. The standard format for command line switches is : BASEDEV=AIC7870.ADD [Universal Parameter][Adapter ID][Unit Parameter] {[SCSI Target ID]} [Universal Parameter] - An option that applies to all adapters controlled by the driver. [Adapter ID] - /A:n, where n is the number (zero relative) of the adapter installed in the system. The adapter ID is determined when the driver is loaded based on the order that adapters are found in the system. (See below, AIC7870.ADD Specific Command Line Switches.) [Unit Parameter] - Modifies the behavior of the selected host adapter. [SCSI Target ID] - The targets to which the Unit Parameter will be applied. This parameter may be a single ID (d) or list of IDs (d,d,d). Universal Parameters -------------------- /ET - Allow embedded targets. This parameter indicates that the ADD should assume that all targets have more than one logical unit (LUN) defined. /!ET - Do not allow embedded targets (DEFAULT). This parameter indicates that the ADD should assume that all targets have only one logical unit (LUN) defined. /V - Load driver verbosely. This parameter will display the driver name as well as the version number and Adaptec copyright if the driver loads successfully. Information on all targets found in the system will also be displayed. General Unit Parameters ----------------------- /I - Ignore the specified adapter. This allows another driver to share the adapters that the ADD would normally use. /DM - Enable DASD manager support (DEFAULT). This parameter allows OS2DASD.DMD to control the specified target(s) if they are identified as DASD (hard disk) devices. /!DM - Disable DASD manager support. This parameter prevents OS2DASD.DMD from controlling the specified target(s). /SM - Enable SCSI manager support (DEFAULT). This parameter allows OS2SCSI.DMD to control the specified target(s) if they are identified as NON-DASD SCSI devices. All SCSI hard drives will be controlled by OS2DASD.DMD. /!SM - Disable SCSI manager support. This parameter prevents OS2SCSI.DMD from controlling the specified target(s). Configuration Examples ---------------------- Example 1 Suppose that you had a removable hard drive as target 3 and you wanted to control the hard drive with an ASPI application and driver. Normally OS2DASD will allocate this device, treat it as a large floppy and prevent you from sending any SCSI commands via ASPI. BASEDEV=AIC7870.ADD /A:0 /!DM:3 will prevent OS2DASD.DMD from accessing the target and still allow OS2SCSI.DMD and OS2ASPI.DMD to share access to it. Example 2 Suppose that you had a multi-disk CD-ROM as target 4 on host adapter 0 and two DASD devices as targets 1 and 5 on host adapter 1. BASEDEV=AIC7870.ADD /ET /A:0 /!SM:4 /A:1 /!DM:1,5 will prevent OS2SCSI.DMD from accessing the CD-ROM and prevent OS2DASD.DMD from controlling the DASD devices. The driver will also search for multiple LUNs on all host adapters. Important Tips -------------- 1) There are no switches for controlling OS2ASPI.DMD directly. IBM did not define them in their specification and we cannot be sure that other host adapters will have the same switches. 2) OS2SCSI.DMD will only allocate devices when a device driver requests it, but this will prevent OS2ASPI from accessing it. There is nothing in the ASPI specification regarding device allocation so OS2ASPI must rely on other managers to fairly share targets. This should only be a problem if you have two drivers that use different managers and you want them both to access the same target at the same time. 3) Do NOT disable DASD manager access to target 0 if you are booting from your SCSI host adapter. This will prevent the system from booting! AIC7870.ADD-specific command line switches ========================================== This driver supports the AIC-7870 installed on an AHA-2940 PCI host adapter. Adapter numbers are first assigned to boards with their BIOS enabled; the numbers are assigned from lowest BIOS address to highest address. Any remaining boards are assigned numbers by scanning slots. Each slot is a combination of a bus number and a device number pair starting from lowest to higest numbers, and the adapters are assigned a number in the order they are found. Special Unit Parameters: ------------------------ /TAG: - Sets the number (1-16) of tagged commands for all target devices on the host adapter. A value of one disables tagged queuing. 16 is the maximum number allowed and 8 is the default value. /TAG:1 Disables tagged queuing for all target devices on a given host adapter. The driver maintains a maximum of 2 non- tagged commands per target internally. The driver treats all target devices as non-tagged devices, and sends only one command at a time per target to the host adapter. Example: BASEDEV=AIC7870.ADD /A:0 /TAG:8 will set the number of tagged commands for all target devices on the first host adapter to 8. Limitations: ============ Due to an OS problem, OS/2 cannot currently support more than one AHA-2940 (AIC7870) host adapter board. IBM is working to fix this. Contact IBM for the status of this problem (APAR PJ14230). Fault Tolerance is now supported in the driver. However, ABORT and SCSI BUS RESET will only work for targets that are properly behaved.