Difference between revisions of "Jetty/Troubleshooting"

• If you think your application is running, but you get a 404 response, make sure that you have correctly set the context path.

• If you click a link to access the application, make sure you don't have a relative URL problem. Remember that a link to foo/bar on a page at /myapp/page goes to /myapp/foo/bar. If you want it to go to /myapp/page/foo/bar, make sure the browser is redirected from /myapp/page to /myapp/page/.

• If you still cannot get your content, look in the requestlog to see the exact URL that is being requested.

• If you receive a 503 Unavailable response, an exception occurred while deploying the web application. Check the log for details.

• You can test whether the JVM has locked up completely by trying to use a tool like Jconsole or jvisualvm to attach to the process.

• • If you cannot attach to the process, it is likely something has gone wrong with the JVM and/or the operating system rather than Jetty itself.

• • If you can attach to the JVM with Jconsole and/or jvisualvm, look to see how many threads are allocated and what tasks they are doing. A frequent cause of lockups is a slow database so that all the threads in the thread pool end up waiting for a JDBC connection from the connection pool.

• You can test whether Jetty is completely locked up by trying some simple requests to see if they get a response. Opening http://thehost.com/favicon.icon or some other image directly is often a good way to see if Jetty is still running. If it is, try some simple requests within the application that use minimal features (no authentication, no database, for example) and see if any of those requests work.

• Finally, you can use telnet as a fake HTTP client to see if Jetty is accepting connections. If you telnet to the port (80 or 8080) and you see a "Connected to www.example.com" message, Jetty is still accepting connections. Next try typing a request like "OPTION * HTTP/1.0" and press Enter twice to see if you get an HTTP response:

   # telnet blogs.webtide.com 80
   Trying 72.32.76.94...
   Connected to blogs.webtide.com.
   Escape character is '^]'.
   OPTION * HTTP/1.0
   HTTP/1.1 503 Service Unavailable
   Cache-Control: must-revalidate,no-cache,no-store
   Content-Type: text/html;charset=ISO-8859-1
   Content-Length: 1287
   Server: Jetty(7.0.0.v20091005)
   

Check that the Server in the response field is Jetty (and not a load balancer, etc.).

If JSP is incorrectly configured, each context started produces an error message like:

INFO::NO JSP Support for /, did not find org.apache.jasper.servlet.JspServlet

Read the following wikipedia entry for details:

http://en.wikipedia.org/wiki/Ephemeral_port

[...]The IANA suggests 49152 to 65535 as "dynamic and/or private ports.[...]

[...]Many Linux kernels use 32768 to 61000.[...]

We have fixed the test code to make it run successfully on Mac OS. If it nonetheless fails on your Mac OS, raise the port range by executing the following two commands in a terminal:

sudo sysctl -w net.inet.ip.portrange.first=32768
sudo sysctl -w net.inet.ip.portrange.hifirst=32768