PM91417: PROVIDE OPTION FOR BACKWARDS COMPATIBILITY FOR EAREXPANDER.

Fixes are available

APAR status

Closed as program error.

Error description

An option is necessary to provide backwards compatibility
for having the EARExpander command line utility extract files
from JAR files in all locations, not just in JavaEE active
locations.

Local fix

```
n.a
```

Problem summary

****************************************************************
* USERS AFFECTED:  All users of IBM WebSphere Application      *
*                  Server                                      *
****************************************************************
* PROBLEM DESCRIPTION: Partial application updates will not    *
*                      update JARs in non-active Java          *
*                      EE locations.                           *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
Applications deployed to the WebSphere Application Server by
default only expand archives in active Java EE locations.  For
example, JARS in a WAR's WEB-INF/lib directory are active.
JARs in other locations within a WAR are not active.
Because JARs not in active locations are not expanded, partial
application updates are not applied to these JARs.  (Whole JAR
replacements are applied to these JARs.)
For example, the file "SampleScript.js" having the following
packaging structure is not updated:
SampleEAR.ear/
SampleWAR.war/
WEB-INF/SampleDir/NestedSampleDir/
SampleJar.jar/
SampleScript.js
Expansion is performed by internal processing steps, including
deployment steps, and including expansions performed by the
earExpander script.

Problem conclusion

A custom property has been introduced which enables expansion of
all archives, even those outside of active Java EE locations:

org.eclipse.jst.j2ee.commonarchivecore.openAllArchives=true

By default, the custom property value is false. Setting the
value true will revert the fix introduced by PM42643, and
set the server to expand all archives. This should be done
sparingly since setting the server to expand archives outside
of active Java EE locations provides the best performance, and
avoids any problems caused by non-valid archives. For example,
simple corruption of an archive file, or use of multi-byte
characters for entries in a archive file.

To enable expansion of non-standard archives during deployment,
set the property on the processes involved with the deployment,
that is, on the Application Server process, and, if a Deployment
Manager is being used, on the Deployment Manager process.

To enable expansion by the earExpander script, set the property
as a Java Custom property by editing the earExpander script.

The property is not applied to JARs within JARs.  JARs within
JARs will still not be expanded, even with the property set to
true.

Note that all JARs in EAR files are active and all JARs in RAR
files are active.  The processing of JARs in EAR files and
JARs in RAR files is not affected by the custom property.


The fix for this APAR is currently targeted for inclusion in
fix packs 7.0.0.31, 8.0.0.8, and 8.5.5.2.  Please refer to the
Recommended Updates page for delivery information:
http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980

Temporary fix

Comments

APAR Information

APAR number
PM91417
Reported component name
WEBSPHERE APP S
Reported component ID
5724J0800
Reported release
800
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2013-06-19
Closed date
2013-09-10
Last modified date
2013-09-10

APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:

Fix information

Fixed component name
WEBSPHERE APP S
Fixed component ID
5724J0800

Applicable component levels

R700 PSY
UP
R800 PSY
UP
R850 PSY
UP

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.0","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
12 January 2022

Tips

PM91417: PROVIDE OPTION FOR BACKWARDS COMPATIBILITY FOR EAREXPANDER.

Fixes are available

Subscribe

APAR status

Closed as program error.

Error description

Local fix

Problem summary

Problem conclusion

Temporary fix

Comments

APAR Information

APAR number

Reported component name

Reported component ID

Reported release

Status

PE

HIPER

Special Attention

Submitted date

Closed date

Last modified date

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Fix information

Fixed component name

Fixed component ID

Applicable component levels

R700 PSY

R800 PSY

R850 PSY

Document Information

Share your feedback

Need support?