2 Installing Oracle Event Processing

This chapter describes how to install and upgrade Oracle Event Processing, including development tools for use with the Eclipse IDE.

This chapter includes the following sections:

2.1 Installation Overview

To install Oracle Event Processing 11g Release 1 (11.1.1.7):

  1. Download the Oracle Event Processing installer appropriate for your platform.

    See Section 1.5, "Supported Platforms".

  2. Choose the JVM you will use.

    See Section 2.1.2, "Choosing Your JVM"

  3. Decide if you are installing in a production environment or development environment.

    See Section 2.1.3, "Default Oracle Event Processing Domain ocep_domain and Samples".

  4. Familiarize yourself with Oracle Fusion Middleware directory structure and concepts.

    See Section 2.1.4, "Oracle Fusion Middleware Directory Structure and Concepts".

  5. Install Oracle Event Processing using the installer mode of your choice.

    See Section 2.1.5, "Installation Mode".

  6. Install Oracle Event Processing patches, if required.

    See Section 2.5, "Installing an Oracle Event Processing Patch".

  7. Perform post-installation tasks, if applicable.

    See Section 2.6, "Post-Installation Steps".

  8. Decide whether or not you need to upgrade Oracle Event Processing and Oracle Event Processing applications to the current release.

    See Section 2.8, "Upgrading to Oracle Event Processing 11g Release 1 (11.1.1.7)".

  9. Install Apache Ant, a Java-based build tool.

    See the Apache Ant Project at http://ant.apache.org/.

2.1.1 Before You Start the Installation Program

Before you start the installation program, review the following information:

  • If you are using the Generic Package installer or the Linux 64-bit installer to install Oracle Event Processing on a UNIX or Linux system, Oracle recommends that you set the umask to 027 on your system prior to installation. This ensures that WebLogic Server file permissions will be set properly during installation. Use the following command:

    umask 027

    You must enter this command in the same terminal window from which you plan to run the Oracle Event Processing installer.

  • You must run the installer on a system whose locale is set to one using the English language.

2.1.2 Choosing Your JVM

Oracle Event Processing supports the following Java Virtual Machines (JVM):

2.1.2.1 Oracle JRockit Real Time

By default, Oracle Event Processing includes its own version of JRockit (in MIDDLEWARE_HOME/jrockit_JAVA-VERSION_RJROCKIT-VERSION), but it does not include the deterministic garbage collector.

Note:

The Oracle Event Processing installer for the Sun JVM does not include a version of JRockit.

Oracle Event Processing performs optimally when it can access certain features from Oracle JRockit Real Time, in particular the JRockit deterministic garbage collector.

If your application requires low latency, optionally install Oracle JRockit Real Time.

Caution:

Be sure you install the version of Oracle JRockit Real Time for Java version 5.0 or 6.0. Oracle JRockit Real Time for Java version 1.4.2 is not compatible with this version of Oracle Event Processing.

For more information on Oracle JRockit Real Time, see http://www.oracle.com/technology/products/jrockit/jrrt/index.html.

2.1.2.2 Sun JVM

The Sun JVM is the default JVM on Solaris SPARC and is included in the Solaris SPARC installer. If you want to use the Sun JVM (instead of JRockit) on platforms other than Solaris, download the JVM from the Oracle Java SE download site.

For more information, see:

2.1.2.3 Other Platform-Specific JVMs

For other platforms (such as HP or IBM/AIX), ensure that you have the appropriate platform-specific JVM installed.

For more information, see:

2.1.3 Default Oracle Event Processing Domain ocep_domain and Samples

When you choose a Typical 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 option.

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

2.1.4 Oracle Fusion Middleware Directory Structure and Concepts

When you install Oracle Event Processing, consider the following scenarios:

For more information, see "Understanding Oracle Fusion Middleware Concepts and Directory Structure" in the Oracle Fusion Middleware Installation Planning Guide.

2.1.4.1 Oracle Event Processing-Specific Middleware Home

In this scenario, you install Oracle Event Processing in a stand-alone configuration, in its own Middleware Home directory as Figure 2-1 shows.

Figure 2-1 Oracle Event Processing-Specific Middleware Home

Description of Figure 2-1 follows
Description of "Figure 2-1 Oracle Event Processing-Specific Middleware Home"

Table 2-1 lists the various home directories applicable to Oracle Event Processing in this scenario.

Table 2-1 Home Directories and Oracle Event Processing-Specific Middleware Home

Home Directory Type Home Directory

Middleware Home

As selected by the user at Oracle Event Processing install time.

WebLogic Server Home

N/A

Oracle Product HomeFoot 1 

ocep_11.1

Oracle Common Home

N/A

Domain

MIDDLEWARE_HOME/user_projects/domains/ocep_domain


Footnote 1 Also known as simply the Oracle Home.

2.1.4.2 Existing Oracle Fusion Middleware Home

In this scenario, you install Oracle Event Processing into an existing Oracle Fusion Middleware home as Figure 2-2 shows.

In this scenario, you install Oracle Event Processing into its own Product Oracle Home but you create Oracle Event Processing domains in the existing ORACLE_FUSION_MIDDLEWARE_HOME/user_projects/domains directory as Figure 2-2 shows.

Figure 2-2 Oracle Event Processing in an Existing Oracle Fusion Middleware Home

Description of Figure 2-2 follows
Description of "Figure 2-2 Oracle Event Processing in an Existing Oracle Fusion Middleware Home"

In this example topology, there are two Oracle products installed in the same Middleware Home:

  • Oracle Event Processing

  • Oracle SOA Suite

Table 2-2 lists the various home directories applicable to Oracle Event Processing in this scenario.

Table 2-2 Home Directories and Existing Middleware Home

Home Directory Type Home Directory

Middleware Home

As selected by the user at Oracle Fusion Middleware install time.

WebLogic Server Home

As determined by Oracle Fusion Middleware installer.

Oracle Product HomeFoot 1 

ocep_11.1

Oracle Common Home

As determined by Oracle Fusion Middleware installer.

Domain

