Manually Installing Jamf Pro on Windows
This section provides a basic set of steps for manually installing and configuring Jamf Pro on Windows Server.
The supporting scripts and configuration used for manual installation differ from an installation using the Jamf Pro Installer for Windows. If you do not want to manually install Jamf Pro, you can use the Jamf Pro Installer for Windows. For information about obtaining the installer and installation instructions, see Installing Jamf Pro Using the Installer.
If you are upgrading to Tomcat 8.5, you will need to manually modify the server.xml
file to make it compatible with Tomcat 8.5. For more information, see the Server.xml Changes for Tomcat 8.5 article.
General Requirements
The Jamf Pro web app and the MySQL database can be installed on the same server or different servers. You may want to install the MySQL database on a different server if you have a larger environment that requires more resources. Additional configuration is required to implement this scenario. For more information, see Installing the Jamf Pro Web App and MySQL on Different Servers.
The server used to host Jamf Pro should meet the minimum requirements for operating system, Tomcat version, database configuration, and Java installation. For additional information on these Jamf Pro Server Environment requirements, see the Jamf Pro Release Notes for your version of Jamf Pro.
In addition, the following resources are recommended as the minimum allocation for a typical installation of Jamf Pro:
- Windows
A 64-bit capable Intel processor
8 GB of RAM
150 GB of disk space available
Ports 8443 and 8080 available
In environments where the double-byte character set encoding is required, use English as the system language for the server used to host Jamf Pro to avoid potential display issues.
Full local administrator privileges are required to install Jamf Pro on Windows Server. If you are unable to install Jamf Pro, Group Policy Object restrictions may be the cause. Check the GPO settings or contact someone in your organization who can ensure that GPO restrictions allow you full administrator privileges.
You will need to manually add a firewall exception for port 8443.
- Jamf Pro web app (ROOT.war)—To obtain this item in the Jamf Pro manual installation archive, log in to Jamf Account and navigate to the Products page for Jamf Pro.
- Jamf Pro Server Tools Command-Line Interface (CLI)—Instructions for obtaining this item are provided below.
Each installation of Jamf Pro and its required services is unique, and requirements, such as Jamf Pro web app memory, may vary depending on your implementation. For information about allocating additional memory to the Jamf Pro web app, see Jamf Pro Web App Memory.
If you have questions regarding scaling your environment's resources beyond the typical recommendations, contact Jamf Support.
Step 1: Installing Java and MySQL
Java and MySQL must be installed on the server before you can create the Jamf Pro database and install Jamf Pro. For instructions, see the Installing Java and MySQL for Jamf Pro 10.14.0 or Later article.
Step 2: Installing Tomcat
Apache Tomcat is the web application server that runs Jamf Pro.
Jamf tests each version of Jamf Pro with the corresponding version of Tomcat listed in the Apache Tomcat Versions Installed by the Jamf Pro Installer article. You are highly encouraged to install the version of Tomcat associated with the version of Jamf Pro you are installing.
The following instructions explain how to manually configure Tomcat to use a self-signed SSL certificate on port 8443.
Step 3: Installing the Jamf Pro Server Tools CLI
Jamf highly recommends that you regularly create backups as you work toward a fully configured and operational Jamf Pro. For instructions, see Backing Up the Database.
You can also download the Jamf Pro Server Tools GUI by clicking the following link: https://archive.services.jamfcloud.com/jamf-pro-server-tools/release/latest/gui/server-tools.jar
For more information, see the Jamf Pro Server Tools Overview article.
Step 4: Allocating Additional Memory to Tomcat
You can allocate additional memory to Tomcat by using one of the following methods:
Step 5: Creating the Jamf Pro Database
A MySQL database must be created before you can install Jamf Pro.
You can create the Jamf Pro database using one of the following methods:
- Method 1: Creating the Jamf Pro Database Using the Jamf Pro Server Tools CLI—
Follow the instructions in the Creating the Jamf Pro Database Using the Jamf Pro Server Tools Command-Line Interface article.
- Method 2: Manually Creating the Jamf Pro Database—
Follow the instructions in the Manually Creating the Jamf Pro Database article.
Step 6: Installing Jamf Pro
Step 7: (Optional) Disabling TLS 1.0 and 1.1 in Java 11
If you are using the TLS 1.0 or 1.1 protocols in Java 11 for any existing workflows, it is recommended that you disable them since they are deprecated. For instructions, see the Disabling TLS 1.0 and 1.1 in Java 11 article.
Step 8: Connecting to the Jamf Pro Server
Step 9: Securing Your Jamf Pro Server
Secure your Jamf Pro server by following the recommendations in the Jamf Pro Security Recommendations article.