Deploying Unica Plan on Apache Tomcat®
You must follow a set of guidelines when you deploy Unica Plan on Apache Tomcat.
Make sure that the version of Apache Tomcat meets the requirements that are described in the Unica Recommended Software Environments and Minimum System Requirements document. Use the following guidelines when you deploy Unica Plan on Apache Tomcat:
-Dplan.home=<Plan_Home>
Where <Plan_Home> is the path to the directory where you installed Unica Plan.
- -Dfile.encoding=UTF-8
- Make sure that the following JVM parameters are present. If not add them:
- For version 12.1.0, 12.1.0.1, 12.1.0.2, and 12.1.0.3, add the following parameters:
-Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector
-Dlog4j2.configurationFile=file:///<Plan_home>\conf\plan_log4j.xml (in case of fresh install of 12.1)
-Dlog4j.configurationFile=file:///<Plan_home>\conf\plan_log4j.xml (in case of fresh install of 12.1)
- For version 12.1.0.4 or later, if you are installing, add the following parameters. If you are
upgrading from version 12.1.0 or later, remove the parameters mentioned earlier, and add the following parameters:
-Dlog4j.configuration=file:///<Plan_home>\conf\plan_log4j_1x.xml
-Dplan.log4j.config=<Plan_home>\conf\plan_log4j.xml
-Dplan.log4j.async=true (If not set, deafults to true)
Note:- For version 12.1.0, 12.1.0.1, 12.1.0.2, and 12.1.0.3, if you have customized the
plan_log4j.xml
and made some changes to suit your organization, then ensure that you make those settings in theplan_log4j.xml
specified here as per the-Dlog4j2.configurationFile
and the -Dlog4j.configurationFile that has been deployed. - For version 12.1.0.4 or later, if you have customized the
plan_log4j.xml
and made some changes to suit your organization, then ensure that you make those settings in theplan_log4j.xml
specified here as per the-Dplan.log4j.config
file that has been deployed. - In Windows, the file path contains a back slash. Whereas, in UNIX, it must contain a forward slash.
- The path separator in the log4j configuration file name should be set as Windows style() or UNIX (/ ) style based on the underlying operating system.
- Ensure that the parameter
relaxQueryChars
is present in the connector tag inconf/server.xml
in tomcat<Connector port="7002" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" relaxedQueryChars="|,[,],\,`,{,},^" />
- For version 12.1.0, 12.1.0.1, 12.1.0.2, and 12.1.0.3, add the following parameters:
- In the <Plan_home>/conf/ location, the 12.1.2
installer creates a back up of the existing files:
File name before backup File name after backup plan_log4j.xml plan_log4j.xml_pre_12.1.2 plan_log4j_client.xml plan_log4j_client.xml_pre_12.1.2 plan_log4j_socket_server.xml plan_log4j_socket_server.xml_pre_12.1.2 If the backed up files contain custom settings, you must ensure that the custom settings are copied to the newly added configuration files by the 12.1.2 installer.
- Deploy the HCL plan.war file as an enterprise application on Tomcat Apache
server.Note: Deployment of HCL EAR file is not supported in Tomcat.
- Complete the following tasks if your installation must support non-ASCII characters, for example
for Portuguese or for locales that require multi-byte characters:
- Edit the setenv.sh file for the respective product instances script in the bin directory under
your tomcat instances directory to add -
Dfile.encoding=UTF-8 -Dclient.encoding.override=UTF-8 to JAVA_VENDOR
. - Restart Tomcat.
- Edit the setenv.sh file for the respective product instances script in the bin directory under
your tomcat instances directory to add -
- If deploying in a production environment, you can add JVM heap setting for that tomcat instance in app-one/bin/setenv.sh file respectively for all the instances.