3 Overview of the Oracle CEP IDE for Eclipse

This chapter introduces the Oracle Complex Event Processing (Oracle CEP) IDE features available for Eclipse, providing information on how to install and configure the features.

This chapter describes:

3.1 Overview of Oracle CEP IDE for Eclipse

Oracle CEP IDE for Eclipse is a set of plugins for the Eclipse IDE designed to help develop, deploy, and debug applications for Oracle CEP.

This section describes:

For more information about Oracle CEP IDE for Eclipse, see http://www.oracle.com/technology/products/event-driven-architecture/cep-ide/11/.

3.1.1 Features

The key features of the Oracle CEP IDE for Eclipse are as follows:

  • Project creation wizards and templates to quickly get started building event driven applications.

  • Advanced editors for source files including Java and XML files common to Oracle CEP applications.

  • Integrated server management to seamlessly start, stop, and deploy to Oracle CEP server instances all from within the IDE.

  • Integrated debugging.

  • Event Processing Network (EPN) visual design views for orienting and navigating in event processing applications and visually creating and editing EPN components.

  • Oracle CEP application source file validation including Oracle Continuous Query Language (Oracle CQL) syntax highlighting and component configuration and assembly files.

  • Ability to build and export deployable Oracle CEP applications.

  • Integrated support for the Oracle CEP Visualizer so you can use the Oracle CEP Visualizer from within the IDE.

3.1.2 JDK Requirements

In 11g Release 1 (11.1.1), Oracle CEP IDE for Eclipse requires JDK 6.0. For more information, see:

3.1.3 Default Oracle CEP Domain ocep_domain and Development

When you choose a Typical Oracle CEP server install, the installation does not include the default ocep_domain domain (with default passwords) and the product samples.

If you want to install the default ocep_domain and samples (recommended), choose the Custom Oracle CEP server install option.

The Typical install is appropriate for a production environment while the Custom install is appropriate for a development environment.

Oracle recommends that you install the default ocep_domain and samples for use with the Oracle CEP IDE for Eclipse during development.

If you choose a Typical Oracle CEP server install, you can use the Configuration Wizard to create an Oracle CEP server domain.

For more information, see:

3.2 Installing the Latest Oracle CEP IDE for Eclipse

New versions of the IDE will be made available via the Oracle Technology Network Web site. Oracle recommends that you install the IDE from this Eclipse update site.

