2 Installing Oracle Stream Explorer

This chapter explains in detail how to install Oracle Stream Explorer.

This chapter contains the following sections:

2.1 About OPatch

OPatch is a Java-based utility that runs on all supported operating systems and requires installation of the Oracle Universal Installer. It is used to apply patches to Oracle software.

2.2 Common OPatch Commands When Patching an Oracle Fusion Middleware Oracle Home

The following table shows the most common OPatch commands for patching an Oracle Fusion Middleware Oracle home.


Table 2-1 Common OPatch Commands

Command Description

opatch apply

This command applies an interim patch to an Oracle home from the current directory. The ORACLE_HOME environment variable must be set to the Oracle home to be patched.

opatch napply

This command applies multiple patches.

opatch lsinventory

This command lists the inventory for a particular Oracle home, or displays all installations that can be found. This command does not have any required options.

opatch rollback

This command removes an existing one-off patch from the appropriate Oracle home directory indicated by the reference ID.

opatch nrollback

This command rolls back multiple interim patches at the same time.


2.3 Installing Stream Explorer

Oracle Stream Explorer is distributed as an OPatch. This OPatch 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 (on UNIX operating systems) or ORACLE_HOME\OPatch (on Windows operating systems) directory.

OPatch uses the ORACLE_HOME environment variable to identify the Oracle home you are planning to patch.

2.3.1 Obtain the Installer

You can download the installer either from Oracle Software Delivery Cloud or from Oracle Technology Network.

2.3.1.1 Downloading from Oracle Software Delivery Cloud

You can obtain the OPatch for Oracle Stream Explorer from Oracle Software Delivery Cloud.

To obtain the installer:

  1. Acquire the installer from the following location:

    https://edelivery.oracle.com

  2. Accept the License Agreements and Terms and Conditions.

  3. Select Oracle Fusion Middleware as the product pack.

  4. Select Microsoft Windows (32-bit) as the platform and click Go.

    Figure 2-1 Media Pack Search

    Description of Figure 2-1 follows
    Description of "Figure 2-1 Media Pack Search"
  5. Look for Oracle Fusion Middleware 12c Media Pack from the list of available products and click it.

    Figure 2-2 Oracle Fusion Middleware 12c Media Pack

    Description of Figure 2-2 follows
    Description of "Figure 2-2 Oracle Fusion Middleware 12c Media Pack"
  6. Look for Oracle Stream Explorer and download both the parts of it.

    1. Oracle Stream Explorer 12.1.3.0.1 (Part 1 of 2)

    2. Oracle Stream Explorer 12.1.3.0.1 (Part 2 of 2).

    Figure 2-3 Oracle Stream Explorer

    Description of Figure 2-3 follows
    Description of "Figure 2-3 Oracle Stream Explorer"

2.3.1.2 Downloading from Oracle Technology Network

You can obtain the OPatch for Oracle Stream Explorer from Oracle Software Delivery Cloud.

To obtain the software needed to install Using Oracle Stream Analytics:

  1. Go to Oracle Technology Network Download page at: http://www.oracle.com/technetwork/middleware/complex-event-processing/downloads/downloads-086608.html.

  2. Accept the OTN License Agreement to download the licensed version of Oracle Stream Explorer.

  3. Download the following software to install Oracle Stream Explorer.


    Table 2-2 Oracle Stream Explorer Software

    Software Location File Name Purpose

    Stream Explorer 12.1.3 Runtime

    http://download.oracle.com/otn/nt/middleware/12c/121300/ofm_sx_generic_12.1.3.0.0_disk1_1of2.zip
    

    ofm_sx_generic_12.1.3.0.0_disk1_1of2.zip

    Allows you to quickly install a development or evaluation environment on a single host computer

    Stream Explorer 12.1.3 User Experience

    http://download.oracle.com/otn/nt/middleware/12c/121300/ofm_sx_generic_12.1.3.0.0_disk1_2of2.zip
    

    ofm_sx_generic_12.1.3.0.0_disk1_2of2.zip

    Allows you to quickly update a development or evaluation environment on a single host computer

    SOA Quickstart JDeveloper 12.1.3 Installer

    http://download.oracle.com/otn/nt/middleware/12c/121300/fmw_12.1.3.0.0_soaqs_Disk1_1of1.zip

    fmw_12.1.3.0.0_soaqs_Disk1_1of1.zip

    Allows you to quickly install a development or evaluation environment on a single host computer


