Resin is a project mainly written in ..., based on the GPL-2.0 license.
Git portage of Resin's SVN trunk, Caucho's project
Copyright (c) 1998-2011 Caucho Technology. All Rights Reserved.
The documentation included with Resin is in XTP format starting at http://localhost:8080/resin-doc/index.xtp.
For more information about configuring Resin, the full documentation is also available online at:
http://www.caucho.com/resin-4.0/
Questions should go to our mailing list or forums.
http://maillist.caucho.com -- mailing lists http://forum.caucho.com -- forum http://bugs.caucho.com -- bug reports
For pricing and licensing information for Resin 4.0 Professional, see http://www.caucho.com/resin/sales. Resin Professional contains additional performance and reliability features beyond the Resin Open Source version.
Resin 4.0 Open Source is released under the GPL.
Resin licenses do not include technical support. However, we offer several technical support options to fit your support and budget needs.
http://www.caucho.com/resin/sales -- licenses and support
Resin needs a Java JDK before it can run. Resin 4.0 works with JDK 1.6 or greater.
Some locations for JDKs include:
Oracle: http://www.oracle.com/technetwork/java/javase/downloads/index.html
On Windows, you'll need an unzip tool available at http://www.winzip.com
A HTML 5 browser is needed for some features of the /resin-admin tool.
The included HTTP/1.1 server makes it easy to evaluate Resin, JSP and servlets. Just start it up. The default configuration file is found in resin-4.0.x/conf/resin.xml.
On Unix, you'll want to build the JNI libraries:
resin-4.0.x> ./configure --prefix=pwd
resin-4.0.x> make
resin-4.0.x> make install
To start the server:
unix> bin/resin.sh start
or
C:> java -jar lib/resin.jar start
The server listens to port 8080. Port 8080 is the default specified in the configuration file resin-4.0.x/conf/resin.xml
Log files are in resin-4.0.x/log
Usually, Resin can find the JDK, but you may need to set JAVA_HOME in some configurations.
Starting Resin with -verbose is a great way to see what environment Resin is running.
Browse http://localhost:8080 or equivalently http://127.0.0.1:8080.
Go through the documentation at http://localhost:8080/resin-doc
You can use the command-line to deploy a .war file:
unix> bin/resin.sh deploy foo.war
You can also copy the war file to the webapps directory.
To deploy a war file, place the file in resin-4.0.x/webapps/foo.war Resin will expand the war file, and the application will be available with the url http://localhost:8080/foo/
Resin supports the development of applications without requiring a war file deployment. Create a directory resin-4.0.x/webapps/bar to correspond to url http://localhost:8080/bar/. Java source files placed in resin-4.0.x/webapps/bar/WEB-INF/classes/ are automatically compiled by Resin.
resin-4.0.x/webapps/bar/index.jsp --> http://localhost:8080/bar/ --> http://localhost:8080/bar/index.jsp
resin-4.0.x/webapps/bar/WEB-INF/web.xml
-- servlet/jsp configuration file
resin-4.0.x/webapps/bar/WEB-INF/resin-web.xml
-- Resin specific configuration
resin-4.0.x/webapps/bar/WEB-INF/classes/example/HelloServlet.java
-- java source file, automatically compiled by Resin
With Resin-Pro, you can get a PDF snapshot report of the server with the command-line:
unix> bin/resin.sh pdf-report
You can also get a watchdog restart report with the -watchdog option
unix> bin/resin.sh pdf-report -watchdog
An administration application is available at
http://localhost:8080/resin-admin
Instructions are provided for setting a password.