DOCUMENT_ROOT
The DOCUMENT_ROOT element specifies root directories that determine file
system paths for serving files to applications.
Syntax
<DOCUMENT_ROOT>dir-path[;...]</DOCUMENT_ROOT>- dir-path is a document root path. This element allows for multiple document root
paths to be specified; the separator used between resource paths is a semicolon
(
;).
The DOCUMENT_ROOT element does not support any attributes or have any child
elements.
Usage
$(res.path.docroot), which resolves to the $FGLASDIR/web directory.$(res.path.idp.docroot), which is the default document root directory for Genero Identity Provider (GIP) applications. This path resolves to the home directory path of the user installing the GIP. For more information, refer to the GIP working directory in the Single Sign-On User Guide.
Other root directories can be specified as required. For example, the resource path
$(res.path.docroot.user), which is not defined in the GAS configuration file by
default, can be set as required for files generated at runtime, such as reports generated by the
Genero Report Engine (GRE). For example, you can set the resource at the command line when starting
the dispatcher: httpdispatch -E res.path.docroot.user="/usr/gre/viewer"
When a web server is included in the solution architecture, the GAS's document root directory is
separate to the web server's, which has its own document root - often called
htdocs for the Apache web server or C:\Inetpub\wwwroot for
IIS. Files located in the web server document root are served by the web server, while files located
in the GAS DOCUMENT_ROOT are served by the GAS, meaning the dispatcher.
Usage example
<DOCUMENT_ROOT>/usr/fgl2c/as/web</DOCUMENT_ROOT>