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
  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.

What to do next

WebLogic 12.2.1.3 blocks a few HTTP methods, for example DELETE and PATCH, which are used by REST API for the newly added Enhanced workflow. To resolve this issue, apply a WebLogic patch (if it is not applied).

For details about the patch, access https://support.oracle.com/knowledge/Middleware/2331453_1.html. You need to be a registered user to access the link. After sucessful authentication, search for the patch number 26923558.

Note: The information provided about the patch belongs to a third-party website. HCL Unica will not be responsible if the information is inaccurate.