home *** CD-ROM | disk | FTP | other *** search
/ IBM Presents OS/2 Software Hits 1995 / OS-2_SW_HITS_2ND_EDITION_1995.ISO / i17 / cdrom3.doc < prev    next >
Text File  |  1994-09-20  |  12KB  |  361 lines
  1. CDROM.NLM for NetWare 3.12 and 4.01               (CDROM3.EXE)
  2. CDROM.NLM now supports CD's with greater than 1824 directories
  3. and more than 58,368 files, along with other enhancements.
  4. ---------------------------------------------------------------
  5.  
  6. This package is made up of the following files:
  7.  
  8. CDROM3 DOC10HH4 - DOCUMENT
  9. CDROM3 EXE10HH4 - BINARY SELF-EXTRACTING FILE
  10.  
  11. The file, once downloaded with the binary option, needs to be
  12. run as it is a self-extracting file.
  13.  
  14. ---------------------------------------------------------------
  15.  
  16. ---------------------------------------------------------------
  17.                            DISCLAIMER
  18. THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO
  19. NOVELL.  NOVELL MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY
  20. THIS INFORMATION.  HOWEVER, THE INFORMATION PROVIDED IN THIS
  21. DOCUMENT IS FOR YOUR INFORMATION ONLY.  NOVELL MAKES NO
  22. EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.
  23. ---------------------------------------------------------------
  24.  
  25. SYMPTOM
  26.  
  27. When users tried to load the CDROM.NLM, the following message
  28. was displayed and the CDROM.NLM module failed to load:
  29.  
  30.      MESSAGE
  31.  
  32.           All of the system resources could not be assigned
  33.  
  34. SYMPTOM
  35.  
  36. The CD CHANGE command hung the server or forced the operating
  37. system into the debugger.  This only occurred in a few
  38. installations and Novell is aware of the problem and is working
  39. on a solution.  If the ASPICD.DSK driver is being used contact
  40. Adaptec for an upgraded driver to address this problem.
  41. However, see the below solution for an interim work-around.
  42.  
  43. SOLUTION
  44.  
  45.   CD CHANGE work-around:
  46.  
  47. 1.  From the Server console, use the CD DISMOUNT command to
  48. dismount the volume.
  49.  
  50. 2.  Load monitor and select DISK INFORMATION.
  51.  
  52. 3.  On the list of System Disk Drives, select the CD-ROM drive
  53.     on which the CD-ROM is to be changed.
  54.  
  55. 4.  Select Drive Operating Status, take the selection for
  56.     Deactivate Drive.
  57.  
  58. 5.  Change the CD-ROM.
  59.  
  60. 6.  Select the Removable Drive Mount Status and take the
  61.     selection for Mount Drive.
  62.  
  63. 7.  Change back to the System Console and issue a CD MOUNT
  64.     command.
  65.  
  66.  
  67. SYMPTOM
  68.  
  69. Many CD-ROMs would not mount under the initial release of the
  70. CDROM.NLM.  The current version of the CDROM.NLM "S" supports a
  71. much broader range of CD's.
  72.  
  73.  
  74. SOLUTION
  75.  
  76. Apply the CDROM3.EXE file.
  77.  
  78. Self-Extracting File Name:  CDROM3.EXE     Revision:  B
  79.  
  80. Files Included     Size     Date      Time
  81.  
  82. \
  83.   CDROM3.TXT         (This File)
  84.     NWPA.NLM      64575   04-22-94    3:50p
  85.    CDROM.NLM      96467   05-24-94    8:50a
  86.   NPA312.NLM      64101   04-22-94   11:49a
  87.  
  88. Installation Instructions:
  89.  
  90. 1.  Rename the existing CDROM.NLM to *.OLD.
  91.  
  92. 2.  Copy the NWPA.NLM file (for NetWare 4.0x) or the NPA312.NLM
  93.     file (for NetWare 3.12) and the CDROM.NLM file to the
  94.     SYS:SYSTEM subdirectory.
  95.  
  96. 3.  Load HBA driver (for example, AHA1540.DSK).
  97.  
  98. 4.  Load ASPICD.DSK or CDNASPI.DSK file if it is needed.
  99.  
  100. 5.  Based upon your version of NetWare use the following load
  101.     statements:
  102.  
  103.       NetWare 3.12       NetWare 4.x
  104.  
  105.       Load AFTER311.NLM       ------------
  106.       Load NPA312.NLM         Load NWPA.NLM
  107.       Load CDROM.NLM          Load CDROM.NLM
  108.  
  109. 6.  For a list of available CDROM.NLM commands, type CD HELP at
  110.     the SYSTEM CONSOLE prompt.
  111.  
  112. Solution Specifics:
  113.  
  114. ---------------------------------------------------------------
  115. CD DEVICE LIST typed at the console prompt yields the following
  116. information:
  117.  
  118. ** CD ROM Device List
  119. No. Act. Device Name                               Volume Name
  120. Mounted
  121.  2   Y   Device # 0 SONY  CD-ROM CDU-541  (8100000 NSEPRO
  122. Y
  123.  
  124. No.
  125. --
  126. Defines the Media Manager object number assigned to this
  127. particular CD player.  When you manipulate the CD in the player
  128. by using the "device number" this is the number you should be
  129. using and NOT the number listed under "Device Name".
  130.  
  131. Act.
  132. --
  133. Indicates whether or not the device, cd player, is active.
  134.  
  135. Device Name
  136. --
  137. Indicates the name of the device as reported by the device. Do
  138. NOT use the number that appears here to try and manipulate the
  139. CD.  Using the above example, you would type "CD MOUNT 2" to
  140. mount the CD.  You would NOT type "CD MOUNT 0".
  141.  
  142.  
  143. Volume Name
  144. --
  145. Indicates the volume name as reported by the CD.
  146.  
  147.  
  148. Mounted
  149. --
  150. Indicates whether or not the CD is mounted as a NetWare volume.
  151. ---------------------------------------------------------------
  152.  
  153. The files contained in CDROM3.EXE will only work with NetWare
  154. 3.12 and 4.0x.
  155.  
  156. Explanation of files:
  157.  
  158. NWPA.NLM
  159. This is a support file for the CDROM.NLM running on a NetWare
  160. 4.0x server.
  161.  
  162. NPA312.NLM
  163. This is a support file for the CDROM.NLM running on a NetWare
  164. 3.12 server.
  165.  
  166. CDROM.NLM
  167. This is the updated CDROM.NLM only for Novell NetWare 3.12 and
  168. 4.0x.
  169.  
  170. NOTE:     The current version of the CDROM.NLM needs to have
  171. AFTER311.NLM, STREAMS.NLM and CLIB.NLM files loaded before it
  172. will load (this is only with NetWare 3.12).  You can accomplish
  173. this by loading the AFTER311.NLM file at the server console.
  174. The CLIB.NLM and STREAMS.NLM files will be automatically
  175. loaded.  The "S" revision of the CDROM.NLM (included in this
  176. file) will not use any previously created index files.  An
  177. index file is created the first time a new CD is mounted as a
  178. NetWare volume.  Novell recommends that you execute the CD
  179. PURGE command at the server console to purge all previous index
  180. files.  The CD PURGE command should only be executed when no
  181. CD's are mounted as NetWare volumes.  Executing the CD PURGE
  182. command requires that each CD re-build its index files the
  183. first time it is mounted as a NetWare volume.  When mounting
  184. CDs with the new CDROM.NLM the /R parameter should be used to
  185. rebuild the index files.  This will result in a slight delay.
  186.  
  187. Issues Resolved:
  188.  
  189. 1.  Many CD-ROMs that would not mount under the initial release
  190. of the CDROM.NLM will now mount without any problems.
  191. Enhancements were made to the CDROM.NLM to better support the
  192. ISO 9660 and the High Sierra CD-ROM formats.
  193.  
  194. 2.  The error messages encountered during the mounting of a CD
  195. volume on a NetWare 4.x server have been addressed.
  196.  
  197. 3.  CD-ROMs without a label will now mount.  A new feature has
  198. been added so that a volume label can be assigned to any CD
  199. volume upon mounting.  Use the following syntax:
  200.  
  201.     CD RENAME /D=<device #> new name
  202.     CD MOUNT device#!volume name /R
  203.  
  204.  NOTE:The "/R" must be used when remounting the renamed volume
  205. for the first time.
  206.  
  207.  NOTE:If CDROM.NLM encounters a CD-ROM without a label, it will
  208. automatically assign a label to the CD that is associated with
  209. the CD device number.
  210.  
  211. 4.  The CDROM.NLM has been enhanced so that volumes are mounted
  212. based on a 64KB block size.  It now takes less resources to
  213. mount a CD-ROM.
  214.  
  215. 5.  CDROM.NLM has been enhanced so that volumes mount faster.
  216. The CDROM.NLM now correctly uses the data base files in the
  217. SYS:SYSTEM subdirectory.
  218.  
  219. 6.  Adding a name space to a CD volume is now possible.  Novell
  220. recommends using the /MAC and /NFS (these are CDROM.NLM command
  221. line parameters) for these types of name spaces.  For OS/2, you
  222. can use the ADD NAME SPACE command to add this support to the
  223. CD volume.
  224.  
  225. 7.  The CDROM.NLM now supports CD's with greater than 1824
  226. directories and more than 58,368 files.
  227.  
  228.     ***************
  229.     *** WARNING ***
  230.     ***************
  231.  
  232. DO NOT enable compression, suballocation, or change any of the
  233. file attributes of the files contained on the CD-ROM or delete
  234. any of the files on the CD-ROM.  Undesirable results may occur.
  235. Novell recommends that only the Supervisor/Admin be given
  236. rights to change the file attributes.
  237.  
  238. 7.  CD-ROM NLM Command Line Options:
  239.  
  240. CD DEVICE LIST
  241. This command shows a listing of CD-ROM devices that are
  242. available on the server, whether they are active, loaded CD-
  243. ROMs, and their mount status.
  244.  
  245. CD VOLUME LIST
  246. This command shows a listing of all CD volumes that have been
  247. mounted since the CDROM.NLM was loaded, the device that
  248. contains the CD-ROM, and the CD-ROM's mount status.
  249.  
  250. CD MOUNT £No.| or £volume name| <flags>
  251. This command mounts a CD-ROM as NetWare Volume.  The available
  252. flags are listed below.  The £No.| or £volume name| can be
  253. obtained by using the CD VOLUME LIST command.
  254.  
  255. CD DISMOUNT £No.| or £volume name|
  256. This command dismounts a CD-ROM that has been mounted as a
  257. NetWare Volume. The £No.| or £volume name| can be obtained by
  258. using the CD VOLUME LIST command.
  259.  
  260. CD CHANGE £No.| or £volume name| <flags>
  261. This command is used to change a CD-ROM that is mounted as a
  262. NetWare volume to another CD-ROM.  Available flags are listed
  263. below.  (See the note about CD CHANGE in the SYMPTOM section of
  264. this document).
  265.  
  266. CD DIR £No.| £volume name|
  267. This command is used to list the ROOT DIRECTORY contents of an
  268. UNMOUNTED CD.
  269.  
  270. CD GROUP (£group name| and £group num|)
  271. This command is used to show assigned groups and assign groups
  272. to a group number 0 through 9.  For example:  Group "CDGROUP"
  273. needs to be assigned to the CD group number 1.  The syntax
  274. would be the following:
  275.  
  276.      CD GROUP CDGROUP 1
  277.  
  278.   NOTE:  The "del" as the group name will remove a group number
  279. assignment.
  280.  
  281.   The assignment could then be displayed by typing:
  282.  
  283.      CD GROUP
  284.  
  285.   The results would be as follows:
  286.  
  287.      ** CD ROM Access Group List
  288.      *Group: 0 > EVERYONE (assigned by default)
  289.      *Group: 1 > CDGROUP
  290.  
  291.   To assign the group to a CD-ROM, see the available CD MOUNT
  292. flags below.
  293.  
  294. CD PURGE
  295. This command will destroy all index files.
  296.  
  297. CD RENAME /D=£No.| £new volume name|
  298. This command is used to change the name of a CD-ROM.  The
  299. syntax is as follows:
  300.  
  301.      CD RENAME /D=<device #> new name
  302.      CD MOUNT device#!volume name /R
  303.  
  304. (NOTE:  The "/R" must be used when remounting the volume.)
  305.  
  306. The £No.| or £volume name| can be obtained by using the CD
  307. VOLUME LIST command.
  308.  
  309. CD HELP
  310. This command displays the help screen for CDROM.NLM.
  311.  
  312. CD MOUNT and DISMOUNT FLAGS
  313. ■  The "/mac" is used to add Macintosh Name Space Support.
  314. This adds the necessary DATA and RESOURCE forks so that
  315. Macintosh workstations can access the information on the CD.
  316.  
  317. ■  The "/nfs" is used to add NFS Name Space Support.
  318.  
  319. ■  The "/G=x" is used to set the default volume group access
  320. rights.  This is used with the CD GROUP command previously
  321. listed.  The mount syntax to assign a group to a CD would be as
  322. follows:
  323.  
  324.      CD MOUNT <device # ! volume name> /G=x
  325.  
  326.    where "x" is the group number assigned to a group.  (See CD
  327. GROUP command above).
  328.  
  329. ■  The "/R" is used to rebuild the index file on the selected
  330.    Volume.
  331.  
  332.    NOTE:  In previous releases, the /R option forced the
  333. CDROM.NLM to reuse an index file if it existed.  The CDROM.NLM
  334. now does this by default.
  335.  
  336. ■  The "/X=name" is used to exclude a directory tree from the
  337. mounted volume as the CD is being mounted.
  338.  
  339. ■  Special option "/I":  This option is used to ignore errors
  340. found with the CD while attempting to mount the CD.
  341.  
  342.    NOTE:  Use of this flag could result in files not showing up
  343. after the CD mounts.
  344.  
  345. ■  The "/W" is used to mount a CD volume with the R/O attribute
  346. turned off.  With versions of the CDROM.NLM before v4.10g, the
  347. CD would be mounted with the R/O option already disabled (that
  348. is, the CD would be mounted R/W).  This allowed the changing of
  349. file attributes, inherited rights masks, trustee assignments
  350. and the adding of groups and users to a CD volume.  If an
  351. attempt is made, with 4.10g version of the CDROM.NLM, to change
  352. any of the above items, an error writing to the CD will occur.
  353. To change the volume to R/W, dismount the CD (CD Dismount <cd
  354. #! cd volume name> and remount it using the "/W" option.
  355.  
  356. ---------------------------------------------------------------
  357. Any trademarks referenced in this document are the property of
  358. their respective owners.  Consult your product manuals for
  359. complete trademark information.
  360. ---------------------------------------------------------------
  361.