Oracle® Fusion Middleware Release Notes 11g Release 1 (11.1.1) for Microsoft Windows x64 E14774-11 |
|
![]() Previous |
![]() Next |
This chapter describes issues associated with Oracle Complex Event Processing (Oracle CEP). It includes the following topics:
This section describes general issue and workarounds. It includes the following topics:
Section 25.1.3, "New and Deprecated Options in the Deployer Tool"
Section 25.1.4, "Changes in Management, Monitoring, and JMX"
Section 25.1.5, "Using stopwlevs.cmd With Multiple Servers on the Same Host"
Section 25.1.6, "Monitor Service may Underestimate Latency For Application-Timestamped Channels"
Section 25.1.8, "Variable Duration Non-Event Detection is not Supported in This Release"
Section 25.1.9, "JMSAdapterMBean Getter Methods for New Connection and User and Password"
Table 25-1 lists Java API deprecated in 11g Release 1 (11.1.1) and the replacement API, if any.
Table 25-1 Deprecated Java API
Deprecated API | Replacement API |
---|---|
|
|
|
|
|
|
|
|
|
|
Table 25-2 lists Oracle CEP schema deprecated in 11g Release 1 (11.1.1) and the replacement schema, if any.
Table 25-2 Deprecated Oracle CEP Schema
Deprecated Schema | Deprecated in Assembly File? | Deprecated in Component Configuration File? | Replacement Schema |
---|---|---|---|
|
Yes |
Yes |
|
|
Yes |
N/A |
|
|
Yes |
N/A |
|
|
Yes |
N/A |
None. |
|
Yes |
N/A |
None. |
|
N/A |
Yes |
None. |
|
N/A |
Yes |
None. |
|
N/A |
Yes |
None. |
The programming model for adapters has changed as follows:
Outbound Adapters
Adapters can now also be outbound; previously they were only inbound.
Lifecycle Callback Methods for Adapters
Spring tags for adapters now include attributes for setting lifecycle callback methods via the EPN assembly file.
Runnable Adapters
For adapters that want to run in a thread, their Java class should now implement com.bea.wlevs.ede.api.RunnableBean
.
Adapter Factories
Programmers are no longer required to create an adapter factory when creating adapters. You only need to create an adapter factory if you want to share adapters among applications.
Publishing Adapter Providers
Adapter providers are factories for adapters that are published through the OSGi service registry.
Previously, the only way of advertising adapter providers was to use Spring-DM only, like this:
<osgi:service interface="com.bea.wlevs.ede.api.AdapterFactory" ref="myBean"> <osgi:service-properties> <entry key="type" value="SocketAdapterType"/> </osgi:service-properties> </osgi:service>
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
.
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.
"Deployer Command-Line Reference" in the Oracle CEP Administrator's Guide.
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).
For more information, see:
"Accessing the Oracle CEP JMX Server" in the Oracle CEP Administrator's Guide
"Configuring JMX" in the Oracle CEP Administrator's Guide
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.cmd
in the server 1 domain directory, the server listening on port 9002 is stopped. If you then use stopwlevs.cmd
in the server 2 domain directory, the stop operation fails due to connection reset error.
Workaround: use the stopwlevs.cmd
command line argument -url
or -listenPort
to specify a port other than 9002.
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.cmd
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.
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.
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.
This section describes configuration issues and their workarounds. It includes the following topics:
Section 25.2.1, "Accessing Signal Generation Dashboard With Firefox Version 3.0 on Windows"
Section 25.2.3, "Starting Oracle CEP Visualizer With Firefox"
Section 25.2.4, "Uploading Files Using Oracle CEP Visualizer With Firefox and SSL"
Section 25.2.5, "A Channel Cannot be a Foreign Stage When Connected to an Oracle CQL Processor"
Section 25.2.6, "Exceptions Thrown When Using Oracle CEP Visualizer with FireFox"
Section 25.2.7, "Multi-Byte Characters are not Supported by loadgen"
Section 25.2.9, "Configuring Oracle CEP Server to use the Sun JVM"
Section 25.2.10, "Oracle CEP Applications as Web Service Provider Requires JDK 1.6.0_14 or Higher"
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.
Active VPN software is known to have unpredictable behavior on multicast traffic. Additionally, having both Cisco VPN and Nortel VPN installed breaks multicast traffic.
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.
When using Oracle CEP Visualizer, you may get an error if you try to upload a file using the Firefox browser and SSL.
This is a known problem (http://bugs.adobe.com/jira/browse/FP-226
) with Adobe Flex that affects Oracle CEP Visualizer.
If a channel is connected to an Oracle CQL processor, it cannot be a foreign stage.
When using Oracle CEP Visualizer with FireFox:
Do not set the Jetty scratch directory to a path with a space in it. Doing so will cause FileNotFoundException
.
Ignore EOFException
thrown on the server side; these exceptions will not cause client side failure.
The loadgen utility supports only ASCII characters. It does not support multi-byte character sets.
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.
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.
How to configure Oracle CEP Server for use with the Sun JVM:
Install the appropriate Sun JDK.
For more information, see:
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:
... JVM_ARGS=-XX:+UnlockDiagnosticVMOptions -XX:+UnsyncloadClass -Xms512m ...
Save and close the script.
Start the affected Oracle CEP server using the modified startwlevs.sh
or startwlevs.cmd
script.
To configure an Oracle CEP application as a Web service provider, you must use JDK 1.6.0_14 or above.
This section describes documentation errata. It includes the following topics:
Section 25.3.1, "Colt Aggregate Function Example Output Incomplete"
Section 25.3.2, "Installing Oracle CEP for Use With a Sun JVM"
Section 25.3.3, "Configuring Oracle CEP for the Sun JDK on Windows"
Section 25.3.4, "Oracle CEP IDE for Eclipse Support for Eclipse 3.5.0 (Galileo)"
Section 25.3.5, "Connecting to the Oracle CEP Server Using Oracle JRockit Mission Control"
Section 25.3.6, "Connecting to the Oracle CEP Server Using JConsole"
Section 25.3.7, "How to Implement a User-Defined Single-Row Function"
"Functions: Colt Aggregate" in the Oracle CEP CQL Language Reference contains incomplete example output for the following functions:
AUTOCORRELATION
HARMONICMEAN
TRIMMEDMEAN
You can use Oracle CEP server with a supported Sun JVM. To do so:
Install a supported Sun JVM.
For more information, see:
Section 1.6, "Supported Platforms" in the Oracle CEP Getting Started.
Install Oracle CEP as a custom install and select the supported Sun JVM:
In each Oracle CEP domain directory, update the setDomainEnv
and startwlevs
scripts.
For more information, see Section 25.3.3, "Configuring Oracle CEP for the Sun JDK on Windows".
The Oracle CEP graphical installation program is self-explanatory, however, you can follow these steps for more information.
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 graphical mode using the commands listed in the following table appropriate for your platform.
Platform | Instructions |
---|---|
Windows | Using Windows Explorer, double-click the appropriate installation program file from its download directory. |
Linux or Solaris | Open a command window, change to the download directory, and enter these commands:
prompt> chmod a+x
In the preceding commands, If you want to create an installation log, use the
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:
Select Typical.
Click Next.
Proceed to step 10.
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.
Click Done to exit the program.
Review the post-installation steps that Section 2.7, "Post-Installation Steps" in the Oracle CEP Getting Started describes.
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:
prompt>
In the preceding command, If you want to create an installation log, use the
prompt> |
Linux or Solaris | Open a command window, change to the download directory, and enter these commands:
prompt> chmod a+x filename prompt> ./filename -mode=console In the preceding commands, If you want to create an installation log, use the
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.
Confirm your choice for ORACLE_CEP_HOME
directory and enter next
(or n
).
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:
Type 1
to choose a Typical install.
Proceed to step 9.
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.
Type exit
to exit the program.
Review the post-installation steps that Section 2.7, "Post-Installation Steps" in the Oracle CEP Getting Started describes.
Silent-mode installation is a non-interactive method of installing your software that requires the use of an XML properties file for selecting installation options.
To install Oracle CEP in silent 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.
Create a silent.xml
file that defines the configuration settings normally entered by a user during an interactive installation process.
See Section 25.3.2.3.1, "Creating a silent.xml File for Silent-Mode Installation."
Note: Incorrect entries in thesilent.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:
prompt>
In the preceding command, If you want to create an installation log, use the
prompt> |
Linux or Solaris | Open a command window, change to the download directory, and enter these commands:
prompt> chmod a+x filename prompt> ./filename -mode=silent -silent_xml=path_to_xml_file In the preceding commands, If you want to create an installation log, use the prompt> ./filename -mode=silent -silent_xml=path_to_xml_file -log=C:\logs\server_install.log |
An Oracle Installer window is displayed, indicating that the files are being extracted. No other prompt or text is displayed.
The installation is complete when the Oracle Installer window disappears.
See Section 25.3.2.3.3, "Returning Exit Codes to the Command Window" for getting information about the success or failure of the silent installation.
Review the post-installation steps that Section 2.7, "Post-Installation Steps" in the Oracle CEP Getting Started describes.
When you install Oracle CEP in silent mode, the installation program uses an XML file (silent.xml
) to determine which installation options should be implemented.
To create a silent.xml file for silent-mode installation:
Using your favorite text editor, create an empty file called silent.xml
on the computer on which you want to install Oracle CEP in silent mode.
Copy the contents of the sample XML file, shown in Example 25-1, into your own silent.xml
file.
Example 25-1 Sample silent.xml File for Silent-Mode Installation
<?xml version="1.0" encoding="UTF-8"?> <!-- Silent installer option: -mode=silent -silent_xml=C:\oracle\silent.xml --> <bea-installer> <input-fields> <data-value name="BEAHOME" value="C:\oracle_cep" /> <data-value name="USER_INSTALL_DIR" value="C:\oracle_cep\ocep_11.1" /> <data-value name="INSTALL_SHORTCUT_IN_ALL_USERS_FOLDER" value="yes"/> <data-value name="COMPONENT_PATHS" value="Oracle Complex Event Processing" /> </input-fields> </bea-installer>
In the silent.xml
file you just created, edit the values for the keywords shown in Table 25-3 to reflect your configuration.
For example, if you want to install into the ORACLE_CEP_HOME directory e:\oracle_cep
, update the corresponding <data-value>
element as follows
<data-value name="BEAHOME" value="e:\oracle_cep" />
Table 25-3 Values for the silent.xml File
For this data-value name... | Enter the following value... |
---|---|
BEAHOME |
The full pathname for the |
USER_INSTALL_DIR |
The full pathname for the directory where you want to install your Oracle CEP software. |
INSTALL_SHORTCUT_IN_ALL_USERS_FOLDER |
Windows only. Specify:
The user performing the installation must have Administrator privileges to install the Start menu shortcuts in the All Users folder. The default value for this parameter, if you do not specify it, is |
COMPONENT_PATHS |
Specify the components and subcomponents of Oracle CEP you want to install on your system. Use the following values:
For additional information about entering these values, see Section 25.3.2.3.2, "Guidelines for Component Selection." If you do not include the |
|
Specify the local JDKs to be installed. Enter the full path of the JDKs to be installed, separated by the pipe symbol ( Use this option to install Oracle CEP for use with a previously installed Sun or platform-specific JDK. |
|
Specify the BEA-supplied JDKs to be installed. Enter the full path of the JDKs to be installed, separated by the pipe symbol ( 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.
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:
<data-value name="COMPONENT_PATHS" value="Oracle Complex Event Processing" />
To install multiple components or subcomponents, separate the components with a bar (|). Do not leave a space before or after the bar.
To specify subcomponents, you must specify a component/subcomponent combination for each entry. For example, to explicitly install Oracle CEP and the samples, enter the following line in the file:
<data-value name="COMPONENT_PATHS" value="Oracle Complex Event Processing/Event Server|Oracle Complex Event Processing/Event Server Samples" />
Note: Because this release of Oracle CEP includes only the server itself and samples, the preceding example is equivalent to the example in the first bullet. |
When run in silent mode, the installation program generates exit codes that indicate the success or failure of the installation. These exit codes are shown in Table 25-4.
Table 25-4 Exit Codes
Code | Description |
---|---|
0 |
Installation completed successfully |
-1 |
Installation failed due to a fatal error |
-2 |
Installation failed due to an internal XML parsing error |
Example 25-2 provides a sample Windows command file that invokes the installation program in silent mode and echoes the exit codes to the command window from which the script is executed.
Example 25-2 Sample Windows Command File Displaying Silent-Mode Exit Codes
rem Execute the installer in silent mode @echo off ofm_ocep_generic_11.1.1.1.0_32_disk1_1of1.exe -mode=silent -silent_xml=C:\downloads\silent.xml -log=C:\logs\products_silent.log @rem Return an exit code to indicate success or failure of installation set exit_code=%ERRORLEVEL% @echo. @echo Exitcode=%exit_code% @echo. @echo Exit Code Key @echo --------------- @echo 0=Installation completed successfully @echo -1=Installation failed due to a fatal error @echo -2=Installation failed due to an internal XML parsing error @echo.
If you installed Oracle CEP for use with the Sun JDK on Windows, you must make changes to the setDomainEnv.cmd
and startwlevs.cmd
scripts in each Oracle CEP domain directory:
Go to the domain directory.
For example, ORACLE_CEP_HOME
\user_projects\domains\ocep_domain\defaultserver
Edit the setDomainEnv.cmd
script and add the following line:
set DISPLAY=:0.0
Edit the startwlevs.cmd
script and add -Djava.awt.headless=true
to the java
command line:
"%JAVA_HOME%\bin\java" %DGC% %DEBUG% -Djava.awt.headless=true
-Dwlevs.home="%USER_INSTALL_DIR%" -Dbea.home="%BEA_HOME%" -jar "%USER_INSTALL_DIR%\bin\wlevs.jar" %ARGS%
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.
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.
The Oracle CEP Administrator's Guide describes how to connect to a local or remote Oracle CEP server using JConsole. This description should read as follows:
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
.
This procedure describes how to use JConsole when the Oracle CEP server has security enabled. This is the default configuration and is recommended for production servers. Alternatively, you can connect to the JMX server with security disabled (see Section 25.3.6.2, "How to Connect to a Local or Remote Oracle CEP JMX Server Using JConsole With Security Disabled").
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.cmd
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.cmd
To connect to a remote Oracle CEP server, enter:
prompt> wlevsjconsole.cmdHOST-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.
Click Cancel.
The Jconsole
New Connection dialog appears.
Configure the New Connection dialog as Table 25-5 describes.
Table 25-5 JConsole New Connection Attributes
Attribute | Description |
---|---|
|
Enter the following URL: service:jmx:msarmi:// Where |
|
Enter an Oracle CEP administration password. Default: wlevs. |
|
Enter the password for the Oracle CEP administration password you chose. Default: wlevs. |
Click Connect.
The jconsole
browser opens and provides access to Oracle CEP MBeans.
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
.
This procedure describes how to use JConsole when the Oracle CEP server has security disabled. This is a common development configuration and is not recommended for production servers. Alternatively, you can connect to the JMX server with security enabled (see Section 25.3.6.1, "How to Connect to a Local or Remote Oracle CEP JMX Server Using JConsole With Security Enabled").
To connect to a local or remote Oracle CEP JMX server using JConsole with security disabled:
Ensure that the local or remote Oracle CEP server is running with security disabled.
For more information, see "Disabling Security" in the Oracle CEP Administrator's Guide.
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.cmd
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.cmd
To connect to a remote Oracle CEP server, enter:
prompt> wlevsjconsole.cmdHOST-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.
Example 13-1, "MyMod.java User-Defined Single-Row Function", in the Oracle CEP CQL Language Reference, is incorrect. Currently, it reads as follows:
package com.bea.wlevs.example.function; public class MyMod { public Object execute(Object[] args) { int arg0 = ((Integer)args[0]).intValue(); int arg1 = ((Integer)args[1]).intValue(); return new Integer(arg0 % arg1); } }
It should read as follows:
package com.bea.wlevs.example.function; public class MyMod { public Object execute(int arg0, int arg1) { return new Integer(arg0 % arg1); } }