MIDDLEWARE_HOME/user_projects/domains/ocep_domain


Footnote 1 Also known as simply the Oracle Home.

2.1.5 Installation Mode

You use the Oracle Event Processing installer in the following modes:

2.1.5.1 Graphical Mode

Graphical-mode installation is an interactive, GUI-based method for installing your software. It can be run on both Windows and UNIX systems. See Section 2.2, "Installing Oracle Event Processing in Graphical Mode."

Caution:

If you want to run graphical-mode installation, the console attached to the machine on which you are installing the software must support a Java-based GUI. All consoles for Windows systems support Java-based GUIs, but not all consoles for UNIX systems do. If you attempt to start the installation program in graphical mode on a system that cannot support a graphical display, the installation program automatically starts console-mode installation.

2.1.5.2 Console Mode

Console-mode installation is an interactive, text-based method for installing your software from the command line, on either a UNIX system or a Windows system. See Section 2.3, "Installing Oracle Event Processing in Console Mode."

2.1.5.3 Silent Mode

Silent-mode installation is a non-interactive method of installing your software that requires the use of an XML properties file for selecting installation options. You can run silent-mode installation in either of two ways: as part of a script or from the command line. Silent-mode installation is a way of setting installation configurations only once and then using those configurations to duplicate the installation on many machines. See Section 2.4, "Installing Oracle Event Processing in Silent Mode."

2.2 Installing Oracle Event Processing in Graphical Mode

This section describes how to install using the Oracle Event Processing installer in graphical mode.

For more information, see Section 2.1, "Installation Overview".

