PK96006: IF FILE.SERVING.PATTERNS.ALLOW IS DEFINED, PLUGIN GENERATION WILL ADD THAT AND ALL OTHER DYNAMIC PATTERNS IN PLUGIN-CFG.XML

Fixes are available

APAR status

Closed as program error.

Error description

If file.serving.patterns.allow is defined with some value,
plugin generation will now generate plugin-cfg.xml adding this
url patterns AND add all other standard dynamic pattens and
servlet url pattens from web.xml.


This is because file.serving.patterns.allow represents
"exhaustive" list of all patterns only allowed when file serving
is enabled. With this change, users will have selective choice
of separating static and dynamic contents at webserver and
application servers. If the application is using struts 2
framework, the user can also now add allow patterns like *.do
and *.action to also archive static and dynamic content
separation.

Local fix

Manually modification of plugin-cfg.xml or by defining dummy
servlet mapping in web.xml

Problem summary

****************************************************************
* USERS AFFECTED:  All users of IBM WebSphere Application Server
****************************************************************
* PROBLEM DESCRIPTION: File serving allow patterns defined     *
*                      within the ibm-web-ext.xmi file will    *
*                      also get a /* within the                *
*                      plugin-cfg.xml file.                    *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
The plugin generator only recognizes the File Serving Allow
Patterns within the ibm-web-ext.xmi file if FileServingEnabled
is set to true.  FileServingEnabled adds a /* to the
Plugin-cfg.xml file which negates the purpose of defining
unique File Serving Allow Patterns.

Problem conclusion

A new parameter has been introduced called
"deactivateWildCardURIMapping".  When set to true and
FileServingEnabled is set to true and File Serving Allow
Patterns have been defined within the ibm-web-ext.xmi file,
the Plugin Generator will suppress the /* from being added to
the Plugin-cfg.xml file.  If set to false or not added at all,
the /* will be added as usual.

Placement
The deactivateWildCardURIMapping parameter is set in the
following location within the Administrative Console.

WebSphere Application Server Base edition:
[1] Click on Application servers,
[2] Click on the desired server in the list. Ensure that
the Configuration tab is visible.
[3] Under Server Infrastructure, expand the Java and
Process Management icon.
[4] Select Process Definition and then under Additional
Properties, click on Java Virtual Machine.
[5] Click on the Custom properties link and click the New
button. For Name enter deactivateWildCardURIMapping,
and for value enter true to enable the function.
[6] Click OK and then Save.
[7] Restart the application server to pick up the change.

WebSphere Application Server Network Deployment edition:
[1] Click on System Administration
[2] Click on Deployment Manager
[3] Under Server Infrastructure, expand the Java and
Process Management icon.
[4] Select Process Definition and then under Additional
Properties, click on Java Virtual Machine.
[5] Click on the Custom properties link and click the New
button. For Name enter deactivateWildCardURIMapping,
and for value enter true to enable the function.
[6] Click OK and then Save.
[7] Restart the application server to pick up the change.

Limitations
[1] This parameter can only be set within the administrative
console.
[2] Only Plugin generation within the Administrative Console
will recognize and honor this parameter. genPluginCfg
scripts do not pick this up.
[3] This is a global variable.  Therefore, if set, it will
affect any application regardless of how it?s mapped as
long as the ibm-web-ext.xmi updates are in place for those
applications.

The fix for this APAR is currently targeted for inclusion in
fix packs 6.1.0.31 & 7.0.0.9.  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
PK96006
Reported component name
WEBSPHERE APP S
Reported component ID
5724J0800
Reported release
61A
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2009-09-11
Closed date
2009-10-30
Last modified date
2009-10-30

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

R61A PSY
UP
R61H PSY
UP
R61I PSY
UP
R61P PSY
UP
R61S PSY
UP
R61W PSY
UP
R61Z PSY
UP
R700 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":"6.1","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
29 December 2021

Tips

PK96006: IF FILE.SERVING.PATTERNS.ALLOW IS DEFINED, PLUGIN GENERATION WILL ADD THAT AND ALL OTHER DYNAMIC PATTERNS IN PLUGIN-CFG.XML

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

R61A PSY

R61H PSY

R61I PSY

R61P PSY

R61S PSY

R61W PSY

R61Z PSY

R700 PSY

Document Information

Share your feedback

Need support?