Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
📙 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).
OpenJDK 11Download the 'x86 64-bit' version of the JRE zip file here (e.g.,
zulu11.35.15-ca-jre11.0.5-win_x64.zip
).Extract the zip file to a desired location (e.g.,
C:\openjdk11
).Create a new System variable called JAVA_HOME and for the value, enter the path above, where you extracted the zip file.
Edit your Path System variable... add
%JAVA_HOME%\bin
to the end.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).
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
).Extract the zip file to a desired location (e.g.,
C:\openjdk8
).Create a new System variable called JAVA_HOME and for the value, enter the path above, where you extracted the zip file.
Edit your Path System variable... add
%JAVA_HOME%\bin
to the end.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).
Download the latest version of the Java 8 JRE installer here.
Click the Windows x64 installer to download (e.g.,
jre-8u202-windows-x64.exe
).Run the executable once it downloads and accept defaults.
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
).Edit your Path System variable... add
%JAVA_HOME%\bin
to the end.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.
Note |
---|
In order to provide enough memory to the Java process, it is important that the 64-bit versions of both Java and Tomcat are used. |
Download the latest version of Tomcat 8.5 here.
Scroll down to the 8.5.x versions, and download 32-bit/64-bit Windows Service Installer under the Core link.
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
Code Block |
---|
<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
Code Block |
---|
<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
Launch the Configure Tomcat application.
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.
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)
Click Apply. Go back to the General tab and ensure the Service Status is Stopped; if not, click the Stop button.
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
Table of content
Table of Contents | ||
---|---|---|
|
https://threadfix.it/ | www.denimgroup.com
© Copyright 2020 Denim Group, LTD. All Rights Reserved.