Patch Name: PHSS_25817

Patch Description: s700_800 10.X OV OB3.50 patch - SSEA packet

Creation Date: 02/01/17

Post Date:  02/01/24

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.03.50

Filesets:
	OMNIBACK-II.OMNI-SSEA-P,A.03.50

Automatic Reboot?: No

Status: General Superseded

Critical: No

Path Name: /hp-ux_patches/s700_800/10.X/PHSS_25817

Symptoms:
	PHSS_25817:
	Id = JAGad48627  SR:8606179403
	    If preexec script fails OmniBack II by default just
	    aborts the agent and exits. It does not run post-exec
	    script or clean up.

	Id = NSMex04226
	    Restore fails with:

	      "[Major] From: SYMA@<hostname> ""  Time: <time>
	       [223:325] Could not activate volume group
	       /dev/sg_sap.

	       [Major] From: SYMA@<hostname> ""  Time: <time>
	       [223:363] Could not prepare mirror disks of object
	       /sg_sap for backup.
	       (Activation of volume group failed.)".

	Id = HSLco30300  SR:H555006603
	    Split mirror backup fails with:

	      "[Critical] From: SSEA@<host> ""  Time: <time>
	        Command "/etc/horcmgr" failed with exit code 3.
	        For details please check log directories:
	        Log file directory in operation:
	                /var/opt/omni/log/yyyy-mm-dd-xx/curlogxx
	        Log file directory for automatic storing:
	                /var/opt/omni/log/yyyy-mm-dd-xx/tmpxx".

	Id = HSLco31032  SR:H555006753
	    Split mirror backup session fails with:

	      "[Critical] From: SSEA@<host> ""  Time: <time>
	       Failed to find T-VOL/R-Vol of LDEVs.

	       [SseMapLdevToRdsk] Unable to found /dev/rdsks
	       file for LDEV = <number>".

	Id = HSLco31434  SR:H555006835
	    Unexpected close reading message from the agent on the
	    Backup System (SSEA abnormally ends on R2).

	Id = HSLco30701  SR:H555006685
	    Resolving fails on the Application host. The spt inq
	    structure returns corrupted results.

	Id = HSLco31490  SR:H555006844
	    SSEA integration backup fails with:

	      "[Critical] From: SSEA@<host_name> ""  Time: <time>
	        Command "/etc/horcmgr" failed with exit code 3.
	       [Critical] From: SSEA@<host_name> ""  Time: <time>
	        Failed to start RAID Manager instance.
	            (Command /etc/horcmgr failed.)".

	PHSS_24425:
	Id = NSMex04086
	    Session status is "Completed/Failures" although there
	    is no any indication of errors.

	Id = NSMex04209
	    SSEA Integration backup fails with an error:

	      "[Critical] From: SSEA@<hostname> "" Time: <time>
	         Failed to find <volume/volume No.> of LDEVs.".

	Id = NSMex04216
	    SSEA Integration backup reports the following warning:

	      "[Warning] Cascading structure of BC pairs found
	        (THIS IS UNSUPPORTED).".

	Id = NSMex04392
	    SSEA Integration backup fails with an error:

	      "Filesystem <path> could not be mounted.".

	Id = NSMex04267
	    SSEA Integration backup fails with an error:

	      "[61:1005] Got unexpected close from Split Mirror
	       Agent.".

	Id = HSLco23886
	    LVM Mirror (XP Campus Cluster) is not supported
	    within OmniBack II SSEA Integration.

	PHSS_22436:
	Id = NSMex03360
	    SSEA Integration split does not appear to mount some
	    filesystems.

	Id = NSMex03700
	    Disk resolving failed on Backup Host.

	Id = NSMex03717
	    a) SSEA integration backup fails with an error:

	       "[Major] From: SSEA@<hostname> ""  Time: <time>
	        [224:106] Resolving of object "filename" has failed.
	    	(Cannot find block device path name of a logical
	         volume)"

	    b) SSEA Integration backup fails with an error:

	       "[Major] From: SSEA@<hostname> ""  Time: <time>
	        File system <filesystem> could
	        not be mounted to . (Invalid filesystem type.)"

	Id = NSMex03482
	    Disk synchronization messages are incorrect.

	Id = HSLco22201
	    OmniBack II SSEA integration is not supported on Sun
	    Solaris operating system.

	Id = NSMex03651
	    Disk synchronization fails with:

	      "[Critical] From: SSEA@<hostname> "" Time: <time>
	       [225:110] Mapping from LDEV to character device
	         file or disk failed for LDEV <dev> on
	         array <array>. (Unable to find character device
	         file for SureStoreE XP256 disk (LDEV))."

	Id = NSMex03673
	    Backup fails with the following message:

	      "[Critical] From: SSEA@<hostname> "" Time: <time>
	       Command "/usr/bin/pairdisplay -g" failed with
	       exit code 242.".

	Id = NSMbb39679
	    OmniBack II aborts Business Copy split mirror
	    backup because one of the disks in a pair is in
	    status COPY.

	Id = NSMex03547
	    SSEA Agent intermittently fails to resolve objects.

	Id = NSMex03739
	    Pre- and post-exec scripts return invalid exit status.

	Id = NSMex03913
	    SSEA backup fails with the following message:

	      "[Critical] From: SSEA@<hostname> "" Time: <time>
	       Command "/usr/bin/pairdisplay -g" failed with
	       exit code 221.".

	Id = NSMex03960
	    SSEA backup fails with the following error:

	      "Failed to start RAID Manager instance.
	       (Unable to find SureStoreE XP256 COMMAND device
	        file.)".

	Id = NSMex03850
	    Sometimes volumes cannot be mounted on JFS 3.3
	    filesystem.

	Id = NSMex03749
	    Mount function does not restore mount options.

	Id = NSMex03563
	    Mounting of a filesystem fails.

	Id = NSMex03931
	    OmniBack II SSEA Integration does not work on XP 512
	    for LDEVs with XP LUN addresses above 128.

