OEID 3.0 WebLogic Installation Steps

Here are the complete steps to installing OEID 3.0 on Windows.  This uses the weblogic release of Studio.  This doesn’t include some optional more advanced features like SSL or clustering.

Prerequisites:

  1. Java Environment
    1. JRockit JDK (version 1.6)
      1. Change the default folder to:  C:\Java\
    2. Install Public JRE:
      1. Change the default folder to: C:\Java\
  2. WebLogic Server
    1. (version 10.3.6, generic version)
    2. Open up a command prompt (Run as Administrator)
    3. Browse to the source folder & run:
      1. java –jar wls1036_generic.jar
    4. Set the Middleware home directory:
      1. C:\Oracle\Middleware
    5. Unchecking the option to receive security updates isn’t handled correctly, they’re optional but if you don’t want to bother with them just keep continuing to get past these windows. 
    6. Select Custom installation, in the next window select ONLY the following:
      1. Core Application Server
      2. Administration Console
      3. Configuration Wizard and Upgrade Framework
    7. In the JDK Selection window browse to the root of the JRockit folder:
      1. C:\Java\jrocki-jdk1.6.0_37-R28.2.5-4.1.0
        1. Note: install it wherever you like, I found it easier to avoid spaces in the name when running some later commands.
      2. Use the default location for the installation directory:
        1. C:\Oracle\Middleware\wlserver_10.3
      3. Optionally install the node manager service; this will install weblogic as a windows service.
    8. Application Development Runtime Environment (version 11.1.1.6)
      1. Open up a command prompt (Run as Administrator)
      2. Browse to the source folder (Disk1) & run:
        1. setup –jreLoc C:\Java\jrockit-jre1.6.0_37-R28.2.5
      3. Optionally, Skip software updates
      4. Accept all the defaults and install.

Oracle Endeca Server

  1. Version 7.5.1
  2. Open up a command prompt (Run as Administrator)
  3. Browse to the source folder (Disk1) & run:
    1. setup –jreLoc C:\Java\jrockit-jre1.6.0_37-R28.2.5
  4. Optionally, deselect the deployment in a secure mode.
  5. Create the WebLogic domain
    1. Open up a command prompt (Run as Administrator)
    2. Browse to the source folder:
      1. C:\Oracle\Middleware\wlserver_10.3\common\bin
    3. Run:
      1. config.cmd
    4. Select the option to “Create a new WebLogic domain”
    5. Check these two options:
      1. Oracle Endeca Server
      2. Oracle JRF (will be automatically selected)
    6. Specify the domain name:  base_domain  (default)
    7. Leave the default domain location folder
      1. C:\Oracle\Middleware\user_projects\domains
    8. Configure the admin credentials (as desired):
      1. Name:  weblogic
      2. Password:  4weblogic
    9. Startup mode:  Development Mode
      1. JRockit SDK should already be selected
    10. Select Administration Server and confirm the following settings:
      1. Name:  AdminServer
      2. Listen Address:  All Local Addresses
      3. Listen port:  7001
      4. SSL listen port:  N/A (grayed out)
      5. SSL enabled:  (not checked)
    11. Click Next and then “Create”
    12. Check the option to “Start Admin Server”
      1. Note:  this may take a while
      2. Note:  admin logs will go to the file:
        1. C:\Oracle\Middleware\user_projects\domains\base_domain\servers\AdminServer\logs\AdminServer.log
  6. Verify the Endeca Server deployment:
    1. Open up a browser:
      1. http://localhost:7001/console
    2. You may get a message “This application is deployed on the first access”.  Wait a bit for the login box to appear.
      1. Username:  weblogic
      2. Password: 4weblogic
    3. Click “deployments”
      1. In the table look for “oracle.endecaserver”  (2nd page)
      2. It should be “Active” and “OK”
    4. Check the OES service is up & running
      1. Open up a command prompt (Run as Administrator)
      2. Browse to the source folder:
        1. C:\Oracle\Middleware\EndecaServer7.5.1_1\endeca-server\endeca-cmd\
      3. Run:
        1. endeca-cmd create-dd SomeDataStoreName
      4. This should create the data domain for “SomeDataStoreName
      5. Run the following to confirm its state “Is Available”:
        1. endeca-cmd get-dd-health SomeDataStoreName

Integrator

  1. Double click the file EID_3.0_Integrator
  2. Once completed open up to confirm it works.

