Patch Name: PHSS_30342

Patch Description: s700_800 11.X OV DP5.00 patch - SSEA packet

Creation Date: 04/03/15

Post Date: 04/03/22

Hardware Platforms - OS Releases:
	s700: 11.00 11.11
	s800: 11.00 11.11

Products:
	DATA-PROTECTOR A.05.00

Filesets:
	DATA-PROTECTOR.OMNI-SSEA-P,fr=A.05.00,fa=HP-UX_B.11.00_32/64,v=HP

Automatic Reboot?: No

Status: General Release

Critical:
	No (superseded patches were critical)
	PHSS_29421: ABORT

Category Tags:
	defect_repair general_release critical halts_system
	manual_dependencies

Path Name: /hp-ux_patches/s700_800/11.X/PHSS_30342

Symptoms:
	PHSS_30342:
	Change Request: H555012230
	  Business Copy (BC) backups fail with the following
	  error message:

	   "|Critical| From: SSEA@<hostname> "<object>" Time:
	    <time> |225:1012| Failed to get pairs for all LDEVs."

	Change Request: H555012426
	  SSEA backup on HP-UX 11.x fails with:

	   "|Critical| From: SSEA@<host> ""  Time:<time>
	    Failed to load Raid Manager library."

	PHSS_30144:
	Change Request: H555011457
	  During SSEA backup the following error is shown in
	  the session report:

	    "|Normal| From: SSEA@<R1_hostname> "" Time:<time>

	    The following BC pairs will be used in current
	    session:  SEQ# LDEV  Port TID LUN MU#  Status SEQ#
	    LDEV---------------------------------------------
	    -------<more then 10 BC pairs reported>----------
	    -------------------------------------------------"

	Change Request: H555011461
	  SSEA backup fails with:

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

	Change Request: H555011701
	  StorageWorks XP integration backup fails with
	  the following error:

	   "|Major| From: BSM@<hostname>  Time: <time>
	    |61:3003| Lost connection to Split Mirror Agent
	    named "<name>"on host <hostname>. Ipc subsystem
	    reports: "Details unknown."

	Change Request: H555011747
	  The following error is reported by "ob2smbsplit"
	  during a backup:

	   "|Major| From: OB2BAR_SMB_Split@<hostname> Time: <time>
	    Preparing of backup host failed (error=-14)

	    |Major| From: OB2BAR_SMB_Split@<hostname> Time: <time>
	    Preparing of backup host failed (error=-14)."

	Change Request: H555011950
	  The following error is reported during a backup:

	   "|Major| From: SSEA@<hostname> "<object>" Time: <time>
	    Mapping from character device file of disk to LDEV
	    failed forcXtYdZ.(|16| Device busy)."

	Change Request: H555012038
	  The following error is reported during a backup:

	   "|Critical| From: SSEA@<hostname> "<object>"
	    Time: <time> Cannot find command device."

	PHSS_29421:
	Change Request: H555010436
	  SSEA integration backup fails with:

	   "|Major| From: OB2BAR@<backup_hostname>  Time:<time>
	       Resolve of the disks fails.

	   "|Major| From: OB2BAR@<backup_hostname> Time:<time>
	       Resolving to disk level failed (error=-14)".

	Change Request: H555010461
	  During multiple ZDB sessions on HP-UX running at the
	  same time, the following is reported in the session
	  report:

	   "|Major| From: SSEA@<hostname> <object>  Time: <time>
	   Filesystem <object> could not be mounted to <object>.
	   /usr/sbin/mount -Fv xfs -r <object> <object>
	   2>&1mount: file system table may be corrupt."

	Change Request: H555010480
	   The following error is reported at the end of backup:

	   "61:3003 Lost connection to Split Mirror Agent
	   COMPLETED Media Agent. |Major| From: BSM@<hostname>
	   <object>" Time: <time> |61:3003| Lost connection to
	   Split Mirror Agent named <object> on host <hostname>.
	   Ipc subsystem reports: "IPC Read ErrorSystem error:
	   |238| Connection timed out."

	Change Request: H555010528
	  After the LDEVs are resolved and the BC pairs are
	  correctly identified, SSEA checks for LDEVs info
	  in the xpdb in order to find out if the current LDEVs
	  have already been used in the previous SSEA backup
	  sessions. The SSEA agent on the R1 side ends abnormally
	  when browsing LDEVs info in the xpdb. After several
	  reallocations of the LDEVs list, the new realloc call
	  fails. Backup fails with:

	   "|Major| From: BSM@<hostname> <object>  Time: <time>
	   |61:3003| Lost connection to Split Mirror Agent named
	   <object> on host <hostname>. Ipc subsystem reports:
	   "IPC Read ErrorSystem error: |10054| Connection reset
	   by peer."

	   "|Critical| From: SSEA@<hostname> <object>  Time:
	   <time> IPC failure reading message from the agent
	   on the application system. (IPC Read ErrorSystem
	   error: |10054| Connection reset by peer.)"

	Change Request: H555010664
	  Backup is failing with the following error:

	   "|Major|From: BSM@<hostname> <object> Time: <time>
	   |61:3003| Lost connection to Split Mirror Agent named
	   <object> on host <hostname>. Ipc subsystem reports:
	   "Details unknown."

	Change Request: H555010924
	  Volume group on the backup side is created without
	  alternate path.

	Change Request: H555011015
	  SSEA integration backup fails with:

	   "|Major| From: SSEA@<host name> ""  Time: <time>
	   |225:109| Mapping from character device file
	   of disk to LDEV failed for .
	   (|2| No such file or directory)"

	Change Request: H555011053
	  The backup session intermittently fails with
	  the following error reported:

	   "|Normal| From: SSEA@<hostname> ""  Time:<time>
	   ABORTED SSEA-Backup Agent on <hostname>."

	  More detailed error message is reported in SSEA
	  debug file:

	   "| -2| |SseXPairSplit| pairsplit failed!
	   [EL_CMDIOE] Control command I/O error, or rejected.
	   ...
	   ...
	   |Major| From: SSEA@<hostname> ""  Time:<time>
	    Failed to split the BC pair of LDEV <LDEV NUMBER>,
	    SEQ# <SEQ NUMBER>, MU# <MU NUMBER>."

	Change Request: 8606257980
	  Data Protector XP Integration backup using split-mirror
	  fails with:

	    "|Major| From: SSEA@<hostname> "" Time: <time>
	    File system for / object not mounted or local
	    disk is in backup."

	Change Request: 8606308890
	  In SSEA environments with multiple host bus adapters
	  only one is used, so the backup performance is poor.

	PHSS_29135:
	Change Request: H555010044
	  During multiple SSEA sessions running at the same time,
	  the following is reported in the session report:

	    "|Major| From: SSEA@<R2_hostname> ""  Time: <time>
	    Filesystem <fs_name> could not be mounted
	    to <mountpoint>.

	    /usr/sbin/mount -F vxfs -r <fs_name> 2>&1
	    mount: file system table may be corrupt".

	Change Request: H555010243
	  Mount command on VxVM SSEA integration backup is
	  failing with error:

	    "mount: /dev/<path>: No such file or directory".

	Change Request: H555010272
	  If softlinks are configured on raw disks or raw logical
	  volumes, the following error message appears in the
	  Zero Downtime Backup agent's debugs:

	    "| -2| |ResolveR1| Object type UNKNOWN (0140144)of
	     /dev/<vg_name>/r<lvol_name> is not supported".

	Change Request: H555010306
	  Using the SSEA Zero Downtime Backup agent, if the
	  option "After the backup, keep the version on mirror
	  disk" is not selected and backup is aborted after the
	  split, mirror is not resynchronized.

	PHSS_28330:
	Change Request: H555009456
	  SSEA backup session report displays messages:

	  "|Normal| From: SSEA@<hostname> ""  Time: <time>
	    ABORTED SSEA-Backup Agent on <hostname>.

	   |Normal| From: SSEA@<hostname> ""  Time: <time>
	    ABORTED SSEA-Application Agent on <hostname>.

	   |Critical| From: BSM@<hostname> "<datalist>"
	   Time: <time>
	    None of the Disk Agents completed successfully.
	    Session has failed.".

	Change Request: H555009625
	  Data Protector SSEA backup fails with error:

	  "|Major| From: SSEA@<hostname> "" Time: <time>
	     Volume group /dev/<vg_name> could not be created.".

	Change Request: H555009899
	  Data Protector SSEA backup fails with error:

	  "|Major| From: BSM@<hostnaem> "<datalist>"
	   Time: <time>
	   |61:3003| Lost connection to Split Mirror Agent
	   named "SM_agent" on host <hostname>.
	   Ipc subsystem reports: "Details unknown."".

	PHSS_27597:
	Change Request: H555008141
	  Pre- and post-exec scripts are improperly executed.

	Change Request: H555008585
	  A warning:

	    "|Warning| From: SSEA@<hostname> ""  Time: <time>
	     Failed to get a BC pair for LDEV 0, MU# 0
	     in RAID <num>. (Details unknown.)"

	  is reported during a Data Protector XP Integration
	  backup.

	Change Request: H555008827
	  Mounting of vxfs on VxVM volume fails on the backup
	  host.

	Change Request: H555008887
	  The connection with the host running SSEA agent is
	  broken.

	Change Request: H555009003
	  SSEA backup session fails with:

	    "|Critical| From: BSM@<hostname> "<barlist>"
	     Time: <time>
	     None of the Disk Agents completed successfully.
	     Session has failed."

