PQ95908: WAS.ADAPTER, MANUALEDIT.JACL SCRIPT FAILS TO BACKUP JDBC-RESOURCE-PROVIDER-TEMPLATES.XML ACROSS FILE SYSTEMS

 Fixes are available

5.1.1.8: WebSphere Application Server 5.1.1 Cumulative Fix 8 for AIX
5.1.1.8: WebSphere Application Server 5.1.1 Cumulative Fix 8 for Windows
5.1.1.8: WebSphere Application Server 5.1.1 Cumulative Fix 8 for HP-UX
5.1.1.8: WebSphere Application Server 5.1.1 Cumulative Fix 8 for Solaris
5.1.1.6: WebSphere Application Server Version 5.1.1 Cumulative Fix 6
5.1.1.7: WebSphere Application Server Version 5.1.1 Cumulative Fix 7
5.1.1.4: WebSphere Application Server Version 5.1.1 Cumulative Fix 4
5.1.1.8: WebSphere Application Server 5.1.1 Cumulative Fix 8 for Linux



APAR status
Closed as program error.

Error description
Installation of any fix pack to WebSphere V5.1.0.0, where
multiple files systems are installed fails in the update to the
adapter. Error shown:

2004-10-13T12:46:38-05:00 Result: WASX7017E: Exception received
while running file
"/usr/local/opt/WebSphere/AppServer/util/ManualEdit.jacl";
exception information:  com.ibm.bsf.BSFException:  error while
eval'ing Jacl expression:  error renaming
"/usr/local/opt/WebSphere/AppServer/config/templates/system/jdbc
-resourc e-provider-templates.xml" to
"/usr/local/opt/WebSphere/AppServer/properties/version/backup/jd
bc-resou rce-provider-templates1097689598.xml":  best guess at
reason:  permission denied 2004-10-13T12:46:38-05:00 Log:
ExecCmd::launch returns 105

An APAR is needed on WAS.adapter who owns ManualEdit.jacl which
fails.

A rename is issued to backup this xml file from the /config dir
to the /properties dir

A rename will only issue  cp  command which will fail accross
multiple file systems if the /config and /properties are in
different file systems

Please open apar against WAS.adapter for this.
Local fix
Workaround is to try running this command directly and
Problem summary
****************************************************************
* USERS AFFECTED: WebSphere Application Server 5.x users who   *
*                 have split the Application Server installed  *
*                 image across multiple filesystems and wish   *
*                 to apply fixpacks                            *
****************************************************************
* PROBLEM DESCRIPTION: The ManualEdit.jacl script may fail     *
*                      on a rename operation during update     *
*                      of the adapter component as part of     *
*                      an Application Server 5.x fixpack       *
*                      install.                                *
****************************************************************
* RECOMMENDATION: This APAR cannot be applied idividually to   *
*                 fix an existing installation or an           *
*                 existing fixpack.  It is only effective      *
*                 when included in subsequent fixpacks         *
*                 issued by IBM.  Please refer to the          *
*                 Circumvention text of this APAR for          *
*                 suggested workarounds.                       *
****************************************************************
ManualEdit.jacl uses a file rename command which is
implemented in java as File.renameTo().  This is not
guaranteed to work across file systems for all platforms.
The file rename is done to move the original xml file from
config/templates/system to properties/version/backup, which
normally works, but some customers have split these onto
different filesystems.
Problem conclusion
ManualEdit.jacl was changed to check for failure of the
intended file rename operation.  If it fails, the jacl script
will perform an alternate rename to create a backup in the
same directory as the original file, but with a .backup
filename extension so that it is ignored by Application Server.
There is no fix for the existing fixpacks because the affected
fixpacks will lay down the prior copy of ManualEdit.jacl
before invoking it.  See the circumvention section for
possible workarounds.
Temporary fix Comments
APAR information
APAR number PQ95908
Reported component name WAS BASE 5.0
Reported component ID 5630A3600
Reported release 10H
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Special Attention NoSpecatt
Submitted date 2004-10-19
Closed date 2004-11-03
Last modified date 2004-11-03

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Modules/Macros
JDBC          

Publications Referenced

Fix information

Applicable component levels
R003 PSY    UP
R00A PSY    UP
R00H PSY    UP
R00I PSY    UP
R00P PSY    UP
R00S PSY    UP
R00W PSY    UP
R103 PSY    UP
R10A PSY    UP
R10H PSY    UP
R10I PSY    UP
R10P PSY    UP
R10S PSY    UP
R10W PSY    UP


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > General
Operating system(s):
Software version: 10H
Software edition:
Reference #: PQ95908
IBM Group: Software Group
Modified date: Nov 3, 2004