This chapter describes issues you might encounter when you install and configure supported Oracle Fusion Middleware products on IBM WebSphere. It includes the following topics:
Note:This chapter contains issues you might encounter while installing, configuring, or managing any of the Oracle Fusion Middleware products on IBM WebSphere.
Be sure to review the product-specific release note chapters elsewhere in this document for any additional issues specific to the products you are using.
Note:This feature is not supported on Oracle Solaris on x86-64 (64-Bit).
This section describes general issue and workarounds. It includes the following topics:
When using the direct binding client APIs to invoke a SOA service deployed on IBM WebSphere Server, you receive the following exception:
Invocation Error with Direct Binding Client APIs on IBM WebSphere Server When using the direct binding client APIs to invoke a SOA service deployed on IBM WebSphere Server, you receive the following exception. java.lang.ClassCastException: Unable to load class: oracle.integration.platform.blocks.direct._Invoker_Stub at com.ibm.rmi.javax.rmi.PortableRemoteObject.narrow(PortableRemoteObject. java:37 2) at javax.rmi.PortableRemoteObject.narrow(PortableRemoteObject.java:137) at oracle.soa.api.JNDIDirectConnectionFactory.createConnection (JNDIDirectConnectionFactory.java:157) at InvokeCompositeNew.main(InvokeCompositeNew.java:76)
As a workaround, you must run the
createEJBStubs.sh script to generate the correct IBM WebSphere Server stub:
$WAS_HOME/bin/createEJBStubs.sh oracle.integration.platform.blocks.direct.Invoker -verbose -cp $GEN_CLASSPATH
where the value of
$GEN_CLASSPATH must include the following JAR files:
Business events are published to the Event Delivery Network (EDN). EDN provides support for delivering events to one-and-only-one subscribers, in which the event is sent to the subscriber in its own global (that is, JTA) transaction. However, one-and-only-one subscriptions are not supported when using EDN with IBM WebSphere Server.
As a workaround, change the one and only one consistency level of the event subscription to guaranteed in the Create Mediator dialog.
Note:This change downgrades the consistency level. Therefore, a system failure may cause an event to be delivered more than once because there is no global transaction. If the subscriber fails to process the event, the event is not resent.
When you attempt to start a deployed task form application in the IBM WebSphere Administration Console, it fails. You receive an error message similar to the following:
Was2Form failed to start. Check the logs for server dmgr on node DefaultCellManager01 for details. ErrorAn error occurred while starting Was2Form. Check the logs for server dmgr on node DefaultCellManager01 for more information.
As a workaround, perform the following steps:
Undeploy the task flow from the IBM WebSphere Administration Console. Save directly to the master configuration to synchronize changes to all nodes.
Deploy the EAR file generated in step 1 through the IBM WebSphere Administration Console.
Go to Websphere Enterprise Applications > Install > Pick EAR from Locale file system.
Click Next (use the default options).
On step 2 of the deploy page "Map modules to servers," select all modules, highlight only the SOA server (for example, soa_server1), and click Apply.
On step 3, "Map virtual hosts for Web modules," select the WAR file.
At the end, save directly to the master configuration again.
Select the EAR file to start it.
If you configure an Oracle SOA Suite cluster or single server environment on IBM WebSphere, you may receive an error when accessing Oracle BPM Worklist indicating that it is undefined. If you log in to IBM WebSphere Administration Console, and select Applications > WebSphere enterprise applications > worklistapp > Shared library references, and see that only one row (worklistapp) is displayed when two rows should display (worklistapp and worklist-was.war), you must perform the following steps.
Uninistall Oracle BPM Worklist (known as worklistapp in the IBM WebSphere Administration Console).
Re-install Oracle BPM Worklist.
To uninistall Oracle BPM Worklist:
Log in to the IBM WebSphere Administration Console.
From the panel on the left hand side, select Applications > Application Type > WebSphere enterprise applications.
Select the check box for worklistapp from the Enterprise Applications list.
Click the Stop button to stop worklistapp.
Select worklistapp again.
Click the Uninstall button, and click OK.
Select Review from the Save and Review options.
Select Synchronize changes with nodes, and click Save.
Wait until configuration synchronization is complete, then click OK.
Confirm that worklistapp is now removed (uninstalled) from Enterprise Applications.
To re-install Oracle BPM Worklist:
If not already there, navigate to Applications > Application Type > WebSphere enterprise applications.
Select the Remote file system option:
Click Browse > DefaultCellDepMgrNode.
Click the root directory (/), and go to your ORACLE_HOME.
Navigate to soa/applications.
Select worklist-was.ear, and click OK.
Select the default Fast Path, and click Next.
Select the installation options:
Change the name Oracle BPM Worklist to worklistapp, and click Next.
Map the modules to the servers:
Select the check boxes for the two modules (jar and war).
From the Clusters and servers list, select server=soa_server1 or the server or cluster on which Oracle SOA Suite is installed.
Confirm that the two modules now have the correct server value (for example, soa_server1) in the server column.
Map the virtual hosts for the web modules:
Select the one web module.
On the Summary screen, review the information, and click Finish.
Output displays on the screen, and you are prompted to save or review your local changes.
Save your workspace changes:
Click Synchronize changes with Nodes.
Verify that Total changed documents is 29 (if not, there may be an error).
Wait until configuration synchronization is complete, then click OK.
The worklistapp is now installed and ready to be started.
Verify that the worklistapp is present in the Enterprise Applications list.
Select worklistapp, and click Start.
Confirm that the Application Status is up.
Test that Oracle BPM Worklist in accessible by visiting the following URL:
The Dashboard tab of a SOA composite application in Oracle Enterprise Manager Fusion Middleware Control may show the state of an instance as running even though the instance has actually completed. In this scenario, verify the actual instance state on the Flow Trace page.
Two-way SSL configuration on IBM WebSphere is not supported. Therefore, there is no support for Oracle Web Service Manager (OWSM) two-way security policies that are SSL-configured. Note that one-way SSL is supported (for example, in which you create an SSL-configured SOA service that invokes another SOA service).
If you click Recover With Options on the Fault and Rejected Messages tab of a SOA composite application, and attempt to recover all faults by selecting Recover All in the Recover With Options dialog, the faults are not recovered and display as pending. The problem only occurs with the Recover With Options dialog. Individual instance recovery and selecting multiple instances for recovery works correctly.
If you install IBM WebSphere Application Server - Network Deployment (ND) for use with Oracle SOA Suite, you must restart the server for JCA adapter binding components to be active. Otherwise, JNDIs are not active, and you receive the following error message:
Non Recoverable System Fault : BINDING.JCA-12563 Exception occured when binding was invoked. Exception occured during invocation of JCA binding: "JCA Binding execute of Reference operation 'Write' failed due to: JCA Binding Component connection issue. JCA Binding Component is unable to create an outbound JCA (CCI) connection. File_MEDComposite:WriteMed [ Write_ptt::Write(body) ] : The JCA Binding Component was unable to establish an outbound JCA CCI connection due to the following issue: BINDING.JCA-12510 JCA Resource Adapter location error. . . . . . .
You cannot create test emulations involving asynchronous BPEL processes in a SOA composite application on IBM WebSphere. During test execution, this results in an
CannotInstantiateObjectException exception error.
When running Oracle AQ Technology Adapter cases on the Websphere Platform, you might encounter the following error:
javax.resource.spi.ResourceAllocationException: setManagedConnection: illegal state exception. State = STATE_ACTIVE_FREE MCW = 28392839
To follow-up on this exception, IBM PMR # 69026,756 has been created
When you deploy an application using Oracle Fusion Middleware on IBM WebSphere, you might receive the following runtime error:
oracle.fabric.common.PolicyEnforcementException: PolicySet Invalid: WSM-06102 PolicyReference The policy reference URI oracle/wss_username_token_service_policy is not valid
To workaround this issue, perform the following steps:
Open the policy-accessor-config.xml file, which can found at the following location:
Locate the policy-accessor properties and uncomment the following properties and set the value of each property as shown:
<property name="active.protocol"> remote </property> <property name="java.naming.provider.url"> corbaloc:iiop:hostname:rmi.port </property>
In this example, replace hostname and rmi.port to identify the host and RMI port where the policy manager is running.
No restart is required. By default, the new version of the
policy-accessor-config.xml is loaded every 10 mins. However, if you want to pick up the changes immediately, then you can restart the server.
When running Oracle Enterprise Manager Fusion Middleware Control on IBM WebSphere, you might experience errors if you attempt to stop or start the internal Oracle applications that are displayed under the Internal Applications folder in the target navigation pane.
The applications listed here are internal Oracle applications. You should not start or stop these applications from Fusion Middleware Control. If you must stop or start these applications, then start or stop the managed servers that host the internal applications.
This section describes configuration issues and their workarounds. It includes the following topics:
When you configure a SOA cluster on IBM WebSphere, you must configure Oracle Coherence with the host names and other required cluster properties.
For Oracle WebLogic Server environments, Oracle Coherence configuration information "Configuring Oracle Coherence for Deploying Composites" in the Oracle Fusion Middleware High Availability Guide.
When configuring a SOA Cluster on IBM WebSphere, you perform a similar set of tasks, using the following instructions that are specific to IBM WebSphere:
Login to the IBM WebSphere Administrative Console.
Navigate to the Java Virtual Machine Custom Properties page:
Servers > soa_server_name > Java and Process Management > Process Definition > Java Virtual Machine > Custom Properties
Add the following properties:
For a multicast cluster:
For a unicast cluster:
tangosol.coherence.wka1 (= host1) tangosol.coherence.wka2 (= host2) tangosol.coherence.localhost = (host?) tangosol.coherence.wka1.port tangosol.coherence.wka2.port tangosol.coherence.localport