Studio

  1. Create a second domain to host Studio
    1. Open up a command prompt (Run as Administrator)
    2. Browse to the source folder:
      1. C:\Oracle\Middleware\wlserver_10.3\common\bin
    3. Run:
      1. config.cmd
    4. Select the option to “Create a new WebLogic domain”
      1. Leave the default option selected (Basic WebLogic Server Domain)
    5. Specify the domain name:  studio_domain
    6. Leave the default domain location folder
      1. C:\Oracle\Middleware\user_projects\domains
    7. Configure the admin credentials:
      1. Name:  endeca
      2. Password:  4endeca
    8. Startup mode for now:  Development Mode
      1. JRockit SDK should already be selected
    9. Select Administration Server to update the settings:
      1. Name:  AdminServer
      2. Listen Address:  All Local Addresses
      3. Listen port:  8080
      4. SSL listen port:  N/A (grayed out)
      5. SSL enabled:  (not checked)
    10. Click Next and then “Create”.
    11. When Done select “Start Admin Server”
    12. As before, verify the installation by opening a browser:
      1. http://localhost:8080/console
  2. Install Studio
    1. First stop Oracle Server.
      1. C:\Oracle\Middleware\user_projects\domains\studio_domain\bin\stopWebLogic.cmd
    2. Find and update the file setDomainEnv.cmd:
    3. Note:  the documentation defines the following step, I did not apply this step since the path was not valid for my Java environment. Any impact from skipping this step hasn’t made itself apparent yet, stay tuned I guess! 
    4. Add the following variable:
      1. set JAVA_OPTIONS=-Djavax.xml.transform.TransformerFactory=com.sun.org.apache.xalan.internal.xsltc.trax.TransformerFactoryImpl-Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl-Djavax.xml.parsers.SAXParserFactory=com.sun.org.apache.xerces.internal.jaxp.SAXParserFactoryImpl
    5. Set the max perm size settings to:
      1. –XX:MaxPermSize=512m
    6. Set the memory argument settings to:
      1. –Xms256m –Xmx1024m
    7. Create these folders:
      1. ..\user_projects\domains\studio_domain\data\endeca-data-sources\
      2. ..\user_projects\domains\studio_domain\deploy\
      3. ..\user_projects\domains\studio_domain\weblogic-deploy\
    8. Restart WebLogic:
      1. ..\user_domains\studio_domain\startWebLogic.cmd
    9. Copy the file “portal-ext.properties” from the source directory for “Studio (Weblogic)” to:
      1. ..\user_projects\domains\studio_domain\
    10. Log on to http://localhost:8080/console
      1. From the Home screen, select “Configure Applications”
      2. Click “Install”
      3. Browse to the *.ear file to upload it.
      4. Install it as an application (Default)
      5. Optionally, change the name to “oeid_studio”
      6. Optionally, change the source files to be copied to every target
      7. Click “Finish”

GettingStarted

  1. Integrator Project
    1. Extract the source files for the EID_3.0_SamplePipeline.zip to your workspace
    2. From the Start Menu open up Integrator
    3. Identify your workspace
    4. From File, select Import, then CloverETL..Import external CloverETL project
    5. Browse to the directory containing the folder “GettingStarted”
    6. Make sure the project has a checkbox and import the project.
    7. In the navigator pane find and open up the graph “Baseline.grf”
    8. Execute the graph & confirm it completed successfully.
  2. Studio Project
    1. Be sure you’ve started both WebLogic domains (base_domain & studio_domain)
    2. In a browser open up:  http://localhost:8080
    3. Login in as admin@oracle.com
      1. Default password:  Welcome123
      2. New password: 4endeca
    4. Access the Control Panel
    5. Optionally, add a new user
      1. screename:  test
      2. email:  test@oracle.com
      3. first name: Test
      4. last name: User
      5. password: 4endeca
    6. Create a new data source:install_1
    7. Return to the home page and create a “New Application”
      1. Specify the name:  GettingStarted
      2. Specify the data source:  GettingStarted
    8. Open up the application and confirm the default page displays content
    9. Access the Control Panel and select “Applications”
    10. To the right of “Getting Started” click the “Actions” link and select “Manage Pages”
    11. Go to “Import” and browse to the location of the file “EID_3.0_SampleApp.lar”
    12. Select all the default options and click “Import”
    13. Click “Back to Getting Started” and verify all the components function correctly.

And with that you should have a complete functional install of OEID on WebLogic.  Enjoy!

Advertisements
This entry was posted in Endeca and tagged , , , , , , , . Bookmark the permalink.

Leave a Reply

Please log in using one of these methods to post your comment:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s