Patch Name: PHSS_22916

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

Creation Date: 01/07/12

Post Date:  01/07/12

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

Filesets:
	OMNIBACK-II.OMNI-CORE-IS,A.03.10

Automatic Reboot?: No

Status: General Superseded

Critical: No

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

Symptoms:
	PHSS_22916:
	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 = NSMex03739
	    Pre- and post-exec script return invalid exit status.

	Id = NSMex03749
	    Mount function does not restore mount option.

	Id = NSMex03913
	    SSEA Integration backup fails with the following error:

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

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

	Id = NSMex03390
	    Large SAP split mirror backup fails with the
	    following message:

	      "BR274E File <...> not found".

	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 error message:

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

	Id = NSMex04392
	    SSEA Integration backup fails with an error:

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

	Id = NSMex04371
	    Resolving fails with an error:

	      "[225:29] CA pairs are established => cannot
	       continue.".

	PHSS_21734:
	Id = NSMex03058
	    Raw disk backup on SSE XP256 BC/1 Configuration fails
	    with the error message:

	      "Internal error: Unknown option -bc1".

	PHSS_19525:
	Id = HSLco16368
	    HP SureStoreE Disk Array XP256 is not supported by
	    OmniBack II to perform a split mirror backup. This
	    patch does not fix any other problem.

Defect Description:
	PHSS_22916:
	Id = HSLco23290
	    Due to the changes made for JFS 3.3 support,
	    volumes are not properly mounted on HP-UX
	    10.20 systems.

	Resolution:
	    Old code is applied for HP-UX 10.20 platforms.

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

	Resolution:
	    Message statuses are properly reported.

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

	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 = 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 = NSMex03913
	    Pairdisplay command fails if two session are started
	    at the same time.

	Resolution:
	    SSEA Agent correctly detects service port numbers
	    availability.

	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.

	    Part of SSPUX310_029.

	Id = NSMex03390
	    During split mirror backup required filesystems are not
	    mounted.

	Resolution:
	    Message format and pointer handling are improved.

	    Part of SSPUX310_034.

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

	Resolution:
	    IPC buffer increased.

	    Part of SSPUX310_039.

	Id = NSMex03673
	    Pairdisplay command fails in ServiceGuard environment.

	Resolution:
	    Hostname resolving is improved.

	    Part of SSPUX310_039.

	Id = NSMex04392
	    Incorrect filesystem options are sent to R2 side.

	Resolution:
	    Correct filesystem options are sent to R2 side.

	Id = NSMex04371
	    Wrong path to device file is used.

	Resolution:
	    Proper path to device file is used.

	    Part of SSPUX310_058.

	PHSS_21734:
	Id = NSMex03058
	    The option '-bc1' is not recognized by the SSEA agent.

	Resolution:
	    The SSEA agent has been improved to recognize the
	    '-bc1' option, which results in starting a backup
	    of disk pairs.

	PHSS_19525:
	Id = HSLco16368
	    Currently OmniBack II only supports the Split Mirror
	    Backup concept with EMC Symmetrix. After the
	    introduction of the new HP SureStoreE Disk Array
	    XP256, it was requested that OmniBack II also
	    supports this disk array with the split mirror backup
	    concept.  This requires to support Oracle 8.0.x and
	    SAP R/3 in this concept as well. In addition a new
	    manual is needed.

	Resolution:
	    The SureStoreE Agent (SSEA) was developed for
	    HP-UX to control the SureStoreE disk array.
	    The Backup Session Manager, INET on HP-UX,
	    and the NT GUI were enhanced and in addition
	    Oracle 8.0.x and SAP integrations are
	    supported. Also the manual "HP OpenView
	    OmniBack II HP SureStore E Disk Array XP256
	    Configuration Guide" will be released.

SR:
	B554000781 B554000521 B554000612 H555003817 B554000803
	B554000847 B554000676 H555005730 B554000491 B554000869

Patch Files:
	/opt/omni/databases/vendor/ssea/hp/s800/hp-ux-1020/A.03.10/
		packet.Z
	/opt/omni/databases/vendor/ssea/hp/s800/hp-ux-1020/A.03.10/
		require.dat

what(1) Output:
	/opt/omni/databases/vendor/ssea/hp/s800/hp-ux-1020/A.03.10/
		packet.Z:
		None
	/opt/omni/databases/vendor/ssea/hp/s800/hp-ux-1020/A.03.10/
		require.dat:
		None

cksum(1) Output:
	274456585 486073 /opt/omni/databases/vendor/ssea/hp/s800/
		hp-ux-1020/A.03.10/packet.Z
	2484855657 23 /opt/omni/databases/vendor/ssea/hp/s800/
		hp-ux-1020/A.03.10/require.dat

Patch Conflicts: None

Patch Dependencies: None

Hardware Dependencies: None

Other Dependencies: None

Supersedes:
	PHSS_19525 PHSS_21734

Equivalent Patches:
	PHSS_22917:
	s700: 11.00
	s800: 11.00

Patch Package Size: 540 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_22916

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

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

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

Special Installation Instructions:
	PHSS_22916:
	NOTE!
	This patch fixes a problem on systems with HP SureStore E
	Disk Array XP 256 integration. If this functionality is
	not required, the patch should not be installed.

	NOTE!
	This patch must be installed on the Installation Server
	host.

	The patch PHSS_19525 introduced new client SSEA that is
	only visible in the Windows NT "Install" user interface.
	In order to support the SureStoreE Agent changes this
	agent must be installed on the appropriate systems. Refer
	to the "HP OpenView OmniBack II HP SureStore E Disk Array
	XP 256 Configuration Guide" for more details on the
	installation.

	NOTE!
	Only the OmniBackII graphical user interface on
	Windows NT supports the installation of the SSEA.

	In order to enable the HP SurStoreE Agent (SSEA)
	functionality, a license-to-use (B7023AA) must be
	installed. In addition, at least the following OB2
	patches are required:

	   PHSS_21650/PHSS_21651 - Cell Server patch
	   PHSS_20111/PHSS_20112 - Oracle8 integration patch
	   PHSS_21770/PHSS_21771 - Core patch
	   PHSS_21732/PHSS_21733 - SAP integration patch
	   OMNIBACK_00012        - Windows NT

	Some of these above mentioned patches may be superseded
	by a newer patch.  Please check the  HP Electronic
	Support Center web page for latest and the most up
	to date patch status.

	For more information regarding the installation procedure
	refer to the "HP OpenView OmniBack II HP SureStore E Disk
	Array XP256 Configuration Guide"



	Patch includes the following Site Specific Patches:
	   SSPUX310_012
	   SSPUX310_029
	   SSPUX310_034
	   SSPUX310_039
	   SSPUX310_058