Back to Contents Page
| Overview | Installing the Driver When Installing OS/2 | Installing the Driver When OS/2 is Already Installed | Using Command Line Options | Troubleshooting |
This chapter explains how to install the Adaptec 7800 Family Manager Set Driver for OS/2. The aic7870.add driver supports Ultra SCSI devices for OS/2 v.2.1x, and OS/2 Warp3.x, 4.x, and 4.x SMP. The aic78u2.add driver supports Ultra2 SCSI devices for OS/2 Warp 3.x, 4.x, and 4.x SMP. Refer to the list of Adaptec 7800 Family Host Adapters.
If you are installing OS/2 for the first
time, see Installing the Driver
When Installing OS/2. If OS/2 is already installed in your system, see Installing the Driver When
OS/2 is Already Installed.
To install the aic7870.add or aic78u2.add driver at the same time you install OS/2, follow the instructions below for the version of OS/2 you are installing.
|
NOTE: When installing OS/2 from a CD-ROM, be sure the CD-ROM SCSI ID is not set to 0 or 7. |
Follow these instructions only if you are installing OS/2 v2.1x for the first time. We assume here that OS/2 is not already installed on the system. You will need to have access to a computer where you can copy DOS files from one diskette to another.
|
NOTE: To install the aic7870.add driver, it is necessary to copy the driver from the 7800 Family Manager Set diskette for OS/2 on to the OS/2 installation diskette #1. However, before you can copy the driver, you must first remove various files from the OS/2 installation diskette #1, as explained in step 2 below. |
1. Go to a computer on which DOS, Windows®, or OS/2 is already installed. Use diskcopy to make backup copies of all IBM OS/2 and Adaptec-supplied diskettes. Use the backup copies as your working diskettes.
2. Delete some of the existing files on the backup copy of the OS/2 diskette #1 so that approximately 120 KBytes of disk space is available on the diskette. Use the following information to help you decide which files to delete:
- If the Adaptec 7800 Family host adapter is the only Adaptec host adapter installed in your system, delete all Adaptec drivers (aha152x.add, aha154x.add, aha164x.add, aha174x.add, aic7770.add, and fd16_700.add).
- If you have an Adaptec host adapter that is not part of the 7800 Family, delete all of the Adaptec drivers not used by that particular host adapter. For example, if you have an Adaptec AHA-1540CP host adapter installed in your computer, delete all Adaptec drivers except for the aha154x.add driver.
- If you have deleted the suggested Adaptec drivers above, and you still do not have approximately 120 KBytes of disk space available on the diskette, delete these files: ibm2flpy.add, ibm2adsk.add, and ibm2scsi.add.
3. Copy the os2ldrfile from the 7800 Family Manager Set diskette for OS/2 (i.e., \os2\aic7870\) onto the OS/2 installation diskette.
4. Copy the ibmint13.i13 and the aic7870.add
files from the 7800 Family Manager Set diskette for OS/2 (i.e., \os2\aic7870\) onto
the
OS/2 diskette # 1.
5. Add the following line to the config.sys file on diskette #1:
basedev=aic7870.add
6. Run the OS/2 v2.1x installation program; follow the instructions in your OS/2 documentation.
7. At the end of the installation process, follow the onscreen instructions to remove the last OS/2 distribution diskette and reboot the computer.
8. After the computer has restarted, OS/2 displays a welcome screen. You have the option to view online information while the OS/2 desktop is building. Allow OS/2 to finish building.
|
NOTE: Refer to the readme.txt file for any additional information on installing OS/2 v2.1x and the driver. |
Follow these instructions only if you are installing OS/2 Warp 3.x, 4.x, and 4.x SMP for the first time. The instructions are the same for these versions of OS/2, unless otherwise stated. We assume here that OS/2 is not already installed on the system. You will need to have access to a computer where you can copy DOS files from one diskette to another.
|
NOTE: To install the aic7870.add or aic78u2.add driver, it is necessary to copy the driver from the Adaptec 7800 Family Manager Set diskette for OS/2 on to the OS/2 installation diskette #1. However, before you can copy the driver, you must first remove various files from the OS/2 installation diskette #1, as explained in step 2 below. |
1. Go to a computer on which DOS, Windows, or OS/2 is already installed. Use diskcopy to make backup copies of all IBM OS/2 and Adaptec-supplied diskettes. Use the backup copies as your working diskettes.
2. Delete some of the existing files on the backup copy of the OS/2 installation diskette #1 so that approximately 140 KBytes of disk space is available on the diskette. Use the following information to help you decide which files to delete:
- If the Adaptec 7800 Family host adapter is the only Adaptec host adapter installed in your system, delete all Adaptec drivers (aha152x.add, aha154x.add, aha164x.add, aha174x.add, aic7770.add, and fd16_700.add).
- If you have an Adaptec host adapter that is not part of the 7800 Family, delete all of the Adaptec drivers not used by that particular host adapter. For example, if you have an Adaptec AHA-1540CP host adapter installed in your computer, delete all Adaptec drivers except for the aha154x.add driver.
- If you have deleted the suggested Adaptec drivers above, and if you do not have a Microchannel architecture system, and you still do not have approximately 120 KBytes of disk space available on the diskette, delete these files: ibm2flpy.add, ibm2adsk.add, and ibm2scsi.add.
|
NOTE: If you have a combination PCI/Microchannel architecture system, you need to delete third-party driver files not required. |
3. Copy the aic7870.add or aic78u2.add driver from the 7800 Family Manager Set diskette for OS/2 onto the OS/2 installation diskette #1. This overwrites any existing version of the driver included on diskette #1.
|
NOTE: The aic7870.add driver resides in the \os2\aic7870 directory and the aic78u2.add driver resides in the \os2\aic78u2 directory. |
4. For each driver removed from the OS/2 diskette #1, remove its corresponding line in the config.sys file (also on OS/2 diskette #1).
For example, if you deleted all Adaptec drivers, as explained in Step 2a, above, remove the following lines from the config.sys file:
basedev=aha152x.add
basedev=aha154x.add
basedev=aha164x.add
basedev=aha174x.add
basedev=aic7770.add
basedev=fd16_700.add
5. In the config.sys file on OS/2 diskette #1, add the following line:
set copyfromfloppy=1
This line must be added so that the
install process copies the aic7870.add or aic78u2.add driver from the OS/2
diskette #1, instead of the aic7870.add driver included on your OS/2 CD-ROM.
|
NOTE: For OS/2 Warp 4.0 or 4.0 SMP users only, add the basedev=aic7870.add or basedev=aic78u2.add line to the top line of the config.sys file on OS/2 diskette #1. This will result in two basedev=aic7870.add or basedev=aic78u2.add statements existing in the config.sys file. |
6. Run the OS/2 installation program; follow the instructions in your OS/2 documentation until you reach the System Configuration window.
7. In the System Configuration windows, click the SCSI Adapter Support icon.
8. Deselect any highlighted adapters
(including the Adaptec 294x, 394x, AIC7870 PCI SCSI), and click OK. The text box
for SCSI Adapter Support should say None.
|
NOTE: If these adapters are not deselected, the driver included on the CD-ROM will be copied over the driver being installed. |
9. Follow the instructions in your OS/2 documentation to complete the installation.
|
NOTE: The update files os2ldr and ibmint13.i13 included with the Adaptec 7800 Family Manager Set are not needed when installing OS/2 Warp. |
10. After installation is complete, verify that only one basedev=aic7870.add statement exists in the config.sys file on your hard drive. Remove other instances if more than one is found.
To update or install the aic7870.add or aic78u2.add driver if OS/2 is already installed, follow the instructions below. The procedures are similar for all versions of OS/2. Procedures that are specific to an OS/2 version are noted when necessary.
If you are updating the driver, simply copy the aic7870.add or aic78u2.add driver from the 7800 Family Manager Set diskette for OS/2 (e.g., \os2\aic7870.add or \os2\aic78u2.add) into the \os2 directory (for OS/2 v2.1x) or \os2\boot directory (for OS/2 Warp 3.x, 4.x, or 4.x SMP) on your hard disk. (Make a backup copy of the older driver before doing this.) This overwrites any existing version of the driver in the directory. Updating of the driver is complete; do not continue with Steps 3 through 5.
|
NOTE: The aic78u2.add driver does not support OS/2 v2.1x |
If OS/2 has been installed and does not recognize the Adaptec 7800 Family host adapter, or if you are adding your Adaptec 7800 Family host adapter to your OS/2 computer, you need to install the driver. To do so, continue with Step 2:
1. Run the ddinstal program by
selecting the Device Driver Install icon from the System Setup folder or by typing
ddinstal at the OS/2 prompt.
|
NOTE: If you are running OS/2 v2.1x, change to the directory containing aic7870.add and associated files and run ddinstal from the OS/2 prompt. |
 |
