📄 starting.xtp
字号:
<document> <header> <product>resin</product> <version>Resin 3.0</version> <title>Resin Installation Quick Start</title> <description><p>You can start using Resin by simply expanding the archive, andstarting Resin with a Java command line.</p> </description> </header> <body> <localtoc/><s1 name="quickstart" title="Quick Start for the Impatient"><p>The Resin web server starts listening to HTTP requests onport 8080 and listens on port 6800for <a href="resin-clustering.xtp">load balancer</a>or cluster messages. Resin can then beused for development or evaluation. The steps are:</p><ol><li>Install JDK 1.5 or later.<ul> <li>On Unix, set the JAVA_HOME variable or link /usr/java to the java home.</li> <li>On Windows, check to make sure the JDK installation sets JAVA_HOME correctly.</li></ul></li><li>unzip/untar the Resin download. It will unzip into resin-3.2.x/.<ul> <li>resin-3.2.x is resin.home, the location of the Resin distribution.</li> <li>For now, it is also ${resin.root}, the location of your content.Soon, you will want to move ${resin.root} tosomething like <var>/var/www</var>.</li></ul></li><li>On Unix, execute use ./configure; make; make install</li><li>Start in development mode <var>java -jar resin-3.2.x/lib/resin.jar</var></li><li>Browse <code>http://localhost:8080</code></li></ol><s2 title="Adding Content"><p>Once you've made sure Resin is working, you'll want to add some contentto the default web site:</p><ol><li>Add PHP files like <var>resin-3.2.0/hosts/default/webapps/ROOT/hello.php</var>.<ul><li>The URL in your browser will be <code>http://localhost:8080/hello.php</code></li></ul></li><li>Add JSP files like <var>resin-3.2.0/hosts/default/webapps/ROOT/hello.jsp</var>.<ul><li>The URL in your browser will be <code>http://localhost:8080/hello.jsp</code></li></ul></li><li>Add servlets like <var>resin-3.2.0/hosts/default/webapps/ROOT/WEB-INF/classes/test/HelloServlet.java</var><ul><li>Create a file <var>resin-3.2.0/hosts/default/webapps/hello/WEB-INF/resin-web.xml</var> toconfigure the servlet.</li></ul></li><li>Add .war files like <var>resin-3.2.0/hosts/default/webapps/hello.war</var>.<ul><li>The URL in your browser is<code>http://localhost:8080/hello</code></li></ul></li><li>Create web-apps directly like<var>resin-3.2.0/hosts/default/webapps/hello/index.php</var>The URL in your browser is <code>http://localhost:8080/hello</code>.<ul><li>Create a file <var>resin-3.2.0/hosts/default/webapps/hello/WEB-INF/resin-web.xml</var> toconfigure the 'hello' web application.</li></ul></li></ol></s2><s2 title="Virtual Hosts"><p>You can easily create <a href="virtual-host.xtp">virtual hosts</a>by creating content in the <var>resin.root/hosts</var> directory:</p><ol><li>Add a hello.php to <var>resin-3.2.0/hosts/localhost/webapps/ROOT/hello.php</var></li></ol></s2><s2 title="Permanent content locations"><p>Eventually, you'll want to move your content and configurationinto a more permanent location:</p><ol><li>Create a permanent resin.root:<ul><li>Virtual hosts go in <var>/var/www/hosts/www.foo.com/webapps/ROOT</var></li><li>Run <var>java -jar resin-3.2.0/lib/resin.jar --resin-root /var/www</var></li><li>You can also set <root-directory> in the <<a href="cluster-tags.xtp#root-directory">cluster</a>> to configure the resin root.</li></ul></li><li>If needed, modify the Resin configuration in <var>resin-3.2.0/conf/resin.xml</var><ul><li>You can copy resin.xml to somewhere like <var>/etc/resin/resin.xml</var></li><li>Run <var>java -jar resin-3.2.0/lib/resin.jar --conf /etc/resin/resin.xml</var></li></ul></li></ol></s2><s2 title="Running Resin as a daemon"><p>In a deployment environment, Resin will run as a background daemon.The previous steps ran Resin in the foreground, which is convenientfor development since the logging output goes to the console.When running as a daemon, Resin detaches from the console and continuesrunning until told to stop.</p><ol><li>Start resin with <var>java -jar resin-3.2.0/lib/resin.jar start</var></li><li>Stop resin with <var>java -jar resin-3.2.0/lib/resin.jar stop</var></li><li>Restart resin with <var>java -jar resin-3.2.0/lib/resin.jar restart</var></li></ol></s2><p>Until you're ready to deploy the server, those are all thesteps needed to get started with Resin.</p></s1><s1 title="Preconditions"><p>Resin 3.2 needs Java before it can run. It needs JDK 1.5 or a later JDK.</p><p>Sun's JDK for Windows, Solaris, and Linux can be found at<a href="http://java.sun.com">http://java.sun.com</a>. Sun also haslinks to some other ports of the JDK.</p></s1><s1 title="Resin Web Server"><p>The easiest and fastest Resin configuration uses the Resin as the primary oronly web server. This configuration provides a Java HTTP server. We recommendyou start with this before trying any other configuration.</p><figure src="httpd.gif"/><p>The server listens at port 8080 in the default configuration andcan be changed to the HTTP port 80 during deployment.</p><s2 title="Windows"><ol><li>Install JDK 1.5 or later.</li><li>Check that the environemnt variable JAVA_HOME is set to the JDK location, e.g. "c:\j2sdk1.5.0_01"</li><li>Unzip resin-3.2.0.zip</li><li>Define the environment variable RESIN_HOME to the location ofResin, for example "c:\resin-3.2.0"</li><li>Execute <var>java -jar resin-3.2.0/lib/resin.jar</var></li><li>Browse http://localhost:8080</li></ol></s2><s2 title="Unix (including MacOS-X)"><ol><li>Install JDK 1.5 or later and link /usr/java to the Java home or define the environment variable JAVA_HOME.</li><li>tar -vzxf resin-3.2.0.tar.gz</li><li>cd resin-3.2.0</li><li>./configure</li><li>make</li><li>make install</li><li>Execute <var>java -jar resin-3.2.0/lib/resin.jar</var></li><li>Browse http://localhost:8080</li></ol></s2><p>For more details, see the <a href="resin-web-server.xtp">Resin Web Server</a>configuration page.</p></s1><s1 title="Resin with Apache"><p>If you are already using Apache for your web server, you can use Resin withApache. This configuration uses Apache to serve html, images, PHP, or Perl,and Resin to serve JSPs and Servlets.</p><p>The Apache configuration uses two pieces: a C program extendingApache (<var>mod_caucho</var>) and Java program supporting servlets andJSP (<var>srun</var>.) The two pieces communicate with a special high-speedprotocol.</p><figure src="apache_srun.gif"/><p>To configure Apache with Resin, you mustconfigure both Apache and Resin. The Resinconfiguration is identical to Resin's httpd configuration. The Apacheconfiguration tells Apache how to find Resin.</p><ol><li>On Unix only, compile mod_caucho.so using <code>./configure --with-apache; make</code></li><li>Make any needed Apache httpd.conf changes</li><li>Make any needed Resin resin.xml changes</li><li>Restart Apache</li><li>Start Resin with <code>resin-3.2.0/bin/resin.sh</code> on Unix or<code>resin-3.2.0/resin.exe</code> on Windows.</li></ol><p>On Unix, you'll run configure using <code>--with-apache</code> and then <code>make</code>:</p><example>unix> ./configure --with-apache=/usr/local/apacheunix> makeunix> make install</example><p>For more details, see the <a href="install-apache.xtp">Resin with Apache</a>configuration page.</p></s1><s1 title="Resin with IIS"><p>You can also combine IIS and Resin. IISserves static content like html and images and Resin serves JSPs andServlets. The IIS configuration requires two pieces:<var>isapi_srun.dll</var>, an ISAPI extension which lets IIS talk toResin, and <var>srun</var>, Resin's Java support.</p><figure src="iis_srun.gif"/><p>For this setup you must configure both IIS and Resin. The Resinconfiguration to run with IIS is identical to Resin's standaloneconfiguration. The IIS configuration tells IIS how to find Resin.</p><ol><li>Setup the registry and IIS using resin-3.2.0/setup.exe</li><li>Any needed Resin resin.xml changes</li><li>Restart IIS</li><li>Start Resin with resin-3.2.0/resin.exe.</li></ol><p>For more details and troubleshooting steps, see the<a href="install-iis.xtp">Resin with IIS</a> configuration page.</p></s1></body></document>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -