In this section:

SSL

All DTP REST APIs, as well as the API Documentation, communicate over SSL. An SSL port is configured in new DTP installations by default, but if you are migrating from Concerto (prior to version 4.9.4) you must configure the SSL manually. See Enabling SSL for instructions. If you are currently running Concerto 4.9.4, you should already have configured the SSL.

DTP Enterprise Pack Settings

DTP and DTP Enterprise Pack must use the same protocol (either HTTP or HTTPS). See Enabling SSL for additional information.

Tomcat Server

DTP ships with and runs on Tomcat. You should only have one instance of Tomcat running on the same machine to avoid conflicts related to port configuration.

If multiple Tomcat configurations are necessary in your infrastructure, you can edit the <DTP_HOME>/tomcat/conf/server.xml file to ensure that servers run on different ports. For example, you may run a Tomcat shutdown on port 8005, and another on port 18005.

The maxHttpHeaderSize attribute for the Tomcat connector is set to 16384 (16 KB).

Configuring Tomcat to Log User Information with DTP Requests and Responses

If you are upgrading from DTP 2022.2 or earlier, you can configure Tomcat to log user information along with each request and response. This is necessary for some users to be in compliance with certain regulations. This is unnecessary for new installs of DTP 2023.1 or later.

To configure Tomcat to log this information from DTP, you need to modify the server.xml file located in <DTP_INSTALL>/tomcat/conf/ by changing the default access log valve entry from:

<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs" prefix="PST_access_log" suffix=".txt" pattern="%h %l %u %t "%r" %s %b" />

to:

<Valve className="com.parasoft.pst.core.tomcat.DTPAccessLogValve" directory="logs" prefix="PST_access_log" suffix=".txt" pattern="%t %s %m %U %H %u %S %A:%{local}p %a:%{remote}p %F %{X-Forwarded-For}i %{User-Agent}i %{Referer}i %I" />

Standard Tomcat access log parameters are supported.  See https://tomcat.apache.org/tomcat-9.0-doc/config/valve.html#Access_Logging for more information.

  • No labels