PK91576: UPGRADING FROM WAS 6.1.0.24 TO WAS 6.1.0.25 WITH PORTAL 6.1.0.1 CAUSES THE PORTAL SERVER TO ABEND DURING STARTUP.

Fixes are available

APAR status

Closed as program error.

Error description

Whitespaces in front of WebSphere variables in the generic jvm
arguments section of the server.xml causes the Portal server to
abend when upgrading from 6.1.0.24 to 6.1.0.25

For example, Portal sets the generic JVM argument in the
server.xml with a leading whitespace:

genericJvmArguments=" ${WPS_JVM_ARGUMENTS_EXT}
-Dderby.system.home=${USER_INSTALL_ROOT}/PortalServer/derby
-Dibm.stream.nio=true -Xgcpolicy:gencon"

This will cause the ${WPS_JVM_ARGUMENTS_EXT} websphere variable
to be resolved incorrectly and the subsequent *.jvm.options file
will be generated with the ${WPS_JVM_ARGUMENTS_EXT} key instead
of the actually value:

${WPS_JVM_ARGUMENTS_EXT}
-Dderby.system.home=/WebSphere/V6R1/AppServer/profiles/default/P
ortalServer/derby -Dibm.stream.nio=true -Xgcpolicy:gencon

During server startup, the following error will be logged:

JVMJ9VM007E Command-line option unrecognized:
${WPS_JVM_ARGUMENTS_EXT}

Local fix

Change the generic jvm argument from the admin console:

1) Servers -> Application Server -> <serverName> -> Server
   Infrastructure -> Java and Process Management -> Process
   Definition -> <processType> -> Java Virtual Machine ->
   Generic JVM arguments

2) Remove the whitespace infront of the websphere variable.

3) Apply -> Save to Master Repository -> Sync Node

4) Restart the application server.

Problem summary

****************************************************************
* USERS AFFECTED:  All users of WebSphere Application Server   *
*                  V6.1                                        *
****************************************************************
* PROBLEM DESCRIPTION: Whitespaces in front of WebSphere       *
*                      variables in the GenericJVMArgs         *
*                      property of the server.xml causes the   *
*                      Portal server to abend when upgrading   *
*                      from 6.1.0.24 to 6.1.0.25               *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
Leading whitespace before a WebSphere variable in the
GenericJVMArgs property of the server.xml causes the
server to abend at 6.1.0.25 when it didn't at 6.1.0.24.
Setting the generic JVM argument in the
server.xml with a leading whitespace:
genericJvmArguments=" ${WPS_JVM_ARGUMENTS_EXT}
-Dderby.system.home=${USER_INSTALL_ROOT}/PortalServer/derby
-Dibm.stream.nio=true -Xgcpolicy:gencon"
This will cause the websphere variable
to be un-resolved in the  *.jvm.options file.
During server startup, the following error will be logged:
JVMJ9VM007E Command-line option unrecognised:
${WPS_JVM_ARGUMENTS_EXT}

Problem conclusion

The code has been modified to handle leading whitespace in the
GenericJVMArgs property.

APAR PK91576 is currently targeted for inclusion in Service
Level (Fix Pack) 6.1.0.27 of WebSphere Application Server V6.1.

Please refer to URL:
//www.ibm.com/support/docview.wss?rs=404&uid=swg27006970
for Fix Pack availability.

Temporary fix

Comments

APAR Information

APAR number
PK91576
Reported component name
WEBSPHERE FOR Z
Reported component ID
5655I3500
Reported release
610
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2009-07-16
Closed date
2009-07-23
Last modified date
2009-11-28

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

PK94036 PM02283

Fix information

Fixed component name
WEBSPHERE FOR Z
Fixed component ID
5655I3500

Applicable component levels

R610 PSY UK49671
UP09/09/21 P F909

Fix is available

Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.

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

Document Information

Modified date:
28 December 2021

Tips

PK91576: UPGRADING FROM WAS 6.1.0.24 TO WAS 6.1.0.25 WITH PORTAL 6.1.0.1 CAUSES THE PORTAL SERVER TO ABEND DURING STARTUP.

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

R610 PSY UK49671

Fix is available

Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.

Document Information

Share your feedback

Need support?