4 Oracle CEP IDE for Eclipse and Oracle CEP Servers

Using Oracle CEP IDE for Eclipse, you can manage and deploy to the Oracle CEP server: the core of an Oracle CEP application. It provides the runtime in which your Oracle CEP application executes.

This chapter describes:

• Section 4.1, "Oracle CEP Server Overview"

• Section 4.2, "Creating Oracle CEP Servers"

• Section 4.3, "Managing Oracle CEP Servers"

• Section 4.4, "Debugging an Oracle CEP Application Running on an Oracle CEP Server"

4.1 Oracle CEP Server Overview

The Oracle CEP IDE for Eclipse provides features that allow you to set up and manage Oracle CEP servers that are used during development. These tools help you to:

• Configure instances of Oracle CEP servers

• Attach to external Oracle CEP server instances

• Manage Oracle CEP server lifecycle with start, stop, and debug commands

• Associate applications with and deploy applications to Oracle CEP servers during development

Table 4-1 maps Eclipse terminology used by the Oracle CEP IDE for Eclipse to Oracle CEP server terminology.

Table 4-1 Eclipse and Oracle CEP Server Concepts

Eclipse IDE Concept	Oracle CEP Server Concept	Description
Runtime	Oracle CEP server installation	The Oracle CEP IDE for Eclipse has the concept of a runtime. The runtime defines the location where the Oracle CEP IDE for Eclipse can find the installation of a particular Oracle CEP server. This information is used to find JAR files and OSGi bundles to add to the project classpath and to further define Servers and Server Instances. Note that a Runtime is not itself a runnable artifact.
Server and Server Instance	Domain	The Oracle CEP IDE for Eclipse uses the term Server to describe an actual runnable Oracle CEP server instance. You can think of it as something that has start scripts, for example. In Oracle CEP server terminology, this equates to a Domain. When you set up a server, you specify the domain that this instance will run. For more information on domains, see: For more information, see "Creating and Updating Oracle CEP Standalone Server Domains" in the Oracle CEP Administrator's Guide. For more information, see "Creating and Updating Oracle CEP Multi-Server Domains" in the Oracle CEP Administrator's Guide.
Publish	Deploy	The Oracle CEP IDE for Eclipse typically uses the term Publish to describe physically deploying an application to a server.
Project	Application or Deployment	A project in the Oracle CEP IDE for Eclipse becomes a single Oracle CEP application packaged as an OSGi bundle. It is deployed to a server and shows in the Oracle CEP server's deployments.xml file.

Server definitions are the central concept in controlling an Oracle CEP server from the Oracle CEP IDE for Eclipse. It is from the server definition that you start and stop the server. After associating a project with the server, you can publish (deploy) the application to and unpublish (undeploy) the application from the server, all without having to leave the Oracle CEP IDE for Eclipse. For more information, see Section 4.2, "Creating Oracle CEP Servers".

You can communicate with a running Oracle CEP server using Oracle CEP IDE for Eclipse in the following ways:

• Start a server from within Oracle CEP IDE for Eclipse.

  In this case, the Oracle CEP server console is sent directly to the console view in Oracle CEP IDE for Eclipse. All of the Oracle CEP server features (such as start, stop, publish, unpublish, debug, and launching the Oracle CEP Visualizer) are available. The Oracle CEP server process itself is managed from within Oracle CEP IDE for Eclipse. In other words, stopping the Oracle CEP server from the Oracle CEP IDE for Eclipse will terminate the actual Oracle CEP server process. Console messages from the Oracle CEP server are sent to the Oracle CEP IDE for Eclipse Console view.

  For more information, see:

  • Section 4.3.1, "How to Start an Oracle CEP Server"

  • Section 4.3.2, "How to Stop an Oracle CEP Server"

