Deploying Unica Collaborate on Tomcat Application Server

You can deploy HCL Unica products on Tomcat application server.

About this task

Use the following guidelines when you deploy Unica Collaborate 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 Collaborate.war is deployed.
Add relaxedQueryChars under Collaborate server.xml as mentioned below.
```
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443"
relaxedQueryChars="|,[,],\,`,{,},^" />
```

You must add Unica Platform and Unica Collaborate data source in Collaborate.xml along with the path of Collaborate.war to the Unica Collaborate 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.