Release Notes

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

New and Changed Features in Oracle CEP 10.3

The following sections describe the new and changed features in Oracle CEP 10.3:


New Features in Oracle CEP 10.3

Version 10.3 of Oracle CEP includes the following new features:

Multi-Servers and Clustering

You can now configure multiple servers in an Oracle CEP domain, and cluster them together to achieve high availability.

See Configuring and Using Oracle Complex Event Processing Clusters.


Oracle CEP applications can optionally publish or consume events to and from a cache to increase the availability of the events and increase the performance of their applications. A cache is a temporary storage area for events, created exclusively to improve the overall performance of your application; it is not necessary for the application to function correctly.

See Using Oracle CEP Caching.

Record and Playback of Events

The event repository feature of Oracle CEP allows you to record events flowing through an event processing network (EPN) and store them so you can later play back the events. The event repository is configured per stage, such as a processor or stream.

See Record and Play Back Events Flowing Through an EPN in the Visualizer Online Help document.

Visualizer Administration Console

Oracle CEP Visualizer, henceforth called Visualizer for simplicity, is a Web 2.0 application that consumes data from Oracle CEP, displays it in a useful and intuitive way to system administrators and operators, and, for specificied tasks, accepts data that is then passed back to Oracle CEP so as to change it configuration.

See Overview of Visualizer.

HTTP Publish-Subscribe Adapter

An HTTP Publish-Subscribe Server is a mechanism whereby Web clients, such as browser-based clients, subscribe to channels, receive messages as they become available, and publish messages to these channels, all using asynchronous messages over HTTP. Every instance of Oracle CEP includes a pub-sub server that programmers can use to implement HTTP publish-subscribe functionality in their applications.

See Using and Creating HTTP Publish-Subscribe Adapters.

JMS Adapter

Oracle CEP provides both inbound and outbound JMS adapters that you can use in your event applications to send and receive messages to and from a JMS queue, respectively, without writing any Java code.

See Using JMS Adapters.

Configuration Wizard for Creating Domains

The Configuration Wizard is a new tool for creating Oracle CEP domains.

See Creating a Domain Using the Configuration Wizard.

Event Processing Language (EPL) New Features

The event processing language (EPL) has the following new features:

Security New Features

Oracle CEP provides a variety of mechanisms to protect server resources such as data and event streams, configuration, username and password data, security policy information, remote credentials, and network traffic.

Oracle CEP supports various security providers for authentication, authorization, role mapping, and credential mapping. As initially installed, Oracle CEP is configured to use the file-based providers for both authentication and authorization. You can also configure the system to use an LDAP or DBMS provider.

For details, see Configuring Security for Oracle CEP.


Changed and Deprecated Features in Oracle CEP 10.3

Version 10.3 of Oracle CEP includes the following changed and deprecated features:

Simpler Helloworld Example

The HelloWorld example has been simplified in the following ways:

See HelloWorld Example.

Programming Model

The Oracle CEP programming model has changed in the following ways:

See Overview of the Oracle CEP Programming Model.

Domain Directory Structure Changes

So as to support clustering and a multi-server environment, the directory structure of the out-of-the-box and sample domains has changed.

Previously, all domain files were located directly under the domain directory, such as ORACLE_CEP_HOME/ocep_10.3/samples/domains/helloworld_domain, where ORACLE_CEP_HOME refers to the top-level installation directory of Oracle CEP.

In the 10.3 release, the domain directory contains one or more sub-directories that correspond to a single server; this directory contains all the configuration files for that server. For example, the HelloWorld domain contains a single server whose configuration files are located in the following directory: ORACLE_CEP_HOME/ocep_10.3/samples/domains/helloworld_domain/defaultserver.

The new Configuration Wizard for creating domains follows this updated directory structure.

See Creating an Oracle Complex Event Processing Domain.

New and Deprecated Options in the Deployer Tool

The -start and -stop commands of the Deployer tool have been deprecated.

When using the -install command to install an application, Oracle CEP automatically starts it after all internal initialization tasks have completed. Subsequently, if you stop and start the Oracle CEP server instance, the application is automatically stopped and started, respectively.

The Deployer tool has two new options: -suspend and -resume. Users should use -suspend to suspend a currently running application, and -resume for it to resume running.

See Deployer Command-Line Reference.

Changes in Management, Monitoring, and JMX

The management framework of Oracle CEP has been overhauled in this version.

For details, see Managing Applications, Servers, and Domains Using MBeans. See Backward Compatibility Issues for changes that are not backward compatible to the previous version of Oracle CEP (WebLogic Event Server 2.0.)

Changes in Logging

You can now specify logging severity for modules of a server, in addition to the logging severity of the server itself. The severity of the modules overrides that of the server.

For details, see Configuring Logging and Debugging.


Upgrading to Oracle CEP 10.3

Upgrading to Oracle CEP 10.3 is a two-step process: first you must upgrade your applications and then you must upgrade the domain to which the applications are deployed. The following sections describe each step:

Upgrading a WebLogic Event Server 2.0 Application to Run on Oracle CEP 10.3

