Deploying Unica Campaign on Tomcat Application Server

You can deploy Unica products on Tomcat application server.

About this task

Use the following guidelines when you deploy Unica Campaign on Tomcat:
  • HCL Unica products customize the JVM used by Tomcat. You may require to create a Tomcat instance that is dedicated to HCL Unica products if you encounter JVM-related errors
  • 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 setenv.bat/sh e.g : set CATALINA_OPTS=%CATALINA_OPTS% -Xms1024m -Xmx1024m -XX:MaxPermSize=512m.

    These are the suggested minimum values. Analyze your sizing requirements to determine correct values for your needs. Depending upon system load -Xmx value should be adjusted. Note that a 64-bit application server and JVM are usually necessary for values greater than 2048.

  • Modify the JAVA_OPTIONS parameter to add the following value in setenv.bat/sh.

    set JAVA_OPTS=%JAVA_OPTS% -DUNICA_PLATFORM_CACHE_ENABLED=true -Dclient.encoding.override=UTF-8.

  • When Unica Insights war is deployed on Tomcat, complete the following configuration in server.xml, where Campaign.war is deployed.
    Add relaxedQueryChars under Campaign server.xml as mentioned below.
    <Connector port="8080" protocol="HTTP/1.1"
    connectionTimeout="20000"
    redirectPort="8443"
    relaxedQueryChars="|,[,],\,`,{,},^" />
  • You must add Unica Platform and Unica Campaign data source in Campaign.xml along with the path of Campaign.war to the Unica Campaign Tomcat instance. For example:
    
    <Context docBase="<Campaign_Install_Path>/Campaign/Campaign.war">
    <Resource name="<UnicaPlatformDS>" factory="com.unica.manager.tomcat.utils.TomcatDSFactory" auth="Application" type="javax.sql.DataSource"
    maxActive="30" maxIdle="10" maxWait="10000"
    username="<db user for Platform schema>" password="<db password>" driverClassName=
    "<db specific class name>" url="<db specific jdbc url>"/>
    
    <Resource name="<campaignPartition1DS>" factory="com.unica.manager.tomcat.utils.TomcatDSFactory" auth="Application" type="javax.sql.DataSource"
    maxActive="30" maxIdle="10" maxWait="10000"
    username="<db user for Campaign schema>" password="<db password>" driverClassName=
    "<db specific class name>" url="<db specific jdbc url> </Context>"/>
    
    
    Note: {{You can encrypt DB password using }} encryptTomcatDBPasswords utility located in <Platform_Home>/tools/bin
  • Restart the Tomcat application server.
    Note:

    Unica products are installed on an AWS ELB with Nginx individual products tomcat instances. AWS ELB is HTTPS and nginx is on http and all products are also on http. This causes issue on campaign settings and campaign pages in Chrome browser. To avoid this problem user must configure Tomcat for SSL offloading and add below parameter:

    scheme="https" secure="true" in the <Connector> element in the server.xml file.

    URL for reference : https://backstage.forgerock.com/knowledge/kb/article/a37878699

    Tomcat Parameters for Flowchart crash

    Please include below parameters in the instance_name/conf/server.xml file.
    • maxHttpHeaderSize="209715200"
    • maxPostSize="-1"