Dispatcher: fastcgidispatch

fastcgidispatch is the dispatcher for Apache 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. For Windows systems, the Genero isapidispatch dispatcher dedicated to the Internet Information Services (IIS) Web server is preferred.

Syntax

fastcgidispatch [options]

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.
`@optionsfile`	The GAS supports the `@` argument to provide a list of dispatcher start-up options in a file. The file can be used to pass override options in a file instead of writing them at the command line. Example: `fastcgidispatch -s @fcgi.options` The file may contain several options, where each option must be in a separate line. See Set override options in a file
`--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`

For information on restarting the fastcgidispatch, see Restarting fastcgidispatch without losing current sessions.