ECO NUMBER: OSDSE01016 ----------- PRODUCT: DIGITAL Optical Storage Desktop Software (OSDS) for DIGITAL UNIX 1.6 -------- UPDATED PRODUCT: DIGITAL Optical Storage Desktop Software (OSDS) for DIGITAL UNIX 1.6 ---------------- APPRX BLCK SIZE: 5220 ---------------- DIGITAL Optical Storage Desktop Software (OSDS) 1.6-E01 for DIGITAL UNIX ECO NUMBER: OSDSE01016 PRODUCT: DIGITAL Optical Storage Desktop Software (OSDS) for DIGITAL UNIX Version 1.6 UPDATED PRODUCT: DIGITAL Optical Storage Desktop Software (OSDS) for DIGITAL UNIX Version 1.6-E01 APPROX BLOCK SIZE: 5220 blocks Kit Description: ------------------- This kit is a full kit update. OSDS V1.6-E01 is the version that makes this product Year 2000 compliant and DUNIX 4.0D compatible. The Cover Letter and the Release Notes are the only changed documents. The Doc Kit remains unchanged from the current version. This kit may be applied to Digital UNIX systems running the following version(s): - DIGITAL UNIX Version 4.0b - DIGITAL UNIX Version 4.0d If you are currently running Digital UNIX V3.2c, V3.2d, V3.2f or V3.2g, you SHOULD NOT install this kit. Installation WILL NOT be successful in such a case. DIGITAL OSDS V1.6-1 continues to provide support for DIGITAL's RW5xx series of optical libraries: RW546, RW551, RW552, RW555 and RW557. Problems Corrected ------------------ 1. This Product is Year 2000 compliant. Utilities that use date are found to work well even after year 2000. 2. A new daemon called "oupdate" is added to sync WORM volumes. When WORM volumes are used oupdate should be invoked as follows: /usr/sbin/oupdate n where 'n' is the time interval in seconds for successive syncing of the WORM media. 3. Corrections have been made to the man pages to help in case of utilities which use the regression date. Installation Instructions ------------------------- The OSDS kit is supplied in the file OSDSE01016.tar(which is a tape archive file). REMOVE ANY PREVIOUS OSDS SOFTWARE BEFORE THIS OSDS INSTALLATION. To extract and install the kit from the tar file do as follows. 1. Extract files from the archive file using: tar xvf OSDSE01016.tar This tar command extracts the subsets of the product into a directory called "kit" 2. Change the directory to the directory named "kit" cd kit 3. Invoke setld -l to install the product. setld -l . Copyright (c) Compaq Computer Corporation 1998. All Rights reserved. This software is proprietary to and embodies the confidential technology of Compaq Computer Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Compaq or an authorized sublicensor. This ECO has not been through an exhaustive field test process. Due to the experimental stage of this ECO/workaround, Compaq makes no representations regarding its use or performance. The customer shall have the sole responsibility for adequate protection and back-up data used in conjunction with this ECO/workaround. ************************************************************* Release Notes appended to Cover Letter 11/17/98 DIGITAL Optical Storage Management Software (OSMS) and DIGITAL Optical Desktop Software (OSDS) Version 1.6-1 for DIGITAL UNIX V4.0b & DIGITAL UNIX4.0d Product Release Notes October, 1998 ________________________________________________________ October 1998 (c) Perceptics Corporation 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995 Portions (c) Digital Equipment Corporation, 1996, 1997. All Rights Reserved. The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. Possession, use, or copying of the software described in this document is authorized only pursuant to a valid written license from DIGITAL, an authorized sublicensor, or the identified licensor. Digital Equipment Corporation makes no representations that the interconnection of its products in the manner described in this document will not infringe existing or future patent rights, nor do the descriptions contained in this document imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. The following are trademarks of Digital Equipment Corporation: DEC, DECimage, DECnet, DIGITAL, Files-11, OpenVMS, VAX, VMS, and the DIGITAL logo. The following are third party trademarks: LaserStar, LaserWare, and WORMS-11 are trademarks of Perceptics Corporation. Portions of the Source Code, Object Code, and documentation for this product were developed by Perceptics Corporation. All other trademarks and registered trademarks are the property of their respective holders. DIGITAL OSMS and DIGITAL OSDS Version 1.6-1 features Correction to Documentation: --------------------------- Please note, the hardcopy Installation and Users guides references support for DIGITAL OSMS and DIGITAL OSDS versions 1.5 and DIGITAL UNIX V3.2c through V3.2g in the title page. Please disregard this information. Both guides provide support for Version 1.6-1 of DIGITAL OSMS and DIGITAL OSDS as well as for version 1.6 and version 1.5. Note 1: for Digital Unix 4.0D ----------------------------- The OSMS/OSDS for Digital Unix 4.0D requires SCSI drivers CLC31C subsets installed, for proper installation of OSMS/OSDS V1.6-1. CLC31C can be found on the Digital Unix Associated Products Disk 2. To install the CLC31C drivers: ----------------------------- Insert the Digital Unix Associated Products Disk containing CLC31C into the CDROM drive. Type the following commands in the same order: #mount -r /dev/rz4c /mnt #cd /mnt #cd CLC31C #cd kit #setld -l . Answer yes to the question "To install all mandatory and optional subsets?". Then build the kernels. Note that two kernels will be built. Once done, you can install OSDS/OSMS V1.6-1 kit. Note 2: Important for De-installation : --------------------------------------- Before reinstalling the OSXS software do the following exercise to ensure complete and correct de-installation of the OSXS Software. #find / -name "*.preOSMS*" (This command looks for anything with a .preOSMSXXX/.preOSDSXXX extension) Example output: file1.preOSMSCAM/file1.preOSDSCAM file2.preOSMSVFS etc... #mv file1.preOSMSCAM file1 #mv file2.preOSMSVFS file2 Continue the mv command for all the .preOSMSXXX/.preOSDSXXX files At the end of this step the OSXS software will be deinstalled. DIGITAL OSDS/DIGITAL OSMS Installation Verification Procedure ------------------------------------------------------------- The Installation Verification Procedure (IVP) verifies that all files required for OSDS operations are copied to the appropriate directories and that the these files have had the correct permissions assigned. For IVP test to succeed, ALL option must have The script file that performs IVP is osmsivp. It is copied to the /usr/sbin directory during installation and may be run at any time after installation. It is recommended, however, that the IVP be run immediately following installation. (In the example input and output below, square brackets [a/b] indicate that either character may apply. For example: os[d|m]sivp may be entered as either as osdssivp or osmssivp depending on the upon the product.) To run the IVP from anywhere in the system, simply invoke the command: # os[d|m]sivp The IVP will search all target directories for those files copied during installation and, if found, will verify that those files have the correct owner, group and permissions. The IVP generates no disk output nor creates any files. While checking files, the IVP will display the message: Checking File: When all files have been verified, the IVP terminates with a beep and the message: OSDS[D|M]SIVP Passed When this message is seen, the OS[D|M]S files have been correctly installed. There are two conditions that may cause the IVP to fail. First, if a file that is expected to exist is not found, the IVP will display the message: File not found directly under the 'Checking File' line. Second, if a file is found that does not possess the correct owner, group or permissions, the IVP will display the message: File has incorrect permissions, owner or group NOTE: If the CLC components are already installed from the Digital Unix Layered product kit then run another IVP called os[d|m]sivp_clc(This is for CLC version 313 only). If any other version of CLC is installed it is required to modify the /usr/sbin/os[ d In either case, any error (whether missing file or incorrect owner, group or permissions on an existing file) will terminate the IVP immediately with a beep and the message: OS[D|M]S IVP Failed If the IVP does fail, perform the following uninstall procedure: # setld -i | grep OS[D|M]S then, using the output from grep, if any: # setld -d [ ... ] This will uninstall any subsets. Check for any .preOS[D|M]S files in the system and their status. For a list of .preOS[D|M]S files refer to the User's Guide. Reinstall the product and run IVP. If the problem persists, contact the local DIGITAL offic e Known Restrictions ------------------ 1. Using DIGITAL OSMS, changer-based volumes mounted nfs may exhibit the following behaviors due to the latency of platter-swapping in the changer. These behaviors are seen with large numbers of concurrent accesses to nfs-mounted optical volumes; ie., a request from client2 is issued before the request from client1, for a volume not physically in a drive, completes: - I/O and/or Device Busy errors seen at the client. - In extreme cases, local processes may be suspended indefinitely waiting for access to some platters. - Also in extreme cases, the nfs server may exhibit nfs resource exhaustion. In DIGITAL UNIX, nfs requests are cached on timeout and, before any requests can be satisfied, the cache becomes full. Timeout at the client is a limitation of the nfs architecture. For these reasons, avoid large numbers of concurrent accesses to optical volumes mounted nfs unless all volumes are physically in drives. 2. Occasionally, files created using DIGITAL OSMS and DIGITAL OSDS 1.4 will not be readable. To read the files created by a previous version of DIGITAL OSMS and DIGITAL OSDS the cache files should be removed when uninstalling the previous version of the software product. 3. Certain scripts running DIGITAL UNIX-C Shell (csh) may crash the system with kernel memory fault or unaligned memory access exceptions while accessing an optical disk under DIGITAL UNIX V4.0b. Appropriate DIGITAL UNIX V4.0b patches (not DIGITAL OSMS or DIGITAL OSDS patches) must be applied to eliminate this problem. Consult the DIGITAL UNIX V4.0b patch information for additional details. 4. Avoid copying files from one side of a platter to the other; buffering is insufficient. If copies need to be made from one side of a platter to the other, first copy the data from the source side to another platter or device and then copy to the destination. 5. Avoid 'omount' when the device (optical filesystem) does not exist. When using OSMS (jukebox support) run the jbc utility and determine which slots are empty to avoid this action. Do this after insertion/removal of platters. New Features ------------- 1. The Software Product is Year 2000 compliant. The utilities that use date are found to work well even after year 2000. 2. A new daemon called "oupdate" is added to sync WORM volumes. When WORM volumes are used oupdate should be invoked as follows: "/usr/sbin/oupdate n" where 'n' is the time interval in seconds for successive syncing of the WORM media. In case the value for n is not supplied the default sync interval is taken as 30 seconds. 3. Certain corrections have been made to the man pages like: In case of utilities which use the regression date the leading '0's cannot be omitted when the date is supplied.