3 Overview of the Oracle CEP IDE for Eclipse

Oracle CEP IDE for Eclipse is an IDE targeted specifically to programmers that want to develop Oracle CEP applications.

This chapter describes:

• Section 3.1, "Overview of Oracle CEP IDE for Eclipse"

• Section 3.2, "Installing the Latest Oracle CEP IDE for Eclipse"

• Section 3.3, "Installing the Oracle CEP IDE for Eclipse Distributed With Oracle CEP"

• Section 3.4, "Configuring Eclipse"

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:

• Section 3.1.1, "Features"

• Section 3.1.2, "JDK Requirements"

• Section 3.1.3, "Default Oracle CEP Domain ocep_domain and Development"

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:

• "Setting Your Development Environment" in the Oracle Complex Event Processing Getting Started

• Section 3.4, "Configuring Eclipse"

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:

• "Installation Overview" in the Oracle Complex Event Processing Getting Started

• "Creating an Oracle CEP Standalone-Server Domain" in the Oracle Complex Event Processing Administrator's Guide

• "Creating an Oracle CEP Multi-Server Domain Using Oracle CEP Native Clustering" in the Oracle Complex Event Processing Administrator's Guide

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.5.1) and WTP (2.0). We recommend you take the entire Galileo installation available at the following Web sites:

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

   Linux: http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/galileo/SR1/eclipse-jee-galileo-SR1-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 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 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 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 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.

    Figure 3-5 About Eclipse

    
    Description of "Figure 3-5 About Eclipse"
    
    

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 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 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:

    • Section 3.1.3, "Default Oracle CEP Domain ocep_domain and Development"

    • Section 3.4, "Configuring Eclipse"

    • Appendix J, "Oracle CEP IDE for Eclipse Tutorial"

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.5.1) and WTP (2.0). We recommend you take the entire Galileo installation available at the following Web sites:

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

   Linux: http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/galileo/SR1/eclipse-jee-galileo-SR1-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 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 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 Select Local Site Archive Dialog"
   
   

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

   Where ORACLE_CEP_HOME refers to the main directory into which you installed Oracle CEP, such as /oracle_cep, 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 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 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 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:

    • Section 3.1.3, "Default Oracle CEP Domain ocep_domain and Development"

    • Section 3.4, "Configuring Eclipse"

    • Appendix J, "Oracle CEP IDE for Eclipse Tutorial"

3.4 Configuring Eclipse

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

To configure Eclipse:

1. Exit out of Eclipse if it is running.

2. Install a Java 6 JRE on your computer.

   By default, the JRockit Java 6.0 JRE is installed with Oracle CEP in your Oracle CEP home directory. For example:

   C:\OracleCEP\jrockit_160_20\jre

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:\OracleCEP\jrockit_160_20\jre\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 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.