Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

Part I Overview

1 Overview of Oracle CEP Server Administration

• 1.1 Understanding Oracle CEP Servers and Domains
• 1.2 Understanding Oracle CEP Server Lifecycle
  • 1.2.1 User Action: Start Oracle CEP Server
  • 1.2.2 User Action: Stop Oracle CEP Server
• 1.3 Understanding Oracle CEP Server Configuration
  • 1.3.1 Oracle CEP Server Configuration Files
  • 1.3.2 Configuring an Oracle CEP Server by Manually Editing the config.xml File
  • 1.3.3 Configuration History Management
• 1.4 Understanding Oracle CEP Server Administration Tools
  • 1.4.1 Configuration Wizard
  • 1.4.2 Oracle CEP Visualizer
  • 1.4.3 wlevs.Admin Command-Line Utility
  • 1.4.4 Deployer Command-Line Utility
  • 1.4.5 Security Command-Line Utilities
  • 1.4.6 JMX
• 1.5 Understanding Oracle CEP Server Administration Tasks
  • 1.5.1 Creating Oracle CEP Servers and Domains
  • 1.5.2 Updating Oracle CEP Servers and Domains
  • 1.5.3 Configuring Oracle CEP Servers
  • 1.5.4 Starting and Stopping Oracle CEP Servers
  • 1.5.5 Deploying Applications to Oracle CEP Servers
  • 1.5.6 Managing Oracle CEP Applications, Servers, and Domains

Part II Standalone-Server Domains

2 Introduction to Standalone-Server Domains

• 2.1 Overview of Oracle CEP Standalone-Server Domain Administration
• 2.2 Scalability and Oracle CEP Standalone-Server Domain
• 2.3 Next Steps

3 Administrating Oracle CEP Standalone-Server Domains

• 3.1 Creating an Oracle CEP Standalone-Server Domain
  • 3.1.1 Creating an Oracle CEP Standalone-Server Domain Using the Configuration Wizard in Graphical Mode
• 3.2 Updating an Oracle CEP Standalone-Server Domain
  • 3.2.1 How to Update an Oracle CEP Standalone-Server Domain Using the Configuration Wizard in Graphical Mode
• 3.3 Starting and Stopping an Oracle CEP Server in a Standalone-Server Domain
  • 3.3.1 How to Start an Oracle CEP Standalone-Server Using the startwlevs Script
  • 3.3.2 How to Stop an Oracle CEP Standalone-Server Using the stopwlevs Script

4 Deploying Applications to Standalone-Server Domains

• 4.1 Deploying an Application to an Oracle CEP Standalone-Server Domain
  • 4.1.1 How to Deploy an Application to an Oracle CEP Standalone-Server Using the Oracle CEP Visualizer
  • 4.1.2 How to Deploy an Application to an Oracle CEP Singleton Server Group Using the Deployer Utility

Part III Multi-Server Domains

5 Introduction to Multi-Server Domains

• 5.1 Overview of Oracle CEP Multi-Server Domain Administration
  • 5.1.1 Oracle Coherence Clustering
  • 5.1.2 Oracle CEP Native Clustering
• 5.2 Groups
  • 5.2.1 Singleton Server Deployment Group
  • 5.2.2 Domain Deployment Group
  • 5.2.3 Custom Deployment Groups
• 5.3 Multi-Server Notifications and Messaging
• 5.4 Multi-Server Domain Directory Structure
• 5.5 Order of cluster Element Child Elements
• 5.6 High Availability and Multi-Server Domains
• 5.7 Scalability and Multi-Server Domains
• 5.8 Next Steps

6 Administrating Multi-Server Domains With Oracle Coherence

• 6.1 Creating an Oracle CEP Multi-Server Domain Using Oracle Coherence
  • 6.1.1 How to Create an Oracle CEP Multi-Server Domain With Default Groups Using Oracle Coherence
  • 6.1.2 How to Create an Oracle CEP Multi-Server Domain With Custom Groups Using Oracle Coherence
  • 6.1.3 Configuring the Oracle Coherence Cluster
    • 6.1.3.1 The tangosol-coherence-override.xml File