• Attach to a running Oracle CEP server.

  In this case, the user starts the Oracle CEP server from the command line, then clicks the Start button for that server in Oracle CEP IDE for Eclipse. A dialog is shown asking whether or not to attach and, if the user clicks Yes, Oracle CEP IDE for Eclipse enters attached mode. All of the Oracle CEP server features except debug are available. However, the Oracle CEP server process is not managed by the Oracle CEP IDE for Eclipse. Clicking the Stop button simply disconnects from the attached Oracle CEP server; it does not terminate the actual Oracle CEP server process. Console messages from the Oracle CEP server are sent to the Oracle CEP server console (standard output to the terminal window in which it is running). Oracle CEP IDE for Eclipse only shows limited Oracle CEP IDE for Eclipse operation messages in the console view.

  For more information, see:

  • Section 4.3.3, "How to Attach to an Existing Oracle CEP Server Instance"

  • Section 4.3.4, "How to Detach From an Existing Oracle CEP Server Instance"

4.2 Creating Oracle CEP Servers

Creating a server allows you to start and stop the server instance from within the Oracle CEP IDE for Eclipse, as well as automatically deploy your applications to that server.

This section describes:

• Section 4.2.1, "How to Create an Oracle CEP Server Runtime"

• Section 4.2.2, "How to Create an Oracle CEP Server and Server Runtime"

4.2.1 How to Create an Oracle CEP Server Runtime

Before you can create a server, you must configure the Oracle CEP IDE for Eclipse with the location of your Oracle CEP server installation by creating a server runtime using the runtime wizard. You can access the runtime wizard from several places including the new server wizard, the new project wizard, and the workspace preferences dialog.

You only need to create a runtime explicitly if you have not yet created an Oracle CEP server (see Section 4.2.2, "How to Create an Oracle CEP Server and Server Runtime").

To create an Oracle CEP server runtime:

1. Select Windows > Preferences.

   The Preferences dialog appears as Figure 4-1 shows.

   Figure 4-1 Preferences - Server - Installed Runtimes

   
   Description of "Figure 4-1 Preferences - Server - Installed Runtimes"
   
   

2. Expand the Server option and select Installed Runtimes.

3. Click Add.

   The New Server Runtime dialog appears as shown in Figure 4-2.

   Figure 4-2 New Server Runtime Dialog

   
   Description of "Figure 4-2 New Server Runtime Dialog"
   
   

4. Configure the dialog as shown in Table 4-2.

   Table 4-2 New Server Runtime Dialog Attributes

   Attribute	Description
   Server's host name:	The host name of the computer on which you installed Oracle CEP server. For development, this will typically be localhost.
   Select the server type:	The type of Oracle CEP server. In this example, choose Oracle CEP v11.1.
   Also create new local server	Optionally, check this to create a new local server if you have not yet created a server. For more information, see Section 4.2.2, "How to Create an Oracle CEP Server and Server Runtime".

   
   

5. Click Next.

   The New Server: New Oracle CEP v11 Runtime dialog appears as shown in Figure 4-3.

   Figure 4-3 New Server: New Oracle CEP v11 Runtime Dialog

   
   Description of "Figure 4-3 New Server: New Oracle CEP v11 Runtime Dialog"
   
   

6. Configure the dialog as shown in Table 4-3.

   Table 4-3 New Server Runtime Dialog Attributes

   Attribute	Description
   BEA Home Directory	The fully qualified path to the Oracle CEP server installation directory. This is the same as the "Middleware Home" that was selected when installing the server. When selecting this directory, select directory that contains the Oracle CEP installation rather than the Oracle CEP directory itself. For example, choose: C:\OracleCEP But do not choose: C:\OracleCEP\ocep_11.1 The runtime wizard will use the installation to find the appropriate Oracle CEP installation directory.
   JRE	The type of JRE to use. Select the type of JRE to use from the pull-down menu or click the Installed JRE preferences link to create a new JRE. Be sure to choose either JRockit Real Time 2.0 or the JRockit JDK installed with your Oracle CEP installation.

   
   

7. Click Finish.

4.2.2 How to Create an Oracle CEP Server and Server Runtime

This section describes how to create both a server and server runtime. After creating the initial server and server runtime, you can create additional server runtimes (see Section 4.2.1, "How to Create an Oracle CEP Server Runtime").

To create an Oracle CEP server and Server Runtime:

1. Select Window > Show View > Servers.

   The Servers view appears as shown in Figure 4-4.

   Figure 4-4 Oracle CEP IDE for Eclipse Server View

   
   Description of "Figure 4-4 Oracle CEP IDE for Eclipse Server View"
   
   

