Patch Name: PHSS_28014

Patch Description: s700_800 11.X OV OB4.00 patch - SAP packet

Creation Date: 02/12/13

Post Date:  02/12/16

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

Products:
	OmniBackII A.04.00

Filesets:
	OMNIBACK-II.OMNI-SAP-P,fr=A.04.00,fa=HP-UX_B.11.00_32/64,v=HP

Automatic Reboot?: No

Status: General Release

Critical: No

Category Tags:
	defect_repair general_release manual_dependencies

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

Symptoms:
	PHSS_28014:
	Id = HSLco37210  SR:H555008812
	    During raw device SAP restore following error is
	    reported:

	      "[Minor] From: OB2BAR_SAPREST@<host> ""  Time:<time>
	       Error: Cannot open object <raw disk path>
	       [20] Not a directory)."

	Id = HSLco37773  SR:H555008906
	    During some backint queries following error is reported:

	      "[Critical] From: OB2BAR@<host> ""  Time:<time>
	       Failed to allocate memory.
	       System error: [12] Not enough space"

	Id = HSLco37783  SR:H555008908
	    When OmniBack II tries to backup nonexistent SAP redo
	    logs, session ends as failed.

	PHSS_27581:
	Id = HSLco35646  SR:H555008483
	    Aborting a SAP backup session results in a new session
	    being started.

	Id = HSLco36193  SR:H555008621
	    Errors are reported in debug.log for files of size 0 and
	    for missing function entry statements.

	Id = HSLco36405  SR:H555008643
	    SAP BR tools 6.10 (44) reports:

	       "BR247E No Backup utility ID or ID longer than 16
	       characters".

	Id = JAGae11014  SR:8606244527
	    Session log files contains improper information when
	    SAP backup fails.

	Id = HSLco35966  SR:H555008565
	    "util_sap -APP" displays connection strings.

	Id = HSLco35967  SR:H555008566
	    Raw partition backup is not restored even though
	    OmniBack II states that restore session is completed
	    successfully.

	PHSS_26886:
	Id = HSLco33261  SR: H555007380
	    SAP integration on UNIX clients automatically passes
	    "-u" option.

	PHSS_24983:
	Id = HSLco27809  SR: H555005775
	    SAP R/3 backup preview abnormally ends on Solaris
	    platform.

	Id = HSLco27898  SR: H555005806
	    "Util_sap -OBJSO <SID>" is not excluding locally
	    managed temporary tablespaces from the list of all
	    tablespaces.

	Id = HSLco28402  SR: H555006012
	    Omnisap crashes at the end of backup.

	Id = HSLco28403  SR: H555006013
	    SAP can not be configured when running on Oracle 8.0.x.

	Id = NSMex04633, NSMex04725 SR: H555006500
	    If omnisap.exe runs only brarchive, it does not change
	    -u user to -u user/password.

	Id = NSMex04698  SR: H555006672
	    SAP restore to different system and directory fails.

	Id = HSLco28624  SR: H555006085
	    Symbolic links can not be restored neither via
	    SAP/backint restore nor via filesystem restore.

	Id = HSLco28862  SR: H555006173
	    When running split mirror backup backup SAP
	    integration reads configuration for application
	    host, not for the backup host.

	Id = HSLco28960  SR: H555006205
	    SAP backup fails with an error:

	      "Unable to find library 'libclntsh.sl.8.0"

	Id = HSLco29240  SR: H555006290
	    SAP backup fails with segmentation fault error.

