These vhttpd.conf config file settings affect files used by the vhttpd server, such as where transactions are logged.
DocumentRoot, the logs files, etc. are in subdirectories of this by default. Environment variables may be referenced in the path with $, and home directories with (tilde).
ServerRootmay be set to %INSTALLDIR% (the default) for the Texis installation directory.. The server config file is by default conf/vhttpd.conf in this directory.
ServerRoot-relative. This allows Vortex scripts to be stored in a location other than the server's document tree, e.g. for security or permission reasons. Added in version 4.00.1017300000 20020327.
In version 5 and later,
ScriptRoot can also be set to the
special value "%DOCUMENT_ROOT%" (no prefixes/suffixes) to
use the current document root as the script root. This may be for
back compatibility with a version 4 installation.
ServerRoot-relative. Also sets %LOGDIR%.
VortexLogare placed in here by default. If these are files with no dirs (the default), then a parallel web server can be set up with identical configuration, but logging elsewhere, by just giving a new -logdir on the command line. This eases setting up a quick test server - without mucking up the live server's logs, or having to write a new vhttpd.conf file.
ServerRoot-relative. Added in version 8.
LogFormat. Depending on
LogOptionssettings, the User-Agent and Referer may be logged with each entry as well. If
TransferLogis a file (no dir in its value), it is placed in
LogDir. If a dir is given in the
TransferLogpath, it is then
optioncan be one of:
Refererto log Referer in the transfer log.
UserAgentto log User-Agent in the transfer log.
Combinedto log both User-Agent and Referer in the transfer log.
pidto log the server subprocess PID.
nivcsw; printed in order
LabelLabel the getrusage() values
NoLocalDo not label the getrusage() values (default)
LogFormat, if specified, overrides
LogFormatdirective, with some codes added and some Apache codes unimplemented. See the Texis Monitor web server setting [Httpd] Log Format for details. Added in version 7.01.1384230000 20131111.
ErrorLogis a file (no dir in its value), it is placed in
LogDir. If a dir is given in the
ErrorLogpath, it is then
VortexPath) scripts are logged here. Overrides texis.ini value, if any (here). Note that general non-Vortex server errors are logged to the
ErrorLoginstead. (This config setting also does not affect where Vortex errors are logged for CGI-run Vortex scripts, which are run by the Vortex executable texis, e.g. under Apache or the Monitor Web Server. That is only controlled by the texis.ini setting.)
VortexLog is a file (no dir in its value), it is placed
LogDir. If a relative dir is given in the
VortexLog path, it is then
Note that log file locations can be overridden per-transaction in
directly-run (i.e. via
VortexPath) Vortex scripts, via
<vxcp> (here), if the AllowLogFileOverride setting is true (the default); see
PidFileis a file (no dir in its value), it is placed in
RunDir(version 8 and later) or
LogDir(version 7 and earlier).
PidFile path contains a relative dir, it is then
mime/type ext [ext ...]where mime/type is a MIME Content-Type and ext is one or more filename extensions (no dot) to associate with the MIME type. This list is used to assign Content-Types for file downloads, based on the outermost file extension. It also sets the Content-Types for built-in
VortexPathscripts, overriding the default list. The
AddTypeconfig setting can also modify the MIME type list.
ServerRoot-relative. If the file is missing, a default list is used, based on the default list for
AllowExt. Extensions are case-insensitive. Added in version 3.0.949000000 20000127.
mime/encoding ext [ext ...]where mime/encoding is a MIME Content-Encoding and ext is one or more filename extensions (no dot) to associate with the encoding. This list is used to assign one or more Content-Encodings for each file download, based on non-outermost file extensions. The
AddEncodingconfig setting can also modify this list.
ServerRoot-relative. If the file is missing, a default list for the extensions gz, uu, and Z is used. Extensions are case-insensitive. Added in version 3.0.949000000 20000127.