2. Right-click in the Servers view pane and select New > Server.

3. If this is the first time you have created an Oracle CEP server, there will be no installed server runtimes:

   In this case, the New Server: Define New Server dialog appears as Figure 4-5 shows.

   Figure 4-5 New Server: Define New Server Dialog (No Installed Runtimes)

   
   Description of "Figure 4-5 New Server: Define New Server Dialog (No Installed Runtimes)"
   
   

   Configure the new server as follows:

   1. Configure the dialog as shown in Table 4-4.

      Table 4-4 New Server: Define New Server Dialog (No Installed Runtimes) Attributes

      Attribute	Description
      Server's host name:	The host name of the computer on which you installed Oracle CEP server. For development, this will typically be localhost.
      Select the server type:	The type of Oracle CEP server. In this example, choose Oracle CEP v11

      
      

   2. Click Next.

      The New Server: New Oracle CEP v11 Runtime dialog appears as shown in Figure Figure 4-6.

      Figure 4-6 New Server: New Oracle CEP v11 Runtime Dialog

      
      Description of "Figure 4-6 New Server: New Oracle CEP v11 Runtime Dialog"
      
      

   3. Configure the dialog as shown in Table 4-5.

      Table 4-5 New Server: New Oracle CEP v11 Runtime Dialog Attributes

      Attribute	Description
      BEA Home Directory	The fully qualified path to the Oracle CEP server installation directory. When selecting this directory, select directory that contains the Oracle CEP installation rather than the Oracle CEP directory itself. For example, choose: C:\OracleCEP But do not choose: C:\OracleCEP\ocep_11.1 The runtime wizard will use the installation to find the appropriate Oracle CEP installation directory.
      JRE	The type of JRE to use. Select the type of JRE to use from the pull-down menu or click the Installed JRE preferences link to create a new JRE. Be sure to choose either JRockit Real Time 2.0 or the JRockit JDK installed with your Oracle CEP installation.

      
      

   4. Click Next.

   5. Proceed to step 5.

4. If this is not the first time you have created an Oracle CEP server, there will be one or more installed server runtimes.

   In this case, the New Server: Define New Server dialog appears as Figure 4-7 shows.

   Figure 4-7 New Server: Define New Server (Installed Runtimes) Dialog

   
   Description of "Figure 4-7 New Server: Define New Server (Installed Runtimes) Dialog"
   
   

   Configure the new server as follows:

   1. Configure the dialog as shown in Table 4-6.

      Table 4-6 New Server: Define New Server (Installed Runtimes) Dialog Attributes

      Attribute	Description
      Server's host name:	The host name of the computer on which you installed Oracle CEP server. For development, this will typically be localhost.
      Select the server type:	The type of Oracle CEP server. In this example, choose Oracle CEP v11.
      Server runtime:	Select the server runtime from the pull-down menu. To create or edit server runtimes, click Installed Runtimes. For more information, see Section 4.2.1, "How to Create an Oracle CEP Server Runtime".

      
      

   2. Click Next.

5. The New Server: New Oracle CEP v11 Server dialog appears as Figure 4-8 shows.

   Figure 4-8 New Server: New Oracle CEP v11 Server Dialog

   
   Description of "Figure 4-8 New Server: New Oracle CEP v11 Server Dialog"
   
   

6. Click Advanced.

