Tuesday, 21 January 2014

Oracle SOA 11g - Extending an existing Weblogic domain (containing SOA Server) with OSB

In this post, lets walk through the steps of extending an existing SOA Suite 11g domain (that doesn't have OSB server), with an OSB server. 

SOA 11g Version 11.1.1.7 on Windows 7 has been used for this illustration.


Prerequisites

The following installation needs to be ready to walk through this. Covering the details of installation are outside the scope of this blog. 


  • Weblogic Server 11.1.1.6
  • SOA Suite 11.1.1.6
  • JDeveloper 11.1.1.6
  • OEPE 11.1.1.8 (OEPE Indigo : for compatibility with OSB 11.1.1.6)
  • OSB 11.1.1.6
***************Similarly for 11.1.1.7 ******************
  • Weblogic Server 11.1.1.6
  • SOA Suite 11.1.1.7
  • JDeveloper 11.1.1.7
  • OEPE 11.1.1.8 (OEPE Indigo : for compatibility with OSB 11.1.1.7)
  • OSB 11.1.1.7
**************************************************
All the above are preferably to be installed in a single MIDDLEWARE HOME, which in this case isD:\MWHomes\fmw-11117 going forward will be referred as $MIDDLWARE-HOME

Below is a picture of my installation (I have installation OEPE elsewhere for a different reason, however, it is preferable to install it inside the same middleware home.)




Besides installation, we need to have a domain with SOA Server configured, so that, we can extend that domain with OSB server. I have fmw_domain1 or mydomain created for this, with SOA server and BAM server in it, and both these servers are configured as managed servers and not merged with AdminServer. 

For detailed steps of creating a SOA 11g Weblogic domain, pl refer to the blog " http://subbus.blogspot.in/2014/01/soa-11g-creating-weblogic-domain-with.html "


Extending existing Weblogic domain with OSB


Run the domain configuration Utility (located at $MIDDLWARE-HOME\oracle_common\common\bin\config.cmd, OR alterntively at, $MIDDLEWARE-HOME\wlserver_10.3\common\bin\config.cmd)

In the first screen, choose "Extend an existing Weblogic Domain"


And, then on the next screen choose the particular domain to be extended by navigating through folder structure, in this case fmw_domain1



In the next screen, choose the products OSB and OSB OWSM extension. (Note - if OSB for developers is choosen, then OSB functionality will be merged with AdminServer and it will not be avaialble as an exclusive managed server). Dependency products gets selected automatically.



In the next screen provide schema info. 
Note - the prefix of schema has been changed to DEV (in my case I have given DEV3 for the existing domain) -irrespective of what was given earlier while running the RCU. Pl update this first before progressing further.

Except two component schemas, -OWSM MDS Schema and OSB JMS Reporting provider, all are configuration of existing domain. Even for these two components also, they are using existing schemas DEV3_MDS andDEV3_SOAINFRA. (No new schemas need to be created, and hence no need to run RCU for this extension of domain.)

Note - modify OSB JMS Reporting Provider configuration, by changing the DB and driver info. Its default would be 'derby', and I am changing this here to 'Oracle' and so is the driver change.



In the next screen while choosing optional configuration, select 'Managed Servers, Clusters and Machines' 




In the next screen, configure OSB server by providing appropriate port for it, and other details. In this case, I have provided 10001 as the port # for OSB.



Skip the clusters configuration in the next page, and move to machine configuration. Keep the machine configuration as-is (We are still running on the same local machine, and running in a single node environment)

In the next page, assign OSB server to the local machine where all other servers are already assigned in the existing server configuration.



In the next screen, verify the deployment summary, and 'Extend' the domain.


Verify the domain configuration


After configuring the domain, verify the domain configuration. Deploy sample service(s) and test them.

SOA 11g - Creating Weblogic domain with SOA Server and BAM

In this post, lets walk through the steps of creating a Weblogic domain with SOA Server and BAM server. I have used SOA version 11.1.1.6 for illustration.


1. Prerequisites

The following installation needs to be ready to walk through this. This post only discusses the domation creation, but not product installations.


  • Weblogic Server 11.1.1.6
  • SOA Suite 11.1.1.6
  • JDeveloper 11.1.1.6
*************Similarly for 11.1.1.7 ******************
  • Weblogic Server 11.1.1.6 (wls1036_generic)
  • SOA Suite 11.1.1.7
  • JDeveloper 11.1.1.7
*************************************************

All the above are preferrably to be installed in a single MIDDLEWARE HOME, which in this case is D:\MWHomes\fmw-11116

Below is a picture of my installation (I have also installed OSB, but not required for this, you can ignore for this post).




In the session below lets walk through creating Weblogic domain.


2. Creating a Weblogic domain with Admin Server, SOA Server, BAM Server


Here are the steps in creating domain, and are elaborated further. 

  • Run RCU and create Schemas needed for the use of SOA Suite
  • Run configuration Wizard for creating domain using the above schemas
  • Verify the configured domain, and sample run AdminServer, managed servers

Note - In this blog we are configuring SOA server and BAM server in managed server mode exclusively and not merging with AdminServer. However, for development simplicity one may want to choose to merge them with AdminServer -especically when trying on a low hardware configuration machines.

2.1. Run RCU


run RCU to create repository / schemas for Weblogic domain for SOA server and BAM server only. Steps included are illustrated in the snap shots below:

Oracle XE 11g is used for this exercise, and that was running on localhost in this case.




Choose the components that are needed. In this case, 'SOA Infrastructure', and 'UMS' and 'BAM' are needed. 

Notice that 'Metadata Services(MDS)' gets selected automatically as part of dependency resolution.



Provide password with which these schemas are to be created



Schemas get created in the provided DB (Oracle 11g XE in this case) as follows:









2.2. Domain Configuration Wizard


After RCU creation, create Weblogic Domain by running configuration wizard as follows:

In the domain config wizard, choose the following:

  • Oracle SOA Suite
  • Oracle Enterprise Manager
  • Oracle BAM 




Note - if 'Oracle SOA Suite for developers' is chosen  then the configuration wouldn't provide an exclusive soa_server1 managed server, instead all the soa_server1 functionality will be part of AdminServer only. Sometimes, that would be simple configuration for development reasons - eg: No need of node manager, and one less JVM to run on the machine, etc.

Name the domain. 



Provide the domain Admin credentials - in this case weblogic / welcome1 were given.


Chosen the development mode and JDK



Provide the schema details that are created during the earlier step of 'running RCU'



Schema access gets validated



Select the optional configuration for "Managed Servers, Clusters and Machines" - this is for configuration of SOA and BAM managed servers.



Depending our configuration choices in the initial steps of domain creation, we  will get two servers displayed in the next step soa_sever1 and bam_server1. 

Provide appropriate port numbers for these servers to listen to. We have are doing a simple managed server configuration without clusters. Configuring soa_server1 on port 8001 and bam_server1 on port 9001 to listen to.



Skip the cluster configuration step.

For the machines configuration, select "All local machines"



Next, Move all servers under the local machine



Here is how the deployment summary looks like:




2.3. Verify the configured domain, and sample run servers


Start the Weblogic AdminServer

$MIDDLEWARE-HOME\user_projects\domains\fmw_domain1\bin\startWeblogic.cmd

Start the node manager

First set the node manager properties as follows:

$MIDDLEWARE-HOME\oracle_common\common\bin\setNMProps.cmd

and then run node manager as follows:

$MIDDLEWARE-HOME\wlserver_10.3\server\bin\startNodeManager.cmd

Start soa_server1

Now that node manager has been started, from the Weblogic server console, start soa_server1 

Alternatively, soa_server1 can be started from command prompt without the help of node manager as follows:

$MIDDLEWARE-HOME\user_projects\domains\fmw_domain1\bin\startManagedWeblogic.cmd


Deploy sample composites and test them.

Monday, 20 January 2014

OSB 11g Installation in Windows 7

Here are the steps for someone who wants to install Oracle Service Bus in a Windows 7 machine. Entire installation process can be divided into 6 major steps. In my next post I will share detailed screen shoots of each steps.
  • Installing Java – JDK is only required to run the generic .jar file. If you already have a JDK installed onto your system, you may skip this step.
  • Installing Weblogic Server – This is a simple step run java –jar wls1036_generic.jarcommand and follow the installation screen.
  • Downloading Oracle Enterprise Pack Eclipse (OEPE) – http://www.oracle.com/technetwork/developer-tools/eclipse/downloads/oepe-11118-521475.html                This step can be bit confusing. Unlike its 32bit its 64 bit counterpart DOES NOT shipped with OEPE (Oracle Enterprise Pack Eclipse). One needs to download the right version of OEPE without this step one cannot use the OSB IDE. Still they can develop most of the OSB components using web console a.k.a sbconcole or Service Bus console. Below table will give you a good idea about the different version compatibility
OSB Version
Weblogic Version
OEPE Version
11.1.1.6.0
10.3.6
11.1.1.8.0 (OEPE Indigo)
11.1.1.5.0
10.3.5
11.1.1.7.2 (OEPE-Helios)
11.1.1.4.0
10.3.4
11.1.1.6.1 (OEPE-galileo)
11.1.1.3.0
10.3.3
11.1.1.5
After download correct version of OEPE , unzip the jar and place it under the same folder where you have installed your weblogic server (a.k.a Oracle Home). Make sure to trim the folder name.
  • Running RCU (Repository Creation Utility) – This utility is required IF AND ONLY IF you want to install MDS, which will be needed for installing OWSM (Oracle Web Service Manager).
  • Installing Oracle SOA Suite 11g – This step is needed for installing OWSM and its extension for OSB.
  • Installing Oracle Services Bus 11g – Main installer run without much of trouble, if above steps are properly executed.