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

 

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

2. Install Oracle Event Processor

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

Run the installer:

java -jar fmw_12.1.3.0.0_oep.jar

This will start the installation wizard.

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

 

 

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

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.

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

Then click on install.

Press Finish. And back at the command line:

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

 

Opatch is started and analyzes the situation:

Then the patch is applied:

 

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.

This will start the Configuration Wizard:

Set password to weblogic1 – or something better

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

Set password for keystore to weblogic1 – or something better

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

 

And look what the wizard has created for us:

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

 

 

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

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

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

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

 

 

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

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/ ).

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

Run JDeveloper

JDEV_HOME/jdeveloper/jdev/bin/jdev

and create an OEP Connection to the OEP Domain sx_domain.

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

 

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/