Problem
IBM i Integrated Application Server v8.5 and Integrated Web Services v2.6 instances fail to start. The associated IBM HTTP Server instance starts normally and the JVM appears to be active, but the /www/<server>/wlp/usr/servers/<server>/logs/messages.log shows the application server instance is hung up, not fully started, and did not become active.
Symptom
“CWWKE0002I: The kernel started after x seconds” is the last message logged in the application server’s /www/<server>/wlp/usr/servers/<server>/logs/messages.log.
The /www/<server>/wlp/usr/servers/<server>/workarea/equinox.log contains the following exception:
!ENTRY com.ibm.ws.org.eclipse.equinox.region 4 0 2023-03-03 14:18:50.903
!MESSAGE FrameworkEvent ERROR
!STACK 0
org.osgi.framework.BundleException: Exception in class org.eclipse.equinox.internal.region.RegionManager.start() of bundle com.ibm.ws.org.eclipse.equinox.region.
…
Caused by: java.io.EOFException
at java.base/java.io.DataInputStream.readUnsignedShort(DataInputStream.java:345)
at java.base/java.io.DataInputStream.readUTF(DataInputStream.java:594)
at java.base/java.io.DataInputStream.readUTF(DataInputStream.java:569)
at org.eclipse.equinox.internal.region.StandardRegionDigraphPersistence.readRegionDigraph(StandardRegionDigraphPersistence.java:108)
at org.eclipse.equinox.internal.region.RegionManager.loadRegionDigraph(RegionManager.java:106)
at org.eclipse.equinox.internal.region.RegionManager.start(RegionManager.java:61)
at org.eclipse.osgi.storage.FrameworkExtensionInstaller.startActivator(FrameworkExtensionInstaller.java:287)
at org.eclipse.osgi.storage.FrameworkExtensionInstaller.startExtensionActivator(FrameworkExtensionInstaller.java:272)
… 22 more
Cause
Issues reading the application server’s cached workarea data, which includes persistent cached information related to the individual application server instance, which includes OSGi resolver metadata and persistent OSGi bundle data.
Environment
IBM i OS
Integrated Web Application Server v8.5
Integrated Web Services v2.6
Diagnosing The Problem
If an individual IBM i Integrated Web Services v2.6 or Integrated Web Application Server v8.5 instance fails to start successfully, review the /www/<server>/wlp/usr/servers/<server>/logs/messages.log. If “CWWKE0002I: The kernel started after x seconds” is the last message logged, then review the /www/<server>/wlp/usr/servers/<server>/workarea/equinox.log for the “org.osgi.framework.BundleException: Exception in class org.eclipse.equinox.internal.region.RegionManager.start() of bundle com.ibm.ws.org.eclipse.equinox.region” and “java.io.EOFException” exceptions.
Resolving The Problem
End the application server instance and start it up with the -clean option.
ENDTCPSVR *HTTP HTTPSVR(<server>)
STRTCPSVR *IAS INSTANCE(<server> ‘-clean’)
Then, see whether the <server> starts successfully by reviewing its /www/<server>/wlp/usr/servers/<server>/logs/messages.log file. If it starts successfully, then end the application server and start the complete instance.
ENDTCPSVR *IAS INSTANCE(<server>)
STRTCPSVR *HTTP HTTPSVR(<server>)
Running “STRTCPSVR SERVER(*IAS) INSTANCE(<server> ‘-clean’)” cleans all persistent cached information (under workarea) that is related to the specified server instance, which includes OSGi resolver metadata and persistent OSGi bundle data. If you use this option, the server will be required to recompute any cached data at the next startup, which might take more time than a normal restart that can reuse cached data.
Only the ADMINx application server instances use –clean on every startup. Non-ADMINx application servers do not specify –clean at startup by default to improve application server startup performance, especially when numerous apps are deployed. As a result, it has to be manually specified to perform the cleanup of the workarea for non-ADMIN (e.g. IWS or IAS) servers.
[{“Type”:”MASTER”,”Line of Business”:{“code”:”LOB57″,”label”:”Power”},”Business Unit”:{“code”:”BU058″,”label”:”IBM Infrastructure w/TPS”},”Product”:{“code”:”SWG60″,”label”:”IBM i”},”ARM Category”:[{“code”:”a8m0z0000000CJLAA2″,”label”:”Integrated Application Server”},{“code”:”a8m0z0000000COsAAM”,”label”:”Web Services-u003EIntegrated Web Services”}],”ARM Case Number”:”TS012273706″,”Platform”:[{“code”:”PF012″,”label”:”IBM i”}],”Version”:”7.3.0;7.4.0;7.5.0″}]
