However, Spring-DM does not support exporting and importing an OSGi service in the same application so the above approach is deprecated.

Now, you should declare providers with the wlevs:factory tag like this:

<wlevs:factory provider-name="SocketAdapterType" ref="myBean">

This will work whether the adapters are in the same application or not.

Note that if your adapters and providers are collocated (both in the same application) using a provider is optional; you could just instantiate the adapter directly.

Failure to make this change may result in an application that fails to start and eventually times out.

StockTick Event Type Replaced by OracleStockTick

When using the loadgen adapter, note that the StockTick event is now named OracleStockTick.

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

25.1.4 Changes in Management, Monitoring, and JMX

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

Oracle CEP no longer supports the JRMP protocol. Instead, JMX clients must use the more secure MSA protocol for both local and remote access to the Oracle CEP JMX server. When you connect to the Oracle CEP JMX server that is running on localhost or on a remote host, you must always use the JMX URL service:jmx:msarmi://HOST-NAME:PORT/jndi/jmxconnector so that you are always using the MSA connector (where HOST-NAME is either localhost or the name of the remote host and PORT is the Oracle CEP server JNDI port).

25.1.5 Using stopwlevs.sh With Multiple Servers on the Same Host

Consider a scenario where you start two servers on the same host, for example, with server 1 listening on port 9002 and server 2 listening on port 9022. If you then use stopwlevs.sh in the server 1 domain directory, the server listening on port 9002 is stopped. If you then use stopwlevs.sh in the server 2 domain directory, the stop operation fails due to connection reset error.

Workaround: use the stopwlevs.sh command line argument -url or -listenPort to specify a port other than 9002.

25.1.6 Monitor Service may Underestimate Latency For Application-Timestamped Channels

The monitor service may underestimate the latency time of events that are being processed through the CQL processor when application-timestamped channels are being used and is-totally-ordered is not enabled.

When you connect to Oracle CEP server using JConsole (with or without the wlevsjconsole.sh script), JConsole may throw a java.lang.NullPointerException.

Workaround: click OK in the exception dialog box and proceed. The exception does not affect the JMX connection or Oracle CEP server.

25.1.8 Variable Duration Non-Event Detection is not Supported in This Release

Fixed duration non-event pattern detection is supported in 11g Release 1 (11.1.1). When you create a query for fixed duration non-event detection, you may use the DURATION clause with constant value and time unit, such as DURATION 5 SECONDS, or just a constant value such as DURATION 5.

Variable duration non-event pattern detection is not supported in 11g Release 1 (11.1.1). That is, you may not use the DURATION clause with an arbitrary arithmetic expression, such as DURATION c1+4.

Recurring non-event pattern detection is supported in 11g Release 1 (11.1.1) but only for the fixed duration case. That is, you may use a DURATION clause with a MULTIPLES OF clause but only for a duration that is a constant value.

25.1.9 JMSAdapterMBean Getter Methods for New Connection and User and Password

The following methods have been added to com.bea.wlevs.management.configuration.JMSAdapterMBean:

getConnectionUser

getConnectionPassword

getConnectionEncryptedPassword

The following attributes have been added to the wlevs_application_config.xsd element jms-adapter:

connection-user

connection-password

connection-encrypted-password

When Oracle CEP acquires the JNDI InitialContext, it uses the user and password (or encrypted-password) settings.

When Oracle CEP calls the createConnection method on the javax.jms.ConnectionFactory to create a connection to the JMS destination (JMS queue or topic), it uses the connection-user and connection-password (or connection-encrypted-password) settings, if configured. Otherwise, Oracle CEP uses the user and password (or encrypted-password) settings.

You can use the connection-user and connection-password (or connection-encrypted-password) settings in applications where one security provider is used for JNDI access and a separate security provider is used for JMS access.

25.2 Configuration Issues and Workarounds

This section describes configuration issues and their workarounds. It includes the following topics:

