PI87470: Unable to install resource adapter using loose configuration file

Fixes are available

APAR status

Closed as program error.

Error description

Symptom:
[ERROR   ] CWWKE0701E:
[com.ibm.ws.jca.management.j2ee.internal.JCAMBeanRuntime(608
)] The setResourceAdapter method has thrown an exception
Bundle:com.ibm.ws.jca.management.j2ee(id=310)
java.lang.NullPointerException
at
com.ibm.ws.jca.management.j2ee.internal.ResourceAdapterModul
eMBeanImpl.<init>(ResourceAdapterModuleMBeanImpl.java:108)
    at [internal classes]

Occurs when:
- using a loose configuration file for a resource adapter in
the dropins directory
 - rar folder name differs from the resource adapter ID
 - j2eeManagement-1.1 and jca-1.7 features are enabled

Local fix

Problem summary

****************************************************************
* USERS AFFECTED:  All users of IBM WebSphere Application      *
*                  Server Liberty - Java 2 Connectivity (J2C)  *
****************************************************************
* PROBLEM DESCRIPTION: Installing loose config resource        *
*                      adapter fails with                      *
*                      NullPointerException                    *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
This issue occurs when j2eeManagement-1.1 and jca-1.7 features
are enabled and a loose config Resource Adapter (RA) is
configured.  In the loose configuration file, a file system path
may be referenced which can be a path to any folder.  When the
folder containing the loose RA files does not match the RA's ID
in server.xml, a NullPointerException is thrown from the RA
MBean initialization code.

The stack trace of this issue occurring is the following:
[ERROR   ] CWWKE0701E:
[com.ibm.ws.jca.management.j2ee.internal.JCAMBeanRuntime(608)]
The setResourceAdapter method has thrown an exception
Bundle:com.ibm.ws.jca.management.j2ee(id=310)
java.lang.NullPointerException
    at
com.ibm.ws.jca.management.j2ee.internal.ResourceAdapterModuleMBe
anImpl.<init>(ResourceAdapterModuleMBeanImpl.java:108)
    at [internal classes]

Problem conclusion

The RA MBean code has been fixed to tolerate a wider range of
loose RA file paths, specifically, the RA folder no longer needs
to be an exact match for the RA ID.  However, the RA folder name
does need to contain the RA ID.  Additionally, if this condition
fails in the future, it will not throw an NPE and will instead
isolate the failure to the further usage of the single RA MBean
operation as opposed to disrupting the entire server.

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

Temporary fix

There are several ways to work around this issue:
 A) Do not use a loose RA
 B) have the folder containing the loose RA be an exact match to
the RA ID
 C) If J2EE MBeans are not needed, the j2eeManagement-1.1 can be
disabled to avoid this issue entirely.

Comments

APAR Information

APAR number
PI87470
Reported component name
LIBERTY PROFILE
Reported component ID
5724J0814
Reported release
CD0
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2017-09-15
Closed date
2017-09-25
Last modified date
2017-09-25

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
LIBERTY PROFILE
Fixed component ID
5724J0814

Applicable component levels

RCD0 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":"CD0","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
04 May 2022

Tips

PI87470: Unable to install resource adapter using loose configuration file

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

RCD0 PSY

Document Information

Share your feedback

Need support?