-server-root
From Resin 3.0
(Difference between revisions)
Line 1: | Line 1: | ||
+ | {{Cleanup}} | ||
[[Category:Configuration]] | [[Category:Configuration]] | ||
Latest revision as of 15:59, 7 December 2011
This article requires cleanup and may refer to a legacy version of Resin.
Please visit http://www.caucho.com/documentation/ for the most up-to-date documentation. |
Contents |
Overview
The -server-root command line option sets the root directory for server files.
A more flexible approach that is easier to upgrade is to build the website structure in a separate directory. That directory is the "server-root".
Here is an example of making a server root in /var/wwwroot:
$ mkdir /var/wwwroot $ cd /var/wwwroot $ cp -R /usr/local/resin-pro-3.0.10/conf . $ mkdir webapps $ mkdir webapps/ROOT $ echo "Test wwwroot home" > webapps/ROOT/index.jsp
Start Resin with the -server-root option:
$ /usr/local/resin-pro-3.0.10/bin/httpd.sh -server-root /var/wwwroot
location | purpose |
---|---|
/var/wwwroot/conf/resin.conf | |
/var/wwwroot/conf/app-default.xml | |
/var/wwwroot/webapps/ROOT/index.jsp | corresponds to url http://host:port/ |
/var/wwwroot/webapps/myapp.war|corresponds to url http://host:port/myapp/ | |
/var/wwwroot/webapps/anotherapp/index.jsp | corresponds to url http://host:port/anotherapp/ |
/var/wwwroot/hosts/gryffindor.com | |
/var/wwwroot/hosts/gryffindor.com/webapps/ROOT/index.jsp | corresponds to url http://gryffindor.com:port/ |
/var/wwwroot/hosts/slytherin.com/webapps/ROOT/index.jsp | corresponds to url http://slytherin.com:port/ |
/var/wwwroot/logs/access.log | log file created by Resin, configured in conf/resin.conf |
Upgrading
1) unpack the new tarball:
$ cd /usr/local $ tar xzvf /usr/local/resin-pro-3.0.11.tar.gz
2) Check the Release Notes
Check for any resin.conf changes that might be necessary. It is rare that a new version of Resin requires resin.conf changes.
3) run ./configure; make; make install
$ cd resin-pro-3.0.11 $ ./configure; make; make install
4) Use the new install to start Resin
$ /usr/local/resin-pro-3.0.11/bin/httpd.sh -server-root /var/wwwroot