Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • you have installed Windows or Windows Server.
  • you can login as a user with administration privileges.
  • you have installed Java.
  • you have set the JAVA_HOME or JRE_HOME environment variable.

Step 1  Download and Install Tomcat

  1. Download
    1. To find the latest version, go to the Tomcat downloads page:
    2. for version 8: http://tomcat.apache.org/download-80.cgi
    3. for version 9:   https://tomcat.apache.org/download-90.cgi
    4. Find the latest Binary Distributions section, then the Core sub-heading, and click on 32-bit/64-bit Windows Service Installer.
  2. Install
    1. Run the installer.

    2. When prompted to Choose Install Location, set Destination Folder to a short folder name with no spaces. We recommend: c:/app/tomcat9.

      Warning

      Do not accept the default Destination Folder as this will result in path names that are too long and/or contain spaces. This will prevent the PhixFlow webapp from starting.


    3. Accept all other recommended defaults.
    4. Set the tomcat administrator password to something secure.

Step 2  Configure the service wrapper 
Anchor
service_wrapper
service_wrapper

You must configure the service wrapper before using it to start Tomcat.

...

  • Open Tomcat Properties. If you need further details on how to do this, see: Tomcat start/ stop, open properties
  • Switch to the Java tab.
  • Add these lines to Java Options:

    • Check that the location of the GC (Garbage Collection) log file is correct; in the examples below, this C:\tomcat\logs

Java 8

Excerpt


Code Block
-

...

Djava.awt.headless=true
-XX:+PrintGCDetails
-XX:+PrintGCDateStamps
-Xloggc:C:\tomcat\logs\gc-%t.log


Java 11

Excerpt


Code Block
-Djava.awt.headless=true
-Xlog:gc=debug:file=C:\tomcat\logs\gc-%t.log:time,uptimemillis,tid


  • Add the required memory sizes to Initial Memory Pool and Maximum Memory Pool

...

  • ; see Tomcat Planning for details of estimating Tomcat's memory allocation
  • Switch to the General tab to set the Startup Type. If you want to start/stop Tomcat:
    • manually, set Manual 
    • automatically when Windows starts, set Automatic.

Step 3  Run Tomcat under

...

a service account 
Anchor
run
run

You do not need to run Tomcat under a service account for temporary or ad-hoc systems. In this case you can use the default Local System account.

...

  1. On your server, open Services.
  2. Open the properties for the Apache Tomcat service.
  3. In the Log On tab, enter the service account.

...