-
Notifications
You must be signed in to change notification settings - Fork 12
/
README.caucho
114 lines (75 loc) · 3.62 KB
/
README.caucho
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
Copyright (c) 1998-2008 Caucho Technology. All Rights Reserved.
This is the README file for Resin 4.0(tm)
=========================================
The documentation included with Resin is in XTP format starting at
http://localhost:8080/resin-doc/index.xtp.
The full documentation is also available online at
http://www.caucho.com/resin if you have trouble getting started.
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
I) Licensing/Support
--------------------
For pricing and licensing information for Resin 4.0 Professional,
see http://www.caucho.com/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/sales -- licenses and support
II) Preconditions
-----------------
1) Resin needs a Java JDK before it can run. Resin 4.0 works with
JDK 1.6 or greater.
Some locations for JDKs include:
http://java.sun.com -- Sun's site
2) On Windows, you'll need an unzip tool available at http://www.winzip.com
III) Getting Started
--------------------
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.
1) 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
2) To start the server:
unix> java -jar lib/resin.jar 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
3) 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.
4) Browse http://localhost:8080 or equivalently http://127.0.0.1:8080.
5) Go through the documentation at http://localhost:8080/resin-doc
6) For JSP, create test.jsp in resin-4.0.x/webapps/ROOT/test.jsp and browse
http://localhost:8080/test.jsp.
Resin serves files from resin-4.0.x/webapps/ROOT/ in the default
configuration. All files with the extension '.jsp' are interpreted
as jsp files.
7) For PHP, create test.php in resin-4.0.x/webapps/ROOT/test.php and browse
http://localhost:8080/test.php.
8) 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/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
9) An administration application is available at
http://localhost:8080/resin-admin
Instructions are provided for setting a password.