1 Overview of Oracle CEP Server Administration

1.2.1 User Action: Start Oracle CEP Server

After you start the Oracle CEP server, it performs the following actions:

1. Starts core engine bundles.

2. Starts Oracle CEP bundles.

3. Registers MBeans.

4. Oracle CEP server state is now STARTING.

5. Starts application bundles.

6. Oracle CEP server state is now RUNNING.

1.2.2 User Action: Stop Oracle CEP Server

After you shutdown the Oracle CEP server, it performs the following actions:

1. Oracle CEP server state is SHUTTING_DOWN.

2. Unregister ServerRuntimeMBean.

   Oracle CEP server ceases to have a state.

3. Shuts down Oracle CEP bundles.

4. Shuts down application bundles.

5. Shuts down core engine bundles.

1.3.1 Oracle CEP Server Configuration Files

By default, the Configuration Wizard creates domains in the ORACLE_CEP_HOME/user_projects/domains directory, where ORACLE_CEP_HOME refers to the Oracle CEP installation directory such as d:\oracle_cep.

For example, d:\oracle_cep\user_projects\domains\my_domain, where my_domain is the a domain directory. Each Oracle CEP server you create in this domain will have a subdirectory in my_domain such as c:\oracle_cep\user_projects\domains\my_domain\server1.

The following list describes the important files and directories of a server in a domain, relative to the server directory (such as c:\oracle_cep\user_projects\domains\my_domain\server1):

• deployments.xml—XML file that contains the list of applications, packaged as OSGi bundles, that are currently deployed to the Oracle CEP instance of this domain. You never update this file manually to deploy applications, but rather, use the deployer tool.

• startwlevs.cmd—Command file used to start an instance of Oracle CEP. The UNIX equivalent is called startwlevs.sh.

• stopwlevs.cmd—Command file used to stop an instance of Oracle CEP. The UNIX equivalent is called stopwlevs.sh.

• config/config.xml—XML file that describes the services that have been configured for the Oracle CEP instance. Services include logging, debugging, Jetty Web Service, and JDBC data sources.

  For more information, see Section 1.3.2, "Configuring an Oracle CEP Server by Manually Editing the config.xml File".

• config/security*—Files that configure security for the domain.

• config/atnstore.txt—File that lists the configured users and groups for this domain.

1.3.2 Configuring an Oracle CEP Server by Manually Editing the config.xml File

The most efficient, least error-prone way to configure an Oracle CEP server is to use one or more of the Oracle CEP administration tools as Section 1.4, "Understanding Oracle CEP Server Administration Tools" describes.

Optionally, you can perform Oracle CEP server configuration by manually editing the Oracle CEP server config.xml file. For more information on the location of the Oracle CEP server config.xml file, see Section 1.3.1, "Oracle CEP Server Configuration Files".

You can configure the following server objects and features using the config.xml file (the referenced sections describe the exact elements you must add or update):

• How the servers in a multi-server domain are configured together. This includes the multicast address and port, the groups, and so on.

  See:

  • Chapter 3, "Administrating Oracle CEP Standalone-Server Domains"

  • Chapter 6, "Administrating Multi-Server Domains With Oracle Coherence"

  • Chapter 7, "Administrating Multi-Server Domains With Oracle CEP Native Clustering"

• Security.

  See Chapter 9, "Configuring Security for Oracle CEP."

• Jetty, an open-source, standards-based, full-featured Java Web Server.

  See Chapter 10, "Configuring Jetty for Oracle CEP."

• JMX, required to use the Oracle CEP Visualizer, wlevs.Admin utility, and Deployer utility

  See Chapter 11, "Configuring JMX for Oracle CEP."

• JDBC data source, used to connect to a relational database.

  See Chapter 12, "Configuring JDBC for Oracle CEP."

• HTTP publish-subscribe server.

  See Chapter 13, "Configuring HTTP Publish-Subscribe for Oracle CEP."

• Logging and debugging properties of the server. By default, the log level is set to NOTICE.

  See Chapter 14, "Configuring Logging and Debugging for Oracle CEP."

Example 1-1 shows a sample config.xml, from the ORACLE_CEP_HOME/user_projects/domains/ocep_domain/defaultserver template domain, shows how to configure some of these services.

