SOA-INFRA startup issue

One of the issues which I got involved last week was more related to server administration. The client had a SOA11g environment with Weblogic 10.3.4, SOA 11.1.1.4 & AIA 11.1.1.4. The servers were running fine, but due to some environment issue the soa-infra crashed. As part of the admin process they restarted the SOA managed server. The SOA managed server in Weblogic came up but the soa-infra fails to start with the following error.

Error Snippet @server log

<Apr 21, 2011 12:10:10 AM PDT> <Error> <HTTP> <BEA-101216> <Servlet: "FabricInit" failed to preload on startup in Web application: "/soa-infra".

oracle.fabric.common.FabricException: Error in getting XML input stream: oramds:/deployed-composites/spe/GEOReqABCSImpl_rev1.0/SCA-INF/classes/META-INF/adf-config.xml: oracle.mds.exception.MDSException: MDS-00054: The file to be loaded oramds:/deployed-composites/spe/GEOReqABCSImpl_rev1.0/SCA-INF/classes/META-INF/adf-config.xml does not exist.

                at oracle.fabric.common.metadata.MetadataManagerImpl.getInputStreamFromAbsoluteURL(MetadataManagerImpl.java:280)

                at oracle.integration.platform.common.MDSMetadataManagerImpl.getInputStreamFromAbsoluteURL(MDSMetadataManagerImpl.java:555)

Analysis

 From the log files and stack trace it was pretty evident that one process was holding up the entire soa-infra. The composite process was having a reference to the MDS store and it was missing the adf-config file from the deployed composites folder. The adf-config file usually gets copied to SCA-INF classes folder during the compilation and packaging of the sar (service archive)file.

During deployment, a composite is targeted to a managed server which stores the composite meta-data in the MDS .During startup or on receiving the deployment notification a managed server loads the composite from the MDS.

Below picture gives you the order in which managed server manages soa-infra.

Since the issue is related to the single process, solution was to either provide the adf-config.xml  to the process or un-deploy the process . I am listing the easiest work around that is available so as to resolve the issue.

Workarounds

In 11g there is a deployed-composites.xml in MDS store which has entries related to the composite processes that are deployed to the current soa-infra.

1. Editing the deployed-composites.xml to remove entries of the composite which is causing the issue.

Since the GEOReqABCSImpl is preventing the soa-infra from starting up, remove the  entries  w.r.t GEOReqABCSImpl process from deployed-composites.xml, After that  you should be able to bring up soa-infra.  For similar issue,have a look at the this blog -- ReynoldsBlog

How to edit the deployed compsites.xml

You can export the whole of MDS from the EM console and then edit the appropriate content and import it back.
From the entry exporting the whole soa-infra MDS partition by using EM->SOA->soa-infra->Administration->MDS Configuration.  Exporting via EM is probably the easiest because it then prepares you to fix the problem later.

2.   2.  Use sca_undeployComposite in WLST to remove the composite which is causing the error.

How to use Wlst @ gettingStartedCustomWLSTCommands

This WLST command works in offline mode, so no need for soa-infra to be up and running for undeploying the processes, which makes it ideal option for resolving the issue.

Once you apply any of the above listed workaround, you can restart the managed server or bring up the soa-infra .The soa-infra will be up and running. Special thanks to Antony Reynolds who had helped us with this issue.

Using Jenkins for SOA Deployment Automation

  Last month, my client wanted me  to have a framework for automating the builds.Already the build scripts were in place. Because of the amount of changes/code fixes that different teams were checking in, the situation called for daily/frequent builds to be initiated.To make my customers job easy I was on the lookout for automating the deployments using a GUI automation tool. In my previous project we had used Cruise Control. After comparing different automation tools, I decided on Jenkins (Hudson) a more light weight easy to use tool and having strong support base.

To get started download Jenkins.war file from http://jenkins-ci.org/

There are 2 ways in which you can use Jenkins

1. Run Jenkins in Winstone servlet container

The easiest way to execute Jenkins is through the built in Winstone servlet container. You can execute Jenkins like this:

Set JAVA_HOME

Then run java -jar jenkins.war

Accessing Jenkins

To see Jenkins, simply bring up a web browser and go to URL http://myServer:8080 where myServer is the name of the system running Jenkins.

