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 Standalone-Server Domain

Overview of Oracle CEP Servers and Domains

Creating a Standalone-Server 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

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 CEP Servers

Overview of Configuring Oracle CEP Servers

Configuring the Server by Manually Editing the config.xml File

Configuring and Using Oracle CEP Multi-Server Domains

Overview of Oracle CEP Multi-Server Domains

Oracle CEP Multi-Server Domain

Groups

Multi-Server Notifications and Messaging

Multi-Server Domain Directory Structure

Creating and Configuring a Simple Multi-Server Domain

Adding New Servers to an Existing Domain Using the Configuration Wizard

Adding New Servers in Graphical Mode

Adding New Servers in Silent Mode

Configuring the Servers in a Multi-Server Domain

Configuring Custom Groups for a Multi-Server Domain

Starting the Servers in a Multi-Server Domain

Deploying Applications to a Multi-Server Domain

Deploying to the Singleton Server Group

Deploying to the Domain Group

Deploying to a Custom Group

Using the Multi-Server Domain APIs to Manage Group Membership Changes

Order and Additional Child Elements of the <cluster> Element

Troubleshooting Multi-Server Domains

wlevs.Admin Command-Line Reference

Overview of the wlevs.Admin Utility

Required Environment for the wlevs.Admin Utility

Running the wlevs.Admin Utility Remotely

Running wlevs.Admin Utility in SSL Mode

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

REPLACERULE

GETRULE

ADDPARAMS

DELETEPARAMS

GETPARAMS

UPLOAD

DOWNLOAD

Commands for Managing Oracle CEP MBeans

Specifying MBean Types

MBean Management Commands

GET

INVOKE

QUERY

SET

Commands for Controlling Event Record and Playback

STARTRECORD

ENABLEPLAYBACK

STOPRECORD

DISABLEPLAYBACK

CONFIGURERECORD

CONFIGUREPLAYBACK

Commands for Monitoring Throughput and Latency

MONITORAVGLATENCY

MONITORAVGLATENCYTHRESHOLD

MONITORMAXLATENCY

MONITORAVGTHROUGHPUT

Managing Applications, Servers, and Domains Using MBeans

Overview of Management

Overview of Oracle CEP MBeans

Configuration MBeans

Runtime MBeans

MBean Hierarchy

MBean Naming

Configuration MBean Naming

Runtime MBean Naming

Dynamically Configuring a Component Using JMX: Typical Steps

Programming with JMX

Dynamically Monitoring the Throughput and Latency of a Component

Configuring Security for Oracle CEP

Overview of Security in Oracle CEP

Security Providers

Overview of Users, Groups, and Roles

Security in Oracle CEP Examples and Domains

Securely Specifying User Credentials When Using the Command-Line Utilities

Using the LDAP Provider For Authentication and DBMS Provider for Authorization

Sample LDAP/DBMS Properties File

Using the DBMS Provider for Both Authentication and Authorization

Sample DBMS Property File

Configuring Password Strength

Changing the Default Administration User

Using SSL to Secure Network Traffic

How SSL Is Configured in Oracle CEP

Configuring SSL In a Multi-Server Domain for Use By Visualizer

Disabling Security

Locking Down the Server

Configuring Java SE Security

Security Command Line Utility Reference

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 CEP Application

Type 4 JDBC Driver for SQL Server from DataDirect

Supported Databases

Description of Oracle CEP Data Sources

Data Source Configuration

Configuring Access to a Database using the Type 4 JDBC Drivers from Data Direct

Configuring Access to a Database Using Your Own Database Drivers

Configuring the HTTP Publish-Subscribe Server

Overview of HTTP Publish-Subscribe Servers

How the HTTP Pub-Sub Server Works

HTTP Pub-Sub Server Support in Oracle CEP

Configuring an Existing HTTP Publish-Subscribe Server

Creating a New 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

Configuring Severity for an Individual Module

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