Deploying License Server to a Custom Tomcat Server

Parasoft License Server has been tested and certified on Java 11. Your custom Tomcat server must be running on Java 11 when deploying Parasoft License Server to it. The steps below assume that your Tomcat server has been configured to support HTTPS on port 8443.

To deploy License Server to a custom Tomcat server, follow the steps below. Make sure you deploy License Server using a user account that has read/write permissions to the <TOMCAT> folder.

1. Extract the contents of the distribution archive and copy the licenseserver.war and pstsec.war files into your <TOMCAT>/webapps directory. The applications will be deployed when Tomcat starts.
2. Log into License Server at https://<HOST>:8443/licenseserver using the default username and password (admin/admin). We recommend changing the default after logging in.
3. Log into User Administration at https://<HOST>:8443/pstsec using the default username and password (admin/admin). We recommend changing the default after logging in.

In some cases, the default value for the maxHttpHeaderSize attribute for the Tomcat connector is insufficient. It is recommended that maxHttpHeaderSize be set to at least 16384 (16 KB).

Configuring Tomcat to Log User Information with Requests and Responses

If you are upgrading from License Server 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 License Server 2023.1 or later.

To configure Tomcat to log this information from License Server, you need to:

1. Add com.parasoft.pst.core.tomcat-<VERSION>.jar (distributed with License Server) to your <TOMCAT>/lib directory.

2. Edit the server.xml file located in the <TOMCAT>/conf/ directory by finding the default access log valve entry:

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

   And appending the following example as a new entry:

   <Valve className="com.parasoft.pst.core.tomcat.DTPAccessLogValve" prefix="ls_user_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.

These logs can be found in the ls_user_access_log<DATE>.txt file located in the <TOMCAT>/logs/ directory.