Tuesday, 4 October 2016

Installing Oracle Event Processing 12.1.3

Introduction



Oracle Event Processing (OEP) consists of the Oracle Event Processing server, Oracle Event Processing Visualizer, Oracle Stream Explorer, a command-line administrative interface.
In this post I will show how to install Oracle Event Processing 12.1.3 and configure a domain using both Graphical and Silent modes.
To develop OEP applications we can use both Oracle Stream Explorer and the Oracle JDeveloper Integrated Development Environment (IDE).The easiest way to get the Oracle JDeveloper is to install a SOA Suite 12c Quick Start Distribution.  
Oracle Fusion Middleware 12.1.3 products require JDK7.0 Update 55 or later. Before starting the installation, make sure that you have a working Java Development Kit (JDK) environment.  To check your java version open a command prompt and type the following command: 

>java -version



Directories Structure


During the installation and domain configuration process, you must provide the locations for these directories: Oracle Home, Domain Home.
Create the base location (Oracle base) on your system /u01/app/oracle and from there, two separate branches config and product. The product directory will contain the product binary files and all of the Oracle home directories. The config directory will contain your domain data.


The following directories are used in examples throughout this post:
  • ORACLE_HOME: /u01/app/oracle/product/12.1.3/oep 
  • DOMAIN_HOME: /u01/app/oracle/config/12.1.3/oep/domains 
  • TMP: /temp
be sure to replace these directories with the actual directories on your system.

Obtain the Product Distribution


  1. Go to Oracle Software Delivery Cloud. 
  2. Search the Stream Explorer 
  3. Select the platform.


  1. This will download the following 2 files:
    • V74788-01_1of2.zip
      This archive contains the OEP installer jar file fmw_12.1.3.0.0_oep.jar
    • V74788-01_2of2.zip
      This archive file contains the Stream Explorer Patch
  1. Unzip both files in the TMP folder.

Installing Oracle Event Processing


We can use the Oracle Event Processing installer in the following modes: 
  • Graphical Mode
  • Silent Mode

Graphical Mode


  1. Open a Command Prompt as Administrator and navigate to the TMP folder

    > cd /temp

  2. Launch the installation program by invoking the following command:

    > java -jar fmw_12.1.3.0.0_oep.jar

  3. The installation wizard will launch and the installation welcome screen should appear
  1. Click Next.

  1. Click on Browse and navigate to the folder where the Oracle Event Processing home should be placed.
  2. Click Next.
  1. Choose Event Processing with Examples to install the event server with the example applications.
  2. Click Next.
  1. Click Next.

  1. Click Install to start the installation. This will take a few minutes and after that the following screen should appear.
  1. After the installation finishes, click Next and the following screen should show the summary of the installation.
  1. Click Finish.
By that the Oracle Event Processing server software has been installed. In order to use it, we have to create an Oracle Event Processing domain.
Note: An Oracle Event Processing installation does not include Oracle Fusion Middleware Infrastructure, so only Standalone-server domains may be created for Oracle Event Processing. A standalone-server domain can later be incorporated into a Multiserver domain, if needed.

Silent Mode


Create the following files in the /temp folder: 
  • install.file
  • oraInst.loc (Linux only)

install.file


Copy and paste the following content in the install.file:

[ENGINE]

 #DO NOT CHANGE THIS.
Response File Version=1.0.0.0.0

 [GENERIC]

 #Set this to true if you wish to skip software updates
DECLINE_AUTO_UPDATES=true

 #The oracle home location. This can be an existing Oracle Home or a new Oracle Home
ORACLE_HOME=C:\\u01\\app\\oracle\\product\\12.1.3\\oep

 #Set this variable value to the Installation Type selected. e.g. Event Processing, Event Processing With Examples.
INSTALL_TYPE=Event Processing With Examples


Set the ORACLE_HOME parameter accordingly to your directories structure.

oraInst.loc


Copy and Paste the following content in the oraInst.loc:


 inventory_loc=/u01/oracle/.inventory
inst_group=oracle


Set inventory_loc (inventory location) and inst_group (installation group) parameters accordingly to your Linux environment.

Run the installer


  1. Open a Command Prompt as Administrator and navigate to the TMP folder

    > cd /temp

  2. Launch the installation program by invoking the following command:

    • Windows

      > java -jar fmw_12.1.3.0.0_oep.jar -silent -responseFile C:\\temp\\install.file

    • Linux

      > java -jar fmw_12.1.3.0.0_oep.jar -silent -responseFile /temp/install.file -invPtrLoc /temp/oraInst.loc

Note: you must use the absolute path for install.file and oraInst.loc.

Configuring an Oracle Event Processing Domain


An Oracle Event Processing standalone-server domain contains a single Oracle Event Processing server. We can create a new domain using the Graphical Mode or in Silent Mode.

Graphical Mode


