SCSI CAM Layered Components for DIGITAL UNIX Systems, Version 3.1B Release Notes The following release notes for SCSI CAM Layered Components Version 3.1B describe enhancements, features, and restrictions for this release. These release notes are included in your distribution kit on the DIGITAL layered product CD. The PostScript file is titled clc312_relnotes.ps and the text file is clc312_relnotes.txt. See the Software Product Library CD-ROM User's Guide in the /readme directory on the CD for instructions on how to locate and print the release notes from the CD. Copies of the release notes are also included in the software subset and are located in the directories /usr/opt/CLC312/mc/doc and /usr/opt/CLC312/op/doc after you complete your software installation. The release notes are included in these locations to ensure they are accessible from the product directory after the CD-ROM distribution disc is dismounted. Enhancements and New Features Version 3.1B o Version support. SCSI CAM Layered Components Version 3.1B adds support for DIGITAL UNIX Version 4.0D and DIGITAL TruClusters. o New medium changer driver file supports changer devices on DIGITAL UNIX Version 4.0D. This new file is in addition to the installed files listed in Appendix B of the Installation Guide; note that for this release, files listed in Appendix B as installed under the directory /usr/opt/CLC310 are installed under the /usr/opt/CLC312 directory location and that the full pathname of this additional changer file is /usr/opt/CLC312/mc/cam_changer.4.0D.o. [C] Digital Equipment Corporation 1997. All rights reserved. Version 3.1A There are no enhancements or new features in Version3.1A. Version 3.1 In addition to continued support for DEC OSF/1 Version 3.0 and higher, SCSI CAM Layered Components Version 3.1 adds support for DIGITAL UNIX Version 4.0. Note that DEC OSF/1 Versions below 3.0 are no longer supported. The following enhancements are also included: o The changer driver now supports exclusive opens with the O_EXCL flag. o All driver IOCTL calls can now be interrupted by Ctrl/C (SIGINT), allowing hung processes to be cleared without rebooting the system. o The driver will now return an error on a SCSI bus reset. This allows the application to determine the proper recovery actions to complete the interrupted operation. o There is now a generic SCSI CDB pass-through IOCTL that allows direct communication with a medium changer device and the application. The generic pass-through may be used to access device features not supported by the other IOCTL functions. It may also be used to improve software portability across platforms. Problems Resolved Since the Last Release Version 3.1B The following bugs are fixed in Version 3.1B: o The file command now displays the correct SCSI ID for medium changer device files on systems running DIGITAL UNIX Version 4.0 and higher. o The SCSI CAM Layered Components installation process is now able to find the kernel configuration file when the LANG environment variable indicates a non-Roman alphabet. 2 SCSI CAM Layered Components Release Notes Version 3.1A The following bugs were fixed in Version 3.1A: o Fixed a problem for systems running DIGITAL UNIX Version 4.0 with a media changer device connected to a KZPSA adapter, in which the media changer would not respond to commands. o Fixed a problem that could cause the system to crash with an "unaligned access" panic in changer_read_attributes. This problem occurred if a device that was previously accessed was removed, then accessed again without a reboot between accesses. Version 3.1 The following bugs were fixed in Version 3.1: o Fixes were made to the handling of blank checking and other mode parameters for some optical drives. o The LMSI LF4500 RAPIDCHANGER now selects the platter properly after a power-up or SCSI bus reset. o Optical platters may now be ejected without being spun up by using the NODELAY flag on open. o Problems in the recovery processing of the changer driver that could hang the user process have been corrected. Known Problems in This Release There are no known problems in this release. Items to Note for This Release The purpose of this section is to bring certain items to your attention. These items may, or may not, be new for this release. Support for SCSI CAM Layered Components Utilities SCSI CAM Layered Components currently provides mcutil and other utilities as a convenience for setting up and configuring media changer devices. These utilities may be removed in a future release. Similar functions are provided in the Media Robot Utility (MRU) product (see SPD 64.44.xx). SCSI CAM Layered Components Release Notes 3 Support for Multiple Versions of DIGITAL UNIX The installation procedure for SCSI CAM Layered Components automatically determines the operating system version for your machine and adjusts accordingly. The adjustments include creating links to appropriate operating system-specific files within the SCSI CAM Layered Components kit. Upgrading Your DIGITAL UNIX Operating System The SCSI CAM Layered Components kit transparently adapts to your operating system upon installation. If you run any version of SCSI CAM Layered Components on a DIGITAL UNIX machine and plan to upgrade to a later version of DIGITAL UNIX, then you will need to reinstall the SCSI CAM Layered Components kit. The following steps are recommended: o Remove the SCSI CAM Layered Components software kit (see Deleting Old Subsets in the Installation Guide for instructions) o Upgrade your system to a new version of the operating system o Re-install the SCSI CAM Layered Components software kit Upgrading Your SCSI CAM Layered Components Kit SCSI CAM Layered Components subsets will not be installed if a previous version of the subsets is found on your system. Older versions must be deleted before installing a new version. See Deleting Old Subsets in the Installation Guide for instructions. Note that if you have layered products installed that depend on the SCSI CAM Layered Components drivers, it may be necessary to deinstall those products before deinstalling the existing SCSI CAM Layered Components subsets, then reinstall them after the new version of the SCSI CAM Layered Components is installed. (This is not necessary with NetWorker.) Removing Devices SCSI CAM Layered Components ensures that optical device special files and media changer device special files are not deleted by the operating system when it is rebooted. The following files perform this function: 4 SCSI CAM Layered Components Release Notes /dev/MAKEDEV.MC.log A log file that has a record of each media changer device created. There is a one line entry in the log for each device created by MAKEDEV.MC /dev/MAKEDEV.OP.log A log file that has a record of each optical device created. There is a one line entry in the log for each device created by MAKEDEV.OP /sbin/rc2.d/S01clcdev.mc These two scripts are /sbin/rc2.d/S01clcdev.op automatically executed at system boot time The two scripts (one for media changer devices and one for optical devices) read the appropriate log files, and make a device special file for each entry in the log. To remove a device, in addition to deleting the device special file, you must delete the appropriate line from the MAKEDEV.MC.log or MAKEDEV.OP.log file. See the Completing the Installation chapter in the Installation Guide for information on creating device special files, and editing the system configuration file. System Configuration File Information Devices are not automatically added to the system configuration file. The administrator may modify the system configuration file to reflect the devices present. This will cause the devices to be mentioned in the boot record. It is not necessary to modify the system configuration file, however, as any device is located by the system at the first reference to the device file. For DIGITAL UNIX Version 4.0, devices will still be reported on boot without being added to the configuration file. If you choose to modify the system configuration file, see the op(7) and mc(7) reference pages for information. After modification of the system configuration file, the kernel must be rebuilt for the modifications to take effect. SCSI CAM Layered Components Release Notes 5