To install the latest Oracle CEP IDE for Eclipse:

  1. Obtain the required versions of Eclipse (3.6.2) and WTP (2.0). Be sure to install the Eclipse IDE for Java EE developers. We recommend you take the entire Helios installation available at the following Web sites:

    Windows: http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/helios/R/eclipse-jee-helios-win32.zip

    Linux: http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/helios/SR2/eclipse-jee-helios-SR2-linux-gtk.tar.gz

    Note:

    Check the Oracle CEP Web site (http://www.oracle.com/technologies/soa/complex-event-processing.html) for the latest requirements on the Eclipse tools.

  2. Open your Eclipse IDE and select the menu item Help > Install New Software.

    The Install dialog appears as Figure 3-1 shows.

    Figure 3-1 Install Dialog

    Description of Figure 3-1 follows
    Description of "Figure 3-1 Install Dialog"

  3. Click Add.

    The Add Site dialog appears as Figure 3-2 shows.

    Figure 3-2 Add Site Dialog

    Description of Figure 3-2 follows
    Description of "Figure 3-2 Add Site Dialog"

  4. Configure this dialog as Table 3-1 describes.

    Table 3-1 New Update Site Dialog Attributes

    Attribute Description

    Name

    The name for this remote update site. For example: Oracle CEP Tools Update.

    URL

    The URL to the remote update site. Valid value:

    http://download.oracle.com/technology/software/cep-ide/11/
    

  5. Click OK.

  6. In the Install dialog, from the Work with pull down menu, select the Oracle CEP Tools Update site you just created.

    It make take a few moments for Eclipse to contact the remote update site. During this time, the "There is no site selected" entry reads "Pending".

    When Eclipse has made contact with the remote update site, the Oracle CEP Tools entry appears in the list of update sites as Figure 3-3 shows.

  7. Check the check box next to the Oracle CEP Tools entry as Figure 3-3 shows.

    Figure 3-3 Install Dialog - Site Selected

    Description of Figure 3-3 follows
    Description of "Figure 3-3 Install Dialog - Site Selected"

  8. Click Next.

    The Install Details dialog appears as Figure 3-4 shows.

    Figure 3-4 Install Dialog - Install Details

    Description of Figure 3-4 follows
    Description of "Figure 3-4 Install Dialog - Install Details"

  9. Click Next.

    The Review Licenses dialog appears.

  10. Click Finish.

  11. When prompted restart, Eclipse. If you skip this, unreliable behavior can occur.

  12. To confirm the installation, select Help > About Eclipse.

    The About Eclipse dialog appears as Figure 3-5 shows.

  13. Click Oracle.

    The About Eclipse Features dialog appears as Figure 3-6 shows.

    Figure 3-6 About Eclipse Features Dialog

    Description of Figure 3-6 follows
    Description of "Figure 3-6 About Eclipse Features Dialog"

  14. Click Plug-In Details.

    The Feature Plug-ins dialog appears as Figure 3-7 shows.

    Figure 3-7 Feature Plug-ins Dialog

    Description of Figure 3-7 follows
    Description of "Figure 3-7 Feature Plug-ins Dialog"

  15. Confirm that the plug-ins that Table 3-2 lists are shown.

    Table 3-2 Oracle CEP IDE for Eclipse Plug-Ins

    Provider Plug-in Name Plug-in Id

    Oracle

    Oracle CEP Tools Core

    com.bea.wlevs.eclipse.tools.core

    Oracle

    Oracle CEP Tools Documentation

    com.bea.wlevs.eclipse.tools.doc

    Oracle

    Oracle CEP Tools UI

    com.bea.wlevs.eclipse.tools.ui


  16. After installing Oracle CEP IDE for Eclipse, consider the following topics:

3.3 Installing the Oracle CEP IDE for Eclipse Distributed With Oracle CEP

A version of the Oracle CEP IDE for Eclipse is shipped with the Oracle CEP product, although this version might be older than the one on the Oracle Technology Network site.

To install the Oracle CEP IDE for Eclipse distributed with Oracle CEP:

  1. Obtain the required versions of Eclipse (3.6.2) and WTP (2.0). Be sure to install the Eclipse IDE for Java EE developers. We recommend you take the entire Helios installation available at the following Web sites:

    Windows: http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/helios/R/eclipse-jee-helios-win32.zip

    Linux: http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/helios/SR2/eclipse-jee-helios-SR2-linux-gtk.tar.gz

    Note:

    Check the Oracle CEP Web site (http://www.oracle.com/technologies/soa/complex-event-processing.html) for the latest requirements on the Eclipse tools.

  2. Open your Eclipse IDE and select the menu item Help > Install New Software.

    The Install dialog appears as Figure 3-1 shows.

    Figure 3-8 Install Dialog

    Description of Figure 3-8 follows
    Description of "Figure 3-8 Install Dialog"

  3. Click Add.

    The Add Site dialog appears as Figure 3-2 shows.

    Figure 3-9 Add Site Dialog

    Description of Figure 3-9 follows
    Description of "Figure 3-9 Add Site Dialog"

  4. Click Archive.

    The Select Local Site Archive dialog appears as Figure 3-10 shows.

    Figure 3-10 Select Local Site Archive Dialog

    Description of Figure 3-10 follows
    Description of "Figure 3-10 Select Local Site Archive Dialog"

  5. Navigate to the MIDDLEWARE_HOME/ocep_11.1/eclipse-update-site directory and select the cep-tools-11.1.0.DATE-BUILD.zip file.

    Where MIDDLEWARE_HOME refers to the directory into which you installed Oracle CEP, such as c:\Oracle\Middleware, and DATE is the build date and BUILD is the build number.

  6. Click Open.

  7. Complete the Update Manager, selecting to install the Oracle CEP tools.

  8. When prompted restart, Eclipse. If you skip this, unreliable behavior can occur.

  9. To confirm the installation, select Help > About Eclipse.

    The About Eclipse dialog appears as Figure 3-5 shows.

    Figure 3-11 About Eclipse

    Description of Figure 3-11 follows
    Description of "Figure 3-11 About Eclipse"

  10. Click Oracle.

    The About Eclipse Features dialog appears as Figure 3-6 shows.

    Figure 3-12 About Eclipse Features Dialog

    Description of Figure 3-12 follows
    Description of "Figure 3-12 About Eclipse Features Dialog"

  11. Click Plug-In Details.

    The Feature Plug-ins dialog appears as Figure 3-7 shows.

    Figure 3-13 Feature Plug-ins Dialog

    Description of Figure 3-13 follows
    Description of "Figure 3-13 Feature Plug-ins Dialog"

  12. Confirm that the plug-ins that Table 3-2 lists are shown.

    Table 3-3 Oracle CEP IDE for Eclipse Plug-Ins

    Provider Plug-in Name Plug-in Id

    Oracle

    Oracle CEP Tools Core

    com.bea.wlevs.eclipse.tools.core

    Oracle

    Oracle CEP Tools Documentation

    com.bea.wlevs.eclipse.tools.doc

    Oracle

    Oracle CEP Tools UI

    com.bea.wlevs.eclipse.tools.ui


  13. After installing Oracle CEP IDE for Eclipse, consider the following topics:

3.4 Configuring Eclipse

This section describes how to configure Eclipse to work with Oracle CEP.

To configure Eclipse:

  1. Exit out of Eclipse if it is running.

  2. Install a Java 6 JRE on your computer.

    For example, you might have installed the JRE included with a Java Development Kit to the following location:

    C:\Java\jre6

  3. Using the editor of your choice, open your eclipse.ini file located in your Eclipse install directory, for example, C:\eclipse\ as Example 3-1 shows.

    Example 3-1 Default eclipse.ini File

    -showsplash
    org.eclipse.platform
    --launcher.XXMaxPermSize
    256M
    

    Note:

    When making changes to the eclipse.ini file, add arguments one argument per line, as http://wiki.eclipse.org/Eclipse.ini describes.

    For more information about configuring Eclipse, see http://wiki.eclipse.org/FAQ_How_do_I_run_Eclipse.

  4. Add the following lines to the eclipse.ini file as Example 3-2 shows.

    Example 3-2 Memory Resources

    -showsplash
    org.eclipse.platform
    --launcher.XXMaxPermSize
    256M
    -vmargs
    -Xmx512m
    -XX:MaxPermSize=256M
    
  5. Add the following to the eclipse.ini file as Example 3-3 shows.

    Example 3-3 Virtual Machine Path

    -vm
    PATH-TO-JRE-6.0-JAVAW
    

    Where PATH-TO-JRE-6.0-JAVAW is the fully qualified path to your Java 6.0 JRE javaw executable. For example:

    -vm
    C:\Java\jre6\bin\javaw.exe
    

    Note:

    Do not put both the -vm and the path on the same line. Each must be on a separate line as Example 3-3 shows.

  6. Save and close the eclipse.ini file.

  7. Start Eclipse.

  8. Select Help > About Eclipse and click Installation Details.

  9. Click the Configuration tab.

    The Configuration Details tab appears as shown in Figure 3-14.

    Figure 3-14 Configuration Details for Java 6

    Description of Figure 3-14 follows
    Description of "Figure 3-14 Configuration Details for Java 6"

  10. Confirm that the eclipse.vm property points to the Java 6.0 JRE you configured in the eclipse.ini file.