Deploying Unica Plan on JBoss

You must follow a set of guidelines when you deploy Unica Plan on JBoss.

  1. Existing customers who want to upgrade to JBOSS + 12.0, must perform the following steps:
    • Clear the recent items for all the users. Note: Administrator: Please communicate to all the users to clear their respective recent items prior to the migration to JBOSS.
    • Clear the directory <plan_home>/recentdata.
    • Migrate to JBOSS + 12.0.
  2. No change is needed to be done by new customers who are installing JBOSS + 12.0. This is because recent items will not be present in their case.

From the bin directory under your JBoss installation directory, locate and open the standalone.conf or standalone.conf.bat script appropriate for your operating system 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 directory 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.

Make sure that the version of JBoss meets the requirements that are described in the Unica Enterprise Products Recommended Software Environments and Minimum System Requirements document. Use the following guidelines when you deploy Unica Plan on JBoss:

Use the following guidelines when you deploy the Unica Plan products on any supported version of JBoss:

  1. Deploy the HCL plan.war file as an enterprise application.

    For example: deploy <Plan_Install>\plan.war

    See https://docs.jboss.org/jbossweb/3.0.x/deployer-howto.html for instructions on Deploying Web Server Application in JBoss.

  2. Complete the following tasks if your installation must support non-ASCII characters, for example for Portuguese or for locales that require multi-byte characters:
    1. Edit the standalone.conf script in the bin directory under your JBOSS /bin directory to add -Dfile.encoding=UTF-8 -Dclient.encoding.override=UTF-8 to JAVA_VENDOR.
    2. Restart JBoss server.