7. Configure the dialog as shown in Table 4-7.

   Table 4-7 New Server: New Oracle CEP v11 Server Dialog Attributes

   Attribute	Description
   Domain Directory	The fully qualified path to the directory that contains the domain for this server. Click Browse to choose the directory. Default: ORACLE-CEP-HOME\user_projects\domains\ocep_domain\defaultserver.
   Start Script	The script that Oracle CEP IDE for Eclipse uses to start the Oracle CEP server. Default on UNIX: ORACLE-CEP-HOME/user_projects/domains/ocep_domain/defaultserver/stopwlevs.sh Default on Windows: ORACLE-CEP-HOME\user_projects\domains\ocep_domain\defaultserver\stopwlevs.cmd
   Stop Script	The script that Oracle CEP IDE for Eclipse uses to stop the Oracle CEP server. Default on UNIX: ORACLE-CEP-HOME/\user_projects/domains/ocep_domain/defaultserver/startwlevs.sh Default on Windows: ORACLE-CEP-HOME\user_projects\domains\ocep_domain\defaultserver\startwlevs.cmd
   Debug Port	The Oracle CEP server port that Oracle CEP IDE for Eclipse connects to when debugging the Oracle CEP server. Default: 8453.
   Server Name	The name of the Oracle CEP server. Default: Oracle CEP v11
   User Name	The user name Oracle CEP IDE for Eclipse uses when logging into the Oracle CEP server. Default: wlevs.
   User Password	The user password Oracle CEP IDE for Eclipse uses when logging into the Oracle CEP server. Default: wlevs.
   Automatic Publishing	By default, when you change an application, you must manually publish the changes to the Oracle CEP server. Select Use Workspace Default to configure Oracle CEP IDE for Eclipse to automatically publish changes to the Oracle CEP server. Default: Disabled.

   
   

8. Click Finish.

9. If you configured Automatic Publishing as Use Workspace Default, select Windows > Preferences.

   The Preferences dialog appears as Figure 4-9 shows.

   Figure 4-9 Preferences - Server

   
   Description of "Figure 4-9 Preferences - Server"
   
   

10. Select the Server option.

11. Configure your automatic publishing options:

    • Automatically publish to local servers: enable or disable this option, as required.

      Default: enabled.

      • Publishing interval: configure the frequency at which the Oracle CEP IDE for Eclipse publishes changes to the server (in seconds).

        Default: 60 seconds.

    • Automatically publish to remote servers: enable or disable this option, as required.

      Default: enabled.

      • Publishing interval: configure the frequency at which the Oracle CEP IDE for Eclipse publishes changes to the server (in seconds).

        Default: 60 seconds.

12. Click OK.

4.3 Managing Oracle CEP Servers

Using the Oracle CEP IDE for Eclipse and the Oracle CEP Visualizer accessible from the Oracle CEP IDE for Eclipse, you can manage many aspects of your Oracle CEP server during development.

This section describes the following Oracle CEP server management tasks you can perform from the Oracle CEP IDE for Eclipse:

• Section 4.3.1, "How to Start an Oracle CEP Server"

• Section 4.3.2, "How to Stop an Oracle CEP Server"

• Section 4.3.3, "How to Attach to an Existing Oracle CEP Server Instance"

• Section 4.3.4, "How to Detach From an Existing Oracle CEP Server Instance"

• Section 4.3.5, "How to Deploy an Application to an Oracle CEP Server"

• Section 4.3.6, "How to Configure Connection and Control Settings for Oracle CEP Server"

• Section 4.3.7, "How to Configure Domain (Runtime) Settings for Oracle CEP Server"

• Section 4.3.8, "How to Start the Oracle CEP Visualizer from Oracle CEP IDE for Eclipse"

4.3.1 How to Start an Oracle CEP Server

After you create a server (see Section 4.2.2, "How to Create an Oracle CEP Server and Server Runtime"), you can start the Oracle CEP server from the Oracle CEP IDE for Eclipse.

You can also start the Oracle CEP server in debug mode (see Section 4.4.1, "How to Debug an Oracle CEP Application Running on an Oracle CEP Server").

Alternatively, you can start the Oracle CEP server from the command line and attach to it using Oracle CEP IDE for Eclipse (see Section 4.3.3, "How to Attach to an Existing Oracle CEP Server Instance").

To start an Oracle CEP server:

1. Select Window > Show Views > Servers.

   The Servers view opens as shown in Figure 4-10.

   Figure 4-10 Starting an Oracle CEP Server

   
   Description of "Figure 4-10 Starting an Oracle CEP Server"
   
   

2. Start the server by choosing one of the following:

   1. Click the Start the Server icon in the Servers view tool bar.

   2. Right-click a server in the Servers view and select Start.

   After starting the server you will see log messages from the server in the Console view.

4.3.2 How to Stop an Oracle CEP Server

