Deploying Unica Plan on WebLogic

Use the following guidelines for deploying Unica Plan on WebLogic.

About this task

  • Unica products customize the JVM used by WebLogic. You might create a WebLogic instance dedicated to Unica products if you encounter JVM-related errors.
  • Do not install more than one Unica Plan application under the same WebLogic domain.
  • Verify that the Software Developement Kit (SDK) selected for the WebLogic domain you are using is the Sun SDK by looking in the startup script (startWebLogic.cmd) for the JAVA_VENDOR variable. It should be set to JAVA_VENDOR=Sun. If it is set to JAVA_VENDOR=BEA, JRockit has been selected. JRockit is not supported. To change the selected SDK, refer to the WebLogic documentation.

Complete the following steps to deploy Unica Plan to WebLogic:

Procedure

  1. If your operating system is AIX®, extract the Unica Plan WAR file, delete the xercesImpl.jar file from WEB_INF/lib directory, and recreate the WAR file.
    If the installer combined products in an EAR file, you must first extract that file to obtain the WAR file, and you must recreate the EAR file.
  2. If you are configuring WebLogic to use the IIS plug-in, review the WebLogic documentation to determine whether you have additional requirements.
  3. From the bin directory under your WebLogic domain directory, locate and open the setDomainEnv script in a text editor. Scroll to the JAVA_OPTIONS property, and add the following entries. Use a space to separate entries.

    • -Dplan.home=<HCL_Unica_Home>\<Plan_Home>

      Where <HCL_Unica_Home> is the path to the top-level irectory and <Plan_Home> is the path to the directory where you installed Unica Plan. Typically this directory is HCL_Unica/Plan.

    • -Dfile.encoding=UTF-8
    • Make sure that the following JVM parameters are present. If not add them:
      • -Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector
      • -Dlog4j2.configurationFile=file:///<Plan_home>\conf\plan_log4j.xml (in case of fresh install of 12.0) or file:///<Plan_home>\conf\plan_log4j_11.1.0.0.xml (if present)
      • -Dlog4j.configurationFile=file:///<Plan_home>\conf\plan_log4j.xml (in case of fresh install of 12.0) or file:///<Plan_home>\conf\plan_log4j_11.1.0.0.xml (if present)
      • -Dlog4j.configuration=file:/// <Plan_home>\conf\plan_log4j_1x.xml
      Note:
      • See the log4j2 documentation for details by referring to the link: https://logging.apache.org/log4j/2.0/manual/configuration.html
      • In Windows, the file path contains a back slash. Whereas, in UNIX, it must contain a forward slash.
      • The path separator in the log4j configuration file name should be set as Windows style() or UNIX (/ ) style based on the underlying operating system.
      Note:
      • In Windows, the file path contains a back slash. Whereas, in UNIX, it must contain a forward slash.
      • The path separator in the log4j configuration file name should be set as Windows style() or UNIX (/ ) style based on the underlying operating system.
  4. Save and close the file.
  5. Restart WebLogic.
  6. Deploy Unica Plan as a web application module: select plan.war.
  7. Start the deployed web application.