The Configuration Wizard is an administration tool that enables you to create a new domain or update an existing domain.
By default, the Configuration Wizard creates a standalone-server domain, which can be the starting point for a multi-server domain.
  1. Open the Terminal and navigate to the folder ORACLE_HOME/oep/common/bin 

  2. Launch the Configuration Wizard in graphical mode by invoking the following command:

    • Windows

      > config.cmd

    • Linux

      > ./config.sh

  3. The Configuration Wizard welcome screen should appear.
  1. Click Next.
  1. Choose Create a new OEP domain and click Next.
  1. In the Configure Administrator username and Password screen enter oepadmin into the User name field and welcome1 into the User password and Confirm user password field.
  2. Click Next.
  1. On the Configure Server screen, enter oep_server into the Server name field and 9002 into the Server listen port field.
  2. Click Next.
  1. On the Configure Domain Identity Keystore screen enter welcome1 into the Keystore password field and Confirm keystore password field.
  2. Click Next.
  1. On the Configuration Options screen, accept the defaults and click Next.
  1. On the Create OEP Domain screen, enter oep_domain into the Domain name field and accept the default for the Domain location field.
  2. Click Create to start the domain creation process. The progress is shown on the Creating Domain screen.
  1. Click Done to exit the Configuration Wizard.

Silent Mode


Silent mode is a non-interactive way to create or update a domain and requires an XML properties file for selecting configuration options. 

Create the XML Properties file

  1. Create an XML empty file in the TMP folder. (You can name the file anything you want as long as it has a .xml extension. For this post, the file name is silent.xml). 

  2. Copy the contents of the following sample XML file into the silent.xml file.

    <?xml version="1.0" encoding="UTF-8"?>
    <bea-installer xmlns="http://www.bea.com/plateng/wlevs/config/silent">
      <input-fields>
        <data-value name="CONFIGURATION_OPTION" value="createDomain" />
        <data-value name="USERNAME" value="oepadmin" />
        <data-value name="PASSWORD" value="welcome1" />
        <data-value name="SERVER_NAME" value="oep_server" />
        <data-value name="DOMAIN_NAME" value="oep_domain" />
        <data-value name="DOMAIN_LOCATION" value="/home/oracle/config/12.2.1/oep/domains" />
        <data-value name="NETIO_PORT" value="9002" />
        <data-value name="KEYSTORE_PASSWORD" value="welcome1" /> 
      </input-fields>
    </bea-installer>

  3. In the silent.xml file, edit the values to reflect your configuration.

  4. Save the file

Use the Silent mode and Generate Log


  1. Open a Command Prompt and navigate to the folder ORACLE_HOME/oep/common/bin:

  2. Run the config command to start the wizard in silent mode and generate a log file to catch failures due to incorrect XML property entries:

    • Windows

      >config.cmd -mode=silent -silent_xml=/temp/silent.xml - log=/temp/create_domain.log

    • Linux

      >./config.sh -mode=silent -silent_xml=/temp/silent.xml -log=/temp/create_domain.log
Note: you must use the absolute path for silent.xml and create_domain.log.

Install Stream Explorer



Oracle Stream Explorer (SX) is distributed as an OPatch. We already downloaded and extracted this patch in the /temp folder. This patch needs to be installed on top of Oracle Event Processing 12.1.3 installation. OPatch can be found in your Fusion Middleware's product's ORACLE_HOME/OPatch. OPatch uses the ORACLE_HOME environment variable to identify the Oracle home you are planning to patch.
To install the SX follow the steps below:
  1. Open a terminal windows and navigate to the patch folder TMP/20225179

    > cd /temp/20225179

  2. Set ORACLE_HOME environment variable:

    • Windows

      >set ORACLE_HOME=/u01/app/oracle/product/12.1.3/oep

    • Linux

      >export ORACLE_HOME=/u01/app/oracle/product/12.1.3/oep

  3. Run the OPatch apply command

    • Windows

      >%ORACLE_HOME%/OPatch/opatch apply

    • Linux

      >$ORACLE_HOME/OPatch/opatch apply


 By that Oracle Stream Explorer software has been installed.

Starting OEP server


To start the OEP server do the following:
  1. Open the terminal and navigate to DOMAIN_HOME/oep_domain/oep_server

  2. Run the startwlevs.cmd script

    • Windows

      >startwlevs.cmd

    • Linux

      >./startwlevs.sh

The server is now up and running.

Oracle Event Processing Visualizer is available at  http://host-ip:9002/wlevs.


Oracle Stream Explorer is available at  http://host-ip:9002/sx.


Stop OEP server


To stop the OEP server do the following:
  1. Open the terminal and navigate to DOMAIN_HOME/oep_domain/oep_server

  2. Run the stopwlevs script

    • Windows 

      >stopwlevs.cmd
    • Linux 

      >./stopwlevs.sh

The server is now stopped.

Documentation 


Oracle Event Processing Get Started
Administering Oracle Event Processing
Getting Started with Oracle Stream Explorer
Posted by at
Labels: , , , ,

No comments:

Post a Comment

Subscribe to: Post Comments (Atom)