When accessing the signal generation example dashboard (at URL http://localhost:9002/signalgeneration/dashboard.html) using the Firefox browser version 3.0 on Windows, you will get an error when you click Start.

Workaround: use Internet Explorer version 7 to access the signal generation example dashboard.

25.2.2 VPN Software and Multicast Traffic

Active VPN software is known to have unpredictable behavior on multicast traffic. Additionally, having both Cisco VPN and Nortel VPN installed breaks multicast traffic.

25.2.3 Starting Oracle CEP Visualizer With Firefox

When using Oracle CEP Visualizer with the Firefox browser (version 3.0, SSL, and JDK 1.6), the first time you access a Oracle CEP Visualizer page it will render slowly, sometimes up to 30 seconds.

The Oracle CEP IDE for Eclipse uses Eclipse 3.3, which is incompatible with required FireFox 3 libraries on Linux. In this case, Eclipse will crash on startup with a JVM core dump and error message like this:

25.2.8 Configuring Oracle CEP Native Clustering Using IPv6 on Linux

When using Oracle CEP native clustering on Linux with IPv6, you may see an error like the one shown in Example 25-1 after restarting a member of a cluster.

Example 25-1 Oracle CEP Server Log evs4j Error

<Error> <evs4j> <BEA-2049005> <The cluster member 3 is considered to have failed>

Workaround: perform the following procedure:

Using the editor of your choice, open the startwlevs.sh script for the affected Oracle CEP sever.

The startwlevs.sh server start script is located in the server directory under the main domain directory. For example, the default server directory of the HelloWorld domain is located in ORACLE_CEP_HOME/ocep_11.1/samples/domains/helloworld_domain/defaultserver, where ORACLE_CEP_HOME refers to the main Oracle CEP installation directory, such as /oracle_cep.

Edit the startwlevs.sh script to add the -Djava.net.preferIPv4Stack=true property to the java command line:

25.2.9 Multi-Byte Characters are not Supported by loadgen

The loadgen utility supports only ASCII characters. It does not support multi-byte character sets.

25.2.10 Oracle CEP Server Will not Start if the Keystore and Private Key Passwords are Different

The passwords for the keystore and the alias for the SSL private key must be the same. If they are not, the Oracle CEP Server will not start.

25.2.11 Configuring Oracle CEP Server to use the Sun JVM

Typically, when you install Oracle CEP server, you configure Oracle CEP server to use the bundled JRockit SDK 1.6.0_05. Alternatively, you can configure Oracle CEP server to use a supported Sun Microsystems JDK.

Using the editor of your choice, open the setDomainEnv.sh or setDomainEnv.cmd script for the affected Oracle CEP sever.

This script is located in the server directory under the main domain directory. For example, the default server directory of the HelloWorld domain is located in ORACLE_CEP_HOME/ocep_11.1/samples/domains/helloworld_domain/defaultserver, where ORACLE_CEP_HOME refers to the main Oracle CEP installation directory, such as /oracle_cep.

Edit this script to set the JAVA_HOME variable to your JDK 1.6.0_11 installation:

JAVA_HOME=/scratch/jdk/jdk_1.6.0_11

Save and close the script.

Using the editor of your choice, open the startwlevs.sh or startwlevs.cmd script for the affected Oracle CEP sever.

This server start script is located in the server directory under the main domain directory. For example, the default server directory of the HelloWorld domain is located in ORACLE_CEP_HOME/ocep_11.1/samples/domains/helloworld_domain/defaultserver, where ORACLE_CEP_HOME refers to the main Oracle CEP installation directory, such as /oracle_cep.

Edit this script to add the following properties to the JVM_ARGS variable:

If you want to create an installation log, use the -log=full_path_to_log_file option; for example:

prompt> ./filename -log=C:\logs\server_install.log

After the installation program has finished loading, you will see the standard Welcome window.

Click Next.

In the Choose Middleware Home Directory window, you can specify either an existing ORACLE_CEP_HOME directory or create a new one:

To install into an existing ORACLE_CEP_HOME directory:

Select Use an Existing Middleware Home.

Select an existing ORACLE_CEP_HOME directory from the list on the right.

To install into a new ORACLE_CEP_HOME directory:

Select Create a New Middleware Home.

Click the Browse button to browse your computer to select an existing directory or use the New Folder button to create a new directory and then select it.

Click Open.

The ORACLE_CEP_HOME directory is the main installation directory for Oracle CEP, such as c:\oracle_cep. You can have one or many ORACLE_CEP_HOME directories on your computer, whichever suits your development and production environments best.

Click Next.

In the Choose Install Type window, you can choose one of the following options:

To install all Oracle CEP components except the samples and use the Oracle JRockit JVM included with Oracle CEP:

The installer program checks to see if the ORACLE_CEP_HOME directory contains the version of JRockit required by this release of Oracle CEP:

If it finds the required JRockit installation, it does not install a new one.

If it does not find an appropriate JRockit installation, then the installer installs its own version in the ORACLE_CEP_HOME directory.

To install all Oracle CEP components including the samples and select a previously installed Sun or platform-specific JVM (or use the Oracle JRockit JVM included with Oracle CEP):

Select Custom.

In the Choose Products and Components window, check the components you want to install, such as the product samples.

Click Next.

Note:

By default, the complete installation does not include the product samples. If you want to install the samples (recommended), choose the Custom option.

If you want to use a Sun or platform-specific JVM, you must choose the Custom option.

The installer program allows you to choose the JDK to use and to decide whether or not to install the Oracle JRockit JVM included with Oracle CEP.

In the JDK Selection window, you can choose the JDK for the Oracle CEP server.

Use the Browse button to select the Sun or platform-specific JDK you installed previously.

If you do not want the installer to install the Oracle JRockit JVM included with Oracle CEP, uncheck this item.

Click Next.

In the Choose Product Installation Directories window, you can change the default name of the home directory of Oracle CEP, ocep_11.1.

Although you can name this directory anything you want, Oracle recommends that you use the default name for clarity and standardization. For example, the documentation assumes that you install into the ocep_11.1 directory.

Click Next.

If you are installing on Windows, and you logged in as a user with Administrator privileges, then you will see the Choose Shortcut Location window where you can choose where you want the Start Menu folder to appear. The following table describes the options available:

If you select . . .

The following occurs . . .

All Users

Recommended. All users registered on the machine are provided with access to the installed software. Subsequently, if users without Administrator privileges use the Configuration Wizard from this installation to create domains, Start menu shortcuts to the domains are not created. In this case, users can manually create shortcuts in their local Start menu folders, if desired.

Local user

Other users registered on this machine will not have access to the Start menu entries for this installation.

If you logged in as a user without Administrator privileges, the Start menu entries are created in your user's local Start menu folder.

Click Next.

The Installation Summary window shows the products and components you are about to install, along with the approximate size in MB. This window is for your information only; to change the components to be installed, use the Previous button to return to the appropriate window.

Click Next.

The installer program installs Oracle CEP. The Installation Complete window indicates that the product was installed successfully.

25.3.2.2 Installing Oracle CEP in Console Mode

Console-mode installation is an interactive, text-based method for installing your software from the command line, on either a UNIX or Windows system.

When installing in console-mode, respond to the prompts in each section by entering the number associated with your choice or by pressing Enter to accept the default. To exit the installation process, enter exit (or x, for short) in response to any prompt. To review or change your selection, enter previous (or p, for short) at the prompt. To proceed to the following window, enter next (or n, for short).

Note:

In the following procedure, Windows conventions (such as back-slashes in pathnames) are used, for example, C:\oracle_cep\ocep_11.1. When entering pathnames on a UNIX system, be sure to use UNIX conventions, instead. For example, use forward slashes in pathnames, such as /oracle_cep/ocep_11.1.

To install Oracle CEP in graphical mode:

Log in to the Windows or UNIX computer on which you want to install Oracle CEP.

Be sure you log in to the computer as the user that will be the main administrator of the Oracle CEP installation.

Download the product distribution file for the platform on which you want to install Oracle CEP.

Launch the installation program in console mode using the commands listed in the following table appropriate for your platform.

Platform

Instructions

Windows

Open a command window, change to the download directory, and enter the following command:

If you want to create an installation log, use the -log=full_path_to_log_file option; for example:

prompt> ./filename -mode=console -log=C:\logs\server_install.log

At the Welcome prompt, type next (or n for short) or press Enter to continue with the installation process.

In the Choose Middleware Home Directory window, you can specify either an existing ORACLE_CEP_HOME directory or create a new one:

To install into an existing ORACLE_CEP_HOME directory:

Type the number of the existing ORACLE_CEP_HOME directory.

To install into a new ORACLE_CEP_HOME directory:

Type 1 to create a new ORACLE_CEP_HOME directory.

The installation program guides you through the required steps to create the new ORACLE_CEP_HOME.

Be sure to enter the full path of the ORACLE_CEP_HOME directory, for example C:\oracle_cep2.

If you specify a directory that does not exist, the installation program creates it for you.

The ORACLE_CEP_HOME directory is the main installation directory for Oracle CEP, such as c:\oracle_cep. You can have one or many ORACLE_CEP_HOME directories on your computer, whichever suits your development and production environments best.

The installer program checks to see if the ORACLE_CEP_HOME directory contains the version of JRockit required by this release of Oracle CEP:

If it finds the required JRockit installation, it does not install a new one.

If it does not find an appropriate JRockit installation, then the installer installs its own version in the ORACLE_CEP_HOME directory.

To install all Oracle CEP components including the samples and select a previously installed Sun or platform-specific JVM (or use the Oracle JRockit JVM included with Oracle CEP):

Type 2 to choose a Custom install.

In the Choose Components to Install window, enter the numbers in brackets to toggle the components you want to install, such as the samples. To toggle a selection in the list, types its number. When a check mark appears next to the option, the option is selected. To unselect the option, enter its number again to remove the check mark

Enter next (or n) when you have chosen the components.

Note:

By default, the complete installation does not include the product samples. If you want to install the samples (recommended), choose the Custom option.

If you want to use a Sun or platform-specific JVM, you must choose the Custom option.

The installer program allows you to choose the JDK to use and to decide whether or not to install the Oracle JRockit JVM included with Oracle CEP.

In the JDK Selection window, you can choose the JDK for the Oracle CEP server:

To add a local JDK, select the Add Local JDK option (1).

The installation program guides you through the required steps to add a local JDK.

Be sure to enter the full path to the JDK directory, for example:

C:\Program Files\Java\jdk1.6.0_14

To add additional JDKs, select 1 again.

In the JDK Selection window, enter the numbers in brackets to toggle the JDKs you want. To toggle a selection in the list, types its number. When a check mark appears next to the option, the option is selected. To unselect the option, enter its number again to remove the check mark.

If you do not want the installer to install the Oracle JRockit JVM included with Oracle CEP, uncheck this item.

Enter next (or n) when you have selected the local JDK.

In the Choose Product Installation Directories window, you can change the default name of the home directory of Oracle CEP, ocep_11.1, by entering a new value.

Although you can name this directory anything you want, Oracle recommends that you use the default name for clarity and standardization. For example, the documentation assumes that you install into the ocep_11.1 directory.

Enter next (or n) when you are done.

If you are installing on Windows, and you logged in as a user with Administrator privileges, then you will see the Choose Shortcut Location window where you can choose where you want the Start Menu folder to appear. The following table describes the options available:

If you select . . .

The following occurs . . .

1 "All Users"

Recommended. All users registered on the machine are provided with access to the installed software. Subsequently, if users without Administrator privileges use the Configuration Wizard from this installation to create domains, Start menu shortcuts to the domains are not created. In this case, users can manually create shortcuts in their local Start menu folders, if desired.

2 "Local user"

Other users registered on this machine will not have access to the Start menu entries for this installation.

If you logged in as a user without Administrator privileges, the Start menu entries are created in your user's local Start menu folder.

Enter the appropriate number.

Enter next (or n) when you are done.

The Installation Summary window shows the products and components you are about to install, along with the approximate size in MB. This window is for your information only; to change the components to be installed, type Previous to return to the appropriate window.

Enter next (or n).

The installer program installs Oracle CEP. The Installation Complete window indicates that the product was installed successfully.

Incorrect entries in the silent.xml file can cause installation failures. To help you determine the cause of a failure, we recommend that you create a log file when you launch the installation program.

Launch the installation program in silent mode using the commands in the following table appropriate for your platform.

Platform

Instructions

Windows

Open a command window, change to the download directory, and enter the following command:

If you do not include the COMPONENT_PATHS data-value name in the silent.xml file, the complete Oracle CEP product is installed.

LOCAL_JVMS

Specify the local JDKs to be installed. Enter the full path of the JDKs to be installed, separated by the pipe symbol (|). Do not leave a space before or after the bar.

Use this option to install Oracle CEP for use with a previously installed Sun or platform-specific JDK.

BEA_BUNDLED_JVMS

Specify the BEA-supplied JDKs to be installed. Enter the full path of the JDKs to be installed, separated by the pipe symbol (|). Do not leave a space before or after the bar.

Use this option to install Oracle CEP for use with the Oracle JRockit JDK included in the Oracle CEP installer.

Save the file in the directory of your choice.

25.3.2.3.2 Guidelines for Component Selection

Use the following guidelines when you specify values for the COMPONENT_PATHS data-value name:

When you specify a product component to be installed, all subcomponents that are installed by default in a complete installation are also installed. For example, the following entry installs both Oracle CEP and the samples:

25.3.4 Oracle CEP IDE for Eclipse Support for Eclipse 3.5.0 (Galileo)

In this release, Oracle CEP IDE for Eclipse provides a plugin for Eclipse 3.5.0 (Galileo) as well as Eclipse 3.3.x (Europa). You may see minor differences between the Eclipse 3.5.0 user interface and screen captures in the Oracle CEP IDE Developer's Guide for Eclipse.

25.3.5 Connecting to the Oracle CEP Server Using Oracle JRockit Mission Control

Currently, Oracle JRockit Mission Control does not support the MSA RMI protocol. You cannot connect Oracle JRockit Mission Control to the Oracle CEP server using this protocol as "How to Connect to a Local or Remote Oracle CEP JMX Server Using JRockit Mission Control" in the Oracle CEP Administrator's Guide erroneously describes.

To connect to a local or remote Oracle CEP JMX server using JConsole with security enabled:

Ensure that the local or remote Oracle CEP server is running.

Open a command window and set your environment as described in "Setting Your Development Environment" in the Oracle CEP Getting Started.

Launch jconsole using the wlevsjconsole.sh script located in the ORACLE_CEP_HOME/ocep_11.1/bin directory, where ORACLE_CEP_HOME refers to the directory in which you installed Oracle CEP (such as /oracle_home).

To connect to a local Oracle CEP server, enter:

prompt> wlevsjconsole.sh

To connect to a remote Oracle CEP server, enter:

prompt> wlevsjconsole.sh HOST-NAME:PORT

Where HOST-NAME is the name of the remote host and PORT is the NetIO port as configured in the remote host's ORACLE_CEP_HOME/user_projects/domains/DOMAIN-NAME/defaultserver/config/config.xml file.

The jconsole browser attempts to log into the JMX server and initially fails It displays a "Connection Failed: Retry?" dialog with a Connect and Cancel button.

Where HOST-NAME is the name of the local or remote host and PORT is the NetIO port as configured in the remote host's ORACLE_CEP_HOME/user_projects/domains/DOMAIN-NAME/defaultserver/config/config.xml file (defualt 9002).

Username

Enter an Oracle CEP administration password.

Default: wlevs.

Password

Enter the password for the Oracle CEP administration password you chose.

Default: wlevs.

Remote Process

Enter the following URL:

service:jmx:msarmi://HOST-NAME:PORT/jndi/jmxconnector

Where HOST-NAME is the name of the local or remote host and PORT is the NetIO port as configured in the remote host's ORACLE_CEP_HOME/user_projects/domains/DOMAIN-NAME/defaultserver/config/config.xml file (defualt 9002).

Click Connect.

The jconsole browser opens and provides access to Oracle CEP MBeans.

25.3.6.2 How to Connect to a Local or Remote Oracle CEP JMX Server Using JConsole With Security Disabled

You can use the wlevsjconsole script to connect to an Oracle CEP JMX server running on your local host or on a remote host to browse and manage Oracle CEP MBeans with the JDK jconsole.

Open a command window and set your environment as described in "Setting Your Development Environment" in the Oracle CEP Getting Started.

Launch jconsole using the wlevsjconsole.sh script located in the ORACLE_CEP_HOME/ocep_11.1/bin directory, where ORACLE_CEP_HOME refers to the directory in which you installed Oracle CEP (such as /oracle_home).

To connect to a local Oracle CEP server, enter:

prompt> wlevsjconsole.sg

To connect to a remote Oracle CEP server, enter:

prompt> wlevsjconsole.sh HOST-NAME:PORT

Where HOST-NAME is the name of the remote host and PORT is the NetIO port as configured in the remote host's ORACLE_CEP_HOME/user_projects/domains/DOMAIN-NAME/defaultserver/config/config.xml file.

The script automatically connects to the JMX server and the jconsole browser opens and provides access to Oracle CEP MBeans.