Hi, Am 30.07.2018 um 18:25 schrieb Christopher Schultz: > -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA256 > > Marek, > > On 7/30/18 3:22 AM, Marek Czernek wrote: >> Hi there, >> >> recently, we noticed the lack of documentation for Catalina Base, >> and I wanted to find out more about it. Other than a strangely >> obscure txt file [1], I did not find the concept and usage of >> Catalina Base documented in the Tomcat docs. > > Do you mean the CATALINA_BASE environment variable, which is copied > into a running JVM as the "catalina.base" system property? > >> My questions are: >> >> 1) Did I overlook it being documented somewhere? > > Other than in RUNNING.txt (where it is thoroughly described), it is > documented in: > > 1. bin/catalina.sh and bin/catalina.bat > 2. The "Directories and Files" section of each Tomcat X documentation > (e.g. > https://tomcat.apache.org/tomcat-9.0-doc/introduction.html#Directories_a > nd_Files) > 3. The "Introduction" section of each Tomcat X configuration guide for > the "context" container (e.g. > https://tomcat.apache.org/tomcat-9.0-doc/config/context.html#Introductio > n) > >> 2) If not, is there any reason for it not being documented? While >> I don't want to duplicate text, I do not consider a txt file >> somewhere a sufficient docs. > > What, it needs to be in TeX, too? > >> If the answer to both of my questions is no, we'll create a patch >> against the Tomcat docs. >> >> [1] https://tomcat.apache.org/tomcat-9.0-doc/RUNNING.txt > > Patches are always welcome, but I believe it is currently > properly-documented. > > Is there something specific you were looking for and could not find?
That's the point to ask for some details I'm struggeling with 1. $CATALINA_BASE/bin/tomcat-juli.jar: when do I need to place this jar in this directory? It is only clear to have it in CATALINA_BASE for the documented switch to log4j. From reading catalina.sh I would say it is only necessary to place it in CATALINA_BASE when we want to use a different version. Is this assumption correct? 2. $CATALINA_BASE/conf: What files have to be in this directory? If they are not present - are they loaded from CATALINA_HOME? RUNNING.txt only mentions server.xml. But it looks like we need to have at least a copy of web.xml in this directory too. Reading catalina.sh we also should copy (or link) catalina.policy when running with a security manager. For other files the situation is not clear, e.g. catalina.properties, context.xml, ... Some stackoverflow answers to that question recommend to copy the whole conf directory from CATALINA_HOME to CATALINA_BASE. I'm not sure if this is a good idea if I don't need to change the defaults. The documentation could be improved by listing the files that are mandatory in CATALINA_BASE Regards, Stefan --------------------------------------------------------------------- To unsubscribe, e-mail: users-unsubscr...@tomcat.apache.org For additional commands, e-mail: users-h...@tomcat.apache.org
