...
There are several things which you will need in order to perform a Tomcat release build.
- A build environment
running on x86 or x86-64 architecture. This is required to build the Windows installer and uninstaller binaries which require NSIS which is an x86-only product. Use of Microsoft Windows is not required; builds can be completed on MacOS or Linux with wine installed. Please see Tomcat's Release Process for how to install and configure wine if you choose this option. (Please note that release-builds have been verified to be possible – and repeatable – using Wine on aarm64 MacOS. Please see the Release Process page for how to set this up.) - A Java Development Kit (JDK) which matches the version used to build the release. This version information can be found in each release's source artifact in the build.properties.release file.
- Apache Ant which matches the version used to build the release. This version information can be found in each release's source artifact in the build.properties.release file.
- GnuPG and your own private key. You will be asked to sign the release that you build locally during the build process.
Note: you must use the same Java version and Apache ant version used by the release build in order to reproduce these artifacts exactly.
You will need to configure your build environment. The easiest way to do that is to create a build.properties file in your user's home directory which contains the following configuration:
| Code Block |
|---|
gpg.exec=(full path to gpg.exe on your system) base.path=(full path to a temporary directory where Tomcat can download dependencies e.g. /tmp/tomcat-build-libs) |
How to Verify
TL;DR – scroll down to the bottom of this page to read about how to do this "quickly" if you trust the automated Tomcat release-verification process not to be gamed in any way. Feel free to read and follow the instructions below if you want to see what is happening and/or you do not trust the automated release-verification process.
You will need to download the source distribution of the release. This is the apache-tomcat-x.y.z-src.zip or apache-tomcat-x.y.z-src.tar.gz file which you can find in the downloads area for Apache Tomcat. For example, the source ZIP file for Apache Tomcat 10.1.5 can be found at https://dist.apache.org/repos/dist/dev/tomcat/tomcat-10/v10.1.5/src/apache-tomcat-10.1.5-src.zip
...