home *** CD-ROM | disk | FTP | other *** search
/ Chip 1997 April (Special) / Chip-Special_1997-04_cd.bin / aztech / cdup3 / read.me < prev   
Text File  |  1996-03-21  |  11KB  |  228 lines
  1. NOVELL TECHNICAL INFORMATION DOCUMENT
  2.  
  3. TITLE:  cdup3.exe
  4. README FOR:  CDUP3.EXE
  5.  
  6. NOVELL PRODUCTS and VERSIONS:
  7. NetWare 3.12
  8. NetWare 4.01
  9. NetWare 4.02
  10. NetWare 4.1
  11.  
  12. ABSTRACT:
  13.  
  14. This file contains the latest CDROM.NLM and support files.  These files provide
  15. enhancements to the CDROM.NLM and they also provide support for IDE CDROM
  16. devices under NetWare 3.12 & 4.1.
  17.  
  18.  
  19.  -----------------------------------------------------------------
  20.  DISCLAIMER
  21.  THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL.  NOVELL
  22. MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION.  HOWEVER, THE
  23. INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY.  NOVELL
  24. MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.
  25.  -----------------------------------------------------------------
  26.  
  27.  
  28. ISSUE: 
  29.  
  30. SYMPTOMS:
  31.  1. Attempting to mount CD's with directory and file names that did not conform
  32. to the naming conventions of the High Sierra and ISO9660 specifications caused
  33. problems.
  34.  
  35.  2.  Trying to install a 3.12 server across the wire from a NetWare 3.12 CD
  36. mounted as a volume on a NetWare 4.10 server would sometimes yield problematic
  37. file copies.
  38.  
  39.  3.  CD's with short (two letters or less) file and directory names would
  40. occasionally get a "9" appended to the name as the index file was built for the
  41. CD.
  42.  
  43.  4.  Mounting IDE CDROM devices on NetWare 3.12 was not supported.
  44.  
  45.  5.  Trying to mount CD's with an excessively large number of directories or
  46. files would sometimes fail with an error message indicating that there was not
  47. enough directory space to mount the volume.
  48.  
  49.  SOLUTION:
  50.  1 - 5.  Apply the latest CDROM.NLM and supporting NWPA files included in this
  51. kit.
  52.  
  53.  ADDED FUNCTIONALITY:
  54.  1.  The new CDROM.NLM in this kit boasts greatly improved help screens. 
  55. Please use them!!!
  56.  2.  A purge feature that allows individual index files to be purged has been
  57. added. This flag is implemented on the dismount of a particular volume. The
  58. syntax is as follows:
  59.  
  60.  "cd dismount 5 /purge"
  61.  
  62.  The global purge command is still available.
  63.  
  64. Self-Extracting File Name: cdup3.exe
  65.  
  66. Files Included     Size     Date      Time
  67.  
  68. ..\
  69.        CDUP3.TXT     (This file)
  70.     CDCMMNDS.TXT            7391         7-26-95      3:25:06 pm
  71.        CDROM.NLM          133952        11-29-95     11:36:20 am
  72.       IDEATA.DDI            8512         6-12-95     10:21:16 am
  73.       IDEATA.HAM           14441         6-13-95      1:29:56 pm
  74.        IDECD.CDM            9372         6-26-95     12:44:28 pm
  75.        IDECD.DDI            3818         2-14-95     12:24:40 pm
  76.        IDEHD.CDM            9494         9-19-94      2:03:54 pm
  77.        IDEHD.DDI            5855          5-8-95      2:56:48 pm
  78.         NWPA.NLM           69012         7-13-95      7:46:36 am
  79.     NWPALOAD.NLM            2719         6-13-95      1:37:54 pm
  80. ..\NETWARE.312\
  81.     NPAPATCH.NLM            1985         6-26-95     10:27:20 am
  82.        PM312.NLM            8603         3-27-95     12:38:26 pm
  83.  
  84.  
  85. Installation Instructions:
  86.  
  87. Installation Instructions for all versions of NetWare 3.12 and 4.10:    
  88.  
  89.  Copy all of the files from the root directory of this kit to both the boot
  90. partition of your server and the SYS:SYSTEM directory.
  91.  
  92.  NetWare 3.12 specific instructions:    
  93.  
  94.  Copy the NPAPATCH.NLM and PM312.NLM from the 3.12 subdirectory of the kit to
  95. the boot partition of the server.
  96.  
  97.  
  98. ******************************************************************************-
  99. *************************************
  100.  NOTE:    These new patch files supersede any previous versions.The old NPA312
  101. module is no longer needed.    
  102. ******************************************************************************-
  103. *************************************
  104.  
  105.  Modify your Startup.ncf file so that the VERY FIRST item loaded is the
  106. NPAPATCH.NLM.  NPAPATCH.NLM is dependent on PM312.NLM and will attempt to
  107. auto-load the PM312.NLM file.  This patch fixes a couple of known issues with
  108. the media manager and in as much as the Media Manager manages all communication
  109. with devices this patch must be loaded first.  Failure to load this patch
  110. before any drivers establish communication with the hardware may cause your
  111. server to ABEND. This patch, like all other dynamic patches should not be
  112. unloaded once the server is up.  Unloading any patch while the server is
  113. running can and most likely will cause unpredictable results.      
  114.  
  115.  The current version of the CDROM.NLM needs to have AFTER311.NLM, STREAMS.NLM
  116. and CLIB.NLM files loaded before it will load. You can accomplish this by
  117. loading the AFTER311.NLM file at the server console. The CLIB.NLM and
  118. STREAMS.NLM files will be automatically loaded. Because the latest CDROM.NLM is
  119. message enabled it must be loaded from the SYS volume and you MUST follow the
  120. instructions below carefully for your 3.12 server:
  121.  
  122.  1.  Search the SYS volume for files named CDROM.MSG and delete them. Using the
  123. NDIR command from the root is suggested.  For example "NDIR CDROM.MSG /s".          
  124.  
  125.  Note: If you experience problems with the server after loading this new NLM
  126. make sure that the first search path is      set to the location where the
  127. CDROM.NLM was loaded from.  If you are still experiencing problems then log a
  128. call with    Novell Technical Support. 
  129.  
  130.  IDE specific driver Load Order:
  131.     
  132.  NetWare 3.12 startup.ncf:                     NetWare 4.10 startup.ncf:
  133.       Load NPAPATCH                                       Load IDEATA port=1f0
  134. int=14    
  135.       Load IDEATA port=1f0 int=14                     NetWare 3.12 autoexec.ncf              
  136.       NetWare 4.10 autoexec.ncf                        Load After311                          
  137.       Load CDROM                                            Load CDROM
  138.  
  139.  The new CDROM.NLM will autoload the NWPALOAD.NLM which will in turn autoload
  140. the NWPA.NLM.  After the NWPA.NLM loads the NWPALOAD.NLM will unload
  141. itself.Mount your CD's as NetWare volumes as you normally would. 
  142.  For a list of available CDROM.NLM commands, type CD HELP at the SYSTEM
  143. CONSOLEprompt after the CDROM.NLM has been loaded.  Additional information
  144. about CDROM.NLM commands can be obtained by looking at the CDCMMNDS.TXT file
  145. included in this kit or by studying the September 1994 AppNote. 
  146.  
  147.  Background Information on NWPA (NetWare Peripheral Architecture):
  148.  
  149.  The use of HAM's and CDM's on NetWare 4.1 SFTIII is not currently supported. 
  150. If you need to mount CD's on a NetWare 4.1 SFTIII server, we suggest that you
  151. attempt this only with SCSI devices.
  152.  
  153.  IDE CDROM devices are supported under NetWare 4.1 and 3.12 using the NWPA
  154. (NetWare Peripheral Architecture) layer of support.  The files NWPA.NLM,
  155. NWPALOAD.NLM, and NPAPATCH (3.12 specific) provide this layer of support. 
  156. NWPA.NLM, NWPALOAD.NLM, IDECD.CDM, IDEHD.CDM, IDEATA.HAM, and CDROM.NLM are now
  157. universal files meaning that they are not NetWare version specific.  They can
  158. be loaded on either 3.12 or 4.10. The NWPA layer uses *.HAM and *.CDM files
  159. instead of the normal *.DSK files.  Breaking the monolithic *.DSK drivers out
  160. into *.HAM and *.CDM files makes them much easier to support and much easier to
  161. maintain from a development standpoint. The HAM (Host Adapter Module) extension
  162. refers to the driver that would be loaded to support a specific HBA (HostBus
  163. Adapter).  The CDM (Custom Device Module) extension refers to the driver that
  164. would be loaded to support specific types of devices attached tothe HBA. 
  165.  
  166.  Features and Functions of NWPA:
  167.  
  168.  Under the new NWPA the devices appear slightly differently than they did under
  169. the old *.DSK regime.  Issuing a "List Devices" command from the server console
  170. could yield the following information: (this is for illustration only and most
  171. likely will not be exactly what you will see):
  172.  
  173.  1.   Device # 0 Quantum LPS540S  (5E000000)   (A SCSI hard drive attached).
  174.  19. [V025-A0-D1:1] NEC CD-ROM DRIVE:260 FW:1.01. (An IDE CDROM player).
  175.  
  176.  The numbers to the far left of the above example are the Media Manager object
  177. numbers.  These numbers are used internally in the OS and are simply reported
  178. here.  Basically it is the order in which these devices registered themselves
  179. with the Media Manager.  DOS partitions, NetWare partitions, logical
  180. partitions, physical partitions, Hot Fix areas, etc. are all examples of
  181. objects that the Media Manager has to manage.  Consecutive numbers are very
  182. rare and usually found in the most basic server setups, sometimes not even
  183. then.  Do not be alarmed if your server does not have consecutive numbers!
  184.  
  185.  The NWPA also introduces an enhanced numbering sequence.  In the above example
  186. you see a number within the []'s. This number is defined as follows
  187. [Sx-Vxxx-Ax-Dxx:x]:
  188.  
  189.  Sx - denotes the server number.  In non-SFTIII environments the "S" and
  190. following number will not appear.  In a SFTIII environment you will see either
  191. a 0 (Primary Server) or 1 (Secondary Server) following the "S".
  192.  
  193.  Vxxx - denotes the manufacturer ID.  This was a two position number under the
  194. *.DSK drivers.  The number has been expanded to 3 hexadecimal characters for
  195. use under NWPA.  Numbers less than 100 have been assigned to Novell drivers.
  196.  
  197.  Ax - denotes the NWPA assigned unique adapter number.  This number increments
  198. by one for each load of a HAM.
  199.  
  200.  Dxx:x  - denotes the device number.  This number has been expanded to handle
  201. the need to report more and more devices as technology advances.  For IDE
  202. devices the first digit will be 1 if the port is 1F0, 2 if the port is 170, 3
  203. if the port is 1E8 and 4 if the port is 168.  In the case of SCSI the first
  204. digit denotes the SCSI id set on the device.  For IDE the digit following the
  205. ":" denotes either Master (0) or slave (1).  Under SCSI the digit following the
  206. ":" denotes the LUN (Logical Unit Number). 
  207.  
  208.  By default the HAM's will try and load any needed CDM's for devices that are
  209. attached to the HAM.  If you do not want the HAM's to autoload all of the
  210. required CDM's then instead of loading the HAM's first, which then autoloads
  211. the NWPA layers, we suggest that you explicitly load the NWPA.NLM with the
  212. /naload flag before any HAM's are loaded in the Startup.ncf. This will tell the
  213. NWPA.NLM NOT to autoload the HAM's and CDM's that it normally would. You will
  214. then need to load the HAM's and CDM's manually. 
  215.  
  216.  For example:  Startup.ncf where the CDM's are NOT autoloaded    
  217.       load NWPA /naload    
  218.       load ideata port= int=    
  219.       load idecd
  220.  
  221.  
  222.  -----------------------------------------------------------------
  223.  Any trademarks referenced in this document are the property of their
  224. respective owners.  Consult your product manuals for complete trademark
  225. information.
  226.  -----------------------------------------------------------------
  227.  
  228.