Getting Started Guide

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Installing Oracle Complex Event Processing

This section contains information on the following subjects:

 

Before You Begin

Before you install Oracle Complex Event Processing 3.0 (or Oracle CEP for short):

 

Installation Overview

You install Oracle CEP using a standard Oracle installation program. The program can be used in the following modes:

 

Installing Oracle CEP in Graphical Mode: Main Steps

The Oracle CEP graphical installation program is self-explanatory, however, you can follow these steps for more information.

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

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

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

    3. You can download your software from the Oracle Web site at http://commerce.bea.com.

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

    4. Platform
    Instructions
    Windows
    Using Windows Explorer, double-click the wlevs30_win32.exe file from its download directory.
    UNIX
    Open a command window, change to the download directory, and enter these commands:

    prompt> chmod a+x filename.bin

    prompt> ./filename.bin

    In these commands, filename.bin is the name of the installation program specific to your platform, for example, wlevs30_linux32.bin and wlevs30_solaris64.bin.
    If you want to create an installation log, use the -log=full_path_to_log_file option; for example:

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

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

    5. Click Next.

  5. In the Choose BEA_HOME Directory window, you can specify either an existing BEA_HOME directory or create a new one. Oracle recommends that you use the same BEA_HOME directory into which you installed Oracle JRockit Real Time, if applicable.

    6. The BEA_HOME directory is the main installation directory for many Oracle products, such as c:\beahome. You can have one or many BEA_HOME directories on your computer, whichever suits your development and production environments best.

    If you decide to install into an existing BEA_HOME directory, the installer program checks if the directory includes the version of JRockit required by this release of Oracle CEP. If it finds the required JRockit installation, it does not install a new one. If, however, the installer program does not find an appropriate JRockit installation, then the program installs its own version in the BEA_HOME directory.

    Use the Browse button to browse your computer for an existing or new BEA_HOME directory.

    Click Next.

  6. In the Choose Install Type window, you can choose whether to install the complete version of Oracle CEP (recommended) or whether you want to pick the individual components of the product that you want to install.

    7. Click Next.

  7. If you chose Custom in the preceding step, you will see the Choose Products and Components window. Check the components you want to install.
    8. Note: In this version of Oracle CEP, the only component you can install separately is the Event Server Samples.

    Click Next.

  8. In the Choose Product Installation Directories, you can change the default name of the home directory of Oracle CEP, wlevs30.

    9. 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 you install into the wlevs30 directory.

    Click Next.

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

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

    Click Next.

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

  10. Click Done to exit the program.

 

Installing Oracle CEP in Console Mode: Main Steps

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:\bea\wlevs30. When entering pathnames on a UNIX system, be sure to use UNIX conventions, instead. For example, use forward slashes in pathnames, such as /home/bea/wlevs30.

The following procedure steps you through the installation program.

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

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

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

    3. You can download your software from the Oracle Web site at http://commerce.bea.com.

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

    4. Platform
    Instructions
    Windows
    Open a command window, change to the download directory, and enter the following command:

    prompt> wlevs30_win32.exe -mode=console

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

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

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

    prompt> chmod a+x filename.bin

    prompt> ./filename.bin -mode=console

    In these commands, filename.bin is the name of the installation program specific to your platform, for example, wlevs30_linux32.bin and wlevs30_solaris64.bin.
    If you want to create an installation log, use the -log=full_path_to_log_file option; for example:

    prompt> ./filename.bin -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 BEA_HOME Directory window, the list of known home directories (if any) appear, as well as an option to create a new one. Oracle recommends that you use the same BEA_HOME directory into which you installed Oracle JRockit Real Time, if applicable.

    6. The BEA_HOME directory is the main installation directory for many Oracle products, such as c:\beahome. You can have one or many BEA_HOME directories on your computer, whichever suits your development and production environments best.

    If you decide to install into an existing BEA_HOME directory, the installer program checks if the directory includes the version of JRockit required by this release of Oracle CEP. If it finds the required JRockit installation, it does not install a new one. If, however, the installer program does not find an appropriate JRockit installation, then the program installs its own version in the BEA_HOME directory.

    Type 1 to create a new BEA_home directory, or type the number of the existing BEA_HOME directory.

  6. If you chose 1 to create a new BEA_HOME directory, the installation program guides you through the required steps to create the new BEA_HOME. Be sure to enter the full path of the BEA_HOME directory, for example C:\beahome2. If you specify a directory that does not exist, the installation program creates it for you.
  7. In the Choose Install Type window, you can choose whether to install the complete version of Oracle CEP (recommended) or whether you want to pick the individual components of the product that you want to install.

    8. Enter 1 for a complete install or 2 for a custom install.

  8. If you chose Custom in the preceding step, you will see the Choose Components to Install window. Enter the numbers in brackets to toggle the components you want to install.
    9. Note: In this version of Oracle CEP, the only component you can install separately is the Samples.

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

  9. In the Choose Product Installation Directories, you can change the default name of the home directory of Oracle CEP, wlevs30, by entering a new value.

    10. 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 you install into the wlevs30 directory.

    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:

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

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

  11. Type exit to exit the program.

 

