Sharing some errors and solutions for creating IBM BUSINESS AUTOMATION WORKFLOW V18.0.0.1 and V18.0.0.2 deployment environments

Body

In this article, I want to share some errors met in real cases and the possible solutions when trying to create IBM BUSINESS AUTOMATION WORKFLOW (BAW) V18.0.0.1 and V18.0.0.2 deployment environments (DEs).

Scenario 1:

Some customers encounter CWMCB0058E error in BPMConfig log while creating the BAW V18.0.0.1 DE, for example they get the following exceptions in BPMConfig_YYYYMMDD-**.log
---------------------------------
[10/15/18 12:22:24:420 GMT] 00000001 BPMConfig    E com.ibm.bpm.config.BPMConfig main CWMCB0058E: Information for application navigatorEAR_TPCBPM01HK.AppTarget could not be obtained.
                                com.ibm.bpm.config.util.ConfigException: CWMCB0058E: Information for application navigatorEAR_TPCBPM01HK.AppTarget could not be obtained.
   at com.ibm.bpm.config.util.ws.J2eeHelper.getApplicationInfo(J2eeHelper.java:1028)
   at com.ibm.bpm.config.util.ws.J2eeHelper.setVirtualHostForWebModules(J2eeHelper.java:1921)
---------------------------------

From the logs above, we noticed that the application navigatorEAR_TPCBPM01HK.AppTarget,  which has problem while setting virtual host, was not installed at all.  
Comparing with my local logs, not only for this particular application, all of the case related applications were not installed as well, for example: CaseClient_ClusterName, CaseBuilder_ClusterName, CaseForms_ClusterName...etc.
But while installing the applications, there was even no attempt trying to installing these applications.

Solution:
1). You need to apply the critical ifix JR59780 for BAW18.0.0.1 firstly. in this ifix IBM development fixed a context root issue also.
2). There is no APAR ifix for CWMCB0058E in BAW 18.0.0.1 but you can use below workaround to bypass this error and make the DE creation complete smoothly and successfully.
---------------------------------
Don't set any value for bpm.de.virtualHost in BPMConfig Properties file.

so just change
bpm.de.virtualHost=default_host
as

bpm.de.virtualHost=
---------------------------------

In summary, you need to install JR59780 and change the bpm.de.virtualHost= to resolve this issue in creating the BAW V18.0.0.1 DE.

Scenario 2:

After resolving the above error CWMCB0058E, some customers are still failing to create the BAW V18.0.0.1 DE with below error CWMCB0190E from the FFDC. For example, below error CWMCB0190E indicates that Navigator application fails to install.
---------------------------------
com.ibm.bpm.config.util.ConfigException: CWMCB0190E: The copy file operation failed.
at com.ibm.bpm.config.util.io.FileHelper.copyFile(FileHelper.java:273)
at com.ibm.bpm.config.capability.standard.ComponentContentNavigator.installApplication(ComponentContentNavigator.java:690)
at com.ibm.bpm.config.capability.standard.ComponentContentNavigator.configure(ComponentContentNavigator.java:343)
at com.ibm.bpm.config.capability.Capability.configureClusterMember(Capability.java:257)
at com.ibm.bpm.config.capability.CapabilityApplication.configureClusterMember(CapabilityApplication.java:113)
at com.ibm.bpm.config.capability.ProvisionNode.provisionNode(ProvisionNode.java:146)
at com.ibm.bpm.config.BPMConfig.configureDeploymentEnvironment(BPMConfig.java:844)
at com.ibm.bpm.config.BPMConfig$Actions.createDe(BPMConfig.java:4740)
at com.ibm.bpm.config.cli.CreateAction.runInner(CreateAction.java:156)
at com.ibm.bpm.config.cli.AbstractConfigAction.run(AbstractConfigAction.java:129)
at com.ibm.bpm.config.cli.CreateAction.run(CreateAction.java:35)
at com.ibm.bpm.config.BPMConfig.main(BPMConfig.java:305)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:90)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:55)
at java.lang.reflect.Method.invoke(Method.java:508)
at com.ibm.wsspi.bootstrap.WSLauncher.launchMain(WSLauncher.java:234)
at com.ibm.wsspi.bootstrap.WSLauncher.main(WSLauncher.java:96)
at com.ibm.wsspi.bootstrap.WSLauncher.run(WSLauncher.java:77)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:90)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:55)
at java.lang.reflect.Method.invoke(Method.java:508)
at org.eclipse.equinox.internal.app.EclipseAppContainer.callMethodWithException(EclipseAppContainer.java:587)
at org.eclipse.equinox.internal.app.EclipseAppHandle.run(EclipseAppHandle.java:198)
at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.runApplication(EclipseAppLauncher.java:110)
at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start(EclipseAppLauncher.java:79)
at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:369)
at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:179)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:90)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:55)
at java.lang.reflect.Method.invoke(Method.java:508)
at org.eclipse.core.launcher.Main.invokeFramework(Main.java:340)
---------------------------------

This is possible caused by the disk space is not enough. The Navigator application is almost 600M.

Solution:

After you increase disk space into 3G, the DE could be created successfully.

Scenario 3:

3. When creating the BAW V18.0.0.2 DE, you still meet CWMCB0058E error in BPMConfig log. For example you get the following exceptions in BPMConfig_YYYYMMDD-**.log
---------------------------------
[15/01/19 08:24:46:478 GMT] 00000001 BPMConfig    E com.ibm.bpm.config.BPMConfig main CWMCB0058E: Information for application CaseBuilder_TPSBPM01HK.AppTarget could not be obtained.
                                com.ibm.bpm.config.util.ConfigException: CWMCB0058E: Information for application CaseBuilder_TPSBPM01HK.AppTarget could not be obtained.
   at com.ibm.bpm.config.util.ws.J2eeHelper.getApplicationInfo(J2eeHelper.java:990)
   at com.ibm.bpm.config.util.ws.J2eeHelper.setVirtualHostForWebModules(J2eeHelper.java:1883)
...
Caused by: com.ibm.websphere.management.exception.AdminException: ADMA0017E: The context for CaseBuilder_TPSBPM01HK.AppTarget cannot be obtained. The application does not appear to be installed.
   at com.ibm.ws.management.application.EditApplication.getApplicationInfo(EditApplication.java:354)
---------------------------------

This issue is not fixed in BAW V18.0.0.2 as well.

All of the case manager related applications are not installed due to this error.

Solution:
There is no APAR ifix for CWMCB0058E in BAW 18.0.0.2 and you have to set empty in the bpm.de.virtualHost as workaround and then it can successfully create the deployment environment.  
---------------------------------
Don't set any value for bpm.de.virtualHost in BPMConfig Properties file.

so just change
bpm.de.virtualHost=default_host
as

bpm.de.virtualHost=
---------------------------------

Now there is APAR JR60519 (RUNNING THE BPMCONFIG CREATE FAILS IF BPM.DE.VIRTUALHOST IS SET FOR IBM WORKFLOW SERVER) included into BAW V19.0.0.1, after upgrading to BAW V19.0.0.1, you will be able to set the virtual host for Case Builder application as bpm.de.virtualHost=default_host in a Workflow Server environment.

I hope this article can give you some helps if you are creating IBM BUSINESS AUTOMATION WORKFLOW V18.0.0.1 and V18.0.0.2 deployment environments and meeting above problems.