Image Removed

Image Added

📙 You will learn

How to install and configure ThreadFix on Windows.  While currently ThreadFix supports Windows 2012 R2 and newer, these instructions were developed and tested against Windows Server 2016.

Prerequisites

Audience: IT Professional and/or End User
Difficulty: Intermediate
Time needed: Approximately 60 minutes
Tools required: OpenJDK 11 or OpenJDK 8 or Oracle Java 8, at least Tomcat 7.0.59, MySQL or Microsoft SQL Server

Install Java

OpenJDK 11

ThreadFix version 2.7.9 and newer can run on OpenJDK 11 (or Oracle Java 8 / OpenJDK 8, shown in the sections below).

1. Download the 'x86 64-bit' version of the JRE zip file here (e.g., zulu11.35.15-ca-jre11.0.5-win_x64.zip).

2. Extract the zip file to a desired location (e.g., C:\openjdk11).

3. Create a new System variable called JAVA_HOME and for the value, enter the path above, where you extracted the zip file.

4. Edit your Path System variable... add %JAVA_HOME%\bin to the end.

5. Verify the default version of Java by running the following in a Command Prompt: java -version

OpenJDK 8

ThreadFix version 2.7 and newer can run on OpenJDK 8 (or Oracle Java 8, shown in the next section).

1. Download the 'x86 64-bit' version of the JRE zip file here (e.g., zulu8.42.0.23-ca-jre8.0.232-win_x64.zip).

2. Extract the zip file to a desired location (e.g., C:\openjdk8).

3. Create a new System variable called JAVA_HOME and for the value, enter the path above, where you extracted the zip file.

4. Edit your Path System variable... add %JAVA_HOME%\bin to the end.

5. Verify the default version of Java by running the following in a Command Prompt: java -version

Oracle Java 8

ThreadFix version 2.6.2 and older requires Oracle Java 8 JRE (version 1.8.0_162 or higher).

1. Download the latest version of the Java 8 JRE installer here.

2. Click the Windows x64 installer to download (e.g., jre-8u202-windows-x64.exe).

3. Run the executable once it downloads and accept defaults.

4. Create a new System variable called JAVA_HOME and for the value, enter your JRE install path (e.g., C:\Program Files\Java\jre1.8.0_202).

5. Edit your Path System variable... add %JAVA_HOME%\bin to the end.

6. Verify the default version of Java by running the following in a Command Prompt: java -version 
   

Install and Configure Tomcat 8

Download and Install

ThreadFix requires at least Tomcat 7.0.59, but we recommend the latest version of Tomcat 8.5.

1. Download the latest version of Tomcat 8.5 here.

2. Scroll down to the 8.5.x versions, and download 32-bit/64-bit Windows Service Installer under the Core link.

3. Run the installer and accept all defaults except at the end: disable the checkbox to run Tomcat when clicking Finish.

Web.xml Update

For compatibility with Tomcat 8.5.43 and newer, make the following update:

Open the <tomcat-deploy>\conf\web.xml file in a text editor (run as Administrator) and edit the default servlet as follows:

• OLD

<servlet>
    <servlet-name>default</servlet-name>
    <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
    <init-param>
        <param-name>debug</param-name>
        <param-value>0</param-value>
    </init-param>
    <init-param>
        <param-name>listings</param-name>
        <param-value>false</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>

• NEW

<servlet>
    <servlet-name>default</servlet-name>
    <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
    <init-param>
        <param-name>debug</param-name>
        <param-value>0</param-value>
    </init-param>
    <init-param>
        <param-name>listings</param-name>
        <param-value>false</param-value>
    </init-param>
    <init-param>
        <param-name>fileEncoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>

(Note that the above adds the fileEncoding parameter and sets its value to UTF-8.)

Configuration

1. Launch the Configure Tomcat application.

2. Select the Log On tab and change the default service logon to Local System account, if not already set (it may default to Local Service account instead). If you need to use a domain user instead, e.g., for Windows Authentication access to MS SQL Server, click Windows SQL Server Configuration for instructions.
   

   

3. Select the Java tab and update the following (see screenshot below):

   • Java Virtual Machine: %JAVA_HOME%\bin\server\jvm.dll

   • Java Options: -XX:+UseG1GC

   • Initial Memory Pool: 2048

   • Maximum Memory Pool: 8192 (or higher if wanting to allocate more memory)
     

     

4. Click Apply. Go back to the General tab and ensure the Service Status is Stopped; if not, click the Stop button.

5. Once the process stops, you may move on to database setup.

SSL/TLS Implementation

For information on configuring Tomcat to run over SSL/TLS, refer to the following article.

Install and Configure the Database

• To install and configure MySQL, refer to the following page: Windows MySQL Installation and Configuration.

• To install and configure Microsoft SQL Server, refer to the following page: Windows SQL Server Configuration

Install ThreadFix

• To install and configure ThreadFix, refer to the following page: ThreadFix Installation.

Related articles

📄 CentOS Enterprise Setup

📄 Ubuntu Enterprise Setup

📄 Mac OS Enterprise Setup

📄 ThreadFix Installation