To install Oracle Event Processing in graphical mode:

  1. Log in to the Windows or UNIX computer on which you want to install Oracle Event Processing.

    Be sure you log in to the computer as the user that will be the main administrator of the Oracle Event Processing installation.

  2. Download the product distribution file for the platform on which you want to install Oracle Event Processing.

  3. Launch the installation program in graphical mode using the commands listed in the following table appropriate for your platform.

    Platform Instructions

    Windows

    Using Windows Explorer, double-click the appropriate installation program file from its download directory.

    Linux or Solaris

    Open a command window, change to the download directory, and enter these commands:

    prompt> chmod a+x filename
    prompt> ./filename
    

    In the preceding commands, filename is the name of the installation program specific to your platform (for more information, see http://www.oracle.com/technology/software/products/middleware/htdocs/111110_fmw.html.)

    If you want to create an installation log, use the -log=full_path_to_log_file option; for example:

    prompt> ./filename -log=C:\logs\server_install.log
    

    After the installation program has finished loading, you will see the standard Welcome window.

  4. Click Next.

  5. In the Choose Middleware Home Directory window, you can specify either an existing Oracle Middleware Home directory or create a new one:

    1. To install into an existing Oracle Middleware Home directory:

      • Select Use an Existing Middleware Home.

      • Select an existing Oracle Middleware Home directory from the list on the right.

    2. To install into a new Oracle Middleware Home directory:

      • Select Create a New Middleware Home.

      • Click the Browse button to browse your computer to select an existing directory or click Reset to reset the directory to the default, C:\Oracle\Middleware.

      • Click Open.

    The Oracle Middleware Home directory is the main installation directory for Oracle Event Processing, such as c:\oracle_cep. You can have one or many Oracle Middleware Home directories on your computer, whichever suits your development and production environments best.

    For more information, see Section 2.1.4, "Oracle Fusion Middleware Directory Structure and Concepts".

  6. Click Next.

  7. In the Choose Install Type window, you can choose one of the following options:

    1. To install all Oracle Event Processing components except the samples and use the Oracle JRockit JVM included with Oracle Event Processing:

      • Select Typical.

      • Click Next.

      • Proceed to step 10.

      The installer program checks to see if the Oracle Middleware Home directory contains the version of JRockit required by this release of Oracle Event Processing:

      • If it finds the required JRockit installation, it does not install a new one.

      • If it does not find an appropriate JRockit installation, then the installer installs its own version in the Oracle Middleware Home directory.

    2. To install all Oracle Event Processing components including the default ocep_domain domain (with default passwords) and the samples and select a previously installed Sun or platform-specific JVM (or use the Oracle JRockit JVM included with Oracle Event Processing):

      • Select Custom.

      • In the Choose Products and Components window, check the components you want to install, such as the product samples.

      • Click Next.

      Note:

      By default, the complete installation does not include the default ocep_domain domain (with default passwords) and the product samples. If you want to install the samples (recommended), choose the Custom option.

      If you want to use a Sun or platform-specific JVM, you must choose the Custom option.

      The installer program allows you to choose the JDK to use and to decide whether or not to install the Oracle JRockit JVM included with Oracle Event Processing.

  8. In the JDK Selection window, you can choose the JDK for the Oracle Event Processing server.

    Use the Browse button to select the Sun or platform-specific JDK you installed previously.

    If you do not want the installer to install the Oracle JRockit JVM included with Oracle Event Processing, uncheck this item.

  9. Click Next.

  10. In the Choose Product Installation Directories window, you can change the default name of the Oracle Product Home directory for Oracle Event Processing, ocep_11.1.

    Although you can name this directory anything you want, Oracle recommends that you use the default name for clarity and standardization. For example, the documentation assumes that the Oracle Product Home directory is ocep_11.1.

    For more information, see Section 2.1.4, "Oracle Fusion Middleware Directory Structure and Concepts".

  11. Click Next.

  12. If you are installing on Windows, and you logged in as a user with Administrator privileges, then you will see the Choose Shortcut Location window where you can choose where you want the Start Menu folder to appear. The following table describes the options available:

    If you select . . . The following occurs . . .

    All Users

    Recommended. All users registered on the machine are provided with access to the installed software. Subsequently, if users without Administrator privileges use the Configuration Wizard from this installation to create domains, Start menu shortcuts to the domains are not created. In this case, users can manually create shortcuts in their local Start menu folders, if desired.

    Local user

    Other users registered on this machine will not have access to the Start menu entries for this installation.


    If you logged in as a user without Administrator privileges, the Start menu entries are created in your user's local Start menu folder.

  13. Click Next.

  14. The Installation Summary window shows the products and components you are about to install, along with the approximate size in MB. This window is for your information only; to change the components to be installed, use the Previous button to return to the appropriate window.

  15. Click Next.

    The installer program installs Oracle Event Processing. The Installation Complete window indicates that the product was installed successfully.

  16. Click Done to exit the program.

  17. Review the post-installation steps that Section 2.6, "Post-Installation Steps" describes.

2.3 Installing Oracle Event Processing in Console Mode

This section describes how to install using the Oracle Event Processing installer in console mode.

Console-mode installation is an interactive, text-based method for installing your software from the command line, on either a UNIX or Windows system.

When installing in console-mode, respond to the prompts in each section by entering the number associated with your choice or by pressing Enter to accept the default. To exit the installation process, enter exit (or x, for short) in response to any prompt. To review or change your selection, enter previous (or p, for short) at the prompt. To proceed to the following window, enter next (or n, for short).

Note:

In the following procedure, Windows conventions (such as back-slashes in pathnames) are used, for example, C:\oracle_cep\ocep_11.1. When entering pathnames on a UNIX system, be sure to use UNIX conventions, instead. For example, use forward slashes in pathnames, such as /oracle_cep/ocep_11.1.

For more information, see Section 2.1, "Installation Overview".

To install Oracle Event Processing in console mode:

  1. Log in to the Windows or Linux computer on which you want to install Oracle Event Processing.

    Be sure you log in to the computer as the user that will be the main administrator of the Oracle Event Processing installation.

  2. Download the product distribution file for the platform on which you want to install Oracle Event Processing.

  3. Launch the installation program in console mode using the commands listed in the following table appropriate for your platform.

    Platform Instructions

    Windows

    Open a command window, change to the download directory, and enter the following command:

    prompt> filename -mode=console
    

    In the preceding command, filename is the name of the installation program specific to your platform (for more information, see http://www.oracle.com/technology/software/products/middleware/htdocs/111110_fmw.html).

    If you want to create an installation log, use the -log=full_path_to_log_file option; for example:

    prompt> filename -mode=console -log=C:\logs\server_install.log
    

    Linux

    Open a command window, change to the download directory, and enter these commands:

    prompt> chmod a+x filename
    prompt> ./filename -mode=console
    

    In the preceding commands, filename is the name of the installation program specific to your platform (for more information, see http://www.oracle.com/technology/software/products/middleware/htdocs/111110_fmw.html).

    If you want to create an installation log, use the -log=full_path_to_log_file option; for example:

    prompt> ./filename -mode=console -log=C:\logs\server_install.log
    

  4. At the Welcome prompt, type next (or n for short) or press Enter to continue with the installation process.

  5. In the Choose Middleware Home Directory window, you can specify either an existing Oracle Middleware Home directory or create a new one:

    1. To install into an existing Oracle Middleware Home directory:

      • Type the number of the existing Oracle Middleware Home directory.

    2. To install into a new Oracle Middleware Home directory:

      • Type 1 to create a new Oracle Middleware Home directory.

      • The installation program guides you through the required steps to create the new Oracle Middleware Home.

        Be sure to enter the full path of the Oracle Middleware Home directory, for example C:\oracle_cep2.

        Note:

        Do not terminate the path with a file separator character. That is, enter C:\mydir and not C:\mydir\.

        If you specify a directory that does not exist, the installation program creates it for you.

    The Oracle Middleware Home directory is the main installation directory for Oracle Event Processing, such as c:\oracle_cep. You can have one or many Oracle Middleware Home directories on your computer, whichever suits your development and production environments best.

    For more information, see Section 2.1.4, "Oracle Fusion Middleware Directory Structure and Concepts".

  6. Confirm your choice for Oracle Middleware Home directory and enter next (or n).

  7. In the Choose Install Type window, you can choose one of the following options:

    1. To install all Oracle Event Processing components except the samples and use the Oracle JRockit JVM included with Oracle Event Processing:

      • Type 1 to choose a Typical install.

      • Proceed to step 9.

      The installer program checks to see if the Oracle Middleware Home directory contains the version of JRockit required by this release of Oracle Event Processing:

      • If it finds the required JRockit installation, it does not install a new one.

      • If it does not find an appropriate JRockit installation, then the installer installs its own version in the Oracle Middleware Home directory.

    2. To install all Oracle Event Processing components including the default ocep_domain domain (with default passwords) and the samples and select a previously installed Sun or platform-specific JVM (or use the Oracle JRockit JVM included with Oracle Event Processing):

      • Type 2 to choose a Custom install.

      • In the Choose Components to Install window, enter the numbers in brackets to toggle the components you want to install, such as the samples. To toggle a selection in the list, types its number. When a check mark appears next to the option, the option is selected. To unselect the option, enter its number again to remove the check mark

      • Enter next (or n) when you have chosen the components.

      Note:

      By default, the complete installation does not include the default ocep_domain domain (with default passwords) and the product samples. If you want to install the samples (recommended), choose the Custom option.

      If you want to use a Sun or platform-specific JVM, you must choose the Custom option.

      The installer program allows you to choose the JDK to use and to decide whether or not to install the Oracle JRockit JVM included with Oracle Event Processing.

  8. In the JDK Selection window, you can choose the JDK for the Oracle Event Processing server:

    • To add a local JDK, select the Add Local JDK option (1).

      The installation program guides you through the required steps to add a local JDK.

      Be sure to enter the full path to the JDK directory, for example:

      C:\Program Files\Java\jdk1.6.0_14
      

      To add additional JDKs, select 1 again.

    • In the JDK Selection window, enter the numbers in brackets to toggle the JDKs you want. To toggle a selection in the list, types its number. When a check mark appears next to the option, the option is selected. To unselect the option, enter its number again to remove the check mark.

      If you do not want the installer to install the Oracle JRockit JVM included with Oracle Event Processing, uncheck this item.

    • Enter next (or n) when you have selected the local JDK.

  9. In the Choose Product Installation Directories window, you can change the default name of the Oracle Product Home directory for Oracle Event Processing, ocep_11.1.

    Although you can name this directory anything you want, Oracle recommends that you use the default name for clarity and standardization. For example, the documentation assumes that the Oracle Product Home directory is ocep_11.1.

    For more information, see Section 2.1.4, "Oracle Fusion Middleware Directory Structure and Concepts".

    Enter next (or n) when you are done.

  10. If you are installing on Windows, and you logged in as a user with Administrator privileges, then you will see the Choose Shortcut Location window where you can choose where you want the Start Menu folder to appear. The following table describes the options available:

    If you select . . . The following occurs . . .

    1 "All Users"

    Recommended. All users registered on the machine are provided with access to the installed software. Subsequently, if users without Administrator privileges use the Configuration Wizard from this installation to create domains, Start menu shortcuts to the domains are not created. In this case, users can manually create shortcuts in their local Start menu folders, if desired.

    2 "Local user"

    Other users registered on this machine will not have access to the Start menu entries for this installation.


    If you logged in as a user without Administrator privileges, the Start menu entries are created in your user's local Start menu folder.

    Enter the appropriate number.

  11. Enter next (or n) when you are done.

  12. The Installation Summary window shows the products and components you are about to install, along with the approximate size in MB. This window is for your information only; to change the components to be installed, type Previous to return to the appropriate window.

  13. Enter next (or n).

    The installer program installs Oracle Event Processing. The Installation Complete window indicates that the product was installed successfully.

  14. Type exit to exit the program.

  15. Review the post-installation steps that Section 2.6, "Post-Installation Steps" describes.

2.4 Installing Oracle Event Processing in Silent Mode

This section describes how to install using the Oracle Event Processing installer in silent mode.

Silent-mode installation is a non-interactive method of installing your software that requires the use of an XML properties file for selecting installation options.

For more information, see Section 2.1, "Installation Overview".

To install Oracle Event Processing in silent mode:

  1. Log in to the Windows or UNIX computer on which you want to install Oracle Event Processing.

    Be sure you log in to the computer as the user that will be the main administrator of the Oracle Event Processing installation.

  2. Download the product distribution file for the platform on which you want to install Oracle Event Processing.

  3. Create a silent.xml file that defines the configuration settings normally entered by a user during an interactive installation process.

    See Section 2.4.1, "Creating a silent.xml File for Silent-Mode Installation."

    Note:

    Incorrect entries in the silent.xml file can cause installation failures. To help you determine the cause of a failure, we recommend that you create a log file when you launch the installation program.

  4. Launch the installation program in silent mode using the commands in the following table appropriate for your platform.

    Platform Instructions

    Windows

    Open a command window, change to the download directory, and enter the following command:

    prompt> filename -mode=silent -silent_xml=path_to_xml_file
    

    In the preceding command, filename is the name of the installation program specific to your platform (for more information, see http://www.oracle.com/technology/software/products/middleware/htdocs/111110_fmw.html) and path_to_xml_file is the full pathname of the silent.xml template file you created in the preceding step.

    If you want to create an installation log, use the -log=full_path_to_log_file option; for example:

    prompt> filename -mode=silent -silent_xml=path_to_xml_file  -log=C:\logs\server_install.log
    

    Linux or Solaris

    Open a command window, change to the download directory, and enter these commands:

    prompt> chmod a+x filename
    prompt> ./filename -mode=silent -silent_xml=path_to_xml_file
    

    In the preceding commands, filename is the name of the installation program specific to your platform (for more information, see http://www.oracle.com/technology/software/products/middleware/htdocs/111110_fmw.html) and path_to_xml_file is the full pathname of the silent.xml template file you created in the preceding step.

    If you want to create an installation log, use the -log=full_path_to_log_file option; for example:

    prompt> ./filename -mode=silent -silent_xml=path_to_xml_file  -log=C:\logs\server_install.log
    

    An Oracle Installer window is displayed, indicating that the files are being extracted. No other prompt or text is displayed.

    The installation is complete when the Oracle Installer window disappears.

    See Section 2.4.3, "Returning Exit Codes to the Command Window" for getting information about the success or failure of the silent installation.

  5. Review the post-installation steps that Section 2.6, "Post-Installation Steps" describes.

2.4.1 Creating a silent.xml File for Silent-Mode Installation

When you install Oracle Event Processing in silent mode, the installation program uses an XML file (silent.xml) to determine which installation options should be implemented.

To create a silent.xml file for silent-mode installation:

  1. Using your favorite text editor, create an empty file called silent.xml on the computer on which you want to install Oracle Event Processing in silent mode.

  2. Copy the contents of the sample XML file, shown in Example 2-1, into your own silent.xml file.

    Example 2-1 Sample silent.xml File for Silent-Mode Installation

    <?xml version="1.0" encoding="UTF-8"?>
    <!-- Silent installer option: -mode=silent -silent_xml=C:\oracle\silent.xml -->
    <bea-installer> 
        <input-fields>
            <data-value name="BEAHOME"            value="C:\oracle_cep" />
            <data-value name="USER_INSTALL_DIR"   value="C:\oracle_cep\ocep_11.1" />
            <data-value name="INSTALL_SHORTCUT_IN_ALL_USERS_FOLDER"   value="yes"/>
            <data-value name="COMPONENT_PATHS" value="Oracle Event Processing" />
        </input-fields> 
    </bea-installer>
    
  3. In the silent.xml file you just created, edit the values for the keywords shown in Table 2-3 to reflect your configuration.

    For example, if you want to install into the ORACLE_CEP_HOME directory e:\oracle_cep, update the corresponding <data-value> element as follows

    <data-value name="BEAHOME" value="e:\oracle_cep" />
    

    Table 2-3 Values for the silent.xml File

    For this data-value name... Enter the following value...

    BEAHOMEFoot 1 

    The full pathname for the Oracle Middleware Home directory of your choice.

    For more information, see Section 2.1.4, "Oracle Fusion Middleware Directory Structure and Concepts".

    USER_INSTALL_DIR

    The full pathname for the Oracle Product Home directory for Oracle Event Processing of your choice.

    For more information, see Section 2.1.4, "Oracle Fusion Middleware Directory Structure and Concepts".

    INSTALL_SHORTCUT_IN_ALL_USERS_FOLDER

    Windows only. Specify:

    • true, or yes, to create the shortcuts in the All Users folder.

    • false, or no, to create the shortcuts in the local users folder.

    The user performing the installation must have Administrator privileges to install the Start menu shortcuts in the All Users folder.

    The default value for this parameter, if you do not specify it, is true.

    COMPONENT_PATHS

    Specify the components and subcomponents of Oracle Event Processing you want to install on your system. Use the following values:

    • Oracle Event Processing

    • Oracle Event Processing/Event Server

    • Oracle Event Processing/Event Server Samples

    For additional information about entering these values, see Section 2.4.2, "Guidelines for Component Selection."

    If you do not include the COMPONENT_PATHS data-value name in the silent.xml file, the complete Oracle Event Processing product is installed.

    LOCAL_JVMS

    Option to select supported JVM, which is already installed.

    Note: The presence of the LOCAL_JVMS token negates any default selection and only sets the values assigned for the token as user selection. The value of the token can be a pipe (|) separated JavaHomes.


    Footnote 1 Do not terminate the pathname with a file separator. That is, enter this C:\mydirectory and not C:\mydirectory\.

    Note:

    Silent install does not support the LOCAL_JVMS data-value. To define a local JVM, you must use graphical mode installation as Section 2.2, "Installing Oracle Event Processing in Graphical Mode" describes.

  4. Save the file in the directory of your choice.

2.4.2 Guidelines for Component Selection

Use the following guidelines when you specify values for the COMPONENT_PATHS data-value name:

  • When you specify a product component to be installed, all subcomponents that are installed by default in a complete installation are also installed. For example, the following entry installs both Oracle Event Processing and the samples:

    <data-value name="COMPONENT_PATHS" 
        value="Oracle Event Processing" />
    
  • To install multiple components or subcomponents, separate the components with a bar (|). Do not leave a space before or after the bar.

  • To specify subcomponents, you must specify a component/subcomponent combination for each entry. For example, to explicitly install Oracle Event Processing and the samples, enter the following line in the file:

    <data-value name="COMPONENT_PATHS" value="Oracle Event Processing/Event Server|Oracle Event Processing/Event Server Samples" />
    

    Note:

    Because this release of Oracle Event Processing includes only the server itself and samples, the preceding example is equivalent to the example in the first bullet.

2.4.3 Returning Exit Codes to the Command Window

When run in silent mode, the installation program generates exit codes that indicate the success or failure of the installation. These exit codes are shown in Table 2-4.

Table 2-4 Exit Codes

Code Description

0

Installation completed successfully

-1

Installation failed due to a fatal error

-2

Installation failed due to an internal XML parsing error


Example 2-2 provides a sample Windows command file that invokes the installation program in silent mode and echoes the exit codes to the command window from which the script is executed.

Example 2-2 Sample Windows Command File Displaying Silent-Mode Exit Codes

rem Execute the installer in silent mode
@echo off
ofm_ocep_generic_11.1.1.1.0_32_disk1_1of1.exe -mode=silent -silent_xml=C:\downloads\silent.xml -log=C:\logs\products_silent.log

@rem Return an exit code to indicate success or failure of installation
set exit_code=%ERRORLEVEL%

@echo.
@echo Exitcode=%exit_code%
@echo.
@echo Exit Code Key
@echo ---------------
@echo  0=Installation completed successfully
@echo -1=Installation failed due to a fatal error
@echo -2=Installation failed due to an internal XML parsing error
@echo.

2.4.4 Uninstalling Oracle Event Processing in Silent Mode

This section describes how to uninstall Oracle Event Processing in silent mode using a script included with the installation. You can run this script in silent mode.

To install Oracle Event Processing in silent mode:

  1. Log in to the Windows or UNIX computer from which you want to uninstall Oracle Event Processing.

    Be sure you log in to the computer as the user that is the main administrator of the Oracle Event Processing installation.

  2. Run the uninstall script using the commands in the following table appropriate for your platform.

    Platform Instructions

    Windows

    Open a command window and enter the following command:

    prompt> $BEA_HOME\ocep_11.1\uninstall\uninstall.cmd -mode=silent
    

    In the preceding command, it is assumed that $BEA_HOME has been set, such as during product installation.

    Linux or Solaris

    Open a command window and enter the following command:

    prompt> $BEA_HOME/ocep_11.1/uninstall/uninstall.sh -mode=silent
    

    In the preceding command, it is assumed that $BEA_HOME has been set, such as during product installation.


2.5 Installing an Oracle Event Processing Patch

You can download maintenance and security updates for Oracle Event Processing from My Oracle Support. For more information, see Oracle Smart Update Applying Patches to Oracle WebLogic Server.

2.6 Post-Installation Steps

After installing Oracle Event Processing:

2.6.1 Configuring Oracle Event Processing for the IBM JDK

If you installed Oracle Event Processing for use with the IBM JDK, depending on your operating system and processor architecture, you must make changes to the IBM AIX network options and the setDomainEnv script in each Oracle Event Processing domain directory. This section describes:

2.6.1.1 How to Configure Oracle Event Processing for the IBM JVM on IBM AIX (64-bit)

If you installed Oracle Event Processing for use with the IBM JDK on IBM AIX (64-bit), you must make changes to the IBM AIX network options and the setDomainEnv script in each Oracle Event Processing domain directory.

To configure Oracle Event Processing for the IBM JVM on IBM AIX (64-bit):

  1. Execute the following commands (using super user privileges or sudo) to modify the AIX network options:

    no -o rfc1323=1
    no -o sb_max=4194304
    
  2. Go to the domain directory.

    For example, MIDDLEWARE_HOME/user_projects/domains/ocep_domain/defaultserver

  3. Edit the setDomainEnv.sh script and add the following line:

    export IBM_JAVA_OPTIONS="-Djava.net.preferIPv4Stack=true -Djava.net.preferIPv6Addresses=false"
    

2.7 Installing the Oracle Event Processing IDE for Eclipse

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

For more information, see:

2.8 Upgrading to Oracle Event Processing 11g Release 1 (11.1.1.7)

Upgrading to Oracle Event Processing 11g Release 1 (11.1.1.7) is a two-step process: first you must upgrade your applications and then you must upgrade the domain to which the applications are deployed.

Table 2-5 lists the steps you must take for each supported upgrade path:

For more information, see Section 2.8.5, "Backward Compatibility Issues".

2.8.1 Upgrading a WebLogic Event Server 2.0 Domain to Oracle Event Processing 10.3

This section describes the steps you must take to upgrade a WebLogic Event Server 2.0 domain so that it runs correctly in Oracle Event Processing 10.3. For clarity, it is assumed that the existing WebLogic Event Server 2.0 domain is located in the /bea/user_projects/domains/mydomain20 directory.

To upgrade a WebLogic Event Server 2.0 domain to Oracle Event Processing 10.3:

  1. Using the Configuration Wizard, create a temporary Oracle Event Processing 10.3 domain. Later steps in this procedure require you to use or refer to files in a new Oracle Event Processing 10.3 domain, and it is best to use a new domain. You can later delete this domain if you want.

    For the purposes of this procedure, it is assumed that the new Oracle Event Processing 10.3 domain is called mydomain30, it contains a single server called defaultserver, and the server files are located in the /oracle_cep/user_projects/domains/mydomain30/defaultserver directory.

    See "Creating an Oracle Event Processing Standalone-Server Domain" in the Oracle Fusion Middleware Administrator's Guide for Oracle Event Processing.

  2. If the WebLogic Event Server 2.0 server is currently running, stop it.

  3. Make a backup copy of your WebLogic Event Server 2.0 domain in case you need to revert back.

  4. Replace the following two files in the WebLogic Event Server 2.0 domain with the equivalent files from the Oracle Event Processing 10.3 domain.

    • lib/XACMLAuthorizerInit.ldift

    • lib/XACMLRoleMapperInit.ldift

    The WebLogic Event Server 2.0 files are located relative to the domain directory (/bea/user_projects/domains/mydomain20 in our example) and the Oracle Event Processing 10.3 files are located relative to the server directory under the domain directory (/oracle_cep/user_projects/domains/mydomain30/defaultserver in our example).

  5. Using your favorite text editor, open the atnstore.txt file in the WebLogic Event Server 2.0 domain, located in the config sub-directory of the main domain directory, and add the new Oracle 10.3 groups:

    group: wlevsDeployers
    description:
    group: wlevsApplicationAdmins
    description:
    group: wlevsBusinessUsers
    description:
    group: wlevsOperators
    description:
    
  6. Remove the following files and directories (if they exist) in the WebLogic Event Server 2.0 domain:

    • FileBasedDefaultCredentialMappermy-realmInit.initialized

    • FileBasedXACMLAuthorizermy-realmInit.initialized

    • FileBasedXACMLRoleMappermy-realmInit.initialized

    • rm

    • cm

    • atz

  7. Update the startwlevs.cmd (Windows) or startwlevs.sh (Unix) command scripts in the WebLogic Event Server 2.0 domain to point to the new Oracle 10.3 binaries.

  8. Update the stopwlevs.cmd (Windows) or stopwlevs.sh (Unix) command scripts in the WebLogic Event Server 2.0 domain to point to the new Oracle 10.3 binaries.

  9. Start the server in the 2.0 domain using the Oracle 10.3 binaries.

    "Starting and Stopping an Oracle Event Processing Server in a Standalone-Server Domain" in the Oracle Fusion Middleware Administrator's Guide for Oracle Event Processing.

  10. This upgrade procedure might have changed the security configuration of your 2.0 domain, especially if you created new users and assigned them to groups. If this is the case, use Visualizer to reconfigure the security.

    See:

2.8.2 Upgrading an Oracle Event Processing 10.3 Domain to Oracle Event Processing 11g Release 1 (11.1.1.7)

This section describes the steps you must take to upgrade an Oracle Event Processing 10.3 domain so that it runs correctly in Oracle Event Processing 11g Release 1 (11.1.1). For clarity, it is assumed that the existing Oracle Event Processing 10.3 domain is located in the /bea/user_projects/domains/mydomain103 directory.

To upgrade an Oracle Event Processing 10.3 domain to Oracle Event Processing release 11g Release 1 (11.1.1.7):

  1. Using the Configuration Wizard, create a temporary Oracle Event Processing 11g Release 1 (11.1.1.7) domain. Later steps in this procedure require you to use or refer to files in a new Oracle Event Processing 11g Release 1 (11.1.1.7) domain, and it is best to use a new domain. You can later delete this domain if you want.

    For the purposes of this procedure, it is assumed that the new Oracle Event Processing 11g Release 1 (11.1.1) domain is called mydomain11, it contains a single server called defaultserver, and the server files are located in the /oracle_cep/user_projects/domains/mydomain11/defaultserver directory.

    See "Creating an Oracle Event Processing Standalone-Server Domain" in the Oracle Fusion Middleware Administrator's Guide for Oracle Event Processing.

  2. If the WebLogic Event Server 10.3 server is currently running, stop it.

  3. Make a backup copy of your WebLogic Event Server 10.3 domain in case you need to revert back.

  4. Replace the following two files in the WebLogic Event Server 10.3 domain with the equivalent files from the Oracle Event Processing 11g Release 1 (11.1.1) domain.

    • lib/XACMLAuthorizerInit.ldift

    • lib/XACMLRoleMapperInit.ldift

    The WebLogic Event Server 10.3 files are located relative to the domain directory (/bea/user_projects/domains/mydomain30 in our example) and the Oracle Event Processing 11g Release 1 (11.1.1) files are located relative to the server directory under the domain directory (/oracle_cep/user_projects/domains/mydomain11/defaultserver in our example).

  5. Using your favorite text editor, open the atnstore.txt file in the WebLogic Event Server 10.3 domain, located in the config sub-directory of the main domain directory, and add the new Oracle 11g Release 1 (11.1.1.7) groups:

    group: wlevsDeployers
    description:
    group: wlevsApplicationAdmins
    description:
    group: wlevsBusinessUsers
    description:
    group: wlevsOperators
    description:
    
  6. Remove the following files and directories (if they exist) in the WebLogic Event Server 10.3 domain:

    • FileBasedDefaultCredentialMappermy-realmInit.initialized

    • FileBasedXACMLAuthorizermy-realmInit.initialized

    • FileBasedXACMLRoleMappermy-realmInit.initialized

    • rm

    • cm

    • atz

  7. Update the startwlevs.cmd (Windows) or startwlevs.sh (Unix) command scripts in the WebLogic Event Server 10.3 domain to point to the new Oracle 11g Release 1 (11.1.1.7) binaries.

  8. Update the stopwlevs.cmd (Windows) or stopwlevs.sh (Unix) command scripts in the WebLogic Event Server 10.3 domain to point to the new Oracle 11g Release 1 (11.1.1.7) binaries.

  9. Start the server in the 10.3 domain using the Oracle 11g Release 1 (11.1.1.7) binaries.

    "Starting and Stopping an Oracle Event Processing Server in a Standalone-Server Domain" in the Oracle Fusion Middleware Administrator's Guide for Oracle Event Processing.

  10. This upgrade procedure might have changed the security configuration of your 10.3 domain, especially if you created new users and assigned them to groups. If this is the case, use Visualizer to reconfigure the security.

    See:

2.8.3 Upgrading a WebLogic Event Server 2.0 Application to Run on Oracle Event Processing 10.3

This section describes the steps you must take to upgrade an application that you developed in Version 2.0 of WebLogic Event Server so that it runs on Oracle Event Processing 10.3.

To upgrade a WebLogic Event Server 2.0 application to run on Oracle Event Processing 10.3:

  1. Update the MANIFEST.MF file to import new versions of Spring framework and Oracle Event Processing packages, as well as new required packages. In particular:

    • Update the version of all imported Spring framework packages to 2.5.5. For example:

      Import-Package:
          org.springframework.aop.framework;version="2.5.5",
          org.springframework.aop;version="2.5.5",
          ...
      
    • Update the version of any imported Oracle Event Processing packages to 3.0.0.0. For example:

      Import-Package:
          com.bea.wlevs.ede;version="3.0.0.0",
          com.bea.wlevs.ede.api;version="3.0.0.0",
          ...
      
    • Add the following packages to the Import-Package header if they are not already included:

      Import-Package:
          com.bea.wlevs.management.configuration.spi;version="3.0.0.0",
          com.bea.wlevs.management.spi;version="3.0.0.0",
          com.bea.wlevs.monitor;version="3.0.0.0",
          com.bea.wlevs.spi;version="3.0.0.0",
          com.bea.wlevs.spring.support;version="3.0.0.0",
          commonj.work;version="1.4.0.0",
          org.springframework.osgi.extensions.annotation;version="1.1.0",
          com.bea.wlevs.ede.spi;version="3.0.0.0",
          com.bea.wlevs.configuration.internal;version="3.0.0.0",
          ...
      
  2. If you use Spring or Spring Dynamic Modules for OSGI (Spring DM) features in your application, it is possible that the declaration of the features in the Spring application context file has changed. If this is the case, you must update these declarations in the EPN assembly file of your Oracle Event Processing application.

    Note:

    This change is a result of the upgrade of the Spring framework (from 2.0 to 2.5) that occurred between WebLogic Event Server 2.0 and Oracle Event Processing 10.3, not as a direct result of the Oracle Event Processing upgrade

    Refer to the appropriate 2.5 XSD Schemas for any changes:

    The following bullets list some of the typical changes you might have to make; the following list is not complete:

    • When specifying a property to the <osgi:service-property> tag, use the <entry> tag with the key and value attributes, rather than the old <prop> tag.

      For example, change the following 2.0 tag from:

      <osgi:service-properties>
          <prop key="type">SocketAdapterType</prop>
      </osgi:service-properties>
      

      To:

      <osgi:service-properties>
          <entry key="type" value="SocketAdapterType"/>
      </osgi:service-properties>
      
    • The value or ref attribute of an instance-property must always be set to an explicit value; it can no longer be an empty string to indicate an implicit use of a default value.

      For example, change the following 2.0 tag from:

      <wlevs:adapter id="fileAdapter" provider="FileAdapterType">
          <!-- file: empty value uses default
          <wlevs:instance-property name="file" value="" />
          <wlevs:listener ref="algoTradingProcessor"/>
      </wlevs:adapter>
      

      To:

      <wlevs:adapter id="fileAdapter" provider="FileAdapterType">
          <wlevs:instance-property name="file" value="test.file" />
          <wlevs:listener ref="algoTradingProcessor"/>
      </wlevs:adapter>
      
  3. Recompile the Java code of your 2.0 adapter and business POJO implementations using your IDE. If you get compile-time errors, check the latest 10.3 Javadoc (http://download.oracle.com/docs/cd/E13157_01/wlevs/docs30/javadocs/wlevs/index.html) that describe the new Oracle Event Processing APIs and make the appropriate source code changes.

  4. If your 2.0 application has an adapter that uses the loadgen provider as Example 2-3 shows, then you must register a StockTick event type in your EPN assembly file as Example 2-4 shows.

    Example 2-3 Adapter Using loadgen Provider

    <wlevs:adapter id="fxMarketAmer" provider="loadgen">
        <wlevs:instance-property name="port" value="9011"/>
    </wlevs:adapter>
    

    Example 2-4 Registering a StockTick Event

    <wlevs:event-type-repository>
        <wlevs:event-type type-name="StockTick">
            <wlevs:class>com.bea.wlevs.adapter.defaultprovider.StockTickEvent</wlevs:class>
        </wlevs:event-type>
    </wlevs:event-type-repository>
    
  5. After you have made the preceding changes, reassemble the application and deploy it to Oracle Event Processing 10.3.

    See "Assembling and Deploying Oracle Event Processing Applications" in the Oracle Fusion Middleware Developer's Guide for Oracle Event Processing for Eclipse.

    If, during deployment, you get an exception that indicates that a package is invisible, add this package to the Import-Package header of the MANIFEST.MF file, then reassemble and redeploy the application. Keep adding packages in this manner until the application deploys successfully.

2.8.4 Upgrading an Oracle Event Processing 10.3 Application to Run on Oracle Event Processing 11g Release 1 (11.1.1.7)

This section describes the steps you must take to upgrade an application that you developed in Oracle Event Processing 10.3 so that it runs on Oracle Event Processing 11g Release 1 (11.1.1.7).

To upgrade an Oracle Event Processing 10.3 application to run on Oracle Event Processing release 1111g Release 1 (11.1.1.7):

  1. Update the MANIFEST.MF file to import new versions of Spring framework and Oracle Event Processing packages, as well as new required packages.

    Note that alternatively you can specify unversioned packages which will not require updating and also that you can specify larger versions in order to avoid minor version updates, that is, use "2.5" instead of "2.5.6".

    In particular:

    • Update the version of all imported Spring framework packages to 2.5.6. For example:

      Import-Package:
          org.springframework.aop.framework;version="2.5.6",
          org.springframework.aop;version="2.5.6",
          ...
      
    • Update the version of all imported Spring-DM framework packages to 1.2.0. For example:

      Import-Package:
          org.springframework.osgi.context="1.2.0",
          ...
      
    • Update the version of any imported Oracle Event Processing packages to 11.1.1.4_0. For example:

      Import-Package:
          com.bea.wlevs.ede;version="11.1.1.4_0",
          com.bea.wlevs.ede.api;version="11.1.1.4_0",
          ...
      
    • Add the following packages to the Import-Package header if they are not already included (see the sample source for a complete list of headers that may be required):

      Import-Package:
          com.bea.wlevs.management.spi;version="11.1.1.4_0",
          com.bea.wlevs.spring.support;version="11.1.1.4_0",
          com.bea.wlevs.ede.spi;version="11.1.1.4_0",
          org.springframework.osgi.extensions.annotation;version="1.2.0",
          ...
      
  2. If you use Spring or Spring Dynamic Modules for OSGI (Spring DM) features in your application, it is possible that the declaration of the features in the Spring application context file has changed. If this is the case, you must update these declarations in the EPN assembly file of your Oracle Event Processing application.

    Note:

    This change is a result of the upgrade of the Spring-DM framework (from 1.1 to 1.2) that occurred between Oracle Event Processing 10.3 and Oracle Event Processing 11.1, not as a direct result of the Oracle Event Processing upgrade.

    Refer to the appropriate 2.5 XSD Schemas for any changes:

    In particular convert any Spring-DM declared adapter factories to use the <wlevs:factory/> tag instead. For example, if your 10.3 EPN assembly file contains the service that Example 2-5 shows, then you must replace this service with the wlevs:factory that Example 2-6 shows.

    Example 2-5 Spring-DM Declared Adapter Factory

    <osgi:service interface="com.bea.wlevs.ede.api.AdapterFactory">
        <osgi:service-properties>
            <entry key="type" value="SocketAdapterType"/>
        </osgi:service-properties>
        <bean class="com.bea.wlevs.example.algotrading.adapter.SocketAdapterFactory" />
    </osgi:service>
    

    Example 2-6 wlevs:factory

    <wlevs:factory provider-name="SocketAdapterType"     class="com.bea.wlevs.example.algotrading.adapter.SocketAdapterFactory"/>
    
  3. Recompile the Java code of your 10.3 adapter and business POJO implementations using your IDE. If you get compile-time errors, check the latest 11g Release 1 (11.1.1) Javadoc (see Oracle Fusion Middleware Java API Reference for Oracle Event Processing) that describe the new Oracle Event Processing APIs and make the appropriate source code changes.

  4. After you have made the preceding changes, reassemble the application and deploy it to Oracle Event Processing 11g Release 1 (11.1.1).

    See "Assembling and Deploying Oracle Event Processing Applications" in the Oracle Fusion Middleware Developer's Guide for Oracle Event Processing for Eclipse.

    If, during deployment, you get an exception that indicates that a package is invisible, add this package to the Import-Package header of the MANIFEST.MF file, then reassemble and redeploy the application. Keep adding packages in this manner until the application deploys successfully.

2.8.5 Backward Compatibility Issues

The following are non-backward compatible changes in the management framework:

  • The following classes have been deprecated and removed from all operation signatures:

    • com.bea.wlevs.management.ManagementException

    • com.bea.wlevs.management.ManagementRuntimeException

    • com.bea.wlevs.management.MbeanOperationsException

  • The following methods have been removed from all MBeans: isRegistered(), preRegister(), postRegister(), getMBeanInfo().

  • The monitoring-related methods have been removed from StageMBean and replaced by com.bea.wlevs.monitor.management.MonitorRuntimeMBean.

  • The com.bea.wlevs.management.boot.BootMBean has been removed.

  • The com.bea.wlevs.management.configuration.ConfigSessionBean has been removed.

  • The ObjectName for the AppDeploymentMBean has been changed to include the DomainMBean as a parent.

  • The class com.bea.wlevs.server.management.mbean.ServerRuntimeMBean has been changed to com.bea.wlevs.management.runtime.ServerRuntimeMBean.

  • Two additional modules have been added: com.bea.wlevs.management.api_* and com.bea.wlevs.management.spi_*, in addition to the existing com.bea.wlevs.management_*.

  • The service com.bea.wlevs.spi.ManagementService has been moved from bundle com.bea.wlevs.spi_* to com.bea.wlevs.management.spi_*.