Oracle SOA suite Packaging

In this post we will go through some basic steps to automate the daily tasks i.e. compilation and deployment of SOA projects.

In order to deploy the SOA projects on server we usually follow below two approaches:
1. Compile and Deploy using JDEV
2. Compile and Export the SAR using JDEV. Deploy using EM console.

The above is adopted in development phase. In testing and production we need to automate this deployment activities in order to avoid any human error. SOA suite provide us the ANT scripts to perform this tasks.
This same scripts are used by JDEV to perform the task like deploy/compile etc.

We will now go show the steps to use some basic commands:
I am using Oracle SOA 12c environment.

Pre-requisites:
Configure the ANT_HOME, JAVA_HOME and PATH variables.  
1.    ANT_HOME = (MIDDLEWARE_HOME)\Middleware\Oracle_Home\oracle_common\modules\org.apache.ant_1.9.2.    PATH=%PATH%;(MIDDLEWARE_HOME)\Middleware\Oracle_Home\oracle_common\modules\org.apache.ant_1.9.2\bin
3.    JAVA_HOME=C:\Program Files\Java\jdk1.7.0_71


The SOA build scripts files can be found under (Middlewarehome)\Middleware\Oracle_Home\soa\bin


1.      Compiling the SOA project: ant-sca-compile.xml
This script is used to compile the SOA project. It takes composite.xml path and the output file path. This compilation output is written to output file in XML format.

ant -buildfile ant-sca-compile.xml -Dscac.input=C:\JDeveloper\mywork\SOA_Learning\Flow\SOA\composite.xml -Dscac.output=D:\tmp\SOA\compileoutput.txt
               
2. Generate .SAR file as .JAR: ant-sca-package.xml
This script is used to deploy the SOA project as .SAR called .JAR file.

ant -buildfile ant-sca-package.xml -DcompositeDir=C:\JDeveloper\mywork\SOA_Learning\Flow\SOA -DcompositeName=Flow -Drevision=1.2
3. Deploy to SOA Server: ant-sca-deploy.xml
This script is used to deploy the generated .JAR to SOA Server. We can set the configuration plan based on the environment on which we are deploying i.e. DEV/UAT/PROD
We can use the same script to perform following  activities i.e. undeploy/ exportComposite/ exportUpdates/ importUpdates/ exportSharedData/ undeployRetiredComposites

ant -buildfile ant-sca-deploy.xml -DserverURL=http://localhost:7101 -DsarLocation=C:\JDeveloper\mywork\SOA_Learning\Flow\SOA\deploy\sca_Flow_rev1.1.jar -Doverwrite=true -Duser=weblogic -Dpassword=welcome1 -DforceDefault=true -DkeepInstancesOnRedeploy=false -DregenerateRuleBase=true -Dconfigplan=C:\JDeveloper\mywork\SOA_Learning\Flow\Flow_cfgplan.xml -DfailOnError=true

The above commands can be configured with Hudson to implement continuous integration.

Popular posts from this blog

JAVA embedding in Oracle SOA 12c

Image
In this post we will explore how to EMBED Java or call Java API from Oracle SOA BPEL process. In order to demonstrated this, I have created a simple JAVA project with 3 classes. 1.        Account.java -> This class represent Account DTO       2.       Party.java -> This class represent a party (customer) DTO       3.       GetNumber.java -> This class contains the method that takes Party DTO as input and apply some business logic and return party’s AccountDTO in response. public Account getNumber(Party party) The above classes are created to simulate the calling of actual business logic API’s. Account.java Party.java GetNumber.java public class Account {     public Account() {         super();     }     String account;     public v...
Read more

API Design First approach: Implementing quick mock API's using swagger hub and postman

Image
Consider a scenario, where you as a API developer been ask to to implement the API's for a new mobile/web application team. The requirement is to implement a application to allow users to manage orders.         Mobile APP -> API infra->Backend enterprise system While implement a full working API might take days, you also do not want the application team to wait till the API's are ready. Thus, in most case we end up implementing the mock API's with sample scenarios. In this post, we will define an API using swagger openapi 3.0 yaml specification in swaggerhub. We will then use the definition to implement mock API's in postman. Even though postman provide option to define the API's, i liked swagger hub much better, it allow you to view your API on right side.  For this post I implemented API definition in swagger, please find the below link. https://app.swaggerhub.com/apis-docs/lopesrohan1988/ordermanagement/1.0.0 API Definition can be found at below link: h...
Read more

Passing/Receiving HTTP header in SOA BPEL

Image
In this example we will explore how to pass or receive the parameters from HTTP header. We will explore below two scenarios, To receive the HTTP header from SOAP request. To pass the HTTP header while calling soap service. SOA version used: 12.1.3c To receive the HTTP header from SOAP request: First we need to add the property “oracle.webservices.http.headers” under binding.ws in Service element in composite.xml. This property contains the comma separated parameters that we are expecting in request. Example,  ENV,VERSION. <binding.ws port="http://xmlns.oracle.com/SOA_Learning/HTTPHeader/HTTPHeaderTest#wsdl.endpoint(httpheadertest_client_ep/HTTPHeaderTest_pt)">          <property name="oracle.webservices.http.headers">ENV,VERSION</property> </binding.ws> Now in BPEL source under receive activity, we need add <fromProperties> element which will copy the parameters from HTTP heade...
Read more