deltalounge

Recently I engaged with a customer who experiences (among other problems) the following. Since there is hardly any info on Oracle Support or blogs I thought I’d share some info here:

WSIF JCA Execute of operation 'SomeService' failed due to: Unable to create control directory.
Unable to create control directory: "/mnt/queues/controldir/bpel/fileftp/controlFiles/epajYGFxPFPErSM8HcN8HQ==/outbound".
; nested exception is:
ORABPEL-11075
Unable to create control directory.
Unable to create control directory: "/mnt/queues/controldir/bpel/fileftp/controlFiles/epajYGFxPFPErSM8HcN8HQ==/outbound".
Please make sure that the directory name is valid and that there are adequate permissions to create the directory.


Solution

As the last part of the error message suggests, check for file system stuff:

1. Is the share and/or mount your file / ftp adapter is pointing to still available?
2. Can the share be reached from your SOA Server?
3. Does the directory name exist?
4. Are the required permissions available?

Correct inaccuracies.

Common Issues and Workarounds for File/FTP Adapter

There is an extensive document on solving issues with file and FTP adapters on Oracle support. The documentation for file and FTP adapters can be found:

1. 11g JCA File / FTP adapter
2. 10g File / FTP Adapter

Just uploaded the presentation I gave at the Seminar “Architecture and Governance”:

While doing some research on the web I came across a Service Component Architecture Diagram Generator. The script generates diagrams for applications based on the Service Component Architecture (SCA) model. This can be a great aid to understand the relations between components in large BPEL or SOA applications.

Download the tool here. The readme is over here. The script runs on Linux/Unix and has primarily been tested with Oracle Fusion Middleware 11g applications but should work with other BPEL or SOA frameworks.

On December 13th Whitehorses will host a seminar on SOA and Governance. During this seminar we will show the value of a proper architecture and governance for your organization. In the presentation you will get clear guidelines and steps on a pragmatic approach for implementing a manageable SOA solution.

Some of the topics:

• What is SOA Governance and Why do we need it?
• SOA reference architecture – The importance of solid standardization.
• Service life-cycle governance – Design and build the right services and the proper way to reuse them.
• Service repository – With examples of repositories based on Oracle Enterprise Repository (OER) and a wiki.

rsvp.

Recently McGraw Hill published the Oracle Business Process Management Suite 11g Handbook. It is available on their site and at Amazon.com.

Here is the table of contents with the links to the free chapters:

Part I: Introduction
1. BPM – Background
2. Standards in BPM
3. BPM Suite 11g – Overview

Part II: Mastering Oracle BPM 11g

4. Quick Learners Guide to Oracle BPM 11g
5. Business Process Modeling and Implementation using BPMN 2.0
6. Mastering Business Rules
7. Advanced Human Tasks
8. Developing Rich User Interfaces for BPM with ADF

Part III: Essentials of Oracle BPM Methodology

9. Planning a BPM Adoption
10. Strategic Analysis, Process Selection and Design
11. Technical Design and Project Delivery Strategies

After installing Oracle Enterprise Repository (OER) we experience some memory issues. Besides the messages in the log files, we also couldn’t use the console and em as we did before (when we were just running SOA Suite). It turned out the installation of OER in the same Weblogic domain resulted in some unexpected things.

The WebLogic Server and SOA Suite are started using the startWebLogic script (for windows .cmd and on Linux/Unix .sh). This script uses the setDomainEnv script to set the environment variable for the domain. The setDomainEnv script in turn calls the setSOADomainEnv that actually sets the USER_MEM_ARGS. That in the end are used in the startWebLogic script.

After the installation of OER the setDomainEnv not only calls the setSOADomainEnv. It also calls a script that sets the USER_MEM_ARGS for the oer_server in the domain. Apparently the memory required for OER is less than needed for the SOA Suite. Since the script for OER is executed last, memory setting remain low. As shown in the smippet taken from the setDomainEnv.cmd:

call "%WL_HOME%\common\bin\commEnv.cmd"
call "%DOMAIN_HOME%\bin\setSOADomainEnv.cmd"
call "%DOMAIN_HOME%\bin\setOERDomainEnv.cmd"

To solve the memory issue when starting the WebLogic Server using the startWebLogic script we alter the sequence so the setOERDomainEnv.cmd goes before the setSOADomainEnv.cmd.

If the installer put a second call to setSOADomainEnv.cmd in the setDomainEnv.cmd. That doesn’t work because the setSOADomainEnv.cmd contains the following check:

REM Skip running this script again if it was run once
if "%XENGINE_DIR%" == "" goto set_env
echo *********************************************************
echo ** SOA specific environment is already set. Skipping ...
goto end_set_env

.

