See CONTRIBUTING.md for info on working on PSI Probe and sending patches.
Please download latest probe.war from here
Please download latest psi-probe-web.war release from here
You can rename 'psi-probe-web.war' to the traditional 'probe.war' or other name as you see fit.
Please download latest psi-probe-web.war snapshots from here
You can rename 'psi-probe-web.war' to the traditional 'probe.war' or other name as you see fit.
-
Clone PSI Probe's git repository.
Note: If you plan to contribute to PSI Probe, you should create your own fork on GitHub first and clone that. Otherwise, follow these steps to build the latest version of PSI Probe for yourself.
Execute the following command:
git clone https://github.com/psi-probe/psi-probeThis will create directory called
psi-probe. Subsequent steps will refer to this as "your PSI Probe base directory." -
Minimum JDK version required to build is JDK 17 and run is JDK 17.
-
**Download and install Maven 3.9.9 or better
You may download it from the Apache Maven website.
-
Run Maven.
Execute the following command from your PSI Probe base directory:
mvn packageThis will create a deployable file at
web/target/probe.war.
Generally supported versions for third party tomcat providers align with their support but earlier versions may still work. It is advisable in every case to use only supported tomcat releases per specific vendor. Our support will only be against non CVE releases.
-
Tomcat 9.0 Series
- Requires java 11 or better
- Use psi probe 4.x series for javax namespace
- Spring is no longer receiving updates so vulnerabilities with spring will not be addressed. If you have a subscription to spring, manually patch the jars.
- Tomcat 9.0.72 to 9.0.105
- TomEE 8.0.16 (Based on Tomcat 9.0.82). TomEE 8.0 ended support on December 31st 2023
- NonStop(tm) never supported 9.0 as they changed direction but seem to have come back now for 10.1
- Vmware Tanzu tc 4.1.44 release (Based on Tomcat 9.0.102)
- Vmware Tanzu tc 5.0.23 release (Based on Tomcat 9.0.104)
-
Tomcat 10.1 Series
- Requires java 17 or better
- Use psi probe 5.x series for jakarta namespace
- Tomcat 10.1.6 to 10.1.41
- TomEE 10.0.0 to 10.0.1 (Based on Tomcat 10.1.39).
- NonStop(tm) Servlets For JavaServer Pages(tm) v10.1 (Based on Tomcat 10.1.7)
- Vmware Tanzu tc 10.1.40.A release (Based on Tomcat 10.1.40)
-
Tomcat 11.0 Series
- Requires java 17 or better
- Use psi probe 5.x series for jakarta namespace
- Tomcat 11.0.0.M3 to 11.0.7
- TomEE - no support yet for tomcat 11.0
- NonStop(tm) Servlets For JavaServer Pages(tm) - no support yet for tomcat 11.0
- Vmware Tanzu tc 11.0.6.A release (Based on Tomcat 11.0.6)
PSI Probe uses deep reflection to access data. Take care your tomcat configuration considers this. You can do this by extending the JDK_JAVA_OPTIONS variable:
...
--add-opens=java.base/java.lang=ALL-UNNAMED \
--add-opens=java.base/java.lang.reflect=ALL-UNNAMED \
--add-opens=java.base/java.io=ALL-UNNAMED \
--add-opens=java.base/java.util=ALL-UNNAMED \
--add-opens=java.base/java.util.concurrent=ALL-UNNAMED \
--add-opens=java.base/sun.util.locale=ALL-UNNAMED \
--add-opens=java.rmi/sun.rmi.transport=ALL-UNNAMED \
...