2.3.2 Run the Installer

Use the OPatch tool to patch the installer.

To patch:

  1. Unzip the downloaded patch files.
  2. Copy the unzipped OPatch installer content to /opt/patches directory.
  3. Verify that a patch can be applied to a specific Oracle home.
    opatch apply <path_to_patch_directory> -report
    
  4. Update the PATH environment variable with the location of OPatch on you local machine.
  5. Run the OPatch command from the ORACLE_HOME/OPatch directory. A sample code is provided below and you can modify this to suit your needs:
    > cd /opt/patches/<directory where the downloaded OPatch is available>
    > opatch apply
    
    Oracle Interim Patch Installer version 13.2.0.0.0
    Copyright (c) 2013, Oracle Corporation.  All rights reserved.
    
    Oracle Home       : /opt/Oracle/products/fmw12c
    Central Inventory : /opt/Oracle/oraInventory
    from           : /var/opt/Oracle/oraInst.loc
    OPatch version    : 13.2.0.0.0
    OUI version       : 13.2.0.0.0
    Log file location : /opt/Oracle/products/fmw12c/cfgtoollogs/opatch/15941858_Jun_10_2013_12_35_24/apply2013-06-10_12-35-15PM_1.log
    
    OPatch detects the Middleware Home as "/opt/Oracle/products/fmw12c"
    
    Applying interim patch '15941858' to OH '/opt/Oracle/products/fmw12c'
    Verifying environment and performing prerequisite checks...
    All checks passed.
    
    Please shutdown Oracle instances running out of this ORACLE_HOME on the local system.
    (Oracle Home = '/opt/Oracle/products/fmw12c')
    
    Is the local system ready for patching? [y|n] y
    User Responded with: Y
    Backing up files...
    
    Patching component oracle.wls.core.app.server, 12.1.3.0.0...
    
    Verifying the update...
    Patch 15941858 successfully applied
    Log file location: /opt/Oracle/products/fmw12c/cfgtoollogs/opatch/15941858_Jun_10_2013_12_35_24/apply2013-06-10_12-35-15PM_1.log
    
    ---------------------------------------------------------------------
    
    There are no Interim patches installed in this Oracle Home.
    
    ---------------------------------------------------------------------
    
    OPatch succeeded.
    
  6. Restart the Oracle Stream Explorer Event Processing server using the following commands:
    1. Enter ./stopwlevs.sh at the command prompt to stop the Oracle Stream Explorer Event Processing server.
    2. Enter ./startwlevs.sh at the command prompt to start the Oracle Stream Explorer Event Processing server.

2.3.3 Verify the Installation

To verify the installation of Oracle Stream Explorer in an Oracle Fusion Middleware 12c environment:

  1. Start all the servers in all the domains associated with the Oracle home you just patched. Enter ./startwlevs.sh at the command prompt to start the Oracle Stream Explorer server.
  2. Open the WebLogic Server Administration Console for each domain to verify the Administration Server and to view the status of the components in the domain.

2.3.4 Test the Installation

To test the installation and start using the Oracle Stream Explorer application, follow these steps:

  1. Start the Oracle Stream Explorer Event Processing domain.
  2. Enter http://<host>:<port>/sx in the address bar of a browser. For the list of supported browsers, see Browser Support.

    The default URL is: http://<hostname>:9002/sx.

    The installation is successful if you see the Sign In screen for Oracle Stream Explorer.

    Figure 2-4 Oracle Stream Explorer Sign In Page

    Description of Figure 2-4 follows
    Description of "Figure 2-4 Oracle Stream Explorer Sign In Page"

2.4 What Next?

After you have installed Oracle Stream Explorer, you are ready to start using it. For more information about usage of Oracle Stream Explorer, see Introduction to Oracle Stream Analytics in Using Oracle Stream Explorer.