After you start the Oracle CEP server from the Oracle CEP IDE for Eclipse (see Section 4.3.1, "How to Start an Oracle CEP Server"), you can stop the Oracle CEP server from the Oracle CEP IDE for Eclipse.

To stop an Oracle CEP server:

1. Select Window > Show Views > Servers.

   The Servers view opens as shown in Figure 4-11.

   Figure 4-11 Stopping an Oracle CEP Server

   
   Description of "Figure 4-11 Stopping an Oracle CEP Server"
   
   

2. Stop the server by choosing one of the following:

   1. Click the Stop the Server icon in the Servers view tool bar.

   2. Right-click a server in the Servers view and select Stop.

4.3.3 How to Attach to an Existing Oracle CEP Server Instance

After you create a server (see Section 4.2.2, "How to Create an Oracle CEP Server and Server Runtime"), you can start the Oracle CEP server from the command line and attach Oracle CEP IDE for Eclipse to the existing, already running Oracle CEP server instance.

Alternatively, you can start the Oracle CEP server directly from within Oracle CEP IDE for Eclipse (see Section 4.3.1, "How to Start an Oracle CEP Server").

To attach to an existing Oracle CEP server instance:

1. Start the Oracle CEP server from the command line.

   For more information, see "Starting and Stopping Oracle CEP Servers" in the Oracle CEP Administrator's Guide.

2. Select Window > Show Views > Servers.

   The Servers view opens as shown in Figure 4-10.

   Figure 4-12 Attaching to an Existing Oracle CEP Server Instance

   
   Description of "Figure 4-12 Attaching to an Existing Oracle CEP Server Instance"
   
   

3. Attach to the already running server by choosing one of the following:

   1. Click the Start the Server icon in the Servers view tool bar.

   2. Right-click a server in the Servers view and select Start.

   The Attach to Running CEP Server dialog appears as Figure 4-13 shows.

   Figure 4-13 Attach to Running CEP Server

   
   Description of "Figure 4-13 Attach to Running CEP Server"
   
   

4. Click Yes.

   After attaching to the server you will not see log messages from the server in the Console view.

   You can view the server console using the Oracle CEP Visualizer. For more information, see "How to View Console Output" in the Oracle CEP Visualizer User's Guide.

4.3.4 How to Detach From an Existing Oracle CEP Server Instance

After you attach to an existing, running Oracle CEP server instance (see Section 4.3.3, "How to Attach to an Existing Oracle CEP Server Instance"), you can detach from the Oracle CEP server and leave it running.

To detach from an existing Oracle CEP server instance:

1. Select Window > Show Views > Servers.

   The Servers view opens as shown in Figure 4-11.

   Figure 4-14 Stopping an Oracle CEP Server

   
   Description of "Figure 4-14 Stopping an Oracle CEP Server"
   
   

2. Detach from the server by choosing one of the following:

   1. Click the Stop the Server icon in the Servers view tool bar.

   2. Right-click a server in the Servers view and select Stop.

   Oracle CEP IDE for Eclipse detaches from the Oracle CEP server instance. The Oracle CEP server instance continues to run.

4.3.5 How to Deploy an Application to an Oracle CEP Server

A project in the Oracle CEP IDE for Eclipse is built as an Oracle CEP application, then deployed to the server. To deploy an application, a server must first be defined (see Section 4.2.2, "How to Create an Oracle CEP Server and Server Runtime"). To then deploy an application, simply add it to the server. The application will be deployed immediately if the server is already started, or when the server is next started if the server is stopped.

To deploy an application to an Oracle CEP server:

1. Create an Oracle CEP project (see Section 3.2, "Creating Oracle CEP Projects").

2. Create a server (see Section 4.2.2, "How to Create an Oracle CEP Server and Server Runtime").

3. Select Window > Show Views > Servers.

   The Servers view opens as shown in Figure 4-15.

   Figure 4-15 Adding a Project to an Oracle CEP Server

   
   Description of "Figure 4-15 Adding a Project to an Oracle CEP Server"
   
   

