IBM Support

SI61989 - OSP-BASEDIR-INCORROUT IBM Navigator for i

PTF Cover Letter


PTF ( Program Temporary Fixes ) Cover letter


Order this fix

Abstract

OSP-BASEDIR-INCORROUT IBM Navigator for i


Pre/Co-Requisite PTF / Fix List

REQ  LICENSED           PTF/FIX  LEVEL

TYPE PROGRAM  RELEASE   NUMBER   MIN/MAX  OPTION
---- -------- --------- -------  -------  ------
PRE  5770SS1  V7R3M0    SI60483   NONE     0003
PRE  5770SS1  V7R3M0    SI58548   00/00    0000
PRE  5770SS1  V7R3M0    SI58549   00/00    0000



NOTICE:
-------
Application of this PTF may disable or render ineffective programs that
use system memory addresses not generated by the IBM translator,
including programs that circumvent control technology designed to limit
interactive capacity to purchased levels.  This PTF may be a prerequisite
for future PTFs.  By applying this PTF you authorize and agree to the
foregoing.

This PTF is subject to the terms of the license agreement which
accompanied, or was contained in, the Program for which you are obtaining
the PTF.  You are not authorized to install or use the PTF except as part
of a Program for which you have a valid Proof of Entitlement.

SUBJECT TO ANY WARRANTIES WHICH CAN NOT BE EXCLUDED OR EXCEPT AS EXPLICITLY
AGREED TO IN THE APPLICABLE LICENSE AGREEMENT OR AN APPLICABLE SUPPORT
AGREEMENT, IBM MAKES NO WARRANTIES OR CONDITIONS EITHER EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON INFRINGEMENT,
REGARDING THE PTF.

The applicable license agreement may have been provided to you in printed
form and/or may be viewed using the Work with Software Agreements (WRKSFWAGR)
CL command.





APAR Error Description / Circumvention

-----------------------------------------------
After updated from v7r1m0 to v7r2m0 with PowerHA product
installed, IBM Navigator for i can not be accessed due to server
started failed in some cases.

CORRECTION FOR APAR SE65434 :
-----------------------------
Update configuration file and remove PowerHA plugin jars which
were not required by v7r2m0 to fix the issue.

CIRCUMVENTION FOR APAR SE65434 :
--------------------------------
None.


DESCRIPTION OF PROBLEM FIXED FOR APAR SE65492 :
-----------------------------------------------
When attempting to access the IBM Navigator for i web
application via the https://<server>:2005/ibm/console URL, a
"HTTP 404 - File Not Found for /ibm/console" error is returned
to the browser.

The
/QIBM/UserData/OS/AdminInst/admin2/wlp/usr/servers/admin2/logs/m
essages.log file displays the CWWKZ0404E and CWWKZ0012I errors
for the following iWebNav (IBM Navigator for i) application
plugins:

COM.IBM.I5OS.HASM.SBG_1.0.0.JAR
COM.IBM.I5OS.WEBNAV.PLUGIN.CLUSTERSERVICES_1.0.0.JAR

Here is an example of the errors seens in the
/QIBM/UserData/OS/AdminInst/admin2/wlp/usr/servers/admin2/logs/m
essages.log file.

com.ibm.ws.app.manager.esa.internal.DeploySubsystemAction A
CWWKZ0404E: An exception was generated when trying to resolve
the contents of the application iWebNav. The exception text from
the OSGi framework is: Unable to resolve IFileAdapter wrapping
file with url
file:/QIBM/ProdData/OS400/Navigator/appdata/iWebNav.eba/COM.IBM.
I5OS.HASM.SBG_1.0.0.JAR: missing requirement
org.apache.aries.subsystem.core.archive.ImportPackageRequirement
: namespace=osgi.wiring.package, attributes={},
directives={filter=(&(osgi.wiring.package=com.ibm.ws.jsp.runtime
)(version>=0.0.0)), resolution=mandatory}, resource=IFileAdapter
wrapping file with url
file:/QIBM/ProdData/OS400/Navigator/appdata/iWebNav.eba/COM.IBM.
I5OS.HASM.SBG_1.0.0.JAR

com.ibm.ws.app.manager.AppMessageHelper A CWWKZ0012I: The
application iWebNav was not started.

The above errors are causing the IBM Navigator for i web
application not to start properly.

CORRECTION FOR APAR SE65492 :
-----------------------------
IBM Navigator for i server can not be started due to an
incorrect version of PowerHA GUI bundle jar files. These jar
files were not required by IBM 7.2 and later version. After this
fix, these jar files will be removed to avoid such error.

CIRCUMVENTION FOR APAR SE65492 :
--------------------------------
None.


