home *** CD-ROM | disk | FTP | other *** search
/ Computer Installation Guide - Dragon Clan Series / CD2.iso / SCSI / SC200 / NETWARE / NETWARE.TXT < prev    next >
Encoding:
Text File  |  1994-10-14  |  17.8 KB  |  493 lines
  1. *******************************************************************
  2.                 NETWARE.TXT
  3. *******************************************************************
  4. This file describes the features and use of the NCR SDMS device 
  5. drivers for the Novell NetWare v3.1x and v4.x operating system 
  6. environments. It is divided into the following sections:
  7.  
  8. Introduction
  9. NetWare v3.1x, and v4.x
  10.     Features
  11.     Description
  12.     Installation
  13.     Command Line Options
  14.     Troubleshooting
  15. *******************************************************************
  16.  
  17.  
  18. *************************** Introduction **************************
  19.  
  20. The NCR SDMS 3.0 drivers allow the user to utilize an NCR SCSI 
  21. controller or processor, controlled by an NCR SCSI BIOS, with 
  22. NetWare. The SDMS 3.0 software, coupled with an NCR SCSI controller 
  23. or processor, provides an NCR SCSI solution within the NetWare 
  24. environment.
  25.  
  26. Separate drivers are provided for Novell NetWare v3.1x, and Novell 
  27. NetWare v4.x. The following information will assist in a successful 
  28. installation of the NCR SDMS SCSI drivers.
  29.  
  30.  
  31. *********************** NetWare v3.1x, and v4.x *******************
  32.  
  33. * Features *
  34.  
  35. Supports the ASPI interface
  36. Provides synchronous negotiation (including fast SCSI)
  37. Supports multiple host adapters
  38. Allows multiple logical unit number (LUN)
  39. Supports Disconnect/Reselect
  40. Supports scatter-gather
  41. Supports tagged command queuing
  42. Allows shared interrupts
  43. Supports Wide SCSI (single-ended and differential)
  44. Supports device exclusion
  45. Supports NWOS2 
  46.  
  47.  
  48. * Description *
  49.  
  50. There is a separate NCR SDMS 3.0 device driver and ASPI manager for 
  51. each of two major releases of NetWare. For NetWare v3.1x, the main 
  52. SDMS device driver is NCRSDMS3.DSK, and the file ASPICAM3.NLM is 
  53. loaded if support for the ASPI interface is desired (this is 
  54. required for devices such as tape drives). For NetWare v4.x, the 
  55. main SDMS device driver is NCRSDMS4.DSK, and the file ASPICAM4.NLM 
  56. is loaded if support for the ASPI interface is desired.
  57.  
  58.  
  59. * Installation *
  60.  
  61. Install NetWare as described in the Novell NetWare Installation 
  62. Manual. The following information is provided to assist in the 
  63. installation.
  64.  
  65. For An Existing Installation Of NetWare With NCR SDMS Drivers:
  66.  
  67. Replace the NCRSDMSx.DSK and ASPICAMx.NLM drivers with the ones 
  68. supplied on the NCR device drivers diskette.  No other actions 
  69. should be repuired to use these new drivers. You may may want 
  70. toreview the command line options to insure you are using the 
  71. best options for your configuration.
  72.  
  73.  
  74. For NetWare v3.1x New Installations:
  75.  
  76. 1. Create a directory to which the NetWare file server is to be 
  77. installed. Change to that directory and copy all the files from 
  78. the NetWare system disks into that directory.
  79.  
  80. 2. Copy the file NCRSDMS3.DSK from the NCR device drivers diskette 
  81. into this directory. If ASPI support is desired, also copy 
  82. ASPICAM3.NLM. 
  83.  
  84. 3. To start NetWare and continue the installation, type:  
  85.     
  86.     SERVER
  87.  
  88. 4. When prompted, enter the name of the file server and network 
  89. (IPX) number.  See the chapter on file server installation in the 
  90. NetWare Installation Manual for restrictions and further 
  91. information.
  92.  
  93. 5. At the NetWare prompt, type:
  94.     
  95.     LOAD NCRSDMS3 <options>
  96.  
  97. This command will cause the main driver to be loaded. Without this 
  98. command, NetWare will be unable to access the hard disk drive. If 
  99. ASPI support is desired, also type:
  100.     
  101.     LOAD ASPICAM3
  102.  
  103. 6. To bring up the Installation menu, at the NetWare prompt type:
  104.     
  105.     LOAD INSTALL
  106.  
  107. Continue with the installation according to the file server 
  108. installation chapter in the Novell NetWare Installation Manual.
  109.  
  110. 7. At the Available System Options menu, select the EDIT STARTUP.NCF 
  111. option and check to see that the line LOAD NCRSDMS3 is in the file. 
  112. If not, add this line to the file. This eliminates the need to load 
  113. drivers by hand every time the system is powered up. If the line 
  114. appears more than once, the duplicate statements should be removed 
  115. and all references to "port=xxxx", "slot=xxxx" and/or "mem=xxxx" 
  116. should be removed.
  117.  
  118.  
  119. For NetWare v4.x New Installations:
  120.  
  121. 1. Begin the file server installation as per the instuctions in the 
  122. file server installation chapter in the Novell NetWare Installation 
  123. Manual.  
  124.  
  125. 2. The NetWare installation procedure will prompt you for a Disk 
  126. Driver.  Insert the NCR device drivers diskette into drive a: or b:.
  127. Then select the INS key to select an unlisted driver, and F3 to 
  128. specify the path to search for the driver, and finally enter the 
  129. appropriate driver letter, 
  130.  
  131.     A: 
  132. or
  133.     B:
  134.  
  135. The NCRSDMS4.DSK driver should appear as a selection.  Select the 
  136. driver.
  137.  
  138. 3. Next you will be prompted with the available command line options 
  139. toload the driver.  A description of each option will appear in the 
  140. box at the bottom of the installation screen.  A more detailed 
  141. description is alsogiven later in this document, in the section 
  142. titled Command Line Options. Select any options needed for your 
  143. particular installation.
  144.  
  145. 4. When asked to edit the STARTUP.NCF file, make sure NCRSDMS4 is 
  146. loaded only once. If present, remove the "port=xxxx slot=xxxx 
  147. mem=xxxx" options from the command line.
  148.  
  149. 5. After the installation is complete, if ASPI support is also 
  150. desired, down the server and copy the ASPICAM4.NLM file to the 
  151. appropriate server directory, which is SERVER.40 by default.
  152.  
  153.  
  154.  
  155. * Command Line Options *
  156.  
  157. The NCRSDMS3.DSK and NCRSDMS4.DSK drivers have many tuning 
  158. parameters. (At this time there are no command line options for 
  159. the ASPICAM3.NLM or ASPICAM4. NLM drivers.) Following is a list 
  160. of tuning parameters available, including the default option and 
  161. a list of valid options.  Following each parameter is a description 
  162. of when a parameter should be used and any impact its use/disuse 
  163. might incur.
  164.  
  165. Please note applicable versions listed for each option.
  166.  
  167. If an option is specified but the assignment is not valid, then the 
  168. default value will be used. The NCRSDMS3.DSK and NCRSDMS4.DSK drivers 
  169. will be referred to in the remainder of this section as 
  170. NCRSDMSX.DSK, where X refers to the appropriate NetWare operating 
  171. system version.
  172.  
  173. The options described below are used by placing the specified
  174. characters on the load command line for the NCRSDMS driver. For 
  175. example, if the Verbose Mode command line option is desired in 
  176. NetWare 3.1X, the load command line should look like this:
  177.  
  178.     load NCRSDMS3 -v
  179.  
  180.  
  181. Using the Verbose Mode Option 
  182.  
  183. Command line option:    -v
  184. Function:          Display the current settings of all driver 
  185.             options.
  186.  
  187. This option will indicate the option settings for this load of the 
  188. driver.
  189.  
  190.  
  191. Using the Help Mode Option 
  192.  
  193. Command line option:    -? or -h
  194. Function:        Display the options available in the driver.
  195. Possible Impact:    The driver will not load with -? or -h 
  196.             specified.
  197.  
  198. This option may be specified on the command line for a brief 
  199. description of each of the options available in the driver, as well 
  200. as valid values for each option.  If the -? and other options are 
  201. specified, the help screen will be invoked, the other options will 
  202. be ignored and the driver will not be loaded.
  203.  
  204.  
  205. Using the Tag Command Queuing Option 
  206.  
  207. Command line option:    qtags=<option>
  208. Default value:        enable
  209. Valid options:        enable, disable
  210. Function:        Enable/disable tag command queuing for the 
  211.             devices 
  212. Possible Impact:    Tagged commands may result in improved I/O
  213.             throughput in devices that support such an
  214.             option.
  215.  
  216. Enabling the option results in the driver issuing tagged command 
  217. requests to the devices that support tagged queuing.  Devices that do 
  218. not support tagged queuing are not issued tagged requests.  Depending 
  219. on the drive controller, throughput of the device may be increased by 
  220. the use of queue tags, although an optimal number of queue tags is 
  221. based on the specific device type.
  222.  
  223.  
  224. Using the Depth of Queue Tags Option 
  225.  
  226. Command line option:  qdepth=<option>
  227. Default value:        10
  228. Valid options:        0-128
  229. Function:        Set the depth of the queue for tag command 
  230.             queuing.This value designates the depth of 
  231.             the queue per LUN (I_T_L nexus), e.g. this 
  232.             value designates the depth of the queue per 
  233.             device, or per LUN, if a device has multiple 
  234.             LUNs.
  235. Possible Impact:    Must be set to optimize the performance of 
  236.             tagged command queuing.
  237.  
  238. This option is valid only when tag command queuing (qtags) is 
  239. enabled, which it is by default. 0 is equivalent to 
  240. qtags=disable, and takes precedence over the setting of the 
  241. qtags option.  While the actual depth of the queue depends on 
  242. the specific drive controller, for single drives values of 
  243. about 10-30 are typically most optimal.  A greater number may 
  244. be optimal for peripherals such as disk arrays.  Users should 
  245. experiment with various qdepth values to determine the most 
  246. optimal performance of their particular setup.  The optimal 
  247. qdepth value is based on different aspects of the system, 
  248. including but not limited to: the processor, the available 
  249. memory, the disk drives, and other peripherals.
  250.  
  251. Note:    The driver supports a maximum of 128 qtags per 
  252.     controller at any given time.  The driver may allocate 
  253.     fewer qtags per device if this limit is being reached. 
  254.                   
  255.  
  256. Using the Base Timeout Option 
  257.  
  258. Command line option:    timeout=<option>
  259. Default value:        30 
  260. Valid options:        Any integer value 30 to 999999999 
  261. Function:        Specify the minimum value (in seconds) for 
  262.             command timeout.
  263. Possible Impact:    Insure system integrity when using a slow 
  264.             device.  Performance may be reduced.
  265.  
  266. The amount of time, in seconds, allowed for a command is 
  267. dynamically determined by the number of pending commands and 
  268. a base offset, or base timeout.  If a device is slow, this 
  269. value may be increased to insure the device has adequate time 
  270. to respond to a command issued to it before the command times 
  271. out.  This timeout is determined based on the number of 
  272. outstanding IOs per device.
  273.  
  274.  
  275. Using the Sorting of Read requests Option 
  276.  
  277. Command line option:    sort=<option>
  278. Default value:        enable
  279. Valid options:        enable, disable
  280. Function:        Enable/disable sorting of read commands to 
  281.             be issued to devices.
  282. Possible Impact:    Enabling will normally yield increased 
  283.             performance based on the target device 
  284.             controller.
  285.  
  286. If the devices connected to the host adapter(s) are of a 
  287. non-buffered architecture, such as AT&T's (formerly NCR) 
  288. 6298 disk array, then sorting of reads may result in a 
  289. performance degradation, since the absence of cache 
  290. provides no benefit for sorted requests. In this instance 
  291. the sort option should be disabled.  On most disk drives, an 
  292. on-board cache allows for reading ahead of data, and by 
  293. sorting read requests,  the probabilities of achieving a 
  294. cache hit are greatly increased, thus increasing the overall 
  295. performance of the driver.
  296.  
  297.  
  298. Using the Shared Interrupts Option 
  299.  
  300. Command line option:    shared_int=<option>
  301. Default value:        disable
  302. Valid options:        enable, disable
  303. Function:        Support shared interrupts.
  304. Possible Impact:    Enabling may cause a performance degradation.
  305.  
  306. The shared interrupt option should be enabled any time a PCI 
  307. card other than NCR Host Adapters are added to a system which
  308. assigns all PCI cards the same interrupt value.  The added 
  309. card must be able to support shared interrupts. The driver 
  310. automatically handles the case of more than one NCR host 
  311. adapter sharing an interrupt.
  312.  
  313. Using the Exclusion of Devices Option 
  314.  
  315. Command line option:    xcl=<device>[:device ...]
  316. Default value:        All devices recognized by the driver, i.e. 
  317.             no devices are excluded.
  318. Valid options:        p,i,l  
  319.             (Multiple devices may be specified with a 
  320.             colon separator) where p is the Path 
  321.             designator, and is in the range 0-7, i is the 
  322.             SCSI ID designator, and is in the range 0-31, 
  323.             and l is the LUN designator, and in the range 
  324.             0-7.  
  325.             The LUN parameter is optional.
  326.             Multiple devices may be excluded so long as 
  327.             the string does not exceed 35 characters in 
  328.             length and devices are separated by colons.  
  329. Examples:        xcl=1,2,3 to exclude LUN 3 of the device at 
  330.             SCSI ID 2 on Path 1.
  331.             xcl=1,2,3:2,5 to exclude LUN 3 of the device 
  332.             at SCSI ID 2 on Path 1, and all LUNs on the 
  333.             device at SCSI ID 5 on Path 2 
  334. Function:        Allows for specifying certain devices not be 
  335.             recognized by the driver.
  336. Possible Impact:    Device(s) may not be directly accessed via 
  337.             NCRSDMSX driver.
  338.  
  339. This option is available so that specific devices may be 
  340. excluded from being recognized and directly accessed by the 
  341. NCRSDMSX.DSK drivers.  These devices are not registered with 
  342. the operating system for use by the driver. Other 
  343. applications/drivers can then take over the control of such 
  344. devices. This option is available for support of third party 
  345. vendors who write their own SCSI control applications.
  346.  
  347.  
  348. Using the Wide SCSI Option 
  349.  
  350. Command line option:    wide=<option>
  351. Default value:        enable
  352. Valid options:        enable, disable
  353. Function:        Enable/Disable support of Wide SCSI.
  354.         
  355. This option specifically allows the user to disable support of
  356. wide SCSI when using  a wide SCSI controller.  This option 
  357. should be set to "disable" if a wide SCSI device is present on
  358. the system, but a narrow SCSI cable is connected somewhere on 
  359. the bus between the wide SCSI host adapter  and the wide 
  360. device, thus prohibiting the transfer of wide data.  If this 
  361. option is set to "disable", the wide device may still be used,
  362. but all data transferred to/from the device will be narrow 
  363. (8 bit).  The driver will not initiate a wide SCSI transfer 
  364. request negotiation.
  365.  
  366.  
  367. The following three options affect the amount of memory used by 
  368. the driver.  Please see the section on memory allocation for 
  369. information on how memory is allocated by the driver, and to get 
  370. an approximate feel for the amount of memory which may be saved by
  371. invoking these parameters.
  372.  
  373.  
  374. Using the Maximum Host Adapters Option 
  375.  
  376. Command line option:    max_hbas=<option>
  377. Default value:        8
  378. Valid options:        1-8
  379. Function:        Specify the maximum number of Host Bus 
  380.             Adapters to support.
  381. Possible Impact:    If number is reduced, may allow for 
  382.             reduction in memory used by the driver.
  383.  
  384. This parameter may be used to optimize the use of dynamically 
  385. allocated memory by the driver. If less than 8 NCR based PCI 
  386. host adapters, including any on board (built in to) the 
  387. motherboard, are being used, this parameter will allow for a 
  388. reduction in the total memory being used for the driver.
  389.  
  390.  
  391. Using the Maximum SCSI IDs Option 
  392.  
  393. Command line option:    max_id=<option>
  394. Default value:        32
  395. Valid options:        8-32
  396. Function:        Specify the maximum number of SCSI IDs each 
  397.             host adapter board should support.
  398. Possible Impact:    If number is reduced, may allow for 
  399.             reduction in memory used by the driver.
  400.  
  401. This parameter may be used to optimize the use of dynamically 
  402. allocated memory by the driver.  If all the host adapters, 
  403. including any SCSI controllers on the motherboard are 
  404. connected to less than 31 devices, a user can reduce the size 
  405. of the dynamically allocated memory by setting this value to 
  406. the maximum number of devices on any of the SCSI controllers. 
  407.  
  408.  
  409. Using the Maximum LUNs Option
  410.  
  411. Command line option:    max_lun=<option>
  412. Default value:        4
  413. Valid options:        1-8
  414. Function:        Specify the maximum number of LUNs each host 
  415.             adapter board should support per SCSI id.
  416. Possible Impact:    If number is reduced, may allow for 
  417.             reduction in memory used by the driver.
  418.  
  419. This parameter may be used to optimize the use of dynamically 
  420. allocated memory by the driver. If less than 8 LUNs are being
  421. used per NCR based PCI host adapter SCSI id, this parameter
  422. will allow for a reduction in the total memory being used for 
  423. the driver. 
  424.  
  425.  
  426. Using the Maximum Block Size for Concatenation Option
  427.  
  428. Command line option:    max_kb=<option>
  429. Default value:        32767
  430. Valid options:        0-32767
  431. Function:        Set the maximum number of KB that may be 
  432.             written to disk at one time.
  433. Possible Impact:    A high number may result in more data being 
  434.             transferred in a single data phase.
  435.  
  436. Specify the maximum size block in Kilobytes which may be 
  437. written to disk in one data transfer phase. This ensures 
  438. that when requests are being concatenated, the maximum size 
  439. of the concatenated request would not exceed the specified 
  440. value. If individual requests themselves are greater than this
  441. specified value, no action would be taken.
  442.  
  443.  
  444.  
  445. Information Pertaining to a Specific Driver
  446.  
  447.     This document addresses options available on the NCR SDMS 
  448.     NetWare drivers, version 3.05.00.  For information pertaining 
  449.     to a specific driver, please do one of the following:
  450.  
  451.     For NetWare version 4.XX, consult the NCRSDMS4.DDI file for 
  452.     options available for NCRSDMS4.DSK.  This may be accessed via 
  453.     the NetWare install utility.
  454.  
  455.     For versions of the driver 3.05.00 and later, use the -? 
  456.     option on the command line of the NCRSDMSX.DSK driver
  457.  
  458.  
  459.  
  460. *************** Important Additional Information ******************
  461.  
  462.  
  463. * Memory Allocation *
  464.  
  465.  
  466. The driver allocates memory for certain structures based upon the 
  467. maximum number of SCSI IDs (max_id), LUNs (max_lun), and paths 
  468. (max_hbas) that may be used in the system. The amount of memory 
  469. allocated is based on the following formula:
  470.  
  471. 437 bytes of memory are allocated for the structure, so
  472.  
  473. Memory Allocated = 437 * max_hbas * max_lun * max_id.
  474.  
  475. So for default allocations, the amount of memory allocated is:
  476.  
  477. Memory Allocated = 437 * 8 * 4 * 32 = 447,448 bytes (437 KB).
  478.  
  479. If, for example,
  480.     
  481.     1. only one host adapter is installed (or when using an 
  482.     NCR based PCI SCSI embedded controller and no add in HBAs),
  483.  
  484.     2. only one LUN per device will be used, and
  485.     
  486.     3. the bus is narrow (up to 8 SCSI IDs),
  487.  
  488. then by setting the appropriate command line options, the amount of memory 
  489. allocated will be:
  490.  
  491. Memory Allocated = 437 * 1 * 1 * 8 = 3,496 bytes (3.4 KB).
  492.  
  493.