This section describes the steps you must take to upgrade an application that you developed in Version 2.0 of WebLogic Event Server so that it runs on Oracle CEP 10.3.

  1. Update the MANIFEST.MF file to import new versions of Spring framework and Oracle CEP packages, as well as new required packages. In paticular:
    • Update the version of all imported Spring framework packages to 2.5.5. For example:
    • Import-Package:
    • Update the version of any imported Oracle CEP packages to For example:
    • Import-Package:
    • Add the following packages to the Import-Package header if they are not already included:
    • Import-Package:;version="",;version="",
  2. If you use Spring or Spring Dyanmic Modules for OSGI (Spring DM) features in your application, it is possible that the declaration of the features in the Spring application context file has changed. If this is the case, you must update these declarations in the EPN assembly file of your Oracle CEP application.
  3. Note: This change is a result of the upgrade of the Spring framework (from 2.0 to 2.5) that occurred between WebLogic Event Server 2.0 and Oracle CEP 10.3, not as a direct result of the Oracle CEP upgrade.

    Refer to the appropriate 2.5 XSD Schemas for any changes:


    Spring DM:

    The following bullets list some of the typical changes you might have to make; the following list is not complete.

    • When specifying a property to the <osgi:service-property> tag, use the <entry> tag with the key and value attributes, rather than the old <prop> tag. For example, update the following 2.0 tag:
    •  <osgi:service-properties>
      <prop key="type">SocketAdapterType</prop>


      <entry key="type" value="SocketAdapterType"/>
    • The value or ref attribute of an instance-property must always be set to an explicit value; it can no longer be an empty string to indicate an implicit use of a default value. For example, update the following 2.0 tag:
    •  <wlevs:adapter id="fileAdapter" provider="FileAdapterType">
      <!-- file: empty value uses default
      <wlevs:instance-property name="file" value="" />
      <wlevs:listener ref="algoTradingProcessor"/>

      to something like the following:

       <wlevs:adapter id="fileAdapter" provider="FileAdapterType">
      <wlevs:instance-property name="file" value="test.file" />
      <wlevs:listener ref="algoTradingProcessor"/>
  4. Recompile the Java code of your 2.0 adapter and business POJOs implementations using your IDE. If you get compile-time errors, check the latest 10.3 Javadoc that describe the new Oracle CEP APIs and make the appropriate source code changes.

After you have made the preceding changes, reassemble the application and deploy it to Oracle CEP 10.3. See Assembling and Deploying Oracle Complex Event Processing Applications.

If, during deployment, you get an exception that indicates that a package is invisible, add this package to the Import-Package header of the MANIFEST.MF file, then reassemble and redeploy the application. Keep adding packages in this manner until the application deploys successfully.

Upgrading a WebLogic Event Server 2.0 Domain to Oracle CEP 10.3

This section describes the steps you must take to upgrade a WebLogic Event Server 2.0 domain so that it runs correctly in Oracle CEP 10.3.

For clarity, it is assumed that the existing WebLogic Event Server 2.0 domain is located in the /bea/user_projects/domains/mydomain20 directory.

  1. Using the Configuration Wizard, create a temporary Oracle CEP 10.3 domain. Later steps in this procedure require you to use or refer to files in a new Oracle CEP 10.3 domain, and it is best to use a new domain. You can later delete this domain if you want.
  2. For the purposes of this procedure, it is assumed that the new Oracle CEP 10.3 domain is called mydomain30, it contains a single server called defaultserver, and the server files are located in the /oracle_cep/user_projects/domains/mydomain30/defaultserver directory.

    See Creating and Updating an Oracle CEP Standalone-Server Domain.

  3. If the WebLogic Event Server 2.0 server is currently running, stop it.
  4. Make a backup copy of your WebLogic Event Server 2.0 domain in case you need to revert back.
  5. Replace the following two files in the WebLogic Event Server 2.0 domain with the equivalent files in the Oracle CEP 10.3 domain:
    • lib/XACMLAuthorizerInit.ldift
    • lib/XACMLRoleMapperInit.ldift
    • The WebLogic Event Server 2.0 files are located relative to the domain directory (/bea/user_projects/domains/mydomain20 in our example) and the Oracle CEP 10.3 files are located relative to the the server directory under the domain directory (/oracle_cep/user_projects/domains/mydomain30/defaultserver in our example).

  6. Using your favorite text editor, open the atnstore.txt file in the WebLogic Event Server 2.0 domain, located in the config sub-directory of the main domain directory, and add the new Oracle 10.3 groups:
  7. group: wlevsDeployers
    group: wlevsApplicationAdmins
    group: wlevsBusinessUsers
    group: wlevsOperators
  8. Remove the following files and directories (if they exist) in the WebLogic Event Server 2.0 domain:
    • FileBasedDefaultCredentialMappermy-realmInit.initialized
    • FileBasedXACMLAuthorizermy-realmInit.initialized
    • FileBasedXACMLRoleMappermy-realmInit.initialized
    • rm
    • cm
    • atz
  9. Update the startwlevs.cmd (Windows) or (Unix) command scripts in the WebLogic Event Server 2.0 domain to point to the new Oracle 10.3 binaries.
  10. Update the stopwlevs.cmd (Windows) or (Unix) command scripts in the WebLogic Event Server 2.0 domain to point to the new Oracle 10.3 binaries.
  11. Start the server in the 2.0 domain using the Oracle 10.3 binaries. See Starting the Server.
  12. The preceding upgrade procedure might have changed the your security configuration of your 2.0 domain, especially if you created new users and assigned them to groups. In this case, use Visualizer to reconfigure the security. See Overview of Visualizer.

Backward Compatibility Issues

The following are non-backward compatible changes in the management framework:

  Back to Top       Previous  Next