Deploying Campaign on Tomcat Application Server

You can deploy HCL® Marketing Software products on Tomcat application server.

About this task

Use the following guidelines when you deploy Campaign on Tomcat:
  • HCL Marketing Software products customize the JVM used by Tomcat. You might need to create a Tomcat instance that is dedicated to HCL Marketing Software 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"

  • You must add Platform and Campaign Data Source in Campaign.xml along with the path of Campaign.war to the Campaign Tomcat instance eg. :
    
    <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.