NOVELL TECHNICAL INFORMATION DOCUMENT TITLE: CDROM.NLM DOCUMENT ID: TID021274 DOCUMENT REVISION: A DATE: 11JUL94 ALERT STATUS: Yellow INFORMATION TYPE: Symptom Solution README FOR: CDROM3.EXE NOVELL PRODUCT and VERSION: NetWare 3.12 NetWare 4.01 ABSTRACT: CDROM.NLM for NetWare 3.12 and 4.01. The CDROM.NLM now supports CD's with greater than 1824 directories and more than 58,368 files, along with other enhancements. ------------------------------------------------------------------------------ DISCLAIMER THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL. NOVELL MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION. HOWEVER, THE INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY. NOVELL MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION. ------------------------------------------------------------------------------ SYMPTOM When users tried to load the CDROM.NLM, the following message was displayed and the CDROM.NLM module failed to load: MESSAGE All of the system resources could not be assigned SYMPTOM The CD CHANGE command hung the server or forced the operating system into the debugger. This only occurred in a few installations and Novell is aware of the problem and is working on a solution. If the ASPICD.DSK driver is being used contact Adaptec for an upgraded driver to address this problem. However, see the below solution for an interim work-around. SOLUTION CD CHANGE work-around: 1. From the Server console, use the CD DISMOUNT command to dismount the volume. 2. Load monitor and select DISK INFORMATION. 3. On the list of System Disk Drives, select the CD-ROM drive on which the CD-ROM is to be changed. 4. Select Drive Operating Status, take the selection for Deactivate Drive. 5. Change the CD-ROM. 6. Select the Removable Drive Mount Status and take the selection for Mount Drive. 7. Change back to the System Console and issue a CD MOUNT command. SYMPTOM Many CD-ROMs would not mount under the initial release of the CDROM.NLM. The current version of the CDROM.NLM "S" supports a much broader range of CD's. SOLUTION Apply the CDROM3.EXE file. Self-Extracting File Name: CDROM3.EXE Revision: B Files Included Size Date Time \ CDROM3.TXT (This File) NWPA.NLM 64575 04-22-94 3:50p CDROM.NLM 96467 05-24-94 8:50a NPA312.NLM 64101 04-22-94 11:49a Installation Instructions: 1. Rename the existing CDROM.NLM to *.OLD. 2. Copy the NWPA.NLM file (for NetWare 4.0x) or the NPA312.NLM file (for NetWare 3.12) and the CDROM.NLM file to the SYS:SYSTEM subdirectory. 3. Load HBA driver (for example, AHA1540.DSK). 4. Load ASPICD.DSK or CDNASPI.DSK file if it is needed. 5. Based upon your version of NetWare use the following load statements: NetWare 3.12 NetWare 4.x Load AFTER311.NLM ------------ Load NPA312.NLM Load NWPA.NLM Load CDROM.NLM Load CDROM.NLM 6. For a list of available CDROM.NLM commands, type CD HELP at the SYSTEM CONSOLE prompt. Solution Specifics: ---------------------------------------------------------------- CD DEVICE LIST typed at the console prompt yields the following information: ** CD ROM Device List No. Act. Device Name Volume Name Mounted 2 Y Device # 0 SONY CD-ROM CDU-541 (8100000 NSEPRO Y No. -- Defines the Media Manager object number assigned to this particular CD player. When you manipulate the CD in the player by using the "device number" this is the number you should be using and NOT the number listed under "Device Name". Act. -- Indicates whether or not the device, cd player, is active. Device Name -- Indicates the name of the device as reported by the device. Do NOT use the number that appears here to try and manipulate the CD. Using the above example, you would type "CD MOUNT 2" to mount the CD. You would NOT type "CD MOUNT 0". Volume Name -- Indicates the volume name as reported by the CD. Mounted -- Indicates whether or not the CD is mounted as a NetWare volume. ---------------------------------------------------------------- The files contained in CDROM3.EXE will only work with NetWare 3.12 and 4.0x. Explanation of files: NWPA.NLM This is a support file for the CDROM.NLM running on a NetWare 4.0x server. NPA312.NLM This is a support file for the CDROM.NLM running on a NetWare 3.12 server. CDROM.NLM This is the updated CDROM.NLM only for Novell NetWare 3.12 and 4.0x. NOTE: The current version of the CDROM.NLM needs to have AFTER311.NLM, STREAMS.NLM and CLIB.NLM files loaded before it will load (this is only with NetWare 3.12). You can accomplish this by loading the AFTER311.NLM file at the server console. The CLIB.NLM and STREAMS.NLM files will be automatically loaded. The "S" revision of the CDROM.NLM (included in this file) will not use any previously created index files. An index file is created the first time a new CD is mounted as a NetWare volume. Novell recommends that you execute the CD PURGE command at the server console to purge all previous index files. The CD PURGE command should only be executed when no CD's are mounted as NetWare volumes. Executing the CD PURGE command requires that each CD re-build its index files the first time it is mounted as a NetWare volume. When mounting CDs with the new CDROM.NLM the /R parameter should be used to rebuild the index files. This will result in a slight delay. Issues Resolved: 1. Many CD-ROMs that would not mount under the initial release of the CDROM.NLM will now mount without any problems. Enhancements were made to the CDROM.NLM to better support the ISO 9660 and the High Sierra CD-ROM formats. 2. The error messages encountered during the mounting of a CD volume on a NetWare 4.x server have been addressed. 3. CD-ROMs without a label will now mount. A new feature has been added so that a volume label can be assigned to any CD volume upon mounting. Use the following syntax: CD RENAME /D= new name CD MOUNT device#|volume name /R NOTE:The "/R" must be used when remounting the renamed volume for the first time. NOTE:If CDROM.NLM encounters a CD-ROM without a label, it will automatically assign a label to the CD that is associated with the CD device number. 4. The CDROM.NLM has been enhanced so that volumes are mounted based on a 64KB block size. It now takes less resources to mount a CD-ROM. 5. CDROM.NLM has been enhanced so that volumes mount faster. The CDROM.NLM now correctly uses the data base files in the SYS:SYSTEM subdirectory. 6. Adding a name space to a CD volume is now possible. Novell recommends using the /MAC and /NFS (these are CDROM.NLM command line parameters) for these types of name spaces. For OS/2, you can use the ADD NAME SPACE command to add this support to the CD volume. 7. The CDROM.NLM now supports CD's with greater than 1824 directories and more than 58,368 files. *************** *** WARNING *** *************** DO NOT enable compression, suballocation, or change any of the file attributes of the files contained on the CD-ROM or delete any of the files on the CD-ROM. Undesirable results may occur. Novell recommends that only the Supervisor/Admin be given rights to change the file attributes. 7. CD-ROM NLM Command Line Options: CD DEVICE LIST This command shows a listing of CD-ROM devices that are available on the server, whether they are active, loaded CD-ROMs, and their mount status. CD VOLUME LIST This command shows a listing of all CD volumes that have been mounted since the CDROM.NLM was loaded, the device that contains the CD-ROM, and the CD-ROM's mount status. CD MOUNT [No.] or [volume name] This command mounts a CD-ROM as NetWare Volume. The available flags are listed below. The [No.] or [volume name] can be obtained by using the CD VOLUME LIST command. CD DISMOUNT [No.] or [volume name] This command dismounts a CD-ROM that has been mounted as a NetWare Volume. The [No.] or [volume name] can be obtained by using the CD VOLUME LIST command. CD CHANGE [No.] or [volume name] This command is used to change a CD-ROM that is mounted as a NetWare volume to another CD-ROM. Available flags are listed below. (See the note about CD CHANGE in the SYMPTOM section of this document). CD DIR [No.] [volume name] This command is used to list the ROOT DIRECTORY contents of an UNMOUNTED CD. CD GROUP ([group name] and [group num]) This command is used to show assigned groups and assign groups to a group number 0 through 9. For example: Group "CDGROUP" needs to be assigned to the CD group number 1. The syntax would be the following: CD GROUP CDGROUP 1 NOTE: The "del" as the group name will remove a group number assignment. The assignment could then be displayed by typing: CD GROUP The results would be as follows: ** CD ROM Access Group List *Group: 0 > EVERYONE (assigned by default) *Group: 1 > CDGROUP To assign the group to a CD-ROM, see the available CD MOUNT flags below. CD PURGE This command will destroy all index files. CD RENAME /D=[No.] [new volume name] This command is used to change the name of a CD-ROM. The syntax is as follows: CD RENAME /D= new name CD MOUNT device#|volume name /R (NOTE: The "/R" must be used when remounting the volume.) The [No.] or [volume name] can be obtained by using the CD VOLUME LIST command. CD HELP This command displays the help screen for CDROM.NLM. CD MOUNT and DISMOUNT FLAGS þ The "/mac" is used to add Macintosh Name Space Support. This adds the necessary DATA and RESOURCE forks so that Macintosh workstations can access the information on the CD. þ The "/nfs" is used to add NFS Name Space Support. þ The "/G=x" is used to set the default volume group access rights. This is used with the CD GROUP command previously listed. The mount syntax to assign a group to a CD would be as follows: CD MOUNT /G=x where "x" is the group number assigned to a group. (See CD GROUP command above). þ The "/R" is used to rebuild the index file on the selected Volume. NOTE: In previous releases, the /R option forced the CDROM.NLM to reuse an index file if it existed. The CDROM.NLM now does this by default. þ The "/X=name" is used to exclude a directory tree from the mounted volume as the CD is being mounted. þ Special option "/I": This option is used to ignore errors found with the CD while attempting to mount the CD. NOTE: Use of this flag could result in files not showing up after the CD mounts. þ The "/W" is used to mount a CD volume with the R/O attribute turned off. With versions of the CDROM.NLM before v4.10g, the CD would be mounted with the R/O option already disabled (that is, the CD would be mounted R/W). This allowed the changing of file attributes, inherited rights masks, trustee assignments and the adding of groups and users to a CD volume. If an attempt is made, with 4.10g version of the CDROM.NLM, to change any of the above items, an error writing to the CD will occur. To change the volume to R/W, dismount the CD (CD Dismount and remount it using the "/W" option. ---------------------------------------------------------------- Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information. ---------------------------------------------------------------- ÿ