4. Right-click the server and select Add and Remove Projects.

   The Add and Remove Projects dialog appears as shown in Figure 4-16.

   Figure 4-16 Add and Remove Projects Dialog

   
   Description of "Figure 4-16 Add and Remove Projects Dialog"
   
   

5. Select a project and click Add or click Add All to add all projects to the Oracle CEP server.

6. Click Finish.

   Once an application is deployed, it will show as a child of the server in the Servers view as shown in Figure 4-17.

   Figure 4-17 Server View After Adding a Project

   
   Description of "Figure 4-17 Server View After Adding a Project"
   
   

4.3.6 How to Configure Connection and Control Settings for Oracle CEP Server

After you create a server (see Section 4.2.2, "How to Create an Oracle CEP Server and Server Runtime"), you can use the Server Overview editor to configure all the important server connection and control settings that Oracle CEP IDE for Eclipse uses to communicate with the Oracle CEP server.

For information on how to configure Oracle CEP server domain (runtime) settings, see Section 4.3.7, "How to Configure Domain (Runtime) Settings for Oracle CEP Server".

To configure connection and control settings for Oracle CEP server:

1. Select Window > Show Views > Servers.

2. Double-click a server in the Servers view.

   The Server Overview editor opens as shown in Figure 4-18.

   Figure 4-18 Server Overview Editor

   
   Description of "Figure 4-18 Server Overview Editor"
   
   

3. Configure the Server Overview editor as shown in Table 4-8.

   Table 4-8 Server Overview Editor Attributes

   Attribute	Description
   Server Name	The name of this server. Only used within the Oracle CEP IDE for Eclipse as a useful identifier. For more information, see Section 4.2.2, "How to Create an Oracle CEP Server and Server Runtime".
   Host Name	The name of the host on which this server is installed. For more information, see Section 4.2.2, "How to Create an Oracle CEP Server and Server Runtime".
   Runtime	The current installed runtime selected for this server. Select a new runtime from the pull down menu or click the Edit link to modify the configuration of the selected runtime. For more information, see Section 4.2.2, "How to Create an Oracle CEP Server and Server Runtime".
   Domain Directory	The fully qualified path to the directory that contains the domain for this server. Click Browse to choose the directory. Default: ORACLE-CEP-HOME\user_projects\domains\ocep_domain\defaultserver.
   Start Script	The script that Oracle CEP IDE for Eclipse uses to start the Oracle CEP server. Click Browse to choose the start script. Default on UNIX: ORACLE-CEP-HOME\user_projects\domains\ocep_domain\defaultserver\stopwlevs.sh Default on Windows: ORACLE-CEP-HOME\user_projects\domains\ocep_domain\defaultserver\stopwlevs.cmd
   Stop Script	The script that Oracle CEP IDE for Eclipse uses to stop the Oracle CEP server. Click Browse to choose the stop script. Default on UNIX: ORACLE-CEP-HOME\user_projects\domains\ocep_domain\defaultserver\startwlevs.sh Default on Windows: ORACLE-CEP-HOME\user_projects\domains\ocep_domain\defaultserver\startwlevs.cmd
   Debug Port	The Oracle CEP server port that Oracle CEP IDE for Eclipse connects to when debugging the Oracle CEP server. Default: 8453.
   Server Name	The name of the Oracle CEP server. Default: Oracle CEP v11
   User Name	The user name Oracle CEP IDE for Eclipse uses when logging into the Oracle CEP server. Default: wlevs.
   User Password	The user password Oracle CEP IDE for Eclipse uses when logging into the Oracle CEP server. Default: wlevs.
   Override when the server is automatically published to	By default, when you change an application, you must manually publish the changes to the Oracle CEP server. Select Use default publishing settings to enable automatic publishing using the default publishing preferences. Click the Edit link to configure the default publishing preferences. Select Never publish automatically to disable automatic publishing. Select Override default settings to override the default automatic publishing interval. Enter a new publishing interval (in seconds). Default: Never publish automatically.

   
   

4. Select File > Save.

5. Close the Server Overview editor.

4.3.7 How to Configure Domain (Runtime) Settings for Oracle CEP Server

