-server-root

From Resin 3.0

Revision as of 14:18, 21 December 2005 by Ferg (Talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search


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

Contents

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
Personal tools