2. Deploy  Jenkins into Weblogic server

The Jenkins.war cannot be deployed to Weblogic server without some changes. These are necessary because of Weblogic's proprietary class loaders which behave differently compared to Tomcat, JBoss, et. al.

Refer the  steps @ https://wiki.jenkins-ci.org/display/JENKINS/Weblogic

 

Once the web app is up and running.

In Dashboard --> Create New Job 

Add steps to Execute shell scripts and build files

Once the build is initiated the log entries and progress of build can be monitored in the Console output.

If you ask me which automation tool to pick for your project my answer will be Jenkins.

B2B Callout - B2B runtime error: java.lang.IndexOutOfBoundsException

Recently I was approached with a B2B Callout error. The transaction fails with a Generic B2B error B2B-50029:  B2B runtime error: java.lang.IndexOutOfBoundsException.

Error Stack trace

[soa_server1] [ERROR] [] [oracle.soa.b2b.engine] Informational -:  B2B-50029:  B2B runtime error: java.lang.IndexOutOfBoundsException: Index: 0, Size: 0[[ at oracle.tip.b2b.callout.B2BCalloutHandler.handleOutgoingCallout(B2BCalloutHandler.java:498)    at oracle.tip.b2b.msgproc.Request.outgoingRequestPostColab(Request.java:1318)

            at oracle.tip.b2b.msgproc.Request.outgoingRequest(Request.java:841)

            at oracle.tip.b2b.engine.Engine.processOutgoingMessageImpl(Engine.java:1448)

            at oracle.tip.b2b.engine.Engine.processOutgoingMessage(Engine.java:801)

Issue

Looking at the error log, it was evident that the Callout java class was not populating the output list, which was causing the issue. When the B2B Outbound Handler tries to look up the output list it throws this java.lang.IndexOutOfBoundsException: Index: 0, Size: 0 excpetion.

After you play around with the message then you should be populating the output message before exiting the execute method.

           CalloutMessage cmOut = new CalloutMessage(s);

            output.add(cmOut);

Solution

The below code should fix the issue. We get the input, populate the output and return control back to B2B engine.

    public void execute(CalloutContext calloutContext, List input,

                        List output) throws CalloutDomainException,

                                            CalloutSystemException {

        b2blog(" Callout execute() called - Start");

        try {

            CalloutMessage cmIn = (CalloutMessage)input.get(0);

            String s = cmIn.getBodyAsString();

            b2blog((new StringBuilder()).append("Callout execute() - All Parameter = ").append(cmIn.getParameters()).toString());

            b2blog((new StringBuilder()).append("Callout execute() - CalloutMessage body = ").append(s).toString());

                //add logic of the task that needs to be done like archiving, manipulating the payload

           CalloutMessage cmOut = new CalloutMessage(s);

            output.add(cmOut);

            b2blog((new StringBuilder()).append("Callout execute() - End Callout Testing = "));

        } catch (Exception e) {

            // System.out.println("Exception: "+ e.printStackTrace())

            b2blog((new StringBuilder()).append("Callout execute() - Exception = ").append(e).toString());

            e.printStackTrace();

            throw new CalloutDomainException(e);

        }

    }

b2blog method call is explained in one of my previous blogs on B2B logging.

B2B routing messages to SOA Composite using Document Routing ID

One of the queries I recently got from my client was with regard to B2B engine routing messages to SOA Composite process. They had implemented routing with document definitions for 4010 and 4010V to different composites. They wanted to route both 4010 and 4010V messages to a single composite process.  What was the easiest way to implement these changes across processes and different trading partners?

I will list down the changes that need to be done

1. Add a common Routing ID for 4010 and 4010V document definitions.

1)      Login to B2B Console .Go to Administration -->Document

Document Protocols -->EDI_X12 --> 4010 -->850 -->GEO_850_def

And 4010VICS --> 850 -->GEO_850_def

2)      Update the Routing. Go to Routing sub tab

Document Routing ID -->GEO_850_Routing

2. In the composite.xml of the composite process update binding.b2b docRef value

Old Entry in composite.xml