Installing Oracle CEP in Silent Mode: Main Steps

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. To install using silent mode:

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

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

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

    3. You can download your software from the Oracle Web site at http://commerce.bea.com.

  3. Create a silent.xml file that defines the configuration settings normally entered by a user during an interactive installation process. See Creating a silent.xml File for Silent-Mode Installation.
    4. 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.

    5. Platform
    Instructions
    Windows
    Open a command window, change to the download directory, and enter the following command:

    prompt> wlevs30_win32.exe -mode=silent -silent_xml=path_to_xml_file

    In the preceding command, 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> wlevs30_win32.exe -mode=silent -silent_xml=path_to_xml_file -log=C:\logs\server_install.log

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

    prompt> chmod a+x filename.bin

    prompt> ./filename.bin -mode=silent -silent_xml=path_to_xml_file

    In these commands, filename.bin is the name of the installation program specific to your platform, for example, wlevs30_linux32.bin and wlevs30_solaris64.bin, 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.bin -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 Returning Exit Codes to the Command Window for getting information about the success or failure of the silent installation.

Creating a silent.xml File for Silent-Mode Installation

When you install Oracle CEP 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, follow these steps:

  1. Using your favorite text edit, create an empty file called silent.xml on the computer on which you want to install Oracle CEP in silent mode.
  2. Copy the contents of the sample XML file, shown in Sample silent.xml File for Silent-Mode Installation, into your own silent.xml file.
  3. In the silent.xml file you just created, edit the values for the keywords shown in Table 4-1 to reflect your configuration.

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

    <data-value name="BEAHOME" value="e:\beahome" />
  4. Save the file in the directory of your choice.

    5. Table 4-1 Values for the silent.xml File
    For this data-value name...
    Enter the following value...
    BEAHOME
    The full pathname for the BEA_HOME directory of your choice.
    USER_INSTALL_DIR
    The full pathname for the directory where you want to install your Oracle CEP software.
    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 CEP you want to install on your system. Use the following values:

    WebLogic Event Server

    WebLogic Event Server/Event Server

    WebLogic Event Server/Event Server Samples

    For additional information about entering these values, see Guidelines for Component Selection.
    If you do not include the COMPONENT_PATHS data-value name in the silent.xml file, the complete Oracle CEP product is installed.

Guidelines for Component Selection

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

Sample silent.xml File for Silent-Mode Installation 

<?xml version="1.0" encoding="UTF-8"?>
<!-- Silent installer option: -mode=silent -silent_xml=C:\bea\silent.xml -->
<bea-installer> 
  <input-fields>
      <data-value name="BEAHOME"            value="C:\bea" />
      <data-value name="USER_INSTALL_DIR"   value="C:\bea\wlevs30" />
      <data-value name="INSTALL_SHORTCUT_IN_ALL_USERS_FOLDER"   value="yes"/>
      <data-value name="COMPONENT_PATHS" value="WebLogic Event Server" />
  </input-fields> 
</bea-installer>

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 the following table.

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

Listing 4-1 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.

Listing 4-1 Sample Windows Command File Displaying Silent-Mode Exit Codes 
rem Execute the installer in silent mode
@echo off
wlevs30_win32.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.

 

Post-Installation Steps

After installing Oracle CEP:


  Back to Top       Previous  Next