How to set context path in Tomcat so one could enter the site without appending the deployed folder name?

doctrey picture doctrey · Dec 4, 2011 · Viewed 41.6k times · Source

I read about this on Tomcat guide here and some SO questions. And I think I'm pretty much doing the same thing. But in some way cannot manage to succeed.

First of all I have to say that my application is deployed on a shared Tomcat server that I have no control over. I just drop my .war file and it gets deployed.

I tried to package my application as ROOT.war but didn't work. The admin told me to package it as whatever the name I want and they would take care of it. I packaged it as my-application.war and it got deployed but I have to enter http://my-host/my-application to get to the website.

After contacting the admin they told me that they have put a context elemnt in my host in Tomcat config file like:

<Context path="" docBase="path of my-application deployed folder"/>

which was supposed to set my-application as default application for all the requests coming to my-host. But it didn't and whenever I enter http://my-host I get:

HTTP Status 404 - / The requested resource (/) is not available

But again when I enter http://my-host/my-application it all works fine. Any suggestion on what might be wrong is definitely appreciated.

Updates:
I tried to follow the steps described in tomcat documentation on how to make the application default. 3 ways are described and I tried all three ways and could successfully deploy my application as ROOT on localhost.

I also tried to reproduce the problem I'm facing on remote server so I could find the reason and report it to admin. I find couple of problems.

  1. In server.xml fragment that admin sent me autoDeploy and deployOnStartUp are set to true, whereas they should be false if explicitly defining Context element in server.xml. This will cause double deployment which creates a ROOT folder and a folder with the name of the .war file. Deleting the .war will delete it's corresponding folder and undeploys the application but ROOT remains and must be deleted manually and requires a Tomcat restart. Until it's restarted any deployment of ROOT.war will fail.
  2. I figured there are some reasons preventing ROOT.war from deploying. One could be that a ROOT.xml exists in conf/{engine-name}/{host-name} or a ROOT folder exists in appBase of the host or as I described above a ROOT application from previous deployment is not undeployed and requires Tomcat restart.

Either way I couldn't exactly pinpoint what exactly is preventing ROOT.war from deploying since that requires the access to Tomcat log files and conf files to check the cases I described above.

Also from all I see my the admin seems incapable of maintaining a Tomcat server and finding the problem. So I decided to go with a dedicated Tomcat server after struggling with the shared one.

Answer

Jeff Goldberg picture Jeff Goldberg · Dec 14, 2011

In your question, you state that the admin set the context as:

<Context path="" docBase="path of my-application deployed folder"/>

Based on the comments above, I would suggest trying to use the relative path of your application rather than the absolute path.

I tried this on my tomcat server with:

<Context path="/" docBase="my-application/" />

and that did the trick.

The Host element which contains the Context element does actually set some parameters that might also impact the context. If it's the default settings, then a relative context should simply point to the webapps folder. If it's been changed, the results may vary.