Defect Description:
	PHSS_30342:
	Change Request: H555012230
	  The StorageWorks XP Agent (SSEA) calls to the RAID
	  Manager Library API are using LUNs that are greater
	  than the 0-255 range (XP1024 box). With the RAID
	  Manager Library version 1.07, the truncating feature
	  has been removed. SSEA was not able to resolve the
	  disks.

	  Resolution:
	  Execution of the "getdkclimit()" Raid Manger Library
	  API function will ensure that calls to the XP box only
	  use the LUNs from the 0-255 range.

	  Part of SSPUX500_046.

	Change Request: H555012426
	  SSEA agent does not recognize original path to
	  libsvrrm.sl.

	  Resolution:
	  libsvrrm.sl path is corrected.

	PHSS_30144:
	Change Request: H555011457
	  If the volume groups seen from the application host
	  include more than 10 Logical Volume Manager (LVM)
	  mirror pairs, then the Business Copy (BC) pair
	  report dumped to the session report is not displayed
	  by chunks, causing the buffer to overflow.

	  Resolution:
	  The counter for the displayed BC pairs takes into account
	  also LVM mirror primary disks that do not need to be
	  displayed in the BC pairs report. This way, the BC pairs
	  report is dumped to the session report by chunks.

	  Part of SSPUX500_043.

	Change Request: H555011461
	  SSEA searches for the file systems by scanning
	  "/etc/mnttab" file. Scan fails if one of the rows
	  in /etc/mnttab is unreadable.

	  Resolution:
	  Unreadable parts in "/etc/mntab" file are skipped.

	Change Request: H555011701
	  Table of XP ports is not appropriate for the 01.07.00
	  and higher versions of "rmlib" api.

	  Resolution:
	  Special table of XP ports is defined for the 01.07.00
	  and higher versions of "rmlib" api.

	Change Request: H555011747
	  SSEA cannot resolve softlinks of the mountpoints.
	  The softlink checking exists only for the backup object.

	  Resolution:
	  The softlink checking is added for the mountpoints too.

	Change Request: H555011950
	  For the "multipath" configuration of the veritas disks,
	  SSEA cannot switch to the secondary (alternate) paths
	  of the disks.

	  Resolution:
	  Finding and storing alternate paths of all the disks
	  involved in the backup and making mechanism for switching
	  to the alternate path when primary disk is disabled.

	Change Request: H555012038
	  If a hostname used in a XP backup specification
	  is a substring of a hostname that is already present
	  in the command devices list, then a new entry for
	  the new hostname will not be added in the command devices
	  list.

	Resolution:
	  Hostnames comparing functions correctly.

	PHSS_29421:
	Change Request: H555010436
	  HP-UX LVM Mirroring configuration looks for BC PVOLs
	  on all involved XP boxes instead of only on the XP
	  box(es) where the BC is configured.

	  Resolution:
	  PVOLs are sought only on the XP box(es) where BC is
	  configured.

	  Part of SSPUX500_033.

	Change Request: H555010461
	  When multiple ZDB backup sessions are running,
	  and the R2 host is being prepared by two or more
	  sessions at the same time, the mount system command
	  fails because the "/etc/mnttab" is being refreshed
	  by one of the other ZDB sessions at the same time.

	  Resolution:
	  The system level umount(1M) command is used instead
	  of the program level umount(2) command in order
	  to avoid problems with synching the "mnttab" file.

	Change Request: H555010480
	  SSEA ignores the "OB2IPCKEEPALIVE"
	  environment variable.

	  Resolution:
	  Checking for the "OB2IPCKEEPALIVE" environment
	  variable is implemented for a Solaris platform.

	Change Request: H555010528
	  Invalid access to memory location during the creation
	  of the session list for removing from the IDB.

	  Resolution:
	  Access to memory location during the creation of the
	  session list for removing from the IDB is corrected.

	Change Request: H555010664
	  Process is terminated with an access violation error
	  because of memory overflow caused by a recursion.

	  Resolution:
	  Backup completes successfully.

	  Part of SSPUX500_030.

	Change Request: H555010924
	  Because strtok function is used in a wrong way,
	  alternete paths for volume groups are not created.

	  Resolution:
	  Temporary structure is used for parsing information
	  from alternate_paths structure.

	Change Request: H555011015
	  Veritas filesystem dmp nodes can be in different format
	  than physical discs (cXtYdZ). Because of this disc
	  resolving fails.

	  Resolution:
	  Mapping from different dmp node names to physical
	  disk names (cXtYdZ) is done before resolving.

	Change Request: H555011053
	  pairsplit() API call occasionally fails with no
	  obvious reason.

	  Resolution:
	  Call of pairsplit() is put in a loop that will repeat
	  the call if pairsplit() fails. If pairsplit() fails 10
	  times, error message will be displayed.

	Change Request: 8606257980
	  SSEA agent cannot handle "/" (root) mountpoint when
	  performing a split-mirror backup.

	  Resolution:
	  Mountpoint "/" (root) can be used in SSEA split-mirror
	  backup if following is satisfied:

	  1. Root mountpoint is located on an XP disk.
	  2. SSEA_PRESERVE_MOUNTPOINT environment variable is not
	    set to 1 on Backup host.
	  3. SSEA_BACKUP_ROOT_MOUNTPOINT environment variable is
	    set to 1 on Application side.

	  Note: Such backup cannot be used for Instant Recovery!

	Change Request: 8606308890
	  Data Protector 5.00 Split Mirror Backup is using
	  volume group auto configuration on the backup host
	  and the first path is configured. This feature is
	  causing problems in environments, where multiple
	  host bus adapters are used on the backup host.
	  Reading data from disk across the multiple paths
	  to balance backup load is not possible.

	  Resolution:
	  New .omnirc variable SSEA_BACKUP_VG_EXIST is
	  introduced which disables auto configuration.
	  If set to 1 backup VG that already exists is used.
	  With other agents this variable is set to 0
	  (inf.backup_vg_exist = 0;).

	  Part of SSPUX500_035.

	PHSS_29135:
	Change Request: H555010044
	  When multiple SSEA backups are running and R2 host
	  is being prepared by two or more sessions at the
	  same time, the mount system command can fail because
	  the /etc/mnttab is refreshed by one of the other SSEA
	  sessions at that moment.

	  Resolution:
	  A retry/sleep is introduced to prevent mount system
	  command.

	Change Request: H555010243
	  The DP SSEA integration on Data Protector A.05.00 does
	  not include the PowerPath supportability.

	  Resolution:
	  The DP SSEA integration includes the PowerPath
	  supportability.

	Change Request: H555010272
	  Backup fails after all the operations handled by
	  Data Protector agents and ob2smbsplit are completed
	  because object type inquiry is not recognized.

	  Resolution:
	  Object type inquiry is changed.

	Change Request: H555010306
	  If the option "After the backup, keep the version on
	  mirror disk" is not selected, and no more than one
	  first level mirror is set by the MU Number(s) option,
	  then the mirrors should be resynchronized after the
	  backup. This should also be the case if the split has
	  been made successfully but the backup is aborted.

	  Resolution:
	  If the option "After the backup, keep the version on
	  mirror disk" is not selected, and no more than one
	  first level mirror is set by the MU Number(s) option,
	  then the mirrors are resynchronized even if the split
	  has been made successfully but the backup is aborted.

	  Part of SSPUX500_026.

	PHSS_28330:
	Change Request: H555009456
	  "pairvolstat()" API call fails for some disks.

	  Resolution:
	  Three parameters (linenumber, detailerrno and
	  sourcename)of "pCmd" data structure which holds
	  information used for calling the "pairvolstat()" API
	  are re-initialized before a new "pairvolstat()" call.
	  Call of "ErrClearError" is added in "SarQuery"
	  function.

	  Part of SSPUX500_012.

	Change Request: H555009625
	  The buffer that stores the command for importing the
	  volume group is limited to 1Kb. When there are more
	  than 50 disks to be imported in the volume group the
	  command line exceeds the buffer size limit.

	  Resolution:
	  The buffer that stores the command for importing
	  the volume group is extended to 4Kb.

	Change Request: H555009899
	  The disk group information is not parsed correctly.

	  Resolution:
	  The disk group information is parsed correctly.

	PHSS_27597:
	Change Request: H555008141
	  Scripts are executed with ".%s" which is "sh" instead of
	  script name.

	  Resolution:
	  The dot is removed from fuction that executes the
	  scripts.

	  Part of SSPUX500_001.

	Change Request: H555008585
	  SSEA agent improperly handles "LDEV 0" (unknown logical
	  device).

	  Resolution:
	  Logical device resolution is improved by adding
	  additional checking in cases where "LDEV 0" is
	  encountered.

	  Part of SSPUX500_002.

	Change Request: H555008827
	  Disk group importing procedure is incorrectly
	  implemeted for the backup side.

	  Resolution:
	  Disk group importing procedure in corrected.

	Change Request: H555008887
	  In environments where the firewall between Cell Server
	  and client(s) with firewall idle timeout of <x>
	  minutes is present, it can happen that an agent is in
	  idle state for the amount of time longer than mentioned
	  timeout. In such cases, firewall breaks the connection
	  between Cell Server and the client(s).

	  Resolution:
	  New environment variable OB2IPCKEEPALIVE is introduced.
	  Setting its value to any of YES, TRUE, ON or 1 in
	  /opt/omni/.omnirc file on Cell Server causes sending a
	  dummy package from time to time in order to keep the
	  connection open.

	Change Request: H555009003
	  The data structure that holds information used for
	  calling the pairvolstat() API is not re-initialized
	  before a new pairvolstat() call.

	  Resolution:
	  The data structure that holds information used for
	  calling the pairvolstat() API is re-initialized
	  before a new pairvolstat() call.

	  Part of SSPUX500_008 and SSPSOL500_001.

