************************************************************************* * * * * * BusLogic NetWare V3.11/V3.12 Disk/ASPI Device Drivers Ver. 2.38 * * * * and * * * * BusLogic NetWare V4.00/V4.01/V4.02/V4.10 * * Disk/ASPI Device Drivers Ver. 1.38 * * * * * ************************************************************************* The following paragraphs describe the features and command line options supported by BusLogic's Netware 3.11/3.12 and Netware 4.00/4.01/4.02/4.10 drivers - BT31X.DSK and BT4X.DSK respectively. The examples contained in these paragraphs reference BT31X.DSK, our Netware 3.11/3.12 driver. If you are in a Netware 4.0x environment, please substitute BT4X.DSK wherever BT31X.DSK is referenced below. Also, please substitute Netware 4.x wherever Netware 3.1x is referred to. BusLogic's ASPI Support Manager, BTASPI.DSK, remains the same for both the Netware 3.1x and Netware 4.x platforms. NOTE!! Netware 4.00/4.01/4.02/4.10 contains a BusLogic device driver in the Red Box shrinkwrap - BT40.DSK. The driver on this diskette - BT4X.DSK is an update to that shrinkwrap driver. If you choose to use the updated driver, you should copy it ALONG WITH the file BT4X.DDI (located in the same directory - NW4X - on the BusLogic Software Driver diskette) to whatever disk directory the older BusLogic driver (BT40.DSK) resides in. Note the name change: BT40.DSK changed to BT4X.DSK. You may also have to change existing STARTUP.NCF files which reference the old file name to reference the new driver. For new installations, you may install the updated driver directly by choosing the INSERT option from the INSTALL menu when prompted for additional disk drivers - or you may install this driver when installation is completed as described immediately above. BusLogic's Netware 3.11/3.12 driver - BT31X.DSK, and BusLogic's Netware 4.00/4.01/4.02/4.10 driver - BT4X.DSK, both include support for SCSI-II Tagged Queuing. BusLogic's Netware device drivers support BusLogics' ISA, EISA, Microchannel, VESA (Local Bus), and PCI Bus SCSI host adapters. BTASPI.DSK is BusLogics'ASPI Support Manager for Netware/386. In addition to standard NetWare disk support, the drivers provide the following features: 1) Removable device support (including fixed disk, MO, and CD-ROM) 2) ASPI support 3) NetWare ready support 4) Scatter/gather support 5) ISA host adapter support in a greater-than-16MByte-memory environment 6) SCSI Tagged Queuing Support Notes: Netware 4.x Installation from CDROM ------------------------------------------ To successfully install Netware 4.x from a given CDROM device, you MUST: a) Use the "/m" switch with the BusLogic DOS Manager (BTDOSM.SYS) in your DOS config.sys file (see your BusLogic SW-110 or SW-191 Installation Guide for more details). b) Use the BusLogic Netware 4.x driver "Exclude_IDs" switch (documented below) for the CDROM drive from which you are installing. Once installation is completed, you may modify your Netware startup.ncf file and remove the "Exclude_IDs" switch for this device if you wish to use it under Netware 4.x in conjunction with Novell's CDROM.NLM nlm. ASPI support ------------ To use the BusLogic driver without ASPI support, simply load the BusLogic driver BT31X.DSK: load bt31x To enable BusLogic ASPI support, load BT31X.DSK followed by a load of the BusLogic ASPI Support Manager BTASPI.DSK: load bt31x load btaspi BTASPI.DSK may only be loaded once regardless of how many times you load BT31X. "Over16Meg" Switch ------------------ If you wish to run one or more ISA (BT-542B) BusLogic host adapter in a system with more than 16 meg of memory you must use the following switch on the FIRST load of the BusLogic driver. load BT31X Over16Meg The presence or absence of this command line switch on subsequent loads of the driver will be ignored. When the "Over16Meg" switch is invoked, the following line should be added to your startup.ncf file to enlarge the pool of available buffers below 16 meg: set Reserved Buffers Below 16 Meg=200 "Exclude_IDs" Switch --------------------- If you wish to exclude one or more Disk or CDROM SCSI devices from being reported to Netware when they are found by the BusLogic driver, you may use this option to do so. These devices can then be reserved for ASPI Netware applications such as: - Disk array software which needs to present several SCSI devices as a single logical device to the operating system - 3rd party software controlling CDROM devices through an ASPI interface. To specify which devices to hide on this host adapter, enter one or more SCSI target IDS separated by commas. For example: load BT31X Exclude_IDs = 1,2 This would hide SCSI target 1 and target 2 from the operating system. New SBackup required (3.11 only) -------------------- NOTE: To run Novells' SBackup, you must download a later version from CompuServe. The version shipped with Netware v3.11 looks specifically for Adaptec's Aspitran module and will not work with any other ASPI manager such as BTASPI.DSK from BusLogic. To download the new version, type "go novlib" in CompuServe. Then browse on keyword "Sbackup" in file library 1 to find the appropriate file. Note: This applies to Netware 3.11 ONLY. Other versions of Netware (i.e. Netware 3.12 ) come with BusLogic-compatible versions of SBackup. "Enable_TQ" Switch ------------------ Tagged Queuing is an advanced SCSI-II feature which allows overlapped commands to a SCSI device, thus enhancing performance. The BusLogic SCSI Host Adapters provide support for this feature. However, many SCSI devices do not, and both the host adapter and the SCSI device must support Tagged Queuing in order to take advantage of this feature. The BusLogic SCSI Disk Driver defaults to Tagged Queueing DISABLED for all devices on all BusLogic Host Adapters. Use the ENABLE_TQ switch to enable Tagged Queueing on a given BusLogic Host Adapter: load BT31X Enable_TQ This will only affect those SCSI devices connected to this Host Adapter which also support Tagged Queueing. The maximum number of Tagged requests outstanding is specified by MaxActive switch described below. "MaxActive" Switch --------------- This switch allows you to modify the maximum number of outstanding requests per device allowed at any one time: load BT31X MaxActive=2 Modification of this parameter will allow you to tune the driver for maximum performance based on your specific configuration. Valid values are 1 through 60. If this switch is not specified, the default is value is 1. If you specify the MaxActive switch in conjunction with the Enable_TQ switch, the MaxActive switch will actually control the maximum number of Tagged Queue requests outstanding: load BT31X Enable_TQ MaxActive=4 If you specify the MaxActive switch without specifying the Enable_TQ switch, the MaxActive switch will actually control the maximum number of non-tagged requests outstanding (queued at the Host Adapter, rather than at the device, level). For some Disk Array applications, assignment of larger values to MaxActive may result in optimal performance. In the absence of this switch , the driver will either use the default value of 1 (in many cases, best performance may be achieved by using the default) or will use a built-in performance-optimizing auto-adjusting algorithm. "LongTimeout" Switch -------------------- This switch allows you to increase the amount of time the driver's watchdog timer routine will wait before attempting to abort a CCB which has not finished. The default (if this switch is not invoked) is 10 seconds. If the switch is invoked, the timeout value is increased to 60 seconds. Only special hardware applications which anticipate long periods of time during which a device may remain busy will find this switch useful. In general, it should be ignored. load BT31X LongTimeout "No_Rescan" Switch ------------------ This switch should be used in conjunction with ASPI applications when specifically recommended by the ASPI software vendor/supplier. Otherwise, it should be IGNORED. *** ASPI Developers *** : This switch has the effect of causing the ASPI Get Device Type SRB to return table-driven information about the devices detected during an initial scan. Using the switch will inhibit the ASPI manager from going back out on the SCSI bus to look for the specified device on behalf of this SRB type. The absence of the switch causes the ASPI manager to issue a SCSI inquiry on behalf the the specified device. Syntax is as follows: load BT31X no_rescan "Verbose" Switch ---------------- This switch has the effect of enabling display information about specific driver configuration options. load BT31X verbose "Wide" Switch ------------- This switch has the effect of enabling support for up to 15 SCSI targets if the specified host adapter has this level of support in firmware. If not, the switch is ignored and up to 8 targets are supported. load BT31X wide "NumLuns" Switch ---------------- This switch specifies the number of Logical Units (LUNs) the host adapter will support (try to detect). If the switch is not specified, the default is 8. Valid range is from 1 to 64. If the host adapter only has embedded SCSI targets attached (that is, all attached devices are at LUN 0), it is recommended to set this option value to 1 to turn off LUN support for LUNS other than 0. Ex. 1: load BT31X numluns=1 (limits support to LUN 0 on each SCSI target) Ex. 2: load BT31X wide numluns=64 (enables support for 16 targets/64 luns per target) "PCI" Switch ---------------- This switch enables auto-detection/load (i.e., register with Netware) of first-found available (not yet registered) BusLogic PCI-compliant Host Adapter. If you attempt to register a BusLogic PCI-compliant host adapter at a legacy address range (330,334,etc.), you will be prompted to reload the driver using the PCI switch. load BT4X PCI "ShowPorts" Switch ------------------ If you have multiple BusLogic PCI-compliant host adapters in the system and you wish to override the default auto-load ordering for these cards, use this switch to manually select from a list of available PCI host adapters. load BT4X PCI ShowPorts To reach us & the latest drivers and information: Tech Support: (408) 654-0760 FAX: (408) 492-1542 BBS: (408) 492-1984 Email: techsup@buslogic.com FTP Site: ftp.buslogic.com (204.160.180.11) WWW Page: http://www.buslogic.com