Defect Description:
	PHSS_28014:
	Id = HSLco37210
	    OmniBack II ignores the following caution in the SAP
	    specification:

	      "Caution:By restoring raw partition to a different
	      one, the <dest_dir> means directly the new raw
	      partition, not the directory containing the special
	      file."

	Resolution:
	    The procedure by which the destination directory is
	    formed has been changed.

	Id = HSLco37773
	    Some parts of structures for query are allocated but
	    not released.

	Resolution:
	    All allocated structures are released.

	Id = HSLco37783
	    By design, whenever there are no objects backed up,
	    Omniback II ends session as failed.

	Resolution:
	    Two new global variables have been introduced:

	    a) SessSucessfullWhenNoObjectsBackedUp=0
	    By setting this variable to 1 user can change the
	    OmniBack II behavior in order to end the session as
	    successful when there are no objects backed up.
	    b) TreatScriptReturnAsNormal=<script return>
	    By setting this variable to a certain number instructs
	    OmniBack II to treat all the script returns equal to
	    the specified number as normal.

	PHSS_27581:
	Id = HSLco35646
	    Abort mechanism is implemented incorrectly.

	Resolution:
	    Sapback aborts all the objects upon abort request from
	    OmniBack II user.

	Id = HSLco36193
	    CheckFile checks marked error if parameter is null.
	    Debugs are initialized after function entry is marked.

	Resolution:
	    Error marking is removed and function entry mark is
	    moved.

	Id = HSLco36405
	    Set ID number searching is not strict enough and gets
	    confused by new SAP BR tools format.

	Resolution:
	    More strict checking is applied to coniform that this is
	    really a backint ID.

	    Part of SSPUX400_046.

	Id = JAGae11014
	    Session log files contain incorrect information when
	    SAP backup fails.

	Resolution:
	    Log files contain correct information.

	    Part of SSPUX400_036.

	Id = HSLco35966
	     Connection string in printed in plain text format.

	Resolution:
	    Connection string is encrypted before it is passed to
	    GUI.

	    Part of SSPUX400_040.

	Id = HSLco35967
	    Incorrect function is used for raw partition restore.

	Resolution:
	    Raw partition restore uses proper function.

	    Part of SSPUX400_041.

	PHSS_26886:
	Id = HSLco33261
	    brbackup/brarchive is always started with "-u" option
	    which displays logon information.

	Resolution:
	    brbackup/brarchive options are passed in a file.

	    Part of SSPUX400_025.

	PHSS_24983:
	Id = HSLco27809
	    Null pointer string in debugs is passed on as an
	    argument, which causes core dump.

	Resolution:
	    Source code is made safe to null pointer strings.

	Id = HSLco27898
	    Incorrect query for displaying Oracle tablespaces is
	    used. Locally managed tablespaces must be excluded
	    from the list of all tablespaces.

	Resolution:
	    Query is fixed, locally managed tablespaces are not
	    displayed.

	Id = HSLco28402
	    Depending on the environment incorrect FREE() command
	    can be executed in some cases.

	Resolution:
	    All variables are properly allocated.

	Id = HSLco28403
	    Wrong query (Oracle 8.1.x specific) is used to check
	    login and password.

	Resolution:
	    Query for Oracle 8.1.x is run and if it fails with
	    error "Invalid column name", query for Oracle 8.0.x.
	    is run.

	Id = NSMex04633, NSMex04725
	    When -u option is not specified in backup specification
	    the owner of the backup specification is used. If you
	    specify the -u user/password it should be used instead.

	    Part of SSPUX400_008.

	Resolution:
	    The same -u option which is used for brbackup in the
	    CheckSAPfiles is now used in brarchive.

	Id = NSMex04698
	    Attempted to write random memory content to the file.

	Resolution:
	    Memory is cleared before random memory is written.

	Id = HSLco28624
	    Format of symbolic links backed up with SAP is not
	    consistent with Disk agent format. When backing up
	    symbolic link as part of directory the contents
	    of file is backed up instead of link.

	Resolution:
	    Format of backint is changed in accordance with
	    Disk agent format.

	Id = HSLco28862
	    If OB2BARHOSTNAME is set in split mirror backup,
	    it is incorrectly used.

	Resolution:
	    New variable OB2BAROBJNAME is introduced. In case
	    of split mirror backup it is used for forming object
	    names.

	Id = HSLco28960
	    Library is not found in SHLIB_PATH and LD_LIBRARY_PATH.

	Resolution:
	    ORACLE_HOME/lib64 is added to SHLIB_PATH and
	    LD_LIBRARY_PATH.

	Id = HSLco29240
	    During conversion of string "NextSetNumber" to integer
	    there is no checking if the input parameter to 'atoi'
	    function is null. If this happened backup session
	    ended with segmentation error massage.

	Resolution:
	    Input parameter of 'atoi' function is checked. If it
	    is null, the function is not called.