Enhancement:
	No

SR:
	H555012230 H555012426 H555011461 H555012038 H555011747
	H555011950 H555011457 H555011701 H555010924 H555010436
	H555010461 H555010528 H555011015 H555010480 8606308890
	8606257980 H555011053 H555010664 H555010044 H555010272
	H555010306 H555010243 H555009899 H555009456 H555009625
	H555008887 H555008827 H555008141 H555008585 H555009003

Patch Files:
	
	DATA-PROTECTOR.OMNI-SSEA-P,fr=A.05.00,
		fa=HP-UX_B.11.00_32/64,v=HP:
	/opt/omni/databases/vendor/ssea/hp/s800/hp-ux-11/A.05.00/
		packet.Z
	/opt/omni/databases/vendor/ssea/hp/s800/hp-ux-1020/A.05.00/
		packet.Z
	/opt/omni/databases/vendor/ssea/sun/sparc/solaris-7/A.05.00/
		packet.Z

what(1) Output:
	
	DATA-PROTECTOR.OMNI-SSEA-P,fr=A.05.00,
		fa=HP-UX_B.11.00_32/64,v=HP:
	/opt/omni/databases/vendor/ssea/hp/s800/hp-ux-11/A.05.00/
		packet.Z:
		None
	/opt/omni/databases/vendor/ssea/hp/s800/hp-ux-1020/A.05.00/
		packet.Z:
		None
	/opt/omni/databases/vendor/ssea/sun/sparc/solaris-7/A.05.00/
		packet.Z:
		None

