Oracle Endeca - Deploying the Getting Started application

Wednesday, September 4, 2013

The Getting Started application demonstrates Information Discovery in action, using sales and product data from a fictitious bicycle manufacturer. You can use the Getting Started application to investigate data and discover new insights.

 

Before downloading and installing the Getting Started application, you have to install Oracle Endeca Information Discovery. If you don’t know how, read this blog post: http://www.juvo.be/en/blog/oracle-endeca-information-discovery-30-installation-cookbook.

1. Download the Getting Started application

The Getting Started package consists of a data pipeline processed by Integrator and a LAR file used by Studio.

  1. Sign in to https://edelivery.oracle.com/
  2. Accept the Terms & Restrictions and click Continue.
  3. On the Media Pack Search page:
    • From the Select a Product Pack drop-down list, select Oracle Endeca.
    • From the Platform drop-down list, select Microsoft Windows x64 (64-bit).
    • Click Go.
  4. Click on Oracle Endeca Information Discovery Studio (3.0) Media Pack for Microsoft Windows x64 (64-bit).
  5. Click on the download button next to Oracle Endeca Information Discovery Sample Application (3.0) for Microsoft Windows x64 (64-bit).
  6.  Unzip the file to a folder of your choice.

 

2. Loading the Getting Started data

Make sure the Endeca server and studio are up and running before you continue this guide.
In order to load the Getting Started data into the Endeca server, you have to start up the Integrator.

To start the Integrator:

  1. Choose Start > All Programs > Oracle Endeca Information Discovery 3.0.0 > Integrator.
  2. Click OK to accept the default workspace.
  3. If this is the first time you start up the integrator, a welcome screen will display. Click on Start using Integrator.

To import the project into the Integrator:

  1. Click File > Import to start up the import wizard.
  2. In the next screen, expand the CloverETL folder, select Import external CloverETL projects and click Next.
  3.  In the Imports Projects screen, click Select archive file and browse to the EID_3.0_SamplePipeline.zip file.
  4. Click to finish.

To run the project:

  1. Expand the GettingStarted project in the Navigator (top left pane).
  2. Expand the graph folder
     
  3. Double click on Baseline.grf to open it
     
  4. Click anywhere in the Baseline.grf to give it focus, then click Run.
     The integrator will now create a new Endeca data domain (named GettingStarted) and loads the data and configuration into this domain.
  5. When the execution of the graph is successful, exit the Integrator.
     

3. Deploying the Getting Started application into the Studio

Next, you have to deploy the application into the Studio. Again, make sure that the Studio is up and running before you continue this guide. If you don’t know how, read this guide: http://www.juvo.be/en/blog/oracle-endeca-information-discovery-30-installation-cookbook.

 Log in the to the Studio:

  1. Open a browser and go to http://localhost:8880. The port number may vary according to your installation preferences.
  2. Log in to the Studio using the default username and password: admin@oracle.com/Welcome123. If you already changed the password, use the new password instead. If you haven’t, the application will prompt you to change the password.
     
  3. After this, Studio opens the Discovery Applications page:


First you have to connect to the Getting Started data source that was created when you ran the baseline graph in the Integrator.

To connect to the data source:

  1. In the Studio menu, choose Control Panel. 
     
  2.  In the left pane of the control panel, in the Information Discovery section, choose Data Sources.
  3. Click on Edit in the default data source.
  4. Edit the JSON file in the dialog box to the following:

    { “dataDomainName”: “GettingStarted”, “name”: “GettingStarted”, “port”: “7001”, “server”: “localhost” }
  5. Click on Validate and Save.
  6. Click Back to Home to return to the Discovery Applications Page.

The next step is to create an empty Studio application, into which you can upload the Getting Started project.

Create an empty Studio application:

  1.  On the Discovery Application page, click on New application.
     
  2. As Application name type GettingStarted.
  3. As datasource, choose GettingStarted.
  4. Click on Create Application.

Import the Getting Started project:

  1. From the Studio menu, choose Control Panel.
  2. In the Portal menu, click on Applications.
  3. On the Applications page, for GettingStarted, click on Action and then Manage Pages.
  4.  Click on Export/Import.
  5.  Click on Import.
  6. In the field: Import a LAR file to overwrite the selected data, browse to the GettingStarted LAR file you’ve downloaded.
  7. Accept default settings and click on Import.
  8. Click on Back to Home.
  9. In the Discovery Applications page, click on GettingStarted. The application contains four pages (New Workspace, Sales overview, Resellers and Products).

4. Exploring the Getting Started application

The New Workspace page was generated automatically by the Studio and has a standard Result Table on it.
 

The Sales Overview page provides a dashboard to view and explore overall sales figures.
 

The Resellers page provides details associated with the resellers for the sales transactions and includes a map of the reseller locations.


The Products page allows users to view and explore the sales records in the context of the products that were sold.

 This concludes our guide on how to deploy the Getting Started project into Oracle Endeca Information Discovery. Happy Exploring!

VT/Juvo