This blog post will show you how to install Oracle Enterprise Repository, or OER in short. The assumptions is that you have a running WebLogic Server (with SOA Suite on top of it) and a database.

Prepare – database

The most important part of the preparation for the installation of Oracle Enterprise Repository is the creation of tablespaces and the user that will hold the database objects.
Create the required tablespaces
You can change the names of the tablespaces and alter the path and names of the data files according to your needs. The example is based on an installation on the Windows OS. If your on Linux/Unix you probably know what to do to make it work on your platform…

CREATE TABLESPACE OER_DATA
    DATAFILE 'D:\oracle\oraclexe\oradata\XE\oer_data.dbf' SIZE 300M
 AUTOEXTEND ON NEXT 10240K MAXSIZE UNLIMITED
    EXTENT MANAGEMENT LOCAL AUTOALLOCATE
    LOGGING
    ONLINE
    SEGMENT SPACE MANAGEMENT AUTO;
 
CREATE TABLESPACE OER_LOB
    DATAFILE 'D:\oracle\oraclexe\oradata\XE\oer_lob.dbf' SIZE 300M
 AUTOEXTEND ON NEXT 10240K MAXSIZE UNLIMITED
    EXTENT MANAGEMENT LOCAL AUTOALLOCATE
    LOGGING
    ONLINE
    SEGMENT SPACE MANAGEMENT AUTO;
 
CREATE TABLESPACE OER_INDEX
    DATAFILE 'D:\oracle\oraclexe\oradata\XE\oer_index.dbf' SIZE 300M
 AUTOEXTEND ON NEXT 5120K MAXSIZE UNLIMITED
    EXTENT MANAGEMENT LOCAL AUTOALLOCATE
    LOGGING
    ONLINE
    SEGMENT SPACE MANAGEMENT AUTO;

Create the user
Change the user name and password (both OER in this case) to cater your needs.

CREATE USER OER IDENTIFIED BY OER
DEFAULT TABLESPACE OER_DATA
    TEMPORARY TABLESPACE TEMP;
 
GRANT CREATE MATERIALIZED VIEW TO OER;
GRANT CREATE SEQUENCE TO OER;
GRANT CREATE SESSION TO OER;
GRANT CREATE SYNONYM TO OER;
GRANT CREATE TABLE TO OER;
GRANT CREATE TRIGGER TO OER;
GRANT CREATE VIEW TO OER;
GRANT UNLIMITED TABLESPACE TO OER;

Install OER

Us the follwing command from a dos prompt to start the OER installation. By default it will start in graphical mode. You can use the -mode option to start it in console or silent mode.

java -jar OER111150_generic.jar -log=C:\installSOA\logs\OER_install.log

[Show as slideshow]

Run WebLogic Server Domain Configuration Wizard

To run the Domain Configuration Wizard on Windows you can click: Start > Programs > Oracle Products > Tools > Configuration Wizard. On any platform you can run the config script in the /common/bin/config.cmd. For example:

> cd oracle\Middleware\wlserver_10.3\common\bin
> config.cmd

[Show as slideshow]

Post Install actions

To use all options in the Repository you need to install Java Web Start. To check whether Java Web Start is installed correctly use the test Java link.

In case the JNLP stuff (needed for java Web Start) doesn’t work. This Firefox JNLP fix might help you (via Andreas).

Just found out that there is a new site for SOA Suite 11g sample code. It is availble on Java.Net. Check it out for great examples.

There are always quite some blog posts on installing SOA Suite on several platforms. Recently I discovered that Oracle publishes a Quick Start Guide on the SOA Suite (PDF!) that mainly deals with the installation process (and de-installation should you need it).

This guide is aimed at installations for developers and not for production machines. Unfortunately the installation of OSB is out of scope. I expect it to be upgraded to PS4 (11.1.1.5) soon. I could find any missing instructions while installing PS4 on a Windows7 VirtualBox.

This document looks very similar to the installation chapter in Getting Started with Oracle SOA Suite 11g R1.

Update

It was confirmed by Simone Geib, Product Manager in the Oracle SOA team, that both the OSB part and the PS4 update are coming soon.

Update September

The update for SOA Suite PS4 (11.1.1.5) including Oracle Service Bus is now available.

During the Kscope Thursday Thunder a team of highly skilled ADF (including JHeadstart) and SOA Suite experts is building an application based on these technologies. Although this session – like any real world project – seemed chaotic at times, there were a lot of best practices to learn for all who attended.

We could have learned all of the tips and tricks in a normal session or presentation. However by working this way there is a much stronger feel of how technologies and tools are used in a real world project. It was fun to watch and learn and I think the team had a great time as well!

At the en of the session the End-to-End flow worked really well. Great work in just a few hours time!