<service name="Read850Msg" ui:wsdlLocation=" Read850Msg.wsdl">

    <interface.wsdl interface="http://www.oracle.com/integration/b2b/ Read850Msg /#wsdl.interface(B2B_receive_ptt)"/>

    <binding.b2b docRef="EDI_X12--4010--850--GEO_850_def"/>

  </service>

Modified entry  in composite.xml

<service name="Read850Msg" ui:wsdlLocation=" Read850Msg.wsdl">

    <interface.wsdl interface="http://www.oracle.com/integration/b2b/ Read850Msg /#wsdl.interface(B2B_receive_ptt)"/>

    <binding.b2b docRef="DOC_ROUTING_ID--GEO_850_Routing"/>

  </service>

a.    Deploy the process.

b.    Test the B2B with both 4010 and 4010V files/messages. It will get routed to the single composite process.

Note:- In case the files are not getting routed you will need to re-deploy the agreements for trading partners for which testing is being carried out.

getting started with custom commands in WLST @SOASuite11g

I was recently having a requirement to use WebLogic Scripting Tool because it gave a lot of flexibility to configure SOA composite applications. In WLST there was OFFLINE option for doing deployments and for Composite Application Management.

You can get  wlst commands  @ here

Some of the commands which I loved using are

1.    sca_deployComposite : Deploy a SOA composite application.

2.    sca_undeployComposite : Un deploy a SOA composite application.

3.    sca_startComposite : Start a previously stopped SOA composite application.

4.    sca_stopComposite :Stop a SOA composite application.

5.    sca_activateComposite : Activate a previously retired SOA composite application.

6.    sca_retireComposite : Retire a SOA composite application.

7.    sca_listDeployedComposites : List the deployed SOA composite applications.

Oracle SOA Suite, MDS, and services such as SSL and logging, supply custom WLST commands.

To use those custom commands, you must invoke the WLST script from the Oracle home. Do not use the WLST script in the WebLogic Server home.

The script is located at:

(UNIX) MIDDLEWARE_HOME/ORACLE_SOA1/common/bin/wlst.sh

(Windows) MIDDLEWARE_HOME\Oracle_SOA1\common\bin\wlst.cmd

In case you use the WLS tool from

 MIDDLEWARE_HOME\oracle_common\common\bin

Or  from

MIDDLEWARE_HOME \wlserver_10.3\common\bin

It will throw following error.

Traceback (innermost last):

  File "", 1,="" ?<="" in="" line="" span="">",>

NameError: sca_undeployComposite

To show the way, I will use  sca_undeployComposite command. For un-deploying composite processes using wlst while the soa-infra is offline use the following custom command.

>>  sca_undeployComposite

Syntax

sca_undeployComposite(serverURL, compositeName, revision, user, password)

Argument	Definition
serverURL	URL of the server that hosts the SOA Infrastructure application (for example, http://localhost:8001).
compositeName	Name of the SOA composite application.
Revision	Revision ID of the SOA composite application.
User	Optional. User name to access the composite deployer servlet when basic authentication is configured.
Password	Optional. Password to access the composite deployer servlet when basic authentication is configured.

How to use it

(UNIX) ORACLE_HOME/common/bin/wlst.sh

(Windows) ORACLE_HOME\common\bin\wlst.cmd

Initializing WebLogic Scripting Tool (WLST) ...

Welcome to WebLogic Server Administration Scripting Shell

Type help() for help on available commands

wls:/offline> connect()

Please enter your username [weblogic] :weblogic

Please enter your password [welcome1] :

Please enter your server URL [t3://localhost:7001] : t3://localhost:7001

Connecting to t3://localhost:7001 with userid weblogic ...

Successfully connected to Admin Server 'AdminServer' that belongs to domain 'soa_domain'.

wls:/soa_domain/serverConfig> sca_undeployComposite("http://localhost:8001","GeoComposite", "1.0","weblogic","weblogic123")

serverURL = http://localhost:8001

user = weblogic

partition = default

compositeName = GeoComposite

revision = 1.0

timeout= -1

set user and password...

compositeDN = default/GeoComposite!1.0

Creating HTTP connection to host:localhost, port:8001

Received HTTP response from the server, response code=200

---->Undeploying composite (default/GeoComposite!1.0) success.

That’s pretty much for the day. Happy Easter and a long weekend