Defect Description:
	PHSS_25817:
	Id = JAGad48627
	    If pre-exec script fails, cleanup does not start
	    post-exec script.

	Resolution:
	    New environment variable is introduced. When
	    SSEA_ALWAYS_POST_SCRIPT in .omnirc file on
	    application host is set to 1, post-exec script
	    is always executed.

	Id = NSMex04226
	    Backup is made in SSEA/split mirror backup environment
	    with the Application host in the cluster. When
	    restoring object on the Backup host (R2), which is not
	    in the cluster the cluster tag (-c y) from the
	    Application host is also restored, so the volume group
	    can not be activated properly.

	Resolution:
	    By default the cluster tag on the Backup host (R2) is
	    disabled with the "vgchange -q n -c n" command. To
	    enable the cluster tag on Backup host, set the new
	    environment variable SMB_CLUS_DEACT=1 in the
	    /opt/omni/.omnirc file.

	Id = HSLco30300
	    The command /etc/horcmgr fails if the command
	    device is used by another split mirror session.

	Resolution:
	    New environment variables are introduced
	    SSEA_RM_RETRY and SSEA_RM_SLEEP.

	    SSEA_RM_RETRY defines the number of retries.
	    SSEA_RM_SLEE defines sleeping time in seconds,
	    before new retry is started.


	Id = HSLco31032
	    The resolving from LDEVs to rdsks on the backup host
	    fails due to incorrect reporting of LDEVs to rdsks.

	Resolution:
	    The resolving from LDEVs to rdsks is corrected.

	Id = HSLco31434
	    SSEA agent on R2 does not read the number of rdsk
	    from the R1. Bug is produced while fixing the
	    NSMex04787 case on NT platform, but affected the
	    SSEA agent on the HP-UX platform.

	Resolution:
	    The correct number of strings is read from the SSEA
	    agent on the R2 side.

	Id = HSLco30701
	    The SCTL_InquiryDisk function returns empty or
	    corrupted inq structure.

	Resolution:
	    The ioctl system function writes its output directly
	    to the inq structure. The "mapping from rdsks to LDEVs"
	    and the ScsiInquiry are enhanced.

	    Part of SSPUX350_057.

	Id = HSLco31490
	    SSEA can not start the selected HORCMINST instance
	    number. It is already started by another RaidManager
	    process.

	Resolution:
	    SSEA tries to start the instance with different
	    instance number up to five times.

	PHSS_24425:
	Id = NSMex04086
	    Message level of a resolving failure in XP environment
	    is set to "Normal" instead of "Major".

	Resolution:
	    Message level is corrected.

	Id = NSMex04209
	    If backup devices are exported to more than one port
	    and original devices have more than two mirrors, when
	    session is started and two of these ports are used for
	    that session, SSEA Integration detects more mirrors
	    than it is allowed.

	Resolution:
	    Parsing of raidscan() output is improved.

	Id = NSMex04216
	    If there are two or three mirror disks to source
	    disk, OmniBack II reports that cascading structure is
	    found although cascading structure is present only
	    when there are mirror disks to targer disk.

	Resolution:
	    Searching for cascading structure is excluded as
	    this feature is not supported with OmniBack II
	    A.03.50 version.

	Id = NSMex04392
	    Incorrect filesystem options are sent to R2 side.
	    For HFS filesystems the entries in the mnttab file
	    are not updated promptly.

	Resolution:
	    Correct filesystem options are sent to R2 side.
	    /etc/mnttab is promptly updated for HFS filesystem.

	Id = NSMex04267
	    SSEA API fails after 60 seconds during the change of
	    volume groups. SMB_TIMEOUT is hardcoded to 60 seconds.

	Resolution:
	    SMB_TIMEOUT can be configured in .omnirc file for
	    situations where the changing of volume groups takes
	    more than one minute.

	    Part of SSPUX350_037.

	Id = HSLco23886
	    LVM Mirror (XP Campus Cluster) is not supported within
	    OmniBack II SSEA Integration.

	Resolution:
	    LVM Mirror (XP Campus Cluster) is supported within
	    OmniBack II SSEA Integration.

	    Please see Special Installation Instructions for more
	    details.

	PHSS_22436:
	Id = NSMex03360
	    XP256 Raid Manager's pairdisplay command returns
	    invalid status which causes some raw disks to fail
	    during resolving.

	Resolution:
	    Status checking changed to ignore invalid status from
	    pairdisplay command.

	Id = NSMex03700
	    If there is a lot of backup objects (usually case with
	    SAP databases) and these objects are placed in volume
	    group with a lot of stripped disks, then the size of
	    the internal message sent from SSEA-R1 to SSEA-R2 can
	    overflow hardcoded 100k limit.

	Resolution:
	    New message format reduces message size significantly.

	    Part of the SSPUX350_007.

	Id = NSMex03717
	    a) OmniBack II does not handle soft links correctly.

	    b) SSEA integration backup does not work properly in
	       case that a single session contains both filesystem
	       and rawdisk objects.

	Resolution:
	    Fixes are implemented in ssea.

	    Part of the SSPUX350_007.

	Id = NSMex03482
	    Disk synchronization failure reported as "Normal".

	Resolution:
	    Message statuses are properly reported.

	Id = HSLco22201
	    OmniBack II SSEA integration is not supported on Sun
	    Solaris operating system.

	Resolution:
	    OmniBack II SSEA integration is supported on Sun
	    Solaris 7 and 8 operating systems.
	    Please find the integration manual in the
	    /usr/omni/bin/utilns directory after the patch is
	    installed.

	Id = NSMex03651
	    IPC buffer for communication between SSEA Agents on
	    backup and application host is too small.

	Resolution:
	    IPC buffer increased.

	Id = NSMex03673
	    Pairdisplay command fails in ServiceGuard environment.

	Resolution:
	    Hostname resolving is improved.

	Id = NSMbb39679
	    OmniBack II does not treat status COPY as a valid
	    status.

	Resolution:
	    OmniBack II waits (for configurable timeout) for the
	    second disk to change the status to PAIR.

	    Environment variables are:

	      SSEA_SYNC_SLEEP_TIME = <time in seconds>
	      SSEA_SYNC_RETRY = <number of retries>

	    Default values are 5 for SSEA_SYNC_SLEEP_TIME and
	    10 for SSEA_SYNC_RETRY.

	Id = NSMex03547
	    Resolving of objects fails if stat() function reports
	    error for any entry in /etc/mnttab.

	Resolution:
	    Irrelevant errors are skipped during the resolving.

	Id = NSMex03739
	    Pre- and post-exec scripts return invalid exit status
	    because of timing problem.

	Resolution:
	    Environment variable OB2EXECTIMEOUT is introduced.
	    Variable represents timeout (in seconds) after the end
	    of pre- and post-exec script. Default value is 0.
	    Recommended value is between 5 and 10 seconds.

	Id = NSMex03913
	    Pairdisplay command fails if two session are started
	    at the same time.

	Resolution:
	    SSEA Agent correctly detects service port numbers
	    availability.

	Id = NSMex03960
	    SSEA Agent uses only those disks for which ioscan
	    reports state CLAIMED. Backup fails due to a fact that
	    some of the disks needed for session are in state SCAN.

	Resolution:
	    Disks in state SCAN are reported as well as those in
	    state CLAIMED.

	Id = NSMex03850
	    Changes made for JFS 3.3 support cause mount problems
	    on HP-UX 10.20 platform.

	Resolution:
	    Code now properly works also for the HP-UX 10.20
	    platform.

	    Part of SSPUX350_016.

	Id = NSMex03749
	    Filesystem is not mounted with the options that were
	    used before split mirror backup was performed.

	Resolution:
	    Command line mount command is used instead of mount
	    function for vxfs filesystem.

	Id = NSMex03563
	    Mount operation does not work properly on systems
	    with Online JFS 3.3 installed.

	Resolution:
	    Mount API uses proper arguments.

	Id = NSMex03931
	    Invalid configuration files are created for LDEVs
	    exported to LUN addresses above 128.

	Resolution:
	    New environment variable SSEA_XP_PORTS is introduced.
	    Its value has to be set to "FC" when using Fibre channel
	    and LUN addresses greater than 128.

	    Part of SSPUX350_032.

