Configuring Oracle WebLogic

Topics:

This section describes the pre-requisites and post-requisites for configuring the Oracle WebLogic® Application Server for use with WebFOCUS and ReportCaster. It is assumed that WebLogic components are installed and configured. For additional information, see the WebLogic documentation.

Java Version Requirement

As of WebFOCUS Release 8.2 Version 04, Java Version 8 is the minimum version required. The WebLogic server used to run the WebFOCUS client must be configured to use a release of Java Version 8 that is supported by the WebLogic version being used. Consult the WebLogic server documentation for supported Java releases and how to modify your Java version, if required.

Update Java Settings

Consult the WebLogic server documentation for instructions on where to place the updated settings in your environment.

  • Java 8 minimum memory settings: –Xms1024m –Xmx1024m
  • Classpath: Add the full path and name of the JDBC driver jar files required to access the WebFOCUS Repository database.
  • Temp directory: To avoid potential conflicts, your Java temporary directory should point to a unique location. Create an empty directory on a local filesystem that is writeable to the user that the WebLogic Server is running as, and then set the following Java variable:

    –Djava.io.tmpdir=\fullpath\yourprivatetmpdir

For example, if you are on a Windows system using a standalone WebLogic domain and the startWebLogic.cmd script to start it, you could insert the following into the domain-directory\bin\setDomainEnv.cmd script beginning on the second line:

set USER_MEM_ARGS=”–Xms1024m –Xmx1024m”
set PRE_CLASSPATH=”C:\ibi\derby\lib\derbyclient.jar”
set JAVA_OPTIONS="–Djava.io.tmpdir=C:\yourprivatetmpdir”

WebLogic Post-Installation Step

Prior to deploying the webfocus.war web archive to WebLogic, you must perform the following steps.

  1. Create a file called weblogic.xml in the ..\ibi\WebFOCUS82\webapps\webfocus\WEB-INF directory with the following:
    <?xml version="1.0" encoding="UTF-8"?>
    <wls:weblogic-web-app
    xmlns:wls="http://xmlns.oracle.com/weblogic/weblogic-web-app"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
    http://java.sun.com/xml/ns/javaee/ejb-jar_3_0.xsd
    http://xmlns.oracle.com/weblogic/weblogic-web-app
    http://xmlns.oracle.com/weblogic/weblogic-web-app/1.4/weblogic-web-app.xsd">
    <wls:container-descriptor>
      <wls:prefer-application-packages>
       <wls:package-name>org.bouncycastle.util</wls:package-name> 
       <wls:package-name>org.apache.commons</wls:package-name>
       <wls:package-name>org.opensaml</wls:package-name>
       <wls:package-name>org.eclipse.persistence</wls:package-name>
      </wls:prefer-application-packages>
     </wls:container-descriptor>
    </wls:weblogic-web-app>
  2. Recreate the webfocus.war web archive and call the new archive ibi_apps.war, the following assumes the jar command is in your path and that you want to use /ibi_apps as your WebFOCUS context root:
    1. cd …\ibi\WebFOCUS82\webapps\webfocus
    2. jar cf ..\ibi_apps.war .
  3. Deploy the ibi_apps.war archive in place of the webfocus.war.

WebFOCUS

Feedback