Versions Compared

Key

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

Introduction

Apache Tomcat is the java Java web server which that runs the PhixFlow web application. This guide covers downloading and installing Tomcat 9 This page explains how to install Tomcat on Windows and Windows Server.

Prerequisites

You The following instructions assume that:

  • you have installed Windows

...

  • or Windows Server.

...

  • you can login as a user with

...

  • administration privileges.

...

  • you have installed Java.

Instructions

Step 1  Download and Install Tomcat

  1. Download
    1. To find the latest version

...

    1. , go to the

...

    1. Tomcat downloads page: https://tomcat.apache.org/download-90.cgi
    2. Find the latest Binary Distributions section, then the Core sub-heading, and click on 32-bit/64-bit Windows Service Installer.
  1. 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

...

Instead, choose a short folder name e.g.

c:/app/tomcat9

...

    1. . This will prevent the PhixFlow webapp from starting.


    2. Accept all other recommended defaults.

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:

Click Configure Tomcat

Java Tab

Tomcat.

...

  • 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
-verbose:gc
-Djava.awt.headless=true
-XX:+PrintGCDetails
-XX:+PrintGCDateStamps
-Xloggc:C:\tomcat\logs\gc-%t.log


Java 11

...

Excerpt


Code Block
-Djava.awt.headless=true

Memory


-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

Startup Type

...

  • 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 may wish do not need to run tomcat Tomcat under a service account . This is advisable for long running installations. But note that this is not strictly nessary; for temporary or ad-hoc systems. In this case you can use the default Local System account.

To ensure Tomcat remains running for long periods, running tomcat with the default option - under Local System account - is generally fine. 

To do this:

...

we recommend running it under a service account. 

  1. On your server, open Services.
  2. Open the properties for the Apache Tomcat service

...

  1. .
  2. In the Log On tab, enter the service account.

Conclusion

From this point on, you can use Monitor Tomcat to start /or stop tomcatTomcat.