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

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.

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.

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

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

.

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).

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.

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!