Patch Name: PHSS_8802 Patch Description: s700_800 10.X OmniBackII A.02.10 patch Creation Date: 96/10/17 Post Date: 96/10/22 Repost: 96/10/28 The patch documentation was modified to add a special note regarding a problem discovered with using the patch with JFS (VxFS) filesystems. See the Special Installation Instructions for details. Repost: 96/12/23 The patch documentation was modified to add information on the patches that correct the VXDIRECT problem when backing up VxFS filesystems. Hardware Platforms - OS Releases: s700: 10.00 10.01 10.10 10.20 s800: 10.00 10.01 10.10 10.20 Products: OmniBackII A.02.10 Filesets: OMNIBACK-II.OMNI-ACS-P OMNIBACK-II.OMNI-CC OMNIBACK-II.OMNI-CS OMNIBACK-II.OMNI-DA-P OMNIBACK-II.OMNI-DAS-P OMNIBACK-II.OMNI-MA-P OMNIBACK-II.OMNI-SAP-P Automatic Reboot?: No Status: General Superseded Critical: No Path Name: /hp-ux_patches/s700_800/10.X/PHSS_8802 Symptoms: PHSS_8802: 1. Error message "Specified slot X is not configured or used by some other OB2 session" during restores. 2. Restore of large file fails on AIX. 3. Omniback creates duplicate medium IDs. 4. Internal error in ("polmax.c":536) during rescan of 48AL. 5. "Cannot open exchanger control device" after device was powered-on. 6. During init of MO wrong medium size is determined. 7. Can't use barcode for HP tape library. 8. Various errors when accessing autochanger slots after init/verify/scan. 9. Rescanning MO jukebox causes error for all empty slots: "Cannot open device (No such device or address)" 10. Not possible to install host which has '0' as part of its IP address from within xomniadmin GUI. Error message is "Invalid number in second field!" 11. Use of preallocation list causes Omniback to issue erratic mount request. 12. Various performance enhancements Defect Description: PHSS_8802: 1. This happens with media on which the post-backup script failed. First restore runs fine, another restore will fail with the given error message. 2. File size computed incorrectly in the disk agent on the AIX system which causes very large numbers. 3. Happens only when initializing more than one medium at once. 4. Seen with cleaning tape in slot 6 of the exchanger. 5. Status returned by device after power-on is not interpreted correctly. Operation succeeds when repeated a second time. 6. Ioctl(SIOC_CAPACITY) doesn't work on HP-UX 9.04, need to use DIOC_CAPACITY instead 7. Barcode support is not enabled by default for HP tape library. 8. Medium slot is locked during init/verify/scan and not released properly when the operation fails. 9. Incorrect status is generated for empty slots. 10. The IP address is rejected because it fails the plausibility check. 11. Happens with old-style autochangers (old SCSI II, jukebox, external control), but not Exchanger/ACS/DAS pools. SR: 1653179333 1653181081 Patch Files: /opt/omni/bin/xomniadmin /opt/omni/databases/vendor/acs/hp/s800/hp-ux-10/A.02.10/ packet.Z /opt/omni/databases/vendor/acs/hp/s800/hp-ux/A.02.10/ packet.Z /opt/omni/databases/vendor/da/hp/s800/hp-ux-10/A.02.10/ packet.Z /opt/omni/databases/vendor/da/hp/s800/hp-ux-1020/A.02.10/ packet.Z /opt/omni/databases/vendor/da/hp/s800/hp-ux/A.02.10/packet.Z /opt/omni/databases/vendor/da/ibm/rs6000/aix/A.02.10/ packet.Z /opt/omni/databases/vendor/das/hp/s800/hp-ux-10/A.02.10/ packet.Z /opt/omni/databases/vendor/das/hp/s800/hp-ux/A.02.10/ packet.Z /opt/omni/databases/vendor/ma/hp/s800/hp-ux-10/A.02.10/ packet.Z /opt/omni/databases/vendor/ma/hp/s800/hp-ux/A.02.10/packet.Z /opt/omni/databases/vendor/ma/ibm/rs6000/aix/A.02.10/ packet.Z /opt/omni/databases/vendor/ma/sun/sparc/solaris/A.02.10/ packet.Z /opt/omni/databases/vendor/sap/hp/s800/hp-ux-10/A.02.10/ packet.Z /opt/omni/databases/vendor/sap/hp/s800/hp-ux/A.02.10/ packet.Z /opt/omni/lbin/bsm /opt/omni/lbin/msm /opt/omni/lbin/rsm what(1) Output: /opt/omni/bin/xomniadmin: [TZ=GMT0 /opt/omni/bin/xomniadmin -version] HP OpenView OmniBack II A.02.10: XOMNIADMIN, built o n Tue Aug 6 13:53:20 1996 /opt/omni/databases/vendor/acs/hp/s800/hp-ux-10/A.02.10/ packet.Z: None /opt/omni/databases/vendor/acs/hp/s800/hp-ux/A.02.10/ packet.Z: None /opt/omni/databases/vendor/da/hp/s800/hp-ux-10/A.02.10/ packet.Z: None /opt/omni/databases/vendor/da/hp/s800/hp-ux-1020/A.02.10/ packet.Z: None /opt/omni/databases/vendor/da/hp/s800/hp-ux/A.02.10/ packet.Z: None /opt/omni/databases/vendor/da/ibm/rs6000/aix/A.02.10/ packet.Z: None /opt/omni/databases/vendor/das/hp/s800/hp-ux-10/A.02.10/ packet.Z: None /opt/omni/databases/vendor/das/hp/s800/hp-ux/A.02.10/ packet.Z: None /opt/omni/databases/vendor/ma/hp/s800/hp-ux-10/A.02.10/ packet.Z: None /opt/omni/databases/vendor/ma/hp/s800/hp-ux/A.02.10/ packet.Z: None /opt/omni/databases/vendor/ma/ibm/rs6000/aix/A.02.10/ packet.Z: None /opt/omni/databases/vendor/ma/sun/sparc/solaris/A.02.10/ packet.Z: None /opt/omni/databases/vendor/sap/hp/s800/hp-ux-10/A.02.10/ packet.Z: None /opt/omni/databases/vendor/sap/hp/s800/hp-ux/A.02.10/ packet.Z: None /opt/omni/lbin/bsm: [TZ=GMT0 /opt/omni/lbin/bsm -version] HP OpenView OmniBack II A.02.10: BSM, built on Fri O ct 11 13:39:03 1996 /opt/omni/lbin/msm: [TZ=GMT0 /opt/omni/lbin/msm -version] HP OpenView OmniBack II A.02.10: MSM, built on Wed O ct 2 09:59:29 1996 /opt/omni/lbin/rsm: [TZ=GMT0 /opt/omni/lbin/rsm -version] HP OpenView OmniBack II A.02.10: RSM, built on Fri O ct 11 13:39:14 1996 cksum(1) Output: 954783286 1399852 /opt/omni/bin/xomniadmin 2159538112 2414193 /opt/omni/databases/vendor/acs/hp/s800/ hp-ux-10/A.02.10/packet.Z 3003781369 2270958 /opt/omni/databases/vendor/acs/hp/s800/ hp-ux/A.02.10/packet.Z 1308905160 1166668 /opt/omni/databases/vendor/da/hp/s800/ hp-ux-10/A.02.10/packet.Z 3540042641 1079999 /opt/omni/databases/vendor/da/hp/s800/ hp-ux-1020/A.02.10/packet.Z 1333174517 1129979 /opt/omni/databases/vendor/da/hp/s800/ hp-ux/A.02.10/packet.Z 496169029 780683 /opt/omni/databases/vendor/da/ibm/rs6000/ aix/A.02.10/packet.Z 2848659839 2192745 /opt/omni/databases/vendor/das/hp/s800/ hp-ux-10/A.02.10/packet.Z 2691554414 2046941 /opt/omni/databases/vendor/das/hp/s800/ hp-ux/A.02.10/packet.Z 1918856628 1942935 /opt/omni/databases/vendor/ma/hp/s800/ hp-ux-10/A.02.10/packet.Z 273725752 1799467 /opt/omni/databases/vendor/ma/hp/s800/ hp-ux/A.02.10/packet.Z 724678650 1797273 /opt/omni/databases/vendor/ma/ibm/rs6000/ aix/A.02.10/packet.Z 215047450 1314645 /opt/omni/databases/vendor/ma/sun/sparc/ solaris/A.02.10/packet.Z 191708078 764811 /opt/omni/databases/vendor/sap/hp/s800/ hp-ux-10/A.02.10/packet.Z 8482588 747951 /opt/omni/databases/vendor/sap/hp/s800/hp-ux/ A.02.10/packet.Z 3283729520 1797566 /opt/omni/lbin/bsm 478731817 1432352 /opt/omni/lbin/msm 254496516 1506263 /opt/omni/lbin/rsm Patch Conflicts: None Patch Dependencies: None Hardware Dependencies: None Other Dependencies: None Supersedes: None Equivalent Patches: PHSS_8801: s700: 9.01 9.03 9.05 9.07 s800: 9.00 9.04 Patch Package Size: 27020 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 PHSS_8802 5a. For a standalone system, run swinstall to install the patch: swinstall -x autoreboot=true -x match_target=true \ -s /tmp/PHSS_8802.depot 5b. For a homogeneous NFS Diskless cluster run swcluster on the server to install the patch on the server and the clients: swcluster -i -b This will invoke swcluster in the interactive mode and force all clients to be shut down. WARNING: All cluster clients must be shut down prior to the patch installation. Installing the patch while the clients are booted is unsupported and can lead to serious problems. The swcluster command will invoke an swinstall session in which you must specify: alternate root path - default is /export/shared_root/OS_700 source depot path - /tmp/PHSS_8802.depot To complete the installation, select the patch by choosing "Actions -> Match What Target Has" and then "Actions -> Install" from the Menubar. 5c. For a heterogeneous NFS Diskless cluster: - run swinstall on the server as in step 5a to install the patch on the cluster server. - run swcluster on the server as in step 5b to install the patch on the cluster clients. By default swinstall will archive the original software in /var/adm/sw/patch/PHSS_8802. If you do not wish to retain a copy of the original software, you can create an empty file named /var/adm/sw/patch/PATCH_NOSAVE. Warning: If this file exists when a patch is installed, the patch cannot be deinstalled. Please be careful when using this feature. It is recommended that you move the PHSS_8802.text file to /var/adm/sw/patch for future reference. To put this patch on a magnetic tape and install from the tape drive, use the command: dd if=/tmp/PHSS_8802.depot of=/dev/rmt/0m bs=2k Special Installation Instructions: SUBSYSTEM_SHUT NOTE: * Using this patch with Advanced VxFS (JFS) filesystems on HP-UX 10.X clients can cause corruption of the kernel data structures. The corruption is a result of the direct I/O on VxFS that is implemented in this patch. The problem can be avoided by either - including the assignment OB2VXDIRECT=0 in the /opt/omni/.omnirc file on the respective backup client. Setting this variable for non-VxFS filesystems will have no effect. Setting the variable for VxFs filesystems will disable the direct I/O feature that introduces the corruption and thus it will not be possible to take advantage of the performance improvement during backup. or - installing one of the following patches on the client: PHKL_9404 on s700 with HP-UX 10.01 PHKL_9405 on s800 with HP-UX 10.01 PHKL_9413 on s700 with HP-UX 10.10 PHKL_9414 on s800 with HP-UX 10.10 PHKL_9415 on s700 with HP-UX 10.20 PHKL_9416 on s800 with HP-UX 10.20 If the respective patch is installed, then the direct I/O feature can be enabled for VxFS filesystems by including the assignment OB2VXDIRECT=1 in the /opt/omni/.omnirc file on the respective backup client. "/opt/omni/sbin/omnisv.sh stop" must be executed on the cell server before swinstall is run. After the update restart OmniBackII using "/opt/omni/sbin/omnisv.sh start". The Disk Agent, Media Agent, ACS Agent, DAS Agent and SAP modules need to be redistributed to the appropriate systems from within the "Cell Administration - Install" window of the OmnibackII graphical user interface before the patch modifications take effect. The DAS agent module contains an old version of the libaci.sl shared library which is distributed to the clients during the Install step. If the client system has a newer version of this library, then it must be saved before distributing the DAS agent module and moved in place again after the module was distributed to the DAS agent. The full filename of the library is /usr/omni/lib/libaci.sl on HP-UX 9.X and /opt/omni/lib/libaci.sl on HP-UX 10.X.