• 6.2 Updating an Oracle CEP Multi-Server Domain Using Oracle Coherence
  • 6.2.1 How to Update an Oracle CEP Multi-Server Domain Using the Configuration Wizard in Graphical Mode
• 6.3 Securing the Messages Sent Between Servers in a Multi-Server Domain
  • 6.3.1 How to Secure the Messages Sent Between Servers in a Multi-Server Domain Using Oracle Coherence
• 6.4 Using the Multi-Server Domain APIs to Manage Group Membership Changes
• 6.5 Starting and Stopping an Oracle CEP Server in a Multi-Server Domain

7 Administrating Multi-Server Domains With Oracle CEP Native Clustering

• 7.1 Creating an Oracle CEP Multi-Server Domain Using Oracle CEP Native Clustering
  • 7.1.1 How to Create an Oracle CEP Multi-Server Domain With Default Groups Using Oracle CEP Native Clustering
  • 7.1.2 How to Create an Oracle CEP Multi-Server Domain With Custom Groups Using Oracle CEP Native Clustering
• 7.2 Updating an Oracle CEP Multi-Server Domain Using Oracle CEP Native Clustering
  • 7.2.1 How to Update an Oracle CEP Multi-Server Domain Using the Configuration Wizard in Graphical Mode
• 7.3 Securing the Messages Sent Between Servers in a Multi-Server Domain
  • 7.3.1 How to Secure the Messages Sent Between Servers in a Multi-Server Domain Using Oracle CEP Native Clustering
• 7.4 Using the Multi-Server Domain APIs to Manage Group Membership Changes
• 7.5 Starting and Stopping an Oracle CEP Server in a Multi-Server Domain

8 Deploying Applications to Multi-Server Domains

• 8.1 Overview of Deploying an Application to an Oracle CEP Multi-Server Domain
• 8.2 Deploying to an Oracle CEP Server Using the Oracle CEP Visualizer
• 8.3 Deploying to an Oracle CEP Server Singleton Group Using the Deployer Utility
• 8.4 Deploying to an Oracle CEP Server Domain Group Using the Deployer Utility
• 8.5 Deploying to an Oracle CEP Server Custom Group Using the Deployer Utility
• 8.6 Troubleshooting Multi-Server Domain Deployment
  • 8.6.1 Oracle CEP Server Stops Application After Deployment

Part IV Configuring Services

9 Configuring Security for Oracle CEP

• 9.1 Overview of Security in Oracle CEP
  • 9.1.1 Java SE Security
  • 9.1.2 Security Providers
  • 9.1.3 Users, Groups, and Roles
  • 9.1.4 SSL
  • 9.1.5 FIPS
  • 9.1.6 Enabling and Disabling Security
  • 9.1.7 Security Utilities
  • 9.1.8 Specifying User Credentials When Using the Command-Line Utilities
  • 9.1.9 Security in Oracle CEP Examples and Domains
• 9.2 Configuring Java SE Security for Oracle CEP Server
• 9.3 Configuring a Security Provider
  • 9.3.1 Configuring Authentication Using the LDAP Provider and Authorization Using the DBMS Provider
  • 9.3.2 Configuring Both Authentication and Authorization Using the DBMS Provider
• 9.4 Configuring Password Strength
• 9.5 Configuring SSL to Secure Network Traffic
  • 9.5.1 How to Configure SSL Manually
  • 9.5.2 How to Create a Key-Store Manually
  • 9.5.3 How to Configure SSL in a Multi-Server Domain for Oracle CEP Visualizer
• 9.6 Configuring FIPS for Oracle CEP Server
• 9.7 Configuring HTTPS-Only Connections for Oracle CEP Server
• 9.8 Configuring Security for Oracle CEP Server Services
  • 9.8.1 Configuring Jetty Security
  • 9.8.2 Configuring JMX Security
  • 9.8.3 Configuring JDBC Security
  • 9.8.4 Configuring HTTP Publish-Subscribe Server Channel Security
• 9.9 Configuring the Oracle CEP Security Auditor
• 9.10 Disabling Security

10 Configuring Jetty for Oracle CEP

• 10.1 Overview of Jetty Support in Oracle Complex Event Processing
  • 10.1.1 Servlets
  • 10.1.2 Network I/O Integration
  • 10.1.3 Thread Pool Integration
  • 10.1.4 Jetty Work Managers
    • 10.1.4.1 Understanding How Oracle CEP Uses Thread Pools
    • 10.1.4.2 Understanding Work Manager Configuration
