2 Overview of the Oracle CEP IDE for Eclipse

2.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.

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.

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

• "Setting Your Development Environment" in the Oracle CEP Getting Started

• Section 2.4, "Configuring Eclipse"

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

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

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

   Linux: http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/europa/winter/eclipse-jee-europa-winter-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 > Software Updates > Find and Install.

   The Install/Update dialog appears as Figure 2-1 shows.

   Figure 2-1 Install/Update Dialog

   
   Description of "Figure 2-1 Install/Update Dialog"
   
   

3. Select the Search for New Features option.

4. Click Next.

   The Update Sites to Visit dialog appears as Figure 2-2 shows.

   Figure 2-2 Update Sites to Visit Dialog

   
   Description of "Figure 2-2 Update Sites to Visit Dialog"
   
   

5. Click New Remote Site.

   The New Update Site dialog appears as Figure 2-3 shows.

   Figure 2-3 New Update Site Dialog

   
   Description of "Figure 2-3 New Update Site Dialog"
   
   

6. Configure this dialog as Table 2-1 describes.

   Table 2-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/

   
   

7. Click OK.

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

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

10. To confirm the installation, select Help > About Eclipse Platform.

    The About Eclipse Platform dialog appears as Figure 2-4 shows.

    Figure 2-4 About Eclipse Platform

    
    Description of "Figure 2-4 About Eclipse Platform"
    
    

11. Click Plug-In Details.

    The About Eclipse Platform Plug-ins dialog appears as Figure 2-5 shows.

    Figure 2-5 About Eclipse Platform Plug-ins Dialog

    
    Description of "Figure 2-5 About Eclipse Platform Plug-ins Dialog"
    
    

12. Scroll down in the list and confirm that the plug-ins that Table 2-2 lists are shown.

    Table 2-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 UI	com.bea.wlevs.eclipse.tools.ui
    Oracle	Oracle CEP Tools Documentation	com.bea.wlevs.eclipse.tools.doc

    
    

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

    • Section 2.4, "Configuring Eclipse"

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

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

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

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

   The Install/Update dialog appears as Figure 2-1 shows.

   Figure 2-6 Install/Update Dialog

   
   Description of "Figure 2-6 Install/Update Dialog"
   
   

3. Select the Search for New Features option.

4. Click Next.

   The Update Sites to Visit dialog appears as Figure 2-2 shows.

   Figure 2-7 Update Sites to Visit Dialog

   
   Description of "Figure 2-7 Update Sites to Visit Dialog"
   
   

5. Click New Archived Site.

   The Select Local Site Archive dialog appears as Figure 2-8 shows.

   Figure 2-8 Select Local Site Archive Dialog

   
   Description of "Figure 2-8 Select Local Site Archive Dialog"
   
   

6. 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.

7. Click Open.

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

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

10. To confirm the installation, select Help > About Eclipse Platform.

    The About Eclipse Platform dialog appears as Figure 2-4 shows.

    Figure 2-9 About Eclipse Platform

    
    Description of "Figure 2-9 About Eclipse Platform"
    
    

11. Click Plug-In Details.

    The About Eclipse Platform Plug-ins dialog appears as Figure 2-5 shows.

    Figure 2-10 About Eclipse Platform Plug-ins Dialog

    
    Description of "Figure 2-10 About Eclipse Platform Plug-ins Dialog"
    
    

12. Scroll down in the list and confirm that the plug-ins that Table 2-2 lists are shown.

    Table 2-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 UI	com.bea.wlevs.eclipse.tools.ui
    Oracle	Oracle CEP Tools Documentation	com.bea.wlevs.eclipse.tools.doc

    
    

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

    • Section 2.4, "Configuring Eclipse"

2.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.

   The JRockit Java 6.0 JRE is installed with Oracle CEP in your Oracle CEP home directory. For example:

   C:\OracleCEP\jrockit-R27.6.0-50-1.6.0_05\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 2-1 shows.

   Example 2-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 2-2 shows.

   Example 2-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 2-3 shows.

   Example 2-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-R27.6.0-50-1.6.0_05\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 2-3 shows.

6. Save and close the eclipse.ini file.

7. Start Eclipse.

8. Select Help > About Eclipse Platform and click Configuration Details.

   The Configuration Details dialog appears as shown in Figure 2-11.

   Figure 2-11 Configuration Details for Java 6

   
   Description of "Figure 2-11 Configuration Details for Java 6"
   
   

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

10. Open the Oracle CEP project you originally created using Java 5.

11. Select Window > Preferences.

    The Preferences dialog appears as shown in Figure 2-12.

    Figure 2-12 Preferences Dialog

    
    Description of "Figure 2-12 Preferences Dialog"
    
    

12. Expand the Server option and select Installed Runtimes.

13. Select a runtime that uses the Java 6 JRE.

14. Click OK.

15. Right-click your project and select Properties.

    The Project Properties dialog appears as shown in Figure 2-13.

    Figure 2-13 Project Properties Dialog: Java Build Path

    
    Description of "Figure 2-13 Project Properties Dialog: Java Build Path"
    
    

16. Select the Java Build Path option and click on the Libraries tab.

17. Select the existing JRE System Library [jre1.5.0_XX] Java 5.0 library and click Remove.

18. Create a new JRE System Library for Java 6.0 by clicking Add Library and choosing the Java 6.0 JRE.

19. Select the Project Facets option.

    The Project Facet properties are displayed as Figure 2-14 shows.

    Figure 2-14 Project Properties Dialog: Project Facets

    
    Description of "Figure 2-14 Project Properties Dialog: Project Facets"
    
    

20. Click Modify Project.

    The Modify Faceted Project dialog appears shown in Figure 2-15.

    Figure 2-15 Modify Faceted Project

    
    Description of "Figure 2-15 Modify Faceted Project"
    
    

21. For the Java facet, select 6.0 from the Version pull-down menu.

22. Click Finish.

23. Click OK.

    Your project will now build and run using Java 6.0.