Activation Instructions


None.




Special Instructions


With this PTF, IBM Navigator for i running on admin2 moves to JDK 64
bit. Before applying this PTF, verify licensed program 5770JV1 option
15 (Java SE 7 64 bit) is installed.

1. Enter the following commands to stop the QHTTPSVR subsystem and
QINAVMNSRV job before applying PTF:
ENDSBS SBS(QHTTPSVR) OPTION(*IMMED)
CALL PGM(QSYSDIR/QINAVMNSRV) PARM(*STOP)


2. Apply or remove this PTF (immediate mode).

3. Start the HTTP server(s) using:
STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)

4. It is highly recommended to clear the browser cache after applying
this PTF.

********************************************************************
THE FOLLOWING ARE SUPERSEDED SPECIAL INSTRUCTIONS. IF THE SUPERSEDED
PTF HAS ALREADY BEEN APPLIED AND ITS SPECIAL INSTRUCTION FOLLOWED,
IT IS NOT NECESSARY TO FOLLOW THAT SPECIAL INSTRUCTION AGAIN.
********************************************************************

SPECIAL INSTRUCTIONS FOR SUPERSEDED PTF SI60484 :
=================================================

With this PTF, IBM Navigator for i running on admin2 moves to JDK 64
bit. Before applying this PTF, verify licensed program 5770JV1 option
15 (Java SE 7 64 bit) is installed.

1. Enter the following commands to stop the QHTTPSVR subsystem and
QINAVMNSRV job before applying PTF:
ENDSBS SBS(QHTTPSVR) OPTION(*IMMED)
CALL PGM(QSYSDIR/QINAVMNSRV) PARM(*STOP)


2. Apply or remove this PTF (immediate mode).

3. Start the HTTP server(s) using:
STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)

4. It is highly recommended to clear the browser cache after applying
this PTF.


1. Enter the following commands to stop the QHTTPSVR subsystem and
QINAVMNSRV job before applying PTF:
ENDSBS SBS(QHTTPSVR) OPTION(*IMMED)
CALL PGM(QSYSDIR/QINAVMNSRV) PARM(*STOP)


2. Apply or remove this PTF (immediate mode).

3. Start the HTTP server(s) using:
STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)

4. It is highly recommended to clear the browser cache after applying
this PTF.

1. Enter the following command to stop the QHTTPSVR subsystem before
applying PTF:
ENDSBS SBS(QHTTPSVR) OPTION(*IMMED)

2. Apply or remove this PTF (immediate mode).

3. Start the HTTP server(s) using:
STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)

4. It is highly recommended to clear the browser cache after applying
this PTF.


Default Instructions

THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.



Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  ------------------------------------------------------------
   SI60484      OSP-BASEDIR-INCORROUT IBM Navigator for i
   SI60484      Update xml & sql files for PDI Graph History
   SI60484      Update xml & sql files for PDI Graph History
   SI60484      Update xml & sql files for PDI Graph History
   SI60484      Update xml & sql files for PDI Graph History
   SI59042      OSP-BASEDIR-INCORROUT IBM Navigator for i
   SI59042      service entry to service table
   SI59042      Update xml & sql files for PDI Graph History
   SI59042      Update sql and xml iteration 50 #2
   SI59042      Update sql files for PDI Graph History
   SI59042      Update xml & sql files for PDI Graph History
   SI59042      Update xml & sql files for PDI Graph History
   SI59042      Update xml & sql files for PDI Graph History
   SI59042      Update xml & sql files for PDI Graph History
   SI58546      Update xml & sql files for PDI
   SI58546      OSP-BASEDIR-INCORROUT IBM Navigator for i
   SI58546      OSP-BASEDIR-INCORROUT IBM Navigator for i
   SI58546      Update xml & sql files for PDI

Summary Information

System..............................i
Models..............................
Release.............................V7R3M0
Licensed Program....................5770SS1
APAR Fixed..........................View details for APAR SE65434
View details for APAR SE65492
Superseded by:......................View fix details for PTF SI79560
Recompile...........................N
Library.............................QSYSDIR
MRI Feature ........................NONE
Cum Level...........................C6299730


IBM i Support

IBM disclaims all warranties, whether express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. By furnishing this document, IBM grants no licenses to any related patents or copyrights. Copyright © 1996,1997,1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022 IBM Corporation. Any trademarks and product or brand names referenced in this document are the property of their respective owners. Consult the Terms of use link for trademark information.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.3.0","Product":{"code":"SWG60","label":"IBM i"},"Component":"5770SS1","Edition":"","Line of Business":{"code":"LOB57","label":"Power"}}]

Document Information

Modified date:
29 April 2022