Patch Name: PHKL_29900 Patch Description: s700_800 11.23 SCSI Tape (stape) cumulative Creation Date: 04/05/17 Post Date: 04/05/19 Hardware Platforms - OS Releases: s700: 11.23 s800: 11.23 Products: N/A Filesets: OS-Core.KERN-ENG-A-MAN,fr=B.11.23,fa=HP-UX_B.11.23_IA/PA,v=HP ProgSupport.C-INC,fr=B.11.23,fa=HP-UX_B.11.23_IA/PA,v=HP OS-Core.CORE2-KRN,fr=B.11.23,fa=HP-UX_B.11.23_IA,v=HP Automatic Reboot?: Yes Status: General Release Critical: Yes PHKL_29900: CORRUPTION The risk of data loss on the backup tape media is only of concern if the HPUX host is part of a tape backup SAN. Category Tags: defect_repair hardware_enablement general_release critical corruption Path Name: /hp-ux_patches/s700_800/11.X/PHKL_29900 Symptoms: PHKL_29900: ( SR:8606360797 CR:JAGaf21504 ) Enables support for the HP SuperDLT 600 (AA984A/AA985A) tape drive. Without this change, the stape driver may not set the density and compression optimally for the HP SuperDLT 600 (AA984A/AA985A) tape drive. ( SR:8606360798 CR:JAGaf21505 ) Enables stape driver support for the HP DAT72X6 (Q1567A/Q1566A) autoloader. Without this change, a user will not be able to use fbackup(1M) with the HP DAT72X6 (Q1567A/Q1566A) autoloader. ( SR:8606360799 CR:JAGaf21506 ) Enables support for STK 9840C tape drives. Without this change, the stape driver may not set the density and compression optimally for the STK 9840C tape drive. ( SR:8606347386 CR:JAGaf08209 ) An attempt to restore data from a tape backup created in a SAN backup configuration fails because the backup application does not recognize the data on the tape. Defect Description: PHKL_29900: ( SR:8606360797 CR:JAGaf21504 ) The stape driver does not support the HP SuperDLT 600 (AA984A/AA985A) tape drive. Resolution: New device support added. ( SR:8606360798 CR:JAGaf21505 ) The stape driver does not support the HP DAT72X6 (Q1567A/Q1566A) autoloader. Resolution: New device support added. ( SR:8606360799 CR:JAGaf21506 ) The stape driver does not support the STK 9840C tape drive. Resolution: New device support added. ( SR:8606347386 CR:JAGaf08209 ) When a host application is writing data to a tape, another tape command like mt(1) could be issued from a different host to the same device using a device file without the no-rewind-on-close option (i.e rewind-on-close). This second command would issue a rewind-on-close to the drive between writes (of the first host) causing the tape to reposition to beginning of tape (BOT). The first host that is writing to the drive would have no knowledge that the tape was repositioned and it would then continue writing from the BOT, effectively overwriting the previously written data. Resolution: This patch introduces a kernel tuneable called "st_san_safe" which has a default state of DISABLED when this patch is installed. When st_san_safe is enabled by setting "st_san_safe=1", this forces the stape driver to fail all opens to device files which do not have the no-rewind-on-close option with the errno "EINVAL". The stape driver will also log an entry into the syslog like the following: vmunix: SCSI TAPE: dev = 0xcd002000 Failed open - st_san_safe enabled When st_san_safe is enabled, mksf(1M) will only create new device files with a no-rewind-on-close option. The mksf(1M) command will fail with an error indicating an invalid option was provided in the command line arguments. With st_san_safe enabled, lssf(1M) will not fully decode the density attribute of a tape special device file. Enhancement: No SR: 8606347386 8606360797 8606360798 8606360799 Patch Files: OS-Core.KERN-ENG-A-MAN,fr=B.11.23,fa=HP-UX_B.11.23_IA/PA, v=HP: /usr/share/man/man5.Z/st_san_safe.5 ProgSupport.C-INC,fr=B.11.23,fa=HP-UX_B.11.23_IA/PA,v=HP: /usr/include/sys/mtio.h OS-Core.CORE2-KRN,fr=B.11.23,fa=HP-UX_B.11.23_IA,v=HP: /usr/conf/lib/libio.a(mt_prop.o) /usr/conf/lib/libwsio.a(scsi_tape.o) /usr/conf/lib/libwsio.a(stape.modmeta.o) what(1) Output: OS-Core.KERN-ENG-A-MAN,fr=B.11.23,fa=HP-UX_B.11.23_IA/PA, v=HP: /usr/share/man/man5.Z/st_san_safe.5: None ProgSupport.C-INC,fr=B.11.23,fa=HP-UX_B.11.23_IA/PA,v=HP: /usr/include/sys/mtio.h: mtio.h $Date: 2004/04/26 11:09:04 $Revision: r11.23/ 1 PATCH_11.23 (PHKL_29900) OS-Core.CORE2-KRN,fr=B.11.23,fa=HP-UX_B.11.23_IA,v=HP: /usr/conf/lib/libio.a(mt_prop.o): mt_prop.c $Date: 2004/04/26 11:09:04 $Revision: r11. 23/1 PATCH_11.23 (PHKL_29900) /usr/conf/lib/libwsio.a(scsi_tape.o): scsi_tape.c $Date: 2004/04/26 11:09:04 $Revision: r1 1.23/1 PATCH_11.23 (PHKL_29900) /usr/conf/lib/libwsio.a(stape.modmeta.o): stape.modmeta $Date: 2004/04/26 11:09:04 $Revision: r11.23/1 PATCH_11.23 (PHKL_29900) cksum(1) Output: OS-Core.KERN-ENG-A-MAN,fr=B.11.23,fa=HP-UX_B.11.23_IA/PA, v=HP: 2483046774 2033 /usr/share/man/man5.Z/st_san_safe.5 ProgSupport.C-INC,fr=B.11.23,fa=HP-UX_B.11.23_IA/PA,v=HP: 4043405033 31624 /usr/include/sys/mtio.h OS-Core.CORE2-KRN,fr=B.11.23,fa=HP-UX_B.11.23_IA,v=HP: 683491805 64376 /usr/conf/lib/libio.a(mt_prop.o) 2850015925 263232 /usr/conf/lib/libwsio.a(scsi_tape.o) 842630445 3376 /usr/conf/lib/libwsio.a(stape.modmeta.o) Patch Conflicts: None Patch Dependencies: None Hardware Dependencies: None Other Dependencies: None Supersedes: None Equivalent Patches: None Patch Package Size: 140 KBytes Installation Instructions: Please review all instructions and the Hewlett-Packard SupportLine User Guide or your Hewlett-Packard support terms and conditions for precautions, scope of license, restrictions, and, limitation of liability and warranties, before installing this patch. ------------------------------------------------------------ 1. Back up your system before installing a patch. 2. Login as root. 3. Copy the patch to the /tmp directory. 4. Move to the /tmp directory and unshar the patch: cd /tmp sh PHKL_29900 5. Run swinstall to install the patch: swinstall -x autoreboot=true -x patch_match_target=true \ -s /tmp/PHKL_29900.depot By default swinstall will archive the original software in /var/adm/sw/save/PHKL_29900. If you do not wish to retain a copy of the original software, include the patch_save_files option in the swinstall command above: -x patch_save_files=false WARNING: If patch_save_files is false when a patch is installed, the patch cannot be deinstalled. Please be careful when using this feature. For future reference, the contents of the PHKL_29900.text file is available in the product readme: swlist -l product -a readme -d @ /tmp/PHKL_29900.depot To put this patch on a magnetic tape and install from the tape drive, use the command: dd if=/tmp/PHKL_29900.depot of=/dev/rmt/0m bs=2k Special Installation Instructions: The new tunable st_san_safe should be enabled (set to 1) if the system being patched is part of a SAN tape backup solution where multiple HP-UX hosts can access the same tape device. This will prevent the situation detailed above where a tape unintentionally rewinds in the middle of a backup. The fbackup/frecover utilities require device files which have rewind-on-close set on them. The device files available when st_san_safe=1 (no-rewind-on-close) can not be used by fbackup/frecover. See the manpage for fbackup(1M).