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