Dispatcher: fastcgidispatch

fastcgidispatch is the dispatcher for web servers supporting FastCGI protocol.

It can be started by the web server or in command line.
fastcgidispatch -s
Alternatively, if using the GAS systemd service, you can execute the following command:
systemctl start fastcgidispatch.service
Note:

Fastcgidispatch is supported on UNIX™-like platforms only. While fastcgidispatch is known to work on Windows®, it is not recommended and is not supported. Windows systems use the Genero isapidispatch dispatcher, which is dedicated to the Internet Information Services (IIS) web server.

Syntax

fastcgidispatch [options [...]] [@argfile]
  1. options can be an option as described in Table 1.
  2. argfile defines a file that contains a list of override (-E) commands. The options file must use the following format:
    option-name
    option-value
    [...]
    For examples, go to Set override options in a file.

Options

Table 1. fastcgidispatch options
Option Description

-p directory

--as-directory directory

Specify the Genero Application Server directory.

-f configuration_file

--configuration-file configuration_file

Specify which configuration file to use when starting the Genero Application Server dispatcher. If not specified, the default configuration file, $FGLASDIR/etc/as.xcf, is used.

-E name=value

--resource-overwrite name=value

Overwrites the resource defined in the configuration file or creates a new one.

Example:

fastcgidispatch
 -E res.dvm.wa=$FGLDIR/bin/myrun

If in the configuration file "res.dvm.wa" has another value it is now set to myrun. The final value is the one set in the option.

-s

--standalone

Start the FastCGI dispatcher in standalone mode, where the dispatcher is started prior to any actual request from an application or web server. The web server's FastCGI extension must be configured to connect to an external GAS.

-h

--help

Displays help information.

-V

--version

Displays version information.
--pid-file filename Write the dispatcher process-id to the specified file. The file is created. If the file exists, it is overwritten.
--dump-command Verify the dispatcher start-up options listed in a file by outputting them to standard out.

Example: fastcgidispatch -s @fcgi.options --dump-command