Tag Archives: WLS

Configure BPM engine to publish to BAM

By default the Oracle BPM engine (Business Process Management) is configured so it won’t publish events to BAM (Business Activity Management). So should you choose to use BAM and use these great dashboards, you have set the DisableActions property to false/empty. Here is how it works to configure BPM to BAM:

  • Log in to the Fusion Middleware Control – http://bpm-host:7001/em
  • Navigate through the Farm – WebLogic Domain – select the domain and then select the Server in which BPM is running (soa_server1 in a default install)
  • Use the WebLogic Server dropdown menu as shown in the first screenshot
  • Select the System Mbean browser in the menu
  • Expand the folder ans shown in the second screenshot: Application Defined MBeans - oracle.as.soainfra.config - BMNNConfig - bpmn
  • Find the DisableActions property and remove it’s value
  • Apply the changes

BPM Suite configure BAM Adapter

To have the BPM server push events to BAM – Business Activity Monitoring – we have to configure the BPM suite to use the BAM Adapter. The BAM Adapter is configured (like other SOA Suite and BPM Adapters) in the WebLogic Server Console.

Configure BAM Adapter

  • In the WLS Console, locate the Domain structure and select Deployments.
  • In the Deployments table that is shown, search and click the OracleBAMAdapter (you could filter on type Resource Adapter)
  • As shown in the first screenshot: Select the Configuration tab and within that the Outbound Connection Pools tab
  • Drill down on the oracle.bam.adapter.adc.soap.SOAPConnectionFactory to eis/bam/soap
  • In the properties tab: fill in the details of the connection to the BAM Server (depending on how you installed it). Remember to acknowledge the changes of each field using the enter key (leaving a field without using the enter key and changes will be lost)
  • Save
  • First time you alter the BAM Adapter you have to create a Deployment Plan. Select the Path to the deployment plan and Save
  • Since you need to update the Adapetr now, select it and chose Update
  • Choose the option Update this application in place with the new deployment plan changes and click Finish.

JDeveloper 11g with BPM Studio extension

To create Oracle BPM processess with JDeveloper you need to install the BPM Studio extension. This is similar to installing the SOA Suite extension.

Ensure that the desired version of JDeveloper is installed. You can download JDeveloper here. Should you be unsure on how to install JDeveloper check the SOA Suite quick start guide to guide you.

Install JDeveloper BPM Studio extension

Install JDeveloper in a seperate Middleware Home. When starting JDeveloper choose the “Default” role. To enable JDeveloper to perform development for the SOA Suite and develop and deploy SCA composites you have to install an extension called SOA Composite Editor. When you want to develop BPM processess you need to install BPM Studio extension following these steps:

  • Select Help > Check for Updates
  • Click Next
  • Select Oracle Fusion Middleware Products and Official Oracle Extensions and Updates and click Next
  • Select Oracle SOA Composite Editor and Oracle BPM Studio 11g and click Next
  • Check the update has finished and click finished
  • Restart JDeveloper and you’re good to go

JDeveloper BPM Studio extensionShould you choose to install these extensions from a local file make shure you have the correct version for your JDeveloper and SOA Suite install. You can find these extensions in the JDeveloper Update Center. There is also a JDev extensions blog.

How to VirtualBox overview

VirtualBoxIn this post we’ll share some VirtualBox resources that will help you to use Oracle virtualization product VirtualBox.

Installing an Operating System in VirtualBox

There are several great blog post on how to install an Operating System (OS) in VirtualBox. The install Ubuntu 11.04 in VirtualBox not only offers a good step by step guide to install Ubuntu (also check the more recent Ubuntu 12.04 ) , the steps also provide great insights when you want to install other operating systems. It is fairly easy to get from there to installing Windows8 in VirtualBox.

VirtualBox appliances and extending them

There are several great VirtualBox Appliances for Developers. Oracle offers for example both an appliance to test drive SOA Suite 11g and BPM 11g and a very recent appliance running WebLogic Server 12c , including a bunch of Java tools (including NetBeans, OEPE, Subversion, Hudson, Maven).

These VirtualBox Appliances can easily be extended for example with Oracle OSB as described in installing OSB on SOA Suite 11g appliance and extend SOA Suite appliance with Oracle Service Bus. The latter showing you how to extend the SOA domain and the first how to install OSB in a seperate domain.

Dealing with real world problems using VirtualBox

