Patch Name: PHSS_24425

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

Creation Date: 01/07/31

Post Date:  01/08/08

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_24425

Symptoms:
	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_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:
	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:
	1518474406 2021809 /opt/omni/databases/vendor/ssea/hp/s800/
		hp-ux-1020/A.03.50/packet.Z
	3838304527 2021789 /opt/omni/databases/vendor/ssea/hp/s800/
		hp-ux-11/A.03.50/packet.Z
	3481753283 1550443 /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

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

Patch Package Size: 5530 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_24425

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

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

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

Special Installation Instructions:
	PHSS_24425:
	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