Oracle StreamExplorer and Oracle Event Processor - installation instructions to quickly get going SNAGHTMLd9c89f

Oracle StreamExplorer and Oracle Event Processor – installation instructions to quickly get going

This article discusses the installation of Oracle Event Processor 12c on Linux 64bit and the subsequent installation of Stream Explorer on top of OEP 12c. This article assumes Linux 64bit as the operating system. More specifically: it assumes the environment that can be produced following the instructions in my article Quickly produce a Linux 64 bit Ubuntu 14.04 Desktop environment using Vagrant and Puppet – as starting point for Oracle installations – Ubuntu 14.04 64bit plus Desktop and JDK 7U79. Note that other Linux 64bit environments are probably fine (even better maybe as Ubuntu is not officially certified with OEP). Note that in a subsequent article I am going to leverage Vagrant and Puppet to automatically install OEP and Stream Explorer – so as to stamp out VM images for researching OEP and SX without manual actions.

I assume that the Linux environment has a user oracle in a group oracle and a directory (tree) /u01/app/oracle of which user oracle is the owner. This directory is where the ORACLE_HOME will be based.

The following steps are required:

1. Download Software Packages for OEP and SX and JDeveloper

2. Install Oracle Event Processor

3. Install Stream Explorer (as OPatch on top of OEP)

4. Create an OEP Domain

5. Start the OEP Domain and access Stream Explorer in browser

optional: 6. Install JDeveloper and create a connection to OEP domain

 

1. Download Software Packages for OEP and SX and JDeveloper

Go to http://www.oracle.com/technetwork/middleware/complex-event-processing/downloads/index.html, accept the OTN license agreement, and download three files:

  • OEP – ofm_sx_generic_12.1.3.0.0_disk1_1of2.zip
  • Stream Explorer – ofm_sx_generic_12.1.3.0.1_disk1_2of2.zip
  • (optional) JDeveloper – fmw_12.1.3.0.0_soaqs_Disk1_1of1.zip

 

SNAGHTMLd9c89f

If you are using the Virtual Box created with Vagrant as discussed in my previous article, then move these files to the /files directory under the home directory of the Vagrant project (and extract the zip files while you are at it).

image

2. Install Oracle Event Processor

Start a terminal window as user oracle and navigate to the directory that contains the software packages.

image

Run the installer:

java -jar fmw_12.1.3.0.0_oep.jarimage

This will start the installation wizard.

Set the Inventory Directory to /u01/app/oracle/oraInventory. Click OK.

image

image

 

 

image

Set Oracle Home to /u01/app/oracle/OEP_Home:

image

image

image

Ubuntu is not officially certified. However, for development purposes it will do the job. So press Next despite the warning.

Click on Save Response File.

image

Save the response file that we can use at a later stage to automate the installation process using the silent install procedure.

image

Then click on install.

image

image

image

Press Finish. And back at the command line:

image

3. Install Stream Explorer (as OPatch on top of OEP)

Stream Explorer is distributed as a patch on top of Oracle Event Processor 12.1.3, to be installed through the OPatch tool. Extracting file ofm_sx_generic_12.1.3.0.1_disk1_2of2.zip resulted in a folder called 20636710 which contains StreamExplorer as a patch with that PatchId.

Run OPatch to install the patch like this:

  • set the environment variable ORACLE_HOME to /u01/app/oracle/OEP_HOME
  • navigate to the directory 20636710
  • run the opatch tool using $ORACLE_HOME/Opatch/opatch apply

image

 

Opatch is started and analyzes the situation:

image

Then the patch is applied:

clip_image001[5]

 

4. Create an OEP Domain

Before we can start creating Stream Explorer explorations, we need to configure an OEP domain. Configure your OEP domain with script /u01/app/oracle/OEP_Home/oep/common/bin/config.sh.

image

This will start the Configuration Wizard:

image

image

Set password to weblogic1 – or something better

image

set Server Name to defaultserver and port to 9002 (these are the default values)

image

Set password for keystore to weblogic1 – or something better

image

image

Set name of domain to sx_domain – or something you like better:

image

image

image

 

And look what the wizard has created for us:

a directory structure user_projects under OEP_HOME (/u01/app/oracle/OEP_Home)

image

 

 

5. Start the OEP Domain and access Stream Explorer in browser

The OEP Domain is started using the script: $ [OEP_HOME]/user_projects/domains/[domain_name]/defaultserver/startwlevs.sh

In our case this means:

/u01/app/oracle/OEP_Home/user_projects/domains/sx_domain/defaultserver/startwlevs.sh

image

When started, the Stream Explorer can be accessed in the browser at http://localhost:9002/sx :

image

image

The Visualizer can be accessed as well – at http://localhost:9002/wlevs.  It requires Flash to be installed first:

image

The OEP domain can be stopped like this:

(from a new terminal): /u01/app/oracle/OEP_Home/user_projects/domains/sx_domain/defaultserver/stopwlevs.sh

image

 

 

optional: 6. Install JDeveloper and create a connection to OEP domain

JDeveloper – and then the specific JDeveloper edition shipped as part of the SOA Suite 12c quick start installer – provides the IDE for Oracle Event Processor. You do not need JDeveloper for your first steps with Stream Explorer., However, once you get more serious, it is very likely that you will need the JDeveloper IDE as well.

JDeveloper is installed using two jar files extracted from fmw_12.1.3.0.0_soaqs_Disk1_1of1.zip (note: zip file can be downloaded from http://www.oracle.com/technetwork/middleware/complex-event-processing/downloads/index.html and many other places on OTN and eDelivery)

To install, navigate to the directory that contains the two jar files and run:

java -jar fmw_12.1.3.0.0_soa_quickstart.jar

clip_image001[7]

Follow the steps in the installer to install JDeveloper (see for example https://guidoschmutz.wordpress.com/2014/07/06/installing-oracle-soa-suite-12c-quick-start-distribution/ ).

clip_image001[9]clip_image002

Set the Oracle Home for this JDeveloper installation – /u01/app/oracle/JDeveloper_Home

clip_image003clip_image004clip_image005clip_image006

Run JDeveloper

JDEV_HOME/jdeveloper/jdev/bin/jdev

clip_image007clip_image008clip_image009

and create an OEP Connection to the OEP Domain sx_domain.

clip_image011

clip_image012

The OEP Domain can be manipulated from within JDeveloper as well as on the command line.

clip_image014

 

Resources

I have used these resources on the installation of Stream Explorer (and Oracle Event Processor)

Official Oracle Documentation: http://docs.oracle.com/middleware/1213/eventprocessing/SXGSG/GUID-45846CCC-3A27-4033-80C4-E90BE3F9233A.htm#SXGSG128

Patrick Sinke’s article: http://blog.whitehorses.nl/2015/03/13/setting-up-oracle-stream-explorer-12-1-3/

Niall’s take on the installation process: http://niallcblogs.blogspot.nl/2015/03/381-oracle-stream-explorer-installation.html

Guido Schmutz on OEP & SX on Docker containers: https://guidoschmutz.wordpress.com/2015/03/29/installing-oracle-stream-explorer-in-a-docker-image/