home *** CD-ROM | disk | FTP | other *** search
/ Network Support Encyclopedia 96-1 / novell-nsepro-1996-1-cd2.iso / download / netware / cdup2.exe / CDUP2.TXT < prev    next >
Text File  |  1995-07-18  |  16KB  |  333 lines
  1. NOVELL TECHNICAL INFORMATION DOCUMENT
  2.  
  3. TITLE:  Readme for CDUP2.EXE
  4. README FOR:  CDUP2.EXE
  5.  
  6. NOVELL PRODUCTS and VERSIONS:
  7. NetWare 3.12
  8. NetWare 4.1
  9.  
  10. ABSTRACT:
  11.  
  12. The files in this release kit are currently in test in Novell Labs and Test
  13. bulletins will be soon be issued.  These files provide minor enhancements to 
  14. the CDROM.NLM and most importantly they provide IDE CDROM support under 
  15. NetWare 4.1 and now under 3.12.
  16.  
  17. -----------------------------------------------------------------
  18. DISCLAIMER
  19. THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR
  20. EXTERNAL TO NOVELL.  NOVELL MAKES EVERY EFFORT
  21. WITHIN ITS MEANS TO VERIFY THIS INFORMATION. 
  22. HOWEVER, THE INFORMATION PROVIDED IN THIS DOCUMENT
  23. IS FOR YOUR INFORMATION ONLY.  NOVELL MAKES NO
  24. EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS
  25. INFORMATION.
  26. -----------------------------------------------------------------
  27.  
  28.  
  29. IDE CDROM devices are supported under NetWare 4.1 and 3.12 using the
  30. NWPA (NetWare Peripheral Architecture) layer of support.  The files of
  31. NWPA.NLM, NWPALOAD.NLM, and NPAPATCH (3.12 specific) provide this layer of 
  32. support.  NWPA.NLM, NWPALOAD.NLM, IDECD.CDM, IDEHD.CDM, IDEATA.HAM, and 
  33. CDROM.NLM are now universal files.  They can be loaded on either 3.12 or 4.10. 
  34. The NWPA layer uses *.HAM and *.CDM files instead of the normal *.DSK
  35. files.  Breaking the monolithic *.DSK drivers out into *.HAM and *.CDM
  36. files makes them much easier to support and much easier to maintain from
  37. a development standpoint.  The HAM (Host Adapter Module) extension
  38. refers to the driver that would be loaded to support a specific HBA (Host
  39. Bus Adapter).  The CDM (Custom Device Module) extension refers to the
  40. driver that would be loaded to support specific types of devices attached to
  41. the HBA.  
  42.  
  43. For example, if you were using an IDE HBA (either a paddleboard or a 
  44. motherboard with built-in IDE support) and you had an IDE drive attached
  45. that was serving as a NetWare volume, instead of loading the IDE.DSK
  46. you would now load the IDEATA.HAM and IDEHD.CDM drivers.  If you then wanted 
  47. to add an IDE CDROM player you would simply add the CDROM player to the IDE 
  48. bus and load the IDECD.CDM.  
  49.  
  50.  
  51. SYMPTOM:
  52.  
  53. 1.  Mounting IDE CDROM devices under NetWare 3.12 was not supported.
  54.  
  55. 2.  Trying to mount CD's with an excessively large number of directories or
  56. files would sometimes fail with an error message indicating that there was
  57. not enough directory space to mount the volume.
  58.  
  59.  
  60. SOLUTION: 
  61.  
  62. 1.  Apply the latest CDROM.NLM and supporting NWPA files included in this kit. 
  63.  
  64. 2.  Using the latest CDROM.NLM included in this kit, mount the CD
  65. volume with the /rx flag.  The /rx flag rebuilds the index file with an
  66. extended amount of space being allocated for the index file.
  67.  
  68.  
  69. Self-Extracting File Name: CDUP2.EXE
  70.  
  71. Files Included        Size        Date      Time
  72.  
  73. ..\
  74.     CDUP2.TXT     (This file)
  75.     CDCMMNDS.TXT   7394         7-18-95      9:00 am
  76.            CDROM.NLM      118915       4-13-95      4:33 pm
  77.            NWPA.NLM       69012        7-13-95      7:46 am
  78.            NWPALOAD.NLM   2719         6-13-95      1:37 pm
  79.     IDEATA.DDI     8512         6-12-95     10:21 am
  80.            IDEATA.HAM     14441        6-13-95      1:29 pm
  81.     IDECD.DDI      3818         2-14-95     12:24 pm
  82.            IDECD.CDM      9372         6-26-95     12:44 pm
  83.     IDEHD.DDI      5855         5-08-95      2:56 pm
  84.            IDEHD.CDM      9494         9-19-94      2:03 pm  
  85.  
  86. ..\NETWARE.312
  87.  
  88.     NPAPATCH.NLM  1985         6-26-95     10:27 am  
  89.     PM312.NLM     8603         3-27-95     12:38 pm  
  90.  
  91.  
  92. Installation Instructions:
  93.  
  94. Copy all of the files from the root directory of this kit to both the boot 
  95. partition of your server and the SYS:SYSTEM directory.  You may have
  96. to rename the previous versions of duplicate files in order to accomplish
  97. this.  Make any needed hardware changes.  You may need to re-configure
  98. your original IDE hard drive so that it now knows that there is a slave
  99. device attached to the IDE bus.  Also jumper the IDE CDROM device as a
  100. slave.  
  101.  
  102. Load the IDEATA.HAM in place of the IDE.DSK if required.  
  103.  
  104. Load the new CDROM.NLM.  This will cause NWPALOAD.NLM to load
  105. which in turn loads the NWPA layer.  This should be all that's required.
  106.  
  107. Mount your CD's as NetWare volumes like you have done in the past. 
  108.  
  109. For a list of available CDROM.NLM commands, type CD HELP at the SYSTEM CONSOLE
  110. prompt after the CDROM.NLM has been loaded.  Additional information about 
  111. CDROM.NLM commands can be obtained by looking at the CDCMMNDS.TXT file 
  112. included in this kit or by studying the September 1994 AppNote.  
  113.  
  114.  
  115. NetWare 3.12 specific instructions:
  116.  
  117. Copy the NPAPATCH.NLM and PM312.NLM from the 3.12 subdirectory
  118. on the kit to the boot partition of the server.  
  119.  
  120. Modify your Startup.ncf file so that the VERY FIRST item loaded is the 
  121. NPAPATCH.NLM.  NPAPATCH.NLM is dependent on PM312.NLM and will attempt to 
  122. auto-load the PM312.NLM file.  This patch fixes a couple of issues with the 
  123. media manager and in as much as the Media Manager manages all communication 
  124. with devices this patch must be loaded first.
  125.  
  126. Failure to load this patch before any drivers that would establish
  127. communication with the hardware will cause your server to ABEND.  This
  128. patch like all other patches should not be unloaded once the server is up. 
  129. Unloading any patch while the server is running can and most likely will
  130. cause unpredictable results.  
  131.  
  132.  - 3.12 specific  The current version of the CDROM.NLM needs to have 
  133. AFTER311.NLM, STREAMS.NLM and CLIB.NLM files loaded before it will load.  
  134. You can accomplish this by loading the AFTER311.NLM file at the server console. 
  135. The CLIB.NLM and STREAMS.NLM files will be automatically loaded.  
  136.  
  137. Because the latest CDROM.NLM is message enabled you MUST follow
  138. the instructions carefully or the CDROM.NLM will not load or your server
  139. may possibly ABEND with a GPPE.
  140.  
  141. 1.  Search the SYS volume for files named CDROM.MSG and delete them. 
  142. Using the NDIR command from the root is suggested.  
  143.  
  144. NDIR CDROM.MSG /s
  145.  
  146. Note: If you experience problems with the server after loading this new
  147. NLM make sure that the first search path is set to the location where the 
  148. CDROM.NLM was loaded from.  If you are still experiencing problems
  149. then log a call with Novell Technical Support.  
  150.  
  151.  
  152. Features and Functions of NWPA:
  153.  
  154. NWPA works more closely with the Media Manager layer in the OS
  155. (Operating System) than the old *.DSK drivers did.  Part of the
  156. specification of the NWPA layer states that whenever a *.HAM driver is
  157. loaded it must scan the bus to determine what type of devices are attached
  158. to the bus.  Based on the devices found, the *.HAM then auto-loads the
  159. appropriate *.CDM drivers to support those devices.  
  160.  
  161. Another example.  Let's assume that you had a server with one IDE drive
  162. being used as a boot device and your NetWare volumes were on a SCSI
  163. bus in the same box.  Let's say that you wanted to add an IDE CDROM
  164. device to your existing IDE bus.  You would configure the IDE CDROM
  165. device as a slave and if needed configure the IDE drive as a Master with
  166. Slave attached and attach the CDROM player to the IDE bus.  You would
  167. copy all of the files from this kit to the boot partition of your server in
  168. addition to the SYS:SYSTEM partition.  You would modify your Startup.ncf so 
  169. that instead of loading the IDE.DSK you load the IDEATA.HAM driver which 
  170. would then auto-load the IDECD.CDM device driver and IDEHD.CDM.  The IDECD 
  171. and IDEHD CDM's would be auto-loaded due to the requirements that the HAM's 
  172. auto-load the needed CDM's for whatever devices they find.  
  173.  
  174. Issuing a "List Devices" command from the server console would yield the
  175. following information: (this is for illustration only and most likely will not
  176. be exactly what you will see)
  177.  
  178. 1.   Device # 0 Quantum LPS540S  (5E000000)  A SCSI hard drive attached.
  179. 19. [V025-A0-D1:1] NEC CD-ROM DRIVE:260 FW:1.01.  An IDE CDROM player.
  180. 20. [V025-A0-D1:0] WDC AC2200F Original IDE hard drive with NO NetWare partitions.
  181.  
  182. The fact that the IDE hard drive with NO NetWare partitions is showing
  183. up under "List Devices" may concern you but the only reason that it shows
  184. up is due to the requirement that the HAM's report all devices and load all
  185. CDM's required to support those devices.  If you do not want the HAM's
  186. to autoload all of the required CDM's then instead of loading the HAM's
  187. first which then autoloads the NWPA layers, we suggest that you explicitly
  188. load the NWPA.NLM with the /naload flag before any HAM's are loaded
  189. in the Startup.ncf.  This will tell the NWPA.NLM NOT to autoload the
  190. HAM's and CDM's that it normally would.  You will then need to load the
  191. HAM's and CDM's manually.
  192.  
  193. The numbers to the far left of the above example are the Media Manager
  194. object numbers.  These numbers are used internally in the OS and are
  195. simply reported here.  Basically it is the order in which these devices
  196. registered themselves with the Media Manager.  DOS partitions, NetWare
  197. partitions, logical partitions, physical partitions, Hot Fix areas, etc. are 
  198. all examples of Objects that the Media Manager has to manage.  Consecutive
  199. numbers are very rare and usually found in the most basic server setups and
  200. sometimes not even then.  Do not be alarmed if your server does not have
  201. consecutive numbers!
  202.  
  203. The NWPA also introduces an enhanced numbering sequence.  In the above
  204. example you see a number within the []'s.  This number is defined as
  205. follows [Sx-Vxxx-Ax-Dxx:x]:
  206.  
  207.  Sx - denotes the server number.  In non-SFTIII environments the "S" and 
  208. following number will not appear.  In a SFTIII environment you will see 
  209. either a 0 (Primary Server) or 1 (Secondary Server) following the "S".  
  210.  
  211.  Vxxx - denotes the manufacturer ID.  This was a two position number under 
  212. the *.DSK drivers.  The number has been expanded to 3 hexadecimal characters 
  213. for use under NWPA.  Numbers less than 100 have been assigned to Novell 
  214. drivers.
  215.  
  216.  Ax - denotes the NWPA assigned unique adapter number.  This number increments
  217. by one for each load of a HAM.
  218.  
  219.  Dxx:x  - denotes the device number.  This number has been expanded to handle 
  220. the need to report more and more devices as technology advances.  For IDE 
  221. devices the first digit will be 1 if the port is 1F0, 2 if the port is 170, 
  222. 3 if the port is 1E8 and 4 if the port is 168.  In the case of SCSI the first 
  223. digit denotes the SCSI id set on the device.  For IDE the digit following the 
  224. ":" denotes either Master (0) or slave (1).  Under SCSI the digit following the
  225. ":" denotes the LUN (Logical Unit Number).  
  226.  
  227.  
  228. Types of CDROM players:
  229.  
  230. CDROM players come in two different flavors.  Their identity can be
  231. partially established by looking at the connector on the player.  If the
  232. connector has 50 pins then you know that this device is a SCSI based CD
  233. player.  If the connector is of the 40 pin variety then you have a more
  234. difficult problem on your hands.  We will call the 40 pin connector type 
  235. "other".
  236.  
  237. Of the "other" types of CD players, there are 4 possible interface types:
  238.  
  239.      Mitsumi
  240.      Sony
  241.      Panasonic
  242.      ATAPI
  243.  
  244. The Mitsumi, Sony, and Panasonic types of interfaces are pretty widely
  245. accepted in the industry.  NetWare support for these interfaces though is
  246. non existent.  These interfaces are proprietary and no drivers exist to
  247. provide any type of support for these players to make CD's mountable as
  248. NetWare volumes.  Most of the players that have this type of interface are
  249. connected either directly to some type of proprietary bus card or to an
  250. audio card (sound blaster, soundwave, etc).  Many sound cards have three
  251. separate 40 pin connectors on them in order to support all of the possible
  252. interfaces.  
  253.  
  254. The ATAPI type of player, on the other hand, is commonly referred to as
  255. the IDE CDROM player.  NetWare does provide drivers to mount CD's in
  256. the ATAPI devices as NetWare volumes.  The drivers are found in this kit. 
  257.  
  258. If you have a CD with the "other" type of connector and it is not clearly
  259. labeled as to what type of interface it has or supports, please call the
  260. manufacturer of the device and ask them.
  261.  
  262.  
  263. IDE vs. ENHANCED IDE
  264.  
  265. We hear much talk these days of enhanced IDE or EIDE as it may be called.  
  266. These discussions beg the question; What is the difference between
  267. IDE and EIDE?  Seagate and Quantum have produced a white paper that
  268. defines what the differences are.  There are four major points that are
  269. outlined.  The four points that supposedly define an enhanced IDE device
  270. are as follows:
  271.  
  272.      1.  High capacity addressing of ATA hard drives over 528 MB.
  273.  
  274.      2.  Fast data transfer rates for ATA hard drives (support for PIO
  275.           mode 3 at 11.1 MB per second).
  276.  
  277.      3.  Dual ATA host adapters supporting up to four hard disk drives
  278.           per computer system.  
  279.       See the note on Support Tips for IDE devices later in this document.
  280.  
  281.      4.  Non-hard disk drive ATA peripherals (e.g., CD-ROMs).
  282.  
  283. Unfortunately many manufacturers disagree as to whether their machines
  284. and devices need to meet all four requirements or just one or a combination
  285. thereof.  These disagreements are largely what lead to the incompatibilities
  286. that we so often see when using IDE devices under NetWare.  DOS & Windows  
  287. don't really push the limits of the so called IDE SPECIFICATION.  For many 
  288. years the IDE SPEC was so loosely defined that you could pour water through it.  
  289. NetWare on the other hand pushes the SPEC and tests all of its limitations.
  290.  
  291. Quotes from the white paper:
  292.  
  293. "Each of these features (referring to the four points mentioned earlier)
  294. supports improved functionality at a system level and they are felt to be
  295. positive for the industry and end users.  However, as a package, Enhanced
  296. IDE is causing increased confusion in the industry and raising the risks of
  297. incompatibility and mismatched system integration because theses features
  298. require an extremely high degree of integration.  To have a fully functional
  299. Enhanced IDE system, specific support is required not only for the storage
  300. peripherals but also for host adapters, core logic, system bus, BIOS and
  301. operating systems - virtually every major block of PC architecture.  Adding
  302. to this complexity is the fact that there is no central industry supported
  303. standard that controls these features".
  304.  
  305. "In our experiments with some of the first available Enhanced IDE
  306. products, we encountered a variety of problems that prevented us from
  307. tapping their full potential."  PC Magazine, July 1994.  "The Perfect Hard
  308. Disk," page 194.
  309.  
  310.  
  311. Support Tips for IDE devices:
  312.  
  313. Novell Technical Support has seen several issues where motherboards with dual
  314. IDE ports are unable to support IDE hard drives on one port and IDE CDROM 
  315. devices on the other port.  The problem is due to the way that the dual IDE 
  316. ports are implemented on the motherboard via the CMD chipset.  You may try 
  317. putting the CDROM and hard drive on the same port to see if that will help 
  318. solve your problem.  If you find that the CMD chipset is the source of your 
  319. problem and moving the CDROM and hard drive to the same port did not solve your 
  320. problem we suggest that you contact the manufacturer of your machine for a 
  321. work-around or driver to solve the problem.  If all else fails then we suggest 
  322. that you try a different paddleboard or contact your third party hardware 
  323. supplier to see what products they have that are Novell certified with perhaps 
  324. a more stable bus such as SCSI!  
  325.  
  326.  
  327. -----------------------------------------------------------------
  328. Any trademarks referenced in this document are the property of their
  329. respective owners.  Consult your product manuals for complete trademark
  330. information.
  331. -----------------------------------------------------------------
  332.  
  333.