-server-root

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