Enhancement:
	No

SR:
	H555008908 H555008812 H555008906 H555008621 H555008566
	H555008480 H555008643 8606244527 H555008483 8606260802
	H555008565 H555007380 H555006290 H555006173 H555006012
	H555006013 H555006085 H555006500 H555005806 H555006205
	H555006672 H555005775

Patch Files:
	
	OMNIBACK-II.OMNI-SAP-P,fr=A.04.00,fa=HP-UX_B.11.00_32/64,
		v=HP:
	/opt/omni/databases/vendor/sap/hp/s800/hp-ux-1020/A.04.00/
		packet.Z
	/opt/omni/databases/vendor/sap/hp/s800/hp-ux-11/A.04.00/
		packet.Z
	/opt/omni/databases/vendor/sap/ibm/rs6000/aix-42/A.04.00/
		packet.Z
	/opt/omni/databases/vendor/sap/sun/sparc/solaris-26/A.04.00/
		packet.Z

what(1) Output:
	
	OMNIBACK-II.OMNI-SAP-P,fr=A.04.00,fa=HP-UX_B.11.00_32/64,
		v=HP:
	/opt/omni/databases/vendor/sap/hp/s800/hp-ux-1020/A.04.00/
		packet.Z:
		None
	/opt/omni/databases/vendor/sap/hp/s800/hp-ux-11/A.04.00/
		packet.Z:
		None
	/opt/omni/databases/vendor/sap/ibm/rs6000/aix-42/A.04.00/
		packet.Z:
		None
	/opt/omni/databases/vendor/sap/sun/sparc/solaris-26/A.04.00/
		packet.Z:
		None

cksum(1) Output:
	
	OMNIBACK-II.OMNI-SAP-P,fr=A.04.00,fa=HP-UX_B.11.00_32/64,
		v=HP:
	1090827885 1307995 /opt/omni/databases/vendor/sap/hp/s800/
		hp-ux-1020/A.04.00/packet.Z
	1713914896 1434570 /opt/omni/databases/vendor/sap/hp/s800/
		hp-ux-11/A.04.00/packet.Z
	3048018094 1168195 /opt/omni/databases/vendor/sap/ibm/
		rs6000/aix-42/A.04.00/packet.Z
	595655982 1228182 /opt/omni/databases/vendor/sap/sun/sparc/
		solaris-26/A.04.00/packet.Z

Patch Conflicts: None

Patch Dependencies: None

Hardware Dependencies: None

Other Dependencies:
	PHSS_27601:
	Release Date: Available
	Id = HSLco35966  SR: H555008565
	PHSS_27601 is required for this defect fix.

	PHSS_28235:
	Release Date: February 2003
	Id = HSLco37783  SR: H555008908
	PHSS_28235 is required for this defect fix.

Supersedes:
	PHSS_27581 PHSS_26886 PHSS_24983

Equivalent Patches:
	PHSS_28013:
	s700: 10.20
	s800: 10.20

Patch Package Size: 5050 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_28014

	5. Run swinstall to install the patch:

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

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

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

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

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

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

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

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

	Patch includes the following Site Specific Patches:
	   SSPUX400_008
	   SSPUX400_025
	   SSPUX400_036
	   SSPUX400_040
	   SSPUX400_041
	   SSPUX400_046