• 10.2 Configuring a Jetty Server Instance
  • 10.2.1 jetty Configuration Object
  • 10.2.2 netio Configuration Object
  • 10.2.3 work-manager Configuration Object
  • 10.2.4 jetty-web-app Configuration Object
  • 10.2.5 Developing Servlets for Jetty
  • 10.2.6 Web Application Deployment
• 10.3 Example Jetty Configuration

11 Configuring JMX for Oracle CEP

• 11.1 Overview of JMX Support in Oracle CEP
  • 11.1.1 Understanding JMX Configuration
  • 11.1.2 Understanding JMX Management
    • 11.1.2.1 Accessing the Oracle CEP JMX Server
    • 11.1.2.2 Accessing Configuration MBeans
    • 11.1.2.3 Accessing Oracle CEP Runtime MBeans
  • 11.1.3 Understanding Oracle CEP MBeans
    • 11.1.3.1 Oracle CEP Configuration MBeans
    • 11.1.3.2 Oracle CEP Runtime MBeans
    • 11.1.3.3 Oracle CEP MBean Hierarchy
• 11.2 Configuring JMX
  • 11.2.1 jmx Configuration Object
  • 11.2.2 rmi Configuration Object
  • 11.2.3 jndi-context Configuration Object
  • 11.2.4 exported-jndi-context Configuration Object
  • 11.2.5 Example of Configuring JMX
• 11.3 Managing With JMX
  • 11.3.1 How to Programmatically Connect to the Oracle CEP JMX Server From a Non-Oracle CEP Client
  • 11.3.2 How to Programmatically Connect to the Oracle CEP JMX Server From an Oracle CEP Client
  • 11.3.3 How to Programmatically Configure an Oracle CEP Component Using JMX APIs
  • 11.3.4 How to Programmatically Monitor the Throughput and Latency of an Oracle CEP Component Using JMX APIs
  • 11.3.5 How to Connect to a Local or Remote Oracle CEP JMX Server Using JConsole With Security Enabled
  • 11.3.6 How to Connect to a Local or Remote Oracle CEP JMX Server Using JConsole With Security Disabled

12 Configuring JDBC for Oracle CEP

• 12.1 Overview of Database Access from an Oracle CEP Application
  • 12.1.1 Oracle JDBC Driver
  • 12.1.2 Type 4 JDBC Driver for SQL Server from DataDirect
  • 12.1.3 Supported Databases
    • 12.1.3.1 Databases Supported by the Oracle JDBC Driver
    • 12.1.3.2 Databases Supported by the Type 4 JDBC Driver for SQL Server from DataDirect
• 12.2 Description of Oracle CEP Data Sources
  • 12.2.1 Default Data Source Configuration
  • 12.2.2 Custom Data Source Configuration
• 12.3 Configuring Access to a Database Using the Oracle JDBC Driver
• 12.4 Configuring Access to a Database Using the Type 4 JDBC Drivers from Data Direct
• 12.5 Configuring Access to a Different Database Driver or Driver Version
  • 12.5.1 How to Access a Database Driver Using an Application Library Built With bundler.sh
  • 12.5.2 How to Access a Database Driver Using an Application Library Built With Oracle CEP IDE for Eclipse
  • 12.5.3 How to Access a Database Driver Using bootclasspath

13 Configuring HTTP Publish-Subscribe for Oracle CEP

• 13.1 Overview of HTTP Publish-Subscribe
  • 13.1.1 How the HTTP Pub-Sub Server Works
  • 13.1.2 HTTP Pub-Sub Server Support in Oracle CEP
• 13.2 Creating a New HTTP Publish-Subscribe Server
• 13.3 Configuring an Existing HTTP Publish-Subscribe Server
• 13.4 Example HTTP Publish-Subscribe Server Configuration

14 Configuring Logging and Debugging for Oracle CEP