After you create a server (see Section 4.2.2, "How to Create an Oracle CEP Server and Server Runtime"), you can use the Oracle CEP IDE for Eclipse to configure Oracle CEP server domain (runtime) settings.

You can also use the Oracle CEP IDE for Eclipse to configure all the important server connection and control settings that Oracle CEP IDE for Eclipse uses to communicate with the Oracle CEP server (see Section 4.3.6, "How to Configure Connection and Control Settings for Oracle CEP Server").

To configure domain (runtime) settings for Oracle CEP server:

1. Select Window > Show Views > Servers.

2. Right-click a server in the Servers view and select Open Domain Configuration File as shown in Figure 4-19.

   Figure 4-19 Editing the Domain Configuration File

   
   Description of "Figure 4-19 Editing the Domain Configuration File"
   
   

   The Oracle CEP server domain configuration file config.xml opens as shown in Figure 4-20.

   Figure 4-20 Oracle CEP Domain Configuration File config.xml

   
   Description of "Figure 4-20 Oracle CEP Domain Configuration File config.xml"
   
   

3. Edit the domain configuration file as required.

4. Select File > Save.

5. Close the domain configuration file.

4.3.8 How to Start the Oracle CEP Visualizer from Oracle CEP IDE for Eclipse

After you create a server (see Section 4.2.2, "How to Create an Oracle CEP Server and Server Runtime"), you can start the Oracle CEP Visualizer from the Oracle CEP IDE for Eclipse.

The Oracle CEP Visualizer is the administration console for a running Oracle CEP server. For more information, see the Oracle CEP Visualizer User's Guide.

To start the Oracle CEP Visualizer from Oracle CEP IDE for Eclipse:

1. Start the server (see Section 4.3.1, "How to Start an Oracle CEP Server").

2. Right-click the running server in the Servers view and select Open CEP Visualizer as shown in Figure 4-21.

   Figure 4-21 Opening the Oracle CEP Visualizer

   
   Description of "Figure 4-21 Opening the Oracle CEP Visualizer"
   
   

   The Oracle CEP Visualizer opens as shown in Figure 4-22.

   Figure 4-22 Oracle CEP Visualizer

   
   Description of "Figure 4-22 Oracle CEP Visualizer"
   
   

3. Use the Oracle CEP Visualizer as the Oracle CEP Visualizer User's Guide describes.

4.4 Debugging an Oracle CEP Application Running on an Oracle CEP Server

Because Oracle CEP applications are java applications, standard Java debugging tools including those provided in Eclipse can be used with these applications.

4.4.1 How to Debug an Oracle CEP Application Running on an Oracle CEP Server

This section describes how to debug an Oracle CEP application running on an Oracle CEP server.

To debug an Oracle CEP application running on an Oracle CEP server:

1. Set a breakpoint in the Java code you wish to debug.

   In this case, set the breakpoint by right-clicking in the gutter of the editor and selecting Toggle Breakpoint as Figure 4-23 shows.

   Figure 4-23 Setting a Breakpoint

   
   Description of "Figure 4-23 Setting a Breakpoint"
   
   

2. Select Window > Show Views > Servers.

3. Start the server in debug mode by choosing one of the following as shown in Figure 4-24:

   1. Click the Start the Server in debug mode icon in the Servers view tool bar.

   2. Right-click a server in the Servers view and select Debug.

   Figure 4-24 Starting the Oracle CEP Server in Debug Mode

   
   Description of "Figure 4-24 Starting the Oracle CEP Server in Debug Mode"
   
   

4. The server will start, and when it gets to your breakpoint the thread will stop.

   If the Oracle CEP IDE for Eclipse does not automatically switch to the Debug perspective, switch to that perspective by selecting Window > Open Perspective > Other and selecting the Debug option from the list of perspective.

5. Debug your application using the Debug perspective.

   Note:

   In some cases you may get a dialog box warning that it could not install a breakpoint because of missing line number information. This dialog comes from the core Eclipse debugger and is normally a harmless issue with Oracle CEP Service Engine applications. Simply check the Don't Tell Me Again checkbox and continue debugging.

6. When you are finished you can stop the server as usual (see Section 4.3.2, "How to Stop an Oracle CEP Server").