Troubleshooting
Resin 3.0

Features
Installation
Configuration
Web Applications
IOC/AOP
Resources
JSP
Quercus
Servlets and Filters
Databases
Admin (JMX)
CMP
EJB
Amber
EJB 3.0
Security
XML and XSLT
XTP
JMS
Performance
Protocols
Third-party
Troubleshooting/FAQ

Techniques
Symptoms
FAQ
Third-party
Resin 3.0
Techniques

Techniques

Nothing ever works exactly as planned and various techniques and tools as well as an understanding of commonly encountered problems are valuable aids to troubleshooting your web applications.

Enable debug logging
Thread dump
Out of Memory and Garbage Collection
Clean up the classpath
Monitor the HTTP communication
Use an external compiler
Increase stack size to avoid thread limitations
Use netstat to obtain an OS level view of current TCP/IP port usage
Symptoms

A list of symptoms and their possible resolution.

Resin stops responding
Resin keeps restarting
No line numbers in exception stack traces
java.lang.OutOfMemoryError exception, application runs out of memory
After a while the server starts to go very slow
CPU spikes, excessive CPU usage
Sessions become null, losing session
Specification version 1.3 of package javax.servlet, J2EE Specification, version 1.3 is not compatible with Resin
Unsupported major.minor version 48.0
All FAQ's

A collection of the FAQ from each section of the Resin documentation.

Features FAQ
What operating systems are supported with Resin?
Installation FAQ
Where can I put .jar files so that they are available to all of my web applications?
What happened to bin/resin?
How can I bind to a port under 1024 and still run as a non-root user?
Can I run multiple instances of Resin on the same machine?
Why do I get `can't connect to parent' after installing Resin?
What happened to exception-type='connection'?
IIS 6 will not serve .exe files
Configuration FAQ
Where is the configuration GUI, and the GUI for deploying web-apps and new virtual hosts?
Where can I find the .rnc files that Resin uses for validating configuration files?
Can I precompile JSP's?
How can I disable directory listings?
What impact does always-save-session have on performance?
Web Applications FAQ
How are path related values of the request object changed after a forward or include?
Class.forName() doesn't seem to work right
Why do I have to put my classes in a package?
How do I specify the default file encoding?
Resources/JNDI/JCA FAQ
Can I link one JNDI name to another?
JSP FAQ
Why I am getting extra whitespace in the output of my JSP?
Security FAQ
Can I use different SSL certificates for each virtual host?
Why does Resin say I need OPENSSL_THREADS when I try to use OpenSSL?
What is the sequence of handshakes for an SSL connection?
XML/XSLT FAQ
How do I configure Resin 3 to apply a server-side XSLT transformation?
How do I indicate the stylesheet to use for the transformation?
Performance FAQ
How many concurrent users can a Resin server handle?
Does Resin use NIO for improved performance?
How does Resin use JNI?
Common Problems FAQ
Specification version 1.3 of package javax.servlet, J2EE Specification, version 1.3 is not compatible with Resin Resin-3.0.x. Resin-3.0.x requires version 2.4.
class file has wrong version 48.0, should be 47.0

Third-party
Resin 3.0
Techniques
Copyright © 1998-2006 Caucho Technology, Inc. All rights reserved.
Resin® is a registered trademark, and HardCoretm and Quercustm are trademarks of Caucho Technology, Inc.