Configuration History Management Understanding Oracle CEP Server Configuration

1-8 Oracle Complex Event Processing Administrators Guide

1.3.4 Configuring the Oracle CEP Server bootclasspath

In general, you configure all Oracle CEP server options using the Oracle CEP server configuration file, you configure all Oracle CEP application options using Oracle CEP assembly and component configuration files, and you satisfy all Oracle CEP application run-time dependencies by importing the relevant private artifacts into an Oracle CEP project or deploying a shared application library that contains the relevant shared artifacts that applications import indirectly. If necessary, you can configure the Oracle CEP bootclasspath with artifacts, such as native code libraries, that the Oracle CEP server makes available before both application libraries and Oracle CEP applications are deployed. You can use this technique to satisfy application or application library dependencies that you cannot satisfy using simple application imports or application libraries. For more information, see Application Dependencies in the Oracle Complex Event Processing Developers Guide for Eclipse.

1.3.4.1 How to Configure the Oracle CEP Server bootclasspath

Optionally, you can use the bootclasspath to make native code libraries available to application libraries that depend on them. To configure the Oracle CEP bootclasspath: 1. Update the server start script in the server directory of your domain directory so that Oracle CEP finds the appropriate natvie library JAR file when it boots up. The name of the server start script is startwlevs.cmd Windows or startwlevs.sh UNIX, and the script is located in the server directory of your domain directory. The out-of-the-box sample domains are located in ORACLE_ CEP_HOME ocep_11.1samplesdomains, and the user domains are located in ORACLE_CEP_HOMEuser_projectsdomains, where ORACLE_CEP_HOME refers to the Oracle CEP installation directory, such as d:\oracle_cep. Update the start script by adding the -Xbootclasspatha option to the Java command that executes the wlevs_3.0.jar file. Set the -Xbootclasspatha option to the full pathname of the native library you are going to use. For example, if you want to use the native library mynativelib located in Oracle CEP server directory USER_INSTALL_DIR\bin, update the java command in the start script as follows -- the updated section shown in bold the example is broken here for readability; in practice you should have the full command on one line: JAVA_HOME\bin\java -Dwlevs.home=USER_INSTALL_DIR -Dbea.home=BEA_HOME -Xbootclasspatha:USER_INSTALL_DIR\bin\mynativelib.jar -jar USER_INSTALL_DIR\bin\wlevs_3.0.jar -disablesecurity 1 2 3 4 5 6 In the example, USER_INSTALL_DIR points to ORACLE_CEP_HOME\ocep_ 11.1. 2. If Oracle CEP is running, restart it so it reads the new java option and data source information. For more information, see Section 1.5.4, Starting and Stopping Oracle CEP Servers . Overview of Oracle CEP Server Administration 1-9

1.4 Understanding Oracle CEP Server Administration Tools

This section describes the various Oracle CEP server administration tools that you can use to administer Oracle CEP servers, domains, and applications. You can administer Oracle CEP servers, domains, and applications using any of the following: ■ Section 1.4.1, Configuration Wizard ■ Section 1.4.2, Oracle CEP Visualizer ■ Section 1.4.3, wlevs.Admin Command-Line Utility ■ Section 1.4.4, Deployer Command-Line Utility ■ Section 1.4.5, Security Command-Line Utilities ■ Section 1.4.6, JMX For more information, see: ■ Section 1.3, Understanding Oracle CEP Server Configuration ■ Section 1.5, Understanding Oracle CEP Server Administration Tasks

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 Complex Event Processing Visualizer Users 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 .