• 14.1 Overview of Logging and Debugging Configuration
  • 14.1.1 Commons Apache Logging Framework
    • 14.1.1.1 Setting the Log Factory
    • 14.1.1.2 Using Log Severity Levels
    • 14.1.1.3 Log Files
    • 14.1.1.4 Log Message Format
  • 14.1.2 OSGi Framework Logger
  • 14.1.3 Log4j Logger
    • 14.1.3.1 Loggers
    • 14.1.3.2 Appenders
    • 14.1.3.3 Layouts
• 14.2 Configuring the Oracle CEP Logging Service
  • 14.2.1 logging-service
  • 14.2.2 log-file
  • 14.2.3 log-stdout
  • 14.2.4 Configuring Severity for an Individual Module
• 14.3 Configuring Log4j Logging
  • 14.3.1 Configuring log4j Properties
  • 14.3.2 Configuring Application Manifest
  • 14.3.3 Enabling Log4j Logging
  • 14.3.4 Debugging Log4j Logging
• 14.4 Using the Apache Commons Logging API
• 14.5 Configuring Oracle CEP Debugging Options
  • 14.5.1 How to Configure Oracle CEP Debugging Options Using System Properties
  • 14.5.2 How to Configure Oracle CEP Debugging Options Using a Configuration File

Part V References

A wlevs.Admin Command-Line Reference

• A.1 Overview of the wlevs.Admin Utility
• A.2 Configuring the wlevs.Admin Utility Environment
• A.3 Running the wlevs.Admin Utility Remotely
• A.4 Running wlevs.Admin Utility in SSL Mode
• A.5 Syntax for Invoking the wlevs.Admin Utility
  • A.5.1 Example Environment
  • A.5.2 Exit Codes Returned by wlevs.Admin
• A.6 Connection Arguments
• A.7 User Credentials Arguments
• A.8 Common Arguments
• A.9 Command for Getting Usage Help
  • A.9.1 HELP
    • A.9.1.1 Syntax
    • A.9.1.2 Example
• A.10 Commands for Managing the Server Life Cycle
  • A.10.1 SHUTDOWN
    • A.10.1.1 Syntax
    • A.10.1.2 Example
• A.11 Commands for Managing the Oracle CQL Rules of an Application
  • A.11.1 GETRULE
    • A.11.1.1 Syntax
    • A.11.1.2 Example
  • A.11.2 ADDRULE
    • A.11.2.1 Syntax
    • A.11.2.2 Example
  • A.11.3 DELETERULE
    • A.11.3.1 Syntax
    • A.11.3.2 Example
  • A.11.4 REPLACERULE
    • A.11.4.1 Syntax
    • A.11.4.2 Example
  • A.11.5 STARTRULE
    • A.11.5.1 Syntax
    • A.11.5.2 Example
  • A.11.6 STOPRULE
    • A.11.6.1 Syntax
    • A.11.6.2 Example
  • A.11.7 UPLOAD
    • A.11.7.1 Syntax
    • A.11.7.2 Example
  • A.11.8 DOWNLOAD
    • A.11.8.1 Syntax
    • A.11.8.2 Example
• A.12 Commands for Managing the EPL Rules of an Application
  • A.12.1 ADDRULE
    • A.12.1.1 Syntax
    • A.12.1.2 Example
  • A.12.2 DELETERULE
    • A.12.2.1 Syntax
    • A.12.2.2 Example
  • A.12.3 REPLACERULE
    • A.12.3.1 Syntax
    • A.12.3.2 Example
  • A.12.4 GETRULE
    • A.12.4.1 Syntax
    • A.12.4.2 Example
  • A.12.5 ADDPARAMS
    • A.12.5.1 Syntax
    • A.12.5.2 Example
  • A.12.6 DELETEPARAMS
    • A.12.6.1 Syntax
    • A.12.6.2 Example
  • A.12.7 GETPARAMS
    • A.12.7.1 Syntax
    • A.12.7.2 Example
  • A.12.8 UPLOAD
    • A.12.8.1 Syntax
    • A.12.8.2 Example
  • A.12.9 DOWNLOAD
    • A.12.9.1 Syntax
    • A.12.9.2 Example