There a several examples on the web. I’d like to share three of them. The first shows you how to create a duplicate disk for use in an additional virtual machine. The second shows you how to update a Vagrant box.

On the side: Vagrant uses Oracle’s VirtualBox to build configurable, lightweight, and portable virtual machines dynamically. It uses Chef or Puppet to provision them. Vagrant is used so other developers can get up and running in just a couple commands.

The third shows you how we solved VBOX_E_FILE_ERROR (0x80BB0004) :
VBoxManage.exe: error: Code VBOX_E_FILE_ERROR (0x80BB0004) – File not accessible or erroneous file contents (extended info not available)

Or how to solve VirtualBox VERR_VMX_MSR_LOCKED_OR_DISABLED (0x80004005)
Failed to open a session for the virtual machine Ubuntu 12.10.
VT-x features locked or unavailable in MSR. (VERR_VMX_MSR_LOCKED_OR_DISABLED).

Since Virtual Machines can be quite demanding for resources on your PC or laptop: Here are some hints to increase appliance performance in VirtualBox.

Have Fun!

Fusion Middleware supported on JDK7

JDK7Trying to keep up with Java versions that are supported for JDeveloper and SOA Suite, like in JDeveloper now supports 64 bit Windows and Java. Redstack pointed me to the OFM supported systems configurations that show that Fusion Middleware is supported on JDK7. The XLS showing certification with OS etc can be found:

VirtualBox Appliance for WLS development with Eclipse, Maven, and Hudson

With the Oracle Technet Virtual Developer Day coming up a great VirtualBox appliance came available. The developer day focusses on developing Java EE6 applications and Oracle WebLogic Suite 12c.

WebLogic Server 12.1.1 VirtualBox Appliance

The virtual machine contains:

  • Oracle Linux 5, JDK 1.6 +
  • Oracle WebLogic Server 12.1.1
  • Oracle Coherence 3.7
  • Oracle TopLink 12.1.1
  • Hudson 2.2
  • Subversion 1.4.2
  • Apache Maven 3.0.1
  • NetBeans IDE 7.1 RC2
  • Oracle Enterprise Pack for Eclipse 12.1.1 / Eclipse 3.7
  • Easter Egg: Introductory Labs for Oracle Coherence 3.7

All details on download and importing the appliance can be found on the VirtualBox instructions page. No need to say that the appliance has been released for development and testing purposes.

Labs

The image contains four Labs:

  • Total Oracle WebLogic Server Development with Eclipse, Maven, and Hudson
  • Hands on with an end-to-end Java EE6 Application
  • A Step-By-Step Guide to Oracle Coherence
  • Running the Coherence Examples Project in Eclipse

These can be found in the /home/oracle/labs/ directory. Web links to these Labs can be found here.

Oracle WebLogic Server 12c (12.1.1) available

WLS 12cOracle WebLogic Server 12c (12.1.1) is available for download. The main themes of the new release are according to Oracle:

  • Java EE 6 and Developer Productivity
  • Simplified Deployment and Management with Virtualization
  • Integrated Traffic Management
  • Enhanced Availability and Disaster Recovery
  • Much Higher Performance
  • Seamless Upgrade

WebLogic Server 12 is available as installer or ZIP distribution. Download WebLogic Server 12c. Other useful links:

Oracle Enterprise Pack for Eclipse (12.1.1) available

Shortly after WLS 12c Oracle also has released OEPE 12.1.1 – Oracle Enterprise Pack for Eclipse. It is certified on Windows 7/XP/Vista, MacOS, and Linux. OEPE is supported on JDK 6.

Update: WebLogic 12.1.1 VirtualBox Appliance available

With OTN Virtual Developer Day a WebLogic 12c VirtualBox appliance became available. On the appliance there are Labs and other Java development tools like: Hudson, Subversion, Maven, NetBeans IDE, and Eclipse (including OEPE).

Update: Updated/Patched WebLogic 12.1.1.0 distribution available

Just read Markus Eiseles blog on an updated WebLogic Server 12c on OTN. If you obtain the updated product distribution for WebLogic Server 12.1.1 after March 16, 2012, the patches are included. If you obtained a product distribution for WebLogic Server 12.1.1 prior to March 16, 2012, and you do not wish to re-install with the updated WebLogic Server distribution, you can obtain the patches from Oracle Support.

Memory issues after installing OER

OER assetsAfter 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

.

Installing Oracle Enterprise Repository

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

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

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

SOA Suite Installation Quick Start

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.