cksum(1) Output:
	
	DATA-PROTECTOR.OMNI-SSEA-P,fr=A.05.00,
		fa=HP-UX_B.11.00_32/64,v=HP:
	2073921702 441882 /opt/omni/databases/vendor/ssea/sun/sparc/
		solaris-7/A.05.00/packet.Z
	1116901480 479211 /opt/omni/databases/vendor/ssea/hp/s800/
		hp-ux-1020/A.05.00/packet.Z
	3359443405 486179 /opt/omni/databases/vendor/ssea/hp/s800/
		hp-ux-11/A.05.00/packet.Z

Patch Conflicts: None

Patch Dependencies: None

Hardware Dependencies: None

Other Dependencies:
	In order to completely resolve the problem,
	some of the defect fixes contained in this
	patch depend on the following other patches
	or their successors.

	PHSS_29878:
	Cell Server (CS) packet patch,
	release date: Available
	Change Request: H555008887
	PHSS_29878 is required for this defect fix.

Supersedes:
	PHSS_30144 PHSS_29421 PHSS_29135 PHSS_28330 PHSS_27597

Equivalent Patches: None

Patch Package Size: 1370 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_30342

	5. Run swinstall to install the patch:

		swinstall -x autoreboot=true -x patch_match_target=true \
			  -s /tmp/PHSS_30342.depot

	By default swinstall will archive the original software in 
	/var/adm/sw/save/PHSS_30342.  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 PHSS_30342.text file is 
	available in the product readme:

		swlist -l product -a readme -d @ /tmp/PHSS_30342.depot

	To put this patch on a magnetic tape and install from the
	tape drive, use the command:

		dd if=/tmp/PHSS_30342.depot of=/dev/rmt/0m bs=2k

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

	The DP 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 Data Protector Installation guide.

	
	Patch includes the following Site Specific Patches:
	   SSPUX500_001
	   SSPUX500_002
	   SSPUX500_008
	   SSPUX500_012
	   SSPUX500_026
	   SSPUX500_030
	   SSPUX500_033
	   SSPUX500_035
	   SSPUX500_043
	   SSPUX500_046
	   SSPSOL500_001

	A Site Specific Patch is a temporary hotfix that
	you might have received from HP Support if you
	have encountered a problem with Data Protector
	for which no General Release patch was or is
	available yet.

	If any newer Site Specific Patch - that is
	one with a higher number - for the SSEA agent
	is installed on your system, then you
	must re-apply this SSP after installing
	this SSEA patch.