DOCUMENT

The DOCUMENT_ROOT element specifies root directories that determine filesystem paths to serve files. The default document root directory (res.path.docroot) is FGLASDIR/web. This directory is the default bootstrap template path which is searched for CSS, JavaScript, demos.html, and other files served to the Genero Web Client for JavaScript (GWC-JS) front-end by the Application Server, see GWC-JS.

Note: 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, i.e. the dispatcher.

For the GAS, 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).

Syntax

<DOCUMENT_ROOT> docroot; docrootuser </DOCUMENT_ROOT>

It allows for multiple document root paths to be specified, the separator used between resource paths is a semi-colon, ';'.

The DOCUMENT_ROOT element does not support any attributes or have any child elements.

Usage example

<DOCUMENT_ROOT>/usr/fgl2c/as/web</DOCUMENT_ROOT>

In this usage example, if you have the demos.html file in this directory and wish to access the file, use the URL: http://<app_server>:<port>/demos.html (where the file is on the host where the GAS resides) or http://<web_server>/gas/demos.html (where the file is on the Web server host), see File serving URIs.

Parent elements

This element is a child of one of the following elements: INTERFACE_TO_CONNECTOR