Dotaz: ROOT context - WAR se nerozbaluje

[Nautil]

Ahoj všem,

Používám Tomcat 7.0.29 (ze ZIPu z webu Apache Tomcat), Oracle Linux 6.4 a rád bych deployoval aplikaci myapp s ROOT kontextem s využitím virtualhosta.

Nastavení jsem se snažil provést podle následující dokumentace Tomcatu:

http://tomcat.apache.org/tomcat-7.0-doc/config/context.html#Naming

If you want to deploy a WAR file or a directory using a context path that is not related to the base file name then one of the following options must be used to prevent double-deployment:
a) Disable autoDeploy and deployOnStartup and define all Contexts in server.xml
b) Locate the WAR and/or directory outside of the Host's appBase and use a context.xml file with a docBase attribute to define it.

http://tomcat.apache.org/tomcat-7.0-doc/config/context.html#Defining_a_context

Individual Context elements may be explicitly defined:
A. In an individual file at /META-INF/context.xml inside the application files. Optionally (based on the Host's copyXML attribute) this may be copied to $CATALINA_BASE/conf/[enginename]/[hostname]/ and renamed to application's base file name plus a ".xml" extension.
B. In individual files (with a ".xml" extension) in the $CATALINA_BASE/conf/[enginename]/[hostname]/ directory. The context path and version will be derived from the base name of the file (the file name less the .xml extension). This file will always take precedence over any context.xml file packaged in the web application's META-INF directory.
C. Inside a Host element in the main conf/server.xml.

Požadavky na deployment myapp

1. Deployovaná s context path=""
2. Soubor se jmenuje myapp.war (ne ROOT.war)
3. V rozbaleném WAR souboru by se neměl editovat soubor META-INF/context.xml
4. Měla by být rozbalena jen do jedné složky a deployována 1x.

Abych toto dosáhl, provedl jsem následující

• řídil jsme se možnostmi b) and B. z dokumentace Tomcatu, tedy
• definoval virtualhost myapphostname s appbasedir $CATALINA_HOME/myapp_dst
• umístil myapp.war do složky $CATALINA_HOME/myapp_src (splnění požadavku b)
• vytvořil soubor $CATALINA_HOME/conf/Catalina/myapphost/ROOT.xml obsahující context path="" docBase=$CATALINA_HOME/myapp_src/myapp.war (splnění požadavku B)

Předpokládal jsem, že se myapp.war rozbalí do appBase virtualhosta,t.j. do $CATALINA_HOME/myapp_dst nebo do $CATALINA_HOME/myapp_dst/ROOT, ale nestalo se ani jedno. Aplikace myapp beží z nerozbaleného WARu.

Co bych měl změnit v konfiguraci nebo v souborové struktuře, abych dosáhl požadovaného chování?

Předem díky za rady.

Leoš

=== adresářová struktura - relevantní soubory/složky ===

$CATALINA_BASE
|-- bin
|-- conf
|   |-- Catalina
|   |   |-- localhost
|   |   `-- myapphost
|   |       `-- ROOT.xml
|   |-- catalina.policy
|   |-- catalina.properties
|   |-- context.xml
|   |-- logging.properties
|   |-- server.xml
|   |-- tomcat-users.xml
|   `-- web.xml
|-- lib
|-- LICENSE
|-- logs
|-- NOTICE
|-- myapp_dst
|   |-- mysecondapp
|   `-- mysecondapp.war
|-- myapp_src
|   `-- myapp.war
|-- RELEASE-NOTES
|-- temp
|-- webapps
`-- work

=== server.xml - relevantní část ===

<Engine name="Catalina" defaultHost="myapphost">
  <Realm className="org.apache.catalina.realm.LockOutRealm">
  <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
         resourceName="UserDatabase"/>
  </Realm>

  <Host name="localhost"  appBase="webapps"
        unpackWARs="true" autoDeploy="true">
    <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
           prefix="localhost_access_log." suffix=".txt"
           pattern="%h %l %u %t "%r" %s %b" />
  </Host>

  <Host name="myapphost" appBase="myapp_dst" unpackWARs="true" autoDeploy="true">
  </Host>
</Engine>

=== $CATALINA_HOME/conf/Catalina/myapphost/ROOT.xml ===

<Context path="" docBase="/opt/programs/tomcat7b/myapp_src/myapp.war" />

---

---

Odpovědi

[Filip Jirsák]

Po krátkém hledání na internetu bych řekl, že Tomcat WARko nerozbaluje, minimálně v případě, že je WARko umístěné mimo appBase. Proč vůbec chcete, aby aplikace běžela z rozbaleného WARka? Podle mne k tomu může být důvod jen u špatně napsané aplikace.

[Nautil]

Děkuji. Ano, je to tak, mimo appBase Tomcat WARy nerozbaluje. Šlo mi o to nastavit <Context path=""/>, rozbalit WAR a zároveň se vyhnout vytvoření složky ROOT.war. Rád bych, aby Tomcat rozbalil WAR pouze do složky myapp, což však nejspíš koliduje s dokumentací, která vyžaduje pro prázdný stríng v Context path složku ROOT nebo soubor ROOT.war.

Rozbalení WAR je požadavek zákazníka, pro kterého nastavení provádím. Panuje obava, že aplikace běžící z nerozbaleného WARu bude běžet pomaleji než z rozbaleného.

[Nautil]

Podle mne když použijete docBase, Tomcat WARko nemůže rozbalit, protože vůbec nic neví o cíli – např. jestli je tam povolen zápis. Takže pokud chcete použít automatické rozbalování, musíte WARko nahrát do appBase. ContextPath je pak možné určit buď názvem WARka nebo souborem context.xml ve WARku. Nebo můžete WARko rozbalit předem a docBase nasměrovat na rozbalený adresář. Nebo použít Jetty, které WARka rozbaluje do systémového dočasného adresáře. A nebo se vykašlat na rozbalování, to, že by aplikace běžela pomaleji, je podle mne nesmysl. Týkalo by se to nanejvýš statických souborů, a ty lze stejně nejrychleji odeslat jedině přes NIO, takže je nutné celý mechanismus servletů obejít (Jetty to umí, nevím, zda i Tomcat – ale rozhodně to znamená mnohem víc konfigurace, než jenom někam nahrát WAR).

[Nautil]

Děkuji za upřesnění. Díky Vám jsem si ujasnil, že zmíněné požadavky na deploy se nedají splnit současně a to protože se Tomcat chová takto:

• Svázanost <Context path="string"> se jménem WAR nebo rozbalené složky, kdy prázdný string vyžaduje pojmenování ROOT.war, resp. ROOT/ (složka), což dokumentace Tomcatu popisuje zde.
• Možnost vyhnout se této svázanosti za cenu toho, že WAR soubor webové aplikace (nebo složku s rozbalenou aplikací) nahraju mimo appBase do nějakého docBase, kde ovšem ztrácím možnost rozbalení WAR, protože je docBase pro Tomcat neviditelná.

Ještě jednou díky za Vaše postřehy. Řešením v mém případě bude nejspíše nerozbalovat WAR.