Administration and Configuration Guide

Introduction and Roadmap

Document Scope and Audience

Oracle CEP Documentation Set

Guide to This Document

Samples for the Oracle CEP Application Developer

Creating and Updating an Oracle CEP Domain

Overview of Oracle Complex Event Processing Domains

Creating a Domain Using the Configuration Wizard

Creating a Domain in Graphical Mode

Creating a Domain in Silent Mode

Creating a silent.xml File

Sample silent.xml File

Returning Exit Codes to the Command Window

Adding New Servers to an Existing Domain Using the Configuration Wizard

Adding New Servers in Graphical Mode

Adding New Servers in Silent Mode

Updating an Existing Server Using the Configuration Wizard

Updating an Existing Server in Graphical Mode

Updating an Existing Server in Silent Mode

Stopping and Starting the Server

Starting the Server

Stopping the Server Using the stopwlevs Script

Next Steps

Configuring Oracle Complex Event Processing

Overview of Configuring Oracle Complex Event Processing

Configuring the Server by Manually Editing the config.xml File

Configuring and Using Oracle CEP Clustered Domains

Overview of Clustering and High Availability in Oracle Complex Event Processing

Oracle CEP Clustered Domain

Groups

Cluster Notifications and Messaging

Creating and Configuring a Simple Clustered Domain

Configuring Custom Groups for a Clustered Domain

Starting the Servers in a Clustered Domain

Deploying Applications to a Clustered Domain

Deploying to the Singleton Server Group

Deploying to the Domain Group

Deploying to a Custom Group

Using the Cluster APIs to Manage Group Membership Changes

Securing Cluster Messages

Additional Child Elements of the <cluster> Element

wlevs.Admin Command-Line Reference

Overview of the wlevs.Admin Utility

Required Environment for the wlevs.Admin Utility

Running the wlevs.Admin Utility Remotely

Syntax for Invoking the wlevs.Admin Utility

Example Environment

Exit Codes Returned by wlevs.Admin

Connection Arguments

User Credentials Arguments

Common Arguments

Command for Getting Usage Help

HELP

Commands for Managing the Server Life Cycle

SHUTDOWN

Commands for Managing the EPL Rules of an Application

ADDRULE

DELETERULE

GETRULE

UPLOAD

DOWNLOAD

Commands for Managing Oracle CEP MBeans

Specifying MBean Types

MBean Management Commands

GET

INVOKE

QUERY

SET

Configuring Security for Oracle Complex Event Processing

Overview of Security in Complex Event Processing

Configuring Security With the File-Based Provider

Configuring File-Based Security: Main Steps

Avoiding Cleartext Passwords in the startwlevs Script

Being Prompted for a Password at Server Startup

Putting the Encrypted Password in a Security XML file

Disabling File-Based Security

The passgen Command Line Utility

passgen Syntax

Examples of Using passgen

Using passgen interactively

Providing a Password on the Command Line

The secgen Command Line Utility

Generating a File-Based Provider Configuration File

Generating a Key File

Using the secgen Properties File

Examples of Using secgen

Limitations of secgen

Configuring Jetty for Oracle Complex Event Processing

Overview of Jetty Support in Oracle Complex Event Processing

Servlets

Network I/O Integration

Thread Pool Integration

Work Managers

Understanding How Oracle CEP Uses Thread Pools

Understanding Work Manager

Configuring a Jetty Server Instance

jetty Configuration Object

netio Configuration Object

work-manager Configuration Object

jetty-web-app Configuration Object

Developing Servlets for Jetty

Web App Deployment

Example Jetty Configuration

Configuring JMX for Oracle Complex Event Processing

Overview of JMX Support in Oracle Complex Event Processing

Configuring JMX

jmx Configuration Object

rmi Configuration Object

jndi-context Configuration Object

exported-jndi-context Configuration Object

Example of Configuring JMX

Configuring Access to a Relational Database

Overview of Database Access from an Oracle Complex Event Processing Application

Description of Oracle CEP Data Sources

Data Source Configuration

Configuring Access to a Relational Database: Main Steps

Configuring the HTTP Publish-Subscribe Server

Overview of HTTP Publish-Subscribe Server

Configuring the HTTP Publish-Subscribe Server

Example of Configuring the HTTP Publish-Subscribe Server

Configuring Logging and Debugging

Configuration Scenarios

Overview of Logging Services Configuration

Setting the Log Factory

Using Log Severity Levels

Log Message Format

Format of Output to Standard Out and Standard Error

OSGI Framework Logger

How to Use the Commons Logging API

Configuring the Oracle CEP Logging Service

Logging Service

log-stdout

log-file

Debug

Configuring debug using System Properties

Configuring debug using a Configuration File

Supported Debug Flags

Example Debug Configuration

Log4j

About Log4j

Loggers

Appenders

Layouts

log4j Properties

Enabling Log4j Logging