View source

{{Cleanup}}
[[Category:Configuration]]

== Overview ==

The -server-root [[Command Line Options|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