Deploying Unica Interact on JBoss

You can deploy the Unica Interact application from a WAR file or an EAR file on the JBoss Application Server (JAS).

Add JVM Arguments

About this task

Add the following JVM arguments for Interact RT:
  • --add-opens=java.base/jdk.internal.access=ALL-UNNAMED
  • --add-opens=java.base/jdk.internal.misc=ALL-UNNAMED
  • --add-opens=java.base/sun.nio.ch=ALL-UNNAMED
  • --add-opens=java.base/sun.util.calendar=ALL-UNNAMED
  • --add-opens=java.management/com.sun.jmx.mbeanserver=ALL-UNNAMED
  • --add-opens=jdk.internal.jvmstat/sun.jvmstat.monitor=ALL-UNNAMED
  • --add-opens=java.base/sun.reflect.generics.reflectiveObjects=ALL-UNNAMED
  • --add-opens=jdk.management/com.sun.management.internal=ALL-UNNAMED
  • --add-opens=java.base/java.io=ALL-UNNAMED
  • --add-opens=java.base/java.nio=ALL-UNNAMED
  • --add-opens=java.base/java.net=ALL-UNNAMED
  • --add-opens=java.base/java.util=ALL-UNNAMED
  • --add-opens=java.base/java.util.concurrent=ALL-UNNAMED
  • --add-opens=java.base/java.util.concurrent.locks=ALL-UNNAMED
  • --add-opens=java.base/java.util.concurrent.atomic=ALL-UNNAMED
  • --add-opens=java.base/java.lang=ALL-UNNAMED
  • --add-opens=java.base/java.lang.reflect=ALL-UNNAMED
  • --add-opens=java.base/java.lang.invoke=ALL-UNNAMED
  • --add-opens=java.base/java.math=ALL-UNNAMED
  • --add-opens=java.base/java.time=ALL-UNNAMED
  • --add-opens=java.base/java.text=ALL-UNNAMED
  • --add-opens=java.management/sun.management=ALL-UNNAMED
  • --add-opens=java.sql/java.sql=ALL-UNNAMED
  • --add-opens=java.desktop/java.awt.font=ALL-UNNAMED

Procedure for Deployment

Before you begin

Consider the following points before you deploy Unica Interact on JBoss:
  • Verify that your version of JBoss meets the requirements that are described in the Recommended Software Environments and Minimum System Requirements document, including any necessary fix packs or upgrades.
  • You use the JBoss Integrated Solutions console to configure your JBoss Application Server. The steps that follow provide guidance for setting specific controls.
Note:
Different versions of JBoss Application Server present user interface controls in varying sequences and with alternative labels.

About this task

Complete the following steps to set up the environment for deploying Unica Interact:

Procedure

  1. JVM settings can be added to the standalone.conf script in the JBOSS_EAP_HOME/bin folder.
  2. If you are deploying in a production environment, set the JVM memory heap size parameters to at least 1024 by adding the following line to the standalone.conf script:
    Set MEM_ARGS=-Xms1024m -Xmx1024m -XX:MaxPermSize=256m
  3. Under certain circumstances, deploying older legacy interactive channels or interactive channels with large deployment histories can stress the system and require 2048mb or greater of Campaign design-time and/or Interact runtime Java heap space.
    System administrators can adjust the amount of memory available to the deployment systems via the following JVM parameters:
    -Xms####m -Xmx####m -XX:MaxPermSize=256m
    where the characters #### should be 2048 or higher (depending on their system load.)
    Note: A 64-bit application server and JVM are usually necessary for values greater than 2048. These are the suggested minimum values. Analyze your sizing requirements to determine correct values for your needs.
  4. Go to the JBoss Enterprise Application Platform Admin Console.
  5. Deploy interact.ear /interactRT.war on JBOSS.

Configuring activityOrchastrator feature with JBOSS

To use activityOrchastrator feature please perform following steps.

Procedure

  1. Start JBOSS Standalone service with following command:
    standalone.bat –server-config=standalone-full.xml
    standalone.sh –server-config=standalone-full.xml
  2. Open JBOSS CLI and connect to JBoss server and execute following commands:
    jms-queue add --queue-address=<queue-name> --entries=[java:/jms/<queue-name>]
    <queue-name>: Queue Name (For e.g. test)
  3. Add application server user as well using following command from <JBOSS-HOME>/bin location by using:
    add-user.bat/sh -a -u <username> -p <password> -g guest
    For e.g. uname/pass : jboss/jboss123
  4. Create JDBC connections as mentioned in JBOSS section of “Information for creating JDBC connections" in this guide.
  5. Deploy <path-to-war>/interactRT.war
  6. You needs to add two receiver parameters to configure activityOrchastrator - Username and Password .
    Note - [Username and Password is the credential of JBOSS application server]
  7. Restart the server.