Monday, March 30, 2009

Installing Oracle SOA Suite 10.3.1

We at MagicLamp Software have been working on two SOA related projects for one of our largest clients. We are using Oracles SOA Suite 10.3.4 for this project, so this entry will explain how to properly install Oracle SOA Suite 10.3.1 and the following entry will explain how to properly apply the patch from 10.3.1 to 10.3.4.

  • To begin download the Oracle SOA Suite 10.1.3.X from (http://www.oracle.com/technology/software/tech/soa/index.html). We have installed this product on both Windows XP and Linux.
  • Once downloaded, unzip the archive to a temp folder.
  • Before installing you will require a database to hold your ESB / BPEL / WSM artifacts for this we have used Oracle XE. Oracle XE for Windows can be downloaded from here (http://www.oracle.com/technology/software/products/database/xe/index.html). If installing Oracle XE on Ubuntu Linux read (http://www.oracle.com/technology/tech/linux/install/xe-on-kubuntu.html) to find out how to perform the install using apt-get.
  • Once your Oracle XE Database is installed bring up the APEX console by typing the following command in a web browser (http://localhost:8080/apex). Sign in using your system account and click on the following images, Administration / Database Users.
  • From here you are going to create three new user accounts (ORABPEL, ORAESB, ORAWSM), also ensure that as you create these accounts, each user should have the CONNECT, RESOURCE and DBA Roles checked.
  • Next, using SQL Developer or SQLPlus run the following commands as the system user
alter system set sessions=250 scope=spfile;
alter system set processes=200 scope=spfile;
commit;

  • Before going any further please ensure that you have the two following environment variables set ORACLE_HOME (Which points to the home folder of your Oracle XE database) and JAVA_HOME (Which points to the home folder of your installed Java Virtual Machine).
  • The next step is to run a program called irca. Irca will populate the schema for the SOA Suite. As irca runs it will look for your ORACLE_HOME setting, it will look for your JAVA_HOME setting and lastly will ask for your database connection settings host port and sid. These values should be localhost 1521 and XE. Once connected the script will then start asking for the user name and password for schema's that were created above.
  • To run irca navigate to the following folder (/install/soa_schemas/irca). From here you will want to run icra.sh for Linux or irca.bat for windows. Follow the prompts accordingly.
  • Once completed your ORABPEL, ORAESB, ORAWSM schema should now be populated. Now you are ready to run the SAO Suite Installer.
  • To run the SOA Suite 10.3.1 Installer navigate to this folder /install. For windows execute the 'runinstaller.bat' file. For Linux execute the following command ./runInstaller.sh -ignoresysprereqs, this will allow you to install on another version of Linux.
  • From here you will simply navigate through the prompts, we suggest advanced setup and try not to change the ports if possible the default port should be 8888 and along the way you will need to supply the user names and passwords for the schemas created above. In addition you will need to supply the username and password for the Oracle system user. This is so that the configuration tool can install the HR Schema used in all of the tutorials supplied.
  • Once the installer completes, the configuration tool will automatically begin. Allow this step to complete and then the entire install should be finished.
  • To start the SAO Suite in windows (Start, All Programs, Oracle ESB, Start Server). In Linux from a command prompt type (//product/10.1.3.1/OracleAS_1/opmn/bin/opmnctl startall).
  • To Stop the SOA Suite in Windows (Start, All Programs, Oracle ESB, Stop Server). In Linux from a command prompt type (//product/10.1.3.1/OracleAS_1/opmn/bin/opmnctl stopall).
  • What you will see. Once the server has been started launch a web browser and type http://localhost:8888/em (Enterprise Manager) you should see JDBC resources / Data Sources and Connection Pools created. Then navigate to the ESB Consule http://localhost:8888/esb (Enterprise Service Bus Console) you should see an entry called Default.

Sunday, March 15, 2009

Welcome to the MagicLamp Corner

Hi there and welcome,

This blog will be maintained and visited frequently by the staff of MagicLamp Software. The goal of this blog is to provide answers to various technical issues as they arise in our everyday consulting world and share them with others.