Module Version: 4.0.0
Puppet Version: N/A
OS Name/Version: N/A
The module should note the expected process for upgrading Tomcat when installed from source.
It is unclear how best to upgrade Tomcat when installed from source. The documentation does not cover any methods for upgrading Tomcat via the module, potentially assuming the user is already aware.
The most public guidance for upgrading a from-source install is
MODULES-2141 from 2016:
Discussed with hunter and it sounds like the intended functionality/process would be to install the new version of Tomcat in a new catalina_base and then point the tomcat instance at the new base.
This would allow for a rolling migration to the new Tomcat version as well as the ability to roll back to the old one in the case of issues or bugs with the new version.
To help users understand that the module is designed with the above intent, it should be noted in the module's documentation.
If the above intent from 2016/
MODULES-2141 is no longer relevant, the current intent or process should be documented.