SR:
	H555006685 H555006753 8606179403 H555006844 H555006835
	H555006603 H555005488 H555005717 H555005689 H555005681
	H555004065 H555005289 H555003697 B554000781 B554000676
	B554000847 B554000829 H555004533 H555004741 H555003490
	H555003716 B554000521 B554000612 H555003817 H555004474
	B554000803 B554000491 H555004919

Patch Files:
	/opt/omni/databases/vendor/ssea/hp/s800/hp-ux-1020/A.03.50/
		packet.Z
	/opt/omni/databases/vendor/ssea/hp/s800/hp-ux-11/A.03.50/
		packet.Z
	/opt/omni/databases/vendor/ssea/sun/sparc/solaris-26/
		A.03.50/packet.Z
	/opt/omni/databases/vendor/ssea/sun/sparc/solaris-26/
		A.03.50/require.dat

what(1) Output:
	/opt/omni/databases/vendor/ssea/hp/s800/hp-ux-1020/A.03.50/
		packet.Z:
		None
	/opt/omni/databases/vendor/ssea/hp/s800/hp-ux-11/A.03.50/
		packet.Z:
		None
	/opt/omni/databases/vendor/ssea/sun/sparc/solaris-26/
		A.03.50/packet.Z:
		None
	/opt/omni/databases/vendor/ssea/sun/sparc/solaris-26/
		A.03.50/require.dat:
		None

