Dear SCO Customer, The enclosed Support Level Supplement (SLS) OSS445A, the SCSI Tape Driver Supplement, contains two modifications to the SCSI tape driver in OpenServer 5.0.2. It corrects a problem where the "tape unload" command did not issue a SCSI UNLOAD for the no-rewind device. It also reinstates old semantics for the read filemark ioctl, MT_RFM; these old semantics interpret the 3rd argument to the ioctl call as the number of filemarks to skip. This SLS was created for Sybase SQL Server 10. At this time, the only application known to require these old read filemark semantics reinstating is Sybase SQL Server 10. You should assume that all other applications use the new semantics and will therefore fail if this SLS is applied. Those applications requiring just the tape-unload-fix should download OSS446A. INSTALLATION AND REMOVAL INSTRUCTIONS Installing patches on SCO OpenServer Release 5.0.2 usually consists of two phases: "Loading" and "Applying". The instructions that follow enable you to both install the patch from distribution media or media image, as well as configure the patch to be installed from a remote SCO OpenServer 5.0.2 system over a TCP/IP network. I. BEFORE LOADING THE PATCH Use the Software Manager to check which patches are currently on the system. Do not install Support Level Supplement (SLS) OSS445A if the SCO Large Server Supplement or SLS OSS446A is installed on your system. More information regarding installation of the Release Supplement may be found on page 32 of the SCO OpenServer Release Notes. II. LOADING THE PATCH 1. Log in as root. 2. If you are installing this SLS from floppy disk media, skip this step and proceed to step 3. If you are installing this SLS from a media image, there is a file called oss445a.Z. Uncompress this file with this command: # uncompress oss445a.Z Copy the file to the /tmp directory and name it VOL.000.000: # cp oss445a /tmp/VOL.000.000 3. Execute the command: # scoadmin software or double click on the Software Manager icon on the desktop. 4. Pull down the "Software" menu and select "Patch Management-->Load Patch". 5. You will see the "Load Patch" menu. Be sure the local machine name is selected and choose "Continue". 6. You will see the "Select Media" menu. a. If you are loading this SLS from floppy disk media, select the appropriate floppy disk drive and choose "Continue". Proceed to step 7. b. If you are loading this SLS from a media image per step 2, pull down the "Media Device" menu and select "Media Images", then choose "Continue". You will then see the "Enter Image Directory" menu. Enter /tmp and choose "OK". 7. You will see the "Load Patch Preference" menu. Choose "Full". 8. You will see the "Load Patch Progress" window. If the patch loads successfully, you will see a "Message" window which states "Load Patch complete". Choose "OK". You are then returned to the main Software Manager window. 9. To apply the patch now, continue with step 2 under section III, "Applying the Patch". To exit the Software Manager now, select "Exit" from the "Host" menu. III. APPLYING THE PATCH If you are already root and in Software Manager, skip step 1. 1. Log in as root. Execute the command: # scoadmin software or double click on the Software Manager icon on the desktop. 2. Pull down the Software menu and select "Patch Management-->Apply Patch". 3. You will see the "Apply Patch" menu. Be sure that the local machine name is selected and choose "Continue". 4. You will see the "Select Media" menu. The "Hard Disk" menu item should already be selected. Choose "Continue". This may take a while! 5. You will be presented with the "Select Patch-Product to Apply" menu. Highlight the "SCSI Tape Driver Supplement" patch and then choose "Full" to continue. 6. You will see the "Apply Patch Progress" window as the system applies the patch. NOTE: During the process, the system may prompt you with a message notifying you about some previous modifications to the files in the system area (if there have been any). The full pathname of the directory where the old files are stored is given in the message window. Press a key to continue if this message appears. 7. You will then see a "Message" window stating "Apply Patch Complete". Choose "OK" and you will be returned to the Software Manager's main menu. Exit the Software Manager by choosing "Exit" from the "Host" menu. 8. Log in as root on tty01, and shut down the system: # shutdown -g0 -y After shutting down and rebooting the machine, application of the patch is complete. IV. NOTES ON NETWORK INSTALLATION To install the patch on other SCO OpenServer 5.0.2 machines over the network, first load the patch as in section II above on a designated installation server. Then create the user "swadmin" on the installation server. When running the Software Manager on the system where the patch will be installed, you will be prompted for the source location of the patch in the "Load Patch" window. Be sure to choose "From Another Host" during this phase. You will need to provide the name of the installation server, as well as the password of the "swadmin" user on the installation server, to initiate the installation process. V. PATCH REMOVAL NOTE: Patches must be rolled back in the reverse order in which they were installed on a per-component basis. Hence, if the "SCSI Tape Driver Supplement" patch is not the most recent patch applied to the UNIX component of the product, you will have to rollback all patches applied after the "SCSI Tape Driver Supplement" patch prior to rollback of the "SCSI Tape Driver Supplement" patch. 1. Log in as root. 2. Execute the command: # scoadmin software or double click on the Software Manager icon in the desktop. 3. Pull down the "Software" menu and select "Patch Management-->Rollback Patch". 4. You will see the "Rollback Patch" menu, and be asked to select patched software to rollback. Select "SCO UNIX System V Operating System" and choose "Continue". 5. You will see the "Patch Selection" window. Make sure that the "SCSI Tape Driver Supplement" patch is selected, and choose "Continue". 6. You will see the "Confirm Selected Patches" window. Choose "Rollback" to confirm removal of the "SCSI Tape Driver Supplement" patch. 7. You will see the "Rollback Progress" window, as the system performs the rollback of the patch, and when it's done, you will see the message "Rollback Complete". Exit the Software Manager by choosing "Exit" from the "Host" menu. 8. Log in as root on tty01, and shut down the system: # shutdown -g0 -y After shutting down and rebooting the machine, rollback of the patch is complete. 9. To also unload the patch, making it no longer available to be applied, follow the steps in this section. In step 3, choose: "Patch Management-->Unload Patch" instead of: "Patch Management-->Rollback Patch" If you have questions regarding this SLS, or the product on which it is installed, please contact your software supplier. We appreciate your business. SCO Support Services