Bug 58596

Summary: Add Patch Binary -- Running.txt says tomcat is a JAVA application and doesn't use Environment Variables.
Product: Tomcat 8 Reporter: vivek <vkhrgg>
Component: DocumentationAssignee: Tomcat Developers Mailing List <dev>
Severity: normal    
Priority: P2    
Version: 8.0.x-trunk   
Target Milestone: ----   
Hardware: PC   
OS: All   
Attachments: patch for RUNNING.txt

Description vivek 2015-11-07 15:12:53 UTC
Created attachment 33264 [details]
patch for RUNNING.txt

Running.txt(which helps user to guide for running up tomcat) says tomcat is a JAVA application and doesn't use Environment Variables.

Tomcat always uses CATALINA_HOME as a environment variable.
No matter who is setting this, either explicit or implicit by start up script.
The document says, since it is a JAVA application, it does not use, but JAVA application does use.
And the next few lines are also misleading according to Bug statement CATALINA_HOME(required).
So it seems misleading.

Providing a patch for this.
Comment 1 Konstantin Kolinko 2015-11-07 15:37:22 UTC
No. Tomcat does not use CATALINA_HOME environment variable.

The launch script (catalina.sh or catalina.bat) uses it.

Tomcat itself uses system property named "catalina.home". The script sets that property with a -D command argument to java process that runs Tomcat.
Comment 2 Mark Thomas 2015-11-11 15:36:43 UTC
Wording clarified in trunk, 8.0.x for 8.0.29 and 7.0.x for 7.0.66
Comment 3 Konstantin Kolinko 2015-11-16 12:18:48 UTC
Clarified in 6.0 as well, for 6.0.45