================================================================================
     APACHE TOMCAT PORTABLE ENTERPRISE BUNDLE (v2.0)
     Zero-Configuration, Self-Contained Runtime & Pre-Tuned Stack
================================================================================

WHAT IS INCLUDED:
-----------------
1. Apache Tomcat 10.1 (Jakarta Servlet 6.0, HTTP/2, WebSocket)
2. Eclipse Temurin OpenJDK 21 LTS (Embedded 64-bit runtime)
3. setup.bat: 1-click Windows launcher & environment manager
4. setup.sh:  1-click Linux/macOS launcher & environment manager
5. Pre-hardened server.xml:
   - Server banner masking (suppresses version leakage)
   - ErrorReportValve (suppresses technical stack traces)
   - RemoteIpValve (trusted reverse proxy / NGINX / Cloudflare integration)
6. Pre-sized setenv.bat / setenv.sh:
   - Dynamic path discovery (works in any directory)
   - G1GC low-latency garbage collection
   - OutOfMemoryError automatic heap dumping enabled

HOW TO RUN (WINDOWS):
---------------------
Double-click "setup.bat" or run from PowerShell / Command Prompt:
  .\setup.bat start     -> Starts Tomcat in background & opens browser
  .\setup.bat run       -> Runs Tomcat in current console
  .\setup.bat stop      -> Stops Tomcat
  .\setup.bat test      -> Verifies Java & checks port 8080 status

HOW TO RUN (LINUX / MACOS):
---------------------------
Make executable and run:
  chmod +x setup.sh tomcat/bin/*.sh
  ./setup.sh start      -> Starts Tomcat in background
  ./setup.sh run        -> Runs Tomcat in foreground
  ./setup.sh stop       -> Stops Tomcat
  ./setup.sh test       -> Verifies Java & checks port 8080 status

ACCESSING THE RUNNING SERVER:
-----------------------------
Open your web browser and navigate to:
  http://localhost:8080

DEPLOYING YOUR APPLICATIONS:
----------------------------
Drop your .war file into the "tomcat/webapps/" directory.
To make it the root application, rename your archive to "ROOT.war".

LEGAL & REDISTRIBUTION CLAUSE:
------------------------------
This bundle is 100% Free and Open Source Software (FOSS).
- Apache Tomcat is licensed under the Apache License, Version 2.0.
- Eclipse Temurin OpenJDK is licensed under the GNU GPL v2 with Classpath Exception.
You are legally authorized to download, execute, modify, bundle, and redistribute 
this software for both commercial and personal use without paying royalties.
See LICENSE.txt for complete licensing details.
================================================================================
