Installing Multi-Context Jamf Pro Web Applications on a Windows Server

Jamf Pro Installation and Configuration Guide for Windows 11.16.0

Solution

Application

Content Type

Technical Documentation

Utilities & Services

version

11.16.0

ft:locale

en-US

vrm_version

11.16.0

The following instructions describe how to install multiple Jamf Pro web applications (i.e., "contexts") on a Windows server.

Note:

For reference, you may find the installation instructions for a single Jamf Pro context helpful. For more information, see Manually Installing Jamf Pro on Windows.

On the Windows server, prepare the ROOT.war file to be installed as a unique Tomcat context:
1. If needed, copy the ROOT.war file to the Windows Desktop.
2. Give the file a unique name formatted as follows:
```
context.war
```
  Best Practice:
  Add Multiple .war Files Individually
  The best practice is to put .war files in the Tomcat webapps directory one at a time, waiting for each one to expand before adding the next. Putting multiple .war files in the Tomcat webapps directory at the same time can cause all of them to fail to expand. Although it is possible, you should not name a context ROOT on a multi-context Jamf Pro server.
Manually install Tomcat. For instructions, see step 2 of the single-context manual installation instructions in this guide: Step 2: Installing Tomcat
Install the web application by placing the renamed .war file in the Tomcat webapps directory:
```
C:\Program Files\Apache Software Foundation\Tomcat 10.1\webapps
```
Locate the DataBase.xml file in the following location:
```
C:\Program Files\Apache Software Foundation\Tomcat 10.1\webapps\context\WEB-INF\xml\DataBase.xml
```
1. Make a backup copy of the DataBase.xml file.
2. Open the DataBase.xml file with Notepad ++. (Avoid using NotePad or WordPad.)
3. Edit the file to match the MySQL account created earlier:
```
<DataBaseName>databasename</DataBaseName>
<DataBaseUser>username</DataBaseUser>
<DataBasePassword>password</DataBasePassword>
```

Navigate to the log4j2.xml file inside of the web application directory:

C:\Program Files\Apache Software Foundation\Tomcat 10.1\webapps\context\WEB-INF\classes\log4j2.xml

Make a backup copy of the log4j2.xml file
Open the log4j2.xml with Notepad++ and locate each of the (3) instances of the following path:
```
/Library/JSS/Logs/
```

Use the Find... and Replace... features of Notepad++, or any other method, to modify the target file path for each of the log files. The modified paths should include a separate folder with the same name as the context name used in step 1 to prevent overwriting:

\\Program Files\\Apache Software Foundation\\Tomcat 10.1\\logs\\context\\JAMFChangeManagement.log
\\Program Files\\Apache Software Foundation\\Tomcat 10.1\\logs\\context\\JAMFSoftwareServer.log
\\Program Files\\Apache Software Foundation\\Tomcat 10.1\\logs\\context\\JSSAccess.log

Either the format above or the one below can be used for Windows file paths:

/Program Files/Apache Software Foundation/Tomcat 10.1/logs/context/JAMFChangeManagement.log
/Program Files/Apache Software Foundation/Tomcat 10.1/logs/context/JAMFSoftwareServer.log
/Program Files/Apache Software Foundation/Tomcat 10.1/logs/context/JSSAccess.log

Restart Tomcat using the Tomcat Properties application located on the Notification Center Task Bar at the bottom right of the screen or any preferred method.
Browse to http://192.168.56.103:8080/context to verify the installation.