<?xml version="1.0" encoding="UTF-8"?>
<!--Sample XML file generated by XMLSpy v2007 sp2 (http://www.altova.com)-->
<n1:config 
  xsi:schemaLocation="http://www.bea.com/ns/wlevs/config/server wlevs_server_config.xsd" 
  xmlns:n1="http://www.bea.com/ns/wlevs/config/server" 
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <netio>
      <name>NetIO</name>
      <port>9002</port>
   </netio>
   <netio>
      <name>sslNetIo</name>
      <ssl-config-bean-name>sslConfig</ssl-config-bean-name>
      <port>9003</port>
   </netio>
   <work-manager>
      <name>JettyWorkManager</name>
      <min-threads-constraint>5</min-threads-constraint>
      <max-threads-constraint>10</max-threads-constraint>
   </work-manager>
   <jetty>
      <name>JettyServer</name>
      <network-io-name>NetIO</network-io-name>
      <work-manager-name>JettyWorkManager</work-manager-name>
      <secure-network-io-name>sslNetIo</secure-network-io-name>
   </jetty>
   <rmi>
      <name>RMI</name>
      <http-service-name>JettyServer</http-service-name>
   </rmi>
   <jndi-context>
      <name>JNDI</name>
   </jndi-context>
   <exported-jndi-context>
      <name>exportedJndi</name>
      <rmi-service-name>RMI</rmi-service-name>
   </exported-jndi-context>
   <jmx>
      <rmi-service-name>RMI</rmi-service-name>
      <jndi-service-name>JNDI</jndi-service-name>
   </jmx>
   <ssl>
      <name>sslConfig</name>
      <key-store>./ssl/evsidentity.jks</key-store>
      <key-store-pass>
         <password>{Salted-3DES}j4XEtuXmmvEl4M/NInwq0A==</password>
      </key-store-pass>
      <key-store-alias>evsidentity</key-store-alias>
      <key-manager-algorithm>SunX509</key-manager-algorithm>
      <ssl-protocol>TLS</ssl-protocol>
      <enforce-fips>false</enforce-fips>
      <need-client-auth>false</need-client-auth>
   </ssl>
   <http-pubsub>
      <name>pubsub</name>
      <path>/pubsub</path>
      <pub-sub-bean>
         <server-config>
            <name>/pubsub</name>
            <supported-transport>
               <types>
                  <element>long-polling</element>
               </types>
            </supported-transport>
            <publish-without-connect-allowed>true</publish-without-connect-allowed>
         </server-config>
         <channels>
            <element>
               <channel-pattern>/evsmonitor</channel-pattern>
            </element>
            <element>
               <channel-pattern>/evsalert</channel-pattern>
            </element>
            <element>
               <channel-pattern>/evsdomainchange</channel-pattern>
            </element>
         </channels>
      </pub-sub-bean>
   </http-pubsub>
   <cluster>
      <server-name>productionServer</server-name>
   </cluster>
   <domain>
      <name>ocep_domain</name>
   </domain>

1.3.3 Configuration History Management

When you deploy an application to the Oracle CEP server, the Oracle CEP server creates a configuration history for the application. Any configuration changes you make to the application are recorded in this history. You can view and roll-back (undo) these changes using the Oracle CEP Visualizer or wlevs.Admin tool.

For more information, see:

• "Configuration History Management" in the Oracle CEP Visualizer User's Guide

• Appendix A, "Commands for Managing Configuration History"

1.4.1 Configuration Wizard

The Configuration Wizard is a Java application that you can invoke graphically to create and update Oracle CEP servers and domains.

For more information, see:

• Chapter 3, "Administrating Oracle CEP Standalone-Server Domains"

• Chapter 6, "Administrating Multi-Server Domains With Oracle Coherence"

• Chapter 7, "Administrating Multi-Server Domains With Oracle CEP Native Clustering"

1.4.2 Oracle CEP Visualizer

The Oracle CEP Visualizer is the Oracle CEP graphical administration console.

It is a Web 2.0 application that consumes data from Oracle CEP, displays it in a useful and intuitive way to system administrators and operators, and, for specified tasks, accepts data that is then passed back to Oracle CEP to change its configuration.

Using Oracle CEP Visualizer, you can perform a wide variety of Oracle CEP server, domain, and application administration tasks for existing Oracle CEP standalone server domains and Oracle CEP multi-server domains.

For more information, see "Overview of Visualizer" in the Oracle CEP Visualizer User's Guide.

1.4.3 wlevs.Admin Command-Line Utility

The wlevs.Admin command-line utility is a Java application that you can invoke locally or remotely to perform a wide variety of Oracle CEP server, domain, and application administration tasks.

For more information, see Appendix A, "wlevs.Admin Command-Line Reference".

1.4.4 Deployer Command-Line Utility

The Deployer command-line utility is a Java application that you can invoke locally or remotely to perform application deployment and application administration tasks.

For more information, see Appendix B, "Deployer Command-Line Reference".

1.4.5 Security Command-Line Utilities

Oracle CEP provides a variety of command-line utilities that simplify security administration.

For more information, see Appendix C, "Security Utilities Command-Line Reference".

1.4.6 JMX

Using standards-based interfaces that are fully compliant with the Java Management Extensions (JMX) specification, you can perform a wide variety of Oracle CEP server, domain, and application administration tasks programatically using JMX and Oracle CEP MBeans.

For more information, see:

• Chapter 11, "Configuring JMX for Oracle CEP"

• Oracle CEP Java API Reference

1.5.1 Creating Oracle CEP Servers and Domains

The most important administration task is to create Oracle CEP servers and domains.

For more information, see:

• Chapter 3, "Creating an Oracle CEP Standalone-Server Domain"

• Chapter 6, "Creating an Oracle CEP Multi-Server Domain Using Oracle Coherence"

• Chapter 7, "Creating an Oracle CEP Multi-Server Domain Using Oracle CEP Native Clustering"

1.5.2 Updating Oracle CEP Servers and Domains

Once you create an Oracle CEP server and domain, you can update it to change its configuration or group membership.

For more information, see:

• Chapter 3, "Updating an Oracle CEP Standalone-Server Domain"

• Chapter 6, "Updating an Oracle CEP Multi-Server Domain Using Oracle Coherence"

• Chapter 7, "Updating an Oracle CEP Multi-Server Domain Using Oracle CEP Native Clustering"

1.5.3 Configuring Oracle CEP Servers

Once you create an Oracle CEP server and domain, you must configure the various services they provide.

For more information, see:

• Chapter 9, "Configuring Security for Oracle CEP"

• Chapter 10, "Configuring Jetty for Oracle CEP"

• Section 11.2, "Configuring JMX"

• Chapter 12, "Configuring JDBC for Oracle CEP"

• Chapter 13, "Configuring HTTP Publish-Subscribe for Oracle CEP"

• Chapter 14, "Configuring Logging and Debugging for Oracle CEP"

1.5.4 Starting and Stopping Oracle CEP Servers

After you have created an Oracle CEP domain along with at least a single server, you start a server instance so you can then deploy applications and begin running them. During upgrades and after some configuration changes, you must stop and start the Oracle CEP server.

For more information, see:

• Section 3.3, "Starting and Stopping an Oracle CEP Server in a Standalone-Server Domain"

• Oracle Coherence: Section 6.5, "Starting and Stopping an Oracle CEP Server in a Multi-Server Domain"

• Oracle CEP Native Clustering: Section 7.5, "Starting and Stopping an Oracle CEP Server in a Multi-Server Domain"

1.5.5 Deploying Applications to Oracle CEP Servers

Once you have created and configured an Oracle CEP server and domain, you can deploy Oracle CEP applications to them.

For more information, see:

• Section 4.1, "Deploying an Application to an Oracle CEP Standalone-Server Domain"

• Section 8.1, "Overview of Deploying an Application to an Oracle CEP Multi-Server Domain"

• "Overview of Creating Oracle CEP Applications" in the Oracle CEP Developer's Guide for Eclipse.

1.5.6 Managing Oracle CEP Applications, Servers, and Domains

Once you have deployed applications to an Oracle CEP server and domain, you must manage the application to perform tasks such as monitor its performance and perform upgrades.

For more information, see:

• Section 1.4, "Understanding Oracle CEP Server Administration Tools"

• Section 11.3, "Managing With JMX"