Deploying Unica Campaign on Tomcat Application Server
You can deploy Unica products on Tomcat application server.
About this task
- 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 insetenv.bat/sh
.set
JAVA_OPTS=%JAVA_OPTS% -DUNICA_PLATFORM_CACHE_ENABLED=true -Dclient.encoding.override=UTF-8
. - When Birt 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.