Override configuration resources
Override resources defined in the GAS configuration file at the command line when starting the dispatcher.
Understanding resources
The GAS includes several configuration resources listed in the
<RESOURCE_LIST>
section of the $FGLASDIR/etc/as.xcf file.
These resources define how the GAS operates and allow you to customize its behavior. They include
settings for the application environment, such as where to store or retrieve data, how long
applications and services can run before timing out, and how to manage log levels.
Configuration resources often come with default values that are used by other resources and
configuration elements. For instance, the resource
res.appdata.path
defines the
location where application data is stored, and this path is established during the installation of
the
GAS.<RESOURCE Id="res.appdata.path" Source="INTERNAL">$(res.path.as)/appdata</RESOURCE>
Additionally, some resources, like
res.path.gbc.user
and
res.path.webcomponent.user
, are not predefined by the GAS.
<RESOURCE Id="res.path.gbc.user" Source="INTERNAL"></RESOURCE>
<RESOURCE Id="res.path.webcomponent.user" Source="INTERNAL"></RESOURCE>
Instead,
you can specify these values at runtime when starting the dispatcher, allowing for greater
flexibility in configuration.Dispatcher override option
An essential aspect of configuring the GAS is using the dispatcher override option
(
-E
), which allows you to change a resource defined in the configuration file
(as.xcf
) directly from the command line when needed. For example: (Line breaks have
been added to improve readability.)fastcgidispatch -E res.path.gbc.user="C:\mygbc\dist\customization"
-E res.gip.log=DEBUG -E res.log.categories_filter="ALL"
The values set by these override options take precedence over the values specified in the configuration file, ensuring that you can adapt the dispatcher’s behavior to meet specific requirements at startup.