cksum(1) Output:
	2870582339 2032349 /opt/omni/databases/vendor/ssea/hp/s800/
		hp-ux-1020/A.03.50/packet.Z
	680922197 2032867 /opt/omni/databases/vendor/ssea/hp/s800/
		hp-ux-11/A.03.50/packet.Z
	118923842 1546105 /opt/omni/databases/vendor/ssea/sun/sparc/
		solaris-26/A.03.50/packet.Z
	1830950196 19 /opt/omni/databases/vendor/ssea/sun/sparc/
		solaris-26/A.03.50/require.dat

Patch Conflicts: None

Patch Dependencies: None

Hardware Dependencies: None

Other Dependencies: None

Supersedes:
	PHSS_22436 PHSS_24425

Equivalent Patches:
	PHSS_25818:
	s700: 11.00 11.11 11.20
	s800: 11.00 11.11 11.20

Patch Package Size: 5540 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_25817

	5a. For a standalone system, run swinstall to install the
	    patch:

		swinstall -x autoreboot=true -x match_target=true \
			-s /tmp/PHSS_25817.depot

	By default swinstall will archive the original software in
	/var/adm/sw/patch/PHSS_25817.  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_25817.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_25817.depot of=/dev/rmt/0m bs=2k

Special Installation Instructions:
	PHSS_25817:
	NOTE!
	This patch has to be installed on the Installation
	Server host.

	The OB2 SSEA agent must be redistributed to the SSEA
	client system(s) after the installation of the patch
	in order to get the fixes into effect.

	For distribution of the SSEA agent, refer to
	the OmniBackII Installation guide.


	NOTE!
	PHSS_24425/PHSS_24426 introduces support for LVM Mirror
	(XP Campus Cluster) with OmniBack II SSEA Integration.
	More information about configuring LVM Mirror together
	with OmniBack II A.03.50 can be found in files

	  /opt/omni/bin/utilns/CampusClusterConf.txt
	  /opt/omni/bin/utilns/SureStoreAdmin.pdf

	after the patch is installed and SSEA Agent redistributed to
	clients.


	NOTE!
	Patch PHSS_22436/PHSS_22437 introduces OmniBack II
	HP SureStoreE Disk Array XP integration (SSEA) on Sun
	Solaris.
	In order to complete installation successfully, CORE patch
	PHSS_22914/PHSS_22915 (or later) must be installed.

	After installation of this patch, the manual
	"HP OpenView OmniBack II, HP SureStore E Disk Array XP
	Configuration Guide" will be available in file
	/<OMNIBACK_HOME>/bin/utilns/surestore_sun.pdf.

	In Chapter 2, it describes how to configure
	the XP Disk Array in the Solaris Environment.


	Patch includes the following Site Specific Patches:
	   SSPUX350_007
	   SSPUX350_016
	   SSPUX350_032
	   SSPUX350_037
	   SSPUX350_057