• A.13 Commands for Managing Oracle CEP MBeans
  • A.13.1 Specifying MBean Types
  • A.13.2 MBean Management Commands
  • A.13.3 GET
    • A.13.3.1 Syntax
    • A.13.3.2 Example
  • A.13.4 INVOKE
    • A.13.4.1 Syntax
    • A.13.4.2 Example
  • A.13.5 QUERY
    • A.13.5.1 Syntax
    • A.13.5.2 Example
    • A.13.5.3 Querying for Application and Processor Names
  • A.13.6 SET
    • A.13.6.1 Syntax
    • A.13.6.2 Example
• A.14 Commands for Controlling Event Record and Playback
  • A.14.1 STARTRECORD
    • A.14.1.1 Syntax
    • A.14.1.2 Example
  • A.14.2 STOPRECORD
    • A.14.2.1 Syntax
    • A.14.2.2 Example
  • A.14.3 CONFIGURERECORD
    • A.14.3.1 Syntax
    • A.14.3.2 Example
  • A.14.4 SCHEDULERECORD
    • A.14.4.1 Syntax
    • A.14.4.2 Example
  • A.14.5 LISTRECORD
    • A.14.5.1 Syntax
    • A.14.5.2 Example
  • A.14.6 STARTPLAYBACK
    • A.14.6.1 Syntax
    • A.14.6.2 Example
  • A.14.7 STOPPLAYBACK
    • A.14.7.1 Syntax
    • A.14.7.2 Example
  • A.14.8 CONFIGUREPLAYBACK
    • A.14.8.1 Syntax
    • A.14.8.2 Example
  • A.14.9 SCHEDULEPLAYBACK
    • A.14.9.1 Syntax
    • A.14.9.2 Example
  • A.14.10 LISTPLAYBACK
    • A.14.10.1 Syntax
    • A.14.10.2 Example
• A.15 Commands for Monitoring Throughput and Latency
  • A.15.1 MONITORAVGLATENCY
    • A.15.1.1 Syntax
    • A.15.1.2 Example
  • A.15.2 MONITORAVGLATENCYTHRESHOLD
    • A.15.2.1 Syntax
    • A.15.2.2 Example
  • A.15.3 MONITORMAXLATENCY
    • A.15.3.1 Syntax
    • A.15.3.2 Example
  • A.15.4 MONITORAVGTHROUGHPUT
    • A.15.4.1 Syntax
    • A.15.4.2 Example
• A.16 Commands for Managing Configuration History
  • A.16.1 CONFIGHISTORY
    • A.16.1.1 Syntax
    • A.16.1.2 Example
  • A.16.2 DELETECONFIGCHANGEHISTORY
    • A.16.2.1 Syntax
    • A.16.2.2 Example
  • A.16.3 LISTCHANGERECORDS
    • A.16.3.1 Syntax
    • A.16.3.2 Example
  • A.16.4 LISTRESOURCEREVISIONS
    • A.16.4.1 Syntax
    • A.16.4.2 Example
  • A.16.5 UNDOCONFIGCHANGE
    • A.16.5.1 Syntax
    • A.16.5.2 Example

B Deployer Command-Line Reference

• B.1 Overview of Using the Deployer Command-Line Utility
• B.2 Configuring the Deployer Utility Environment
• B.3 Running the Deployer Utility Remotely
• B.4 Syntax for Invoking the Deployer Utility
  • B.4.1 Connection Arguments
  • B.4.2 User Credential Arguments
  • B.4.3 Deployment Commands
• B.5 Examples of Using the Deployer Utility

C Security Utilities Command-Line Reference

• C.1 The cssconfig Command-Line Utility
  • C.1.1 cssconfig Syntax
• C.2 The encryptMSAConfig Command-Line Utility
  • C.2.1 encryptMSAConfig Syntax
• C.3 The GrabCert Command-Line Utility
  • C.3.1 GrabCert Syntax
  • C.3.2 Examples of Using GrabCert
• C.4 The passgen Command-Line Utility
  • C.4.1 passgen Syntax
  • C.4.2 Examples of Using passgen
    • C.4.2.1 Using passgen interactively
    • C.4.2.2 Providing a Password on the Command Line
• C.5 The secgen Command-Line Utility
  • C.5.1 Generating a File-Based Provider Configuration File
  • C.5.2 Generating a Key File
  • C.5.3 Using the secgen Properties File
  • C.5.4 Examples of Using secgen
  • C.5.5 Limitations of secgen

Index