CAUTION: If you are running OS/2 v2.1x GA, do not run Device Driver Install from the System Setup folder. Instead, open a full screen OS/2 session and change to the drive with the 7800 Family Manager Set diskette for OS/2. Then type ddinstal and press Enter. |
2. Insert the Adaptec 7800 Family Manager Set diskette for OS/2 in the appropriate disk drive and follow the prompts from ddinstal.
The computer scans for the host adapter(s). If a host adapter is found, the Installing Device Drivers message appears. Another message appears when the driver is successfully installed. If no host adapters are found, an error message appears.
3. Reboot the computer for the changes to take effect.
Once installed, the aic7870.add or aic78u2.add driver does not usually require any modifications to its configuration. In certain situations, however, you may wish to add command line options to the driver to meet your specific needs. The command line options described in this section can be used in OS/2 v2.1x and OS/2 Warp 3.x and 4.x.
The aic7870.add or aic78u2.add driver command line resides in the config.sys file. Command line options are not case sensitive, and take effect after the computer is rebooted. The command line syntax is
basedev=aic7870.add [Universal Parameters] [Adapter ID]
[Unit Parameters:
[SCSI Target ID]]
or
basedev=aic78u2.add [Universal Parameters] [Adapter ID]
[Unit Parameters:
[SCSI Target ID]]
|
CAUTION: Your computer may not boot if you enter the command line options incorrectly. |
/et
/!et
No embedded targets allowed. Makes the driver
assume that all targets have only one LUN defined. (This is the default setting.)
/v
Verbose mode. Information such as the driver
name, version number, and Adaptec copyright appears if the driver loads successfully. Also
displays information about all targets found in the computer.
/pcihw
PCI configuration hardware registers. Enables
driver to access PCI configuration hardware registers. This switch is available for some
PCI systems that run into problems when trying to access PCI configuration space through
PCI BIOS function calls. (This is the default setting.)
/!pcihw
Disables the /pcihw switch. This parameter
will cause the driver to access the PCI configuration space though PCI BIOS function
calls.
/a:n
Replace the italicized letters (x,y,z) in the switch descriptions below with the SCSI target ID(s) of the device(s) that you want affected. The IDs may be a single ID (x) or a list of IDs (x,y,z). The IDs must be separated by commas.
/dm:x,y,z
Enables Direct Access Storage Device (DASD)
manager support. Allows os2dasd.dmd to control the specified target(s) when they
are identified as DASD devices. (This is the default setting.)
/!dm:x,y,z
Disables DASD manager support. Prevents os2dasd.dmd
from controlling the specified target(s).
|
CAUTION: Do not disable DASD manager support to the boot drive, or the computer will not be able to boot. |
/sm:x,y,z
/!sm:x,y,z
Disables SCSI manager support. Prevents os2scsi.dmd
from controlling the specified target(s).
/tag:x
Specifies the maximum number of tagged
commands for all target devices on the host adapter (1-16). A value of 1 disables tagged
queuing. The maximum number allowed is 16. (The default is 8.)
/i
Ignores the host adapter. The driver ignores
the host adapter so that another driver may control it.
/ur
Enables reporting of underruns.
/!ur
Disables reporting of underruns. (This is the
default setting.)
Suppose that you have a removable-media drive as target 3. Normally os2dasd allocates this device, treats it as a large floppy, and prevents you from sending any SCSI commands via another device manager. The command line below prevents os2dasd.dmd from accessing the target and allows os2scsi.dmd and os2aspi.dmd to share access to it:
basedev=aic7870.add /a:0 /!dm:3
or
basedev=aic78u2.add /a:0 /!dm:3
Suppose that you have a multidisk CD-ROM as target 4 on host adapter 0 and two DASD devices as targets 1 and 5 on host adapter 1. The command line below prevents os2scsi.dmd from accessing the CD-ROM and os2dasd.dmd from controlling the DASD devices. The driver searches for multiple LUNs on all devices.
basedev=aic7870.add /et /a:0 /!sm:4 /a:1 /!dm:1,5
or
basedev=aic78u2.add /et /a:0 /!sm:4 /a:1 /!dm:1,5
|
NOTE: There are no switches for directly controlling os2aspi.dmd, the ASPI device manager. |
How do I assign an interrupt for the host adapter?
During installation, OS/2 fails to find
the hard drive.
Make sure the latest driver from Adaptec has
been installed. Add the /pcihw or /!pcihw command option to the basedev=aic7870.add (or aic78u2.add)
driver statement in the config.sys file.
Does extended translation need to be
enabled on the host adapter to support drives greater than 1GByte?
Under OS/2, if you are using a FAT file
system and/or switching back and forth from DOS, extended translation should be enabled.
If you are using HPFS (High Performance File System), extended translation may or may not
be enabled. Once the driver for the host adapter loads, the remaining hard drive space
will be seen beyond 1024KBytes.
The error messages listed below are the messages associated with the aic7870.add or aic78u2.add driver. Messages are listed sequentially according to the last three digits of the error code. For example, [xxxxx080], [xxxxx081], [xxxxx082], etc.
|
NOTE: When reporting problems to Customer Support, be sure to include the complete error code in your problem description. |
[xxxxx080] Unable to allocate memory
[xxxxx081] Adapter software
initialization failure
An error has occurred while the driver was
setting up its internal data structures. Verify that your adapter is supported by this
version of the driver.
[xxxxx082] Internal driver error
An error has occurred while the driver was
setting up its internal data structures. Try installing the most up-to-date version of the
driver available from the Adaptec Web site or BBS.
[xxxxx083] Adapter not supported by
this version of the driver
Your adapter is not supported by the driver
on your system. You may have installed a new adapter and have not updated the driver on
your system.
[xxxxx084] Adapter software
initialization failure
An error has occurred while the driver was
setting up its internal data structures. Try installing the most up-to-date version of the
driver available from the Adaptec Web site or BBS.
[xxxxx085] Unable to allocate memory
This indicates that there may be a problem
with the amount of memory installed in your system. Verify that your system has at least
the minimum amount of memory required by your operating system.
[xxxxx087] Internal driver error
An error has occurred while the driver was
setting up its internal data structures. Try installing the most up-to-date version of the
driver available from the Adaptec Web site or BBS.
[xxxxx088] Adapter software
initialization failure
An error has occurred while the driver was
setting up its internal data structures. Try installing the most up-to-date version of the
driver available from the Adaptec Web site or BBS.
[xxxxx089] Unable to allocate memory
This indicates that there may be a problem
with the amount of memory installed in your system. Verify that your system has at least
the minimum amount of memory required by your operating system.
[xxxxx096] Adapter hardware
initialization failure - possible resource conflict
The driver has attempted to initialize the
adapter hardware but failed. This might suggest that the adapter resources (e.g., IRQ)
conflict with the resources of another board installed in your system.
[xxxxx099] Adapter software
initialization failure
[xxxxx09a] Adapter software initialization
failure
[xxxxx09b] Adapter software initialization
failure
An error has occurred initializing one of the
driver's internal data structures for a device connected to the adapter. This may result
in problems accessing the device. Try installing the most up-to-date version of the driver
available from the Adaptec Web site or BBS.
[xxxxx0a7] Unable to allocate memory
This indicates that there may be a problem
with the amount of memory installed in your system. Verify that your system has at least
the minimum amount of memory required by your operating system.
[xxxxx0a9] Possible interrupt conflict
This indicates that the adapter IRQ conflicts
with the IRQ of another board installed in your system. Check your hardware documentation
for instructions on setting and changing IRQs.
[xxxxx0c9] Invalid command line
parameter
A command line option for the driver is
invalid. See Using Command Line Options
for valid command line options.
[xxxxx0ca] Invalid command line syntax
[xxxxx0cb] Invalid command line syntax
[xxxxx0cc] Invalid command line syntax
The command line syntax for the driver is
incorrect. See Using Command Line Options
for entering the correct syntax.
[xxxxx07c] Unable to allocate memory
[xxxxx07d] Unable to allocate memory
[xxxxx07e] Unable to allocate memory
[xxxxx07f] Unable to allocate memory
This indicates that there may be a problem
with the amount of memory installed in your system. Verify that your system has at least
the minimum amount of memory required by your operating system.