vqServer Aliases, files and directories


Web browsers ask web sites for files by name. vqServer interprets this name as an alias and translates it to the file's real name using an internal list. Each alias is also associated with information which tells vqServer how to handle the request.

There is a different list of aliases for each server. To display the aliases for the main web server, click on Aliases under Main web server in the control centre menu. To display the aliases for another server, click on Server in the control centre menu, then click on the name of the server you are interested in, then click on Aliases.

vqServer processes requests by searching its list of aliases (from most specific to least specific) until it finds an alias which matches the request. The part of the requested file name which matches the alias is replaced with the real name corresponding to the alias to determine the real name of the file requested.

For example, suppose that a web browser requests the file /index.html form your web site. The first alias which matches this is / (the last alias in the standard list of aliases). The real name associated with / is public/. vqServer therefore responds to the request by sending the file public/index.html where public/ is interpreted as a subdirectory of the website/ directory.

The information associated with each alias also determines how vqServer handles a request. There are four possibilities:

  1. Send file: just return the file requested.
  2. Redirect: redirect the request to the translated location. The real name must be something like http://host/path/filename.ext.
  3. Run java servlet: the servlet corresponding to the real name is loaded if necessary and run. See calling servlets and servlet aliases for more information on servlet aliases.
  4. Run CGI script: runs the CGI script corresponding to the real name. The real name must be something like cgidirectory/progname.exe.

Aliases always begin with /. If an alias refers to a directory the alias and its real name also end with /. Whenever an alias changes vqServer checks it against your computer's file system and adds or removes /s as necessary.

vqServer
Register (free!)
Support

Contents

Servers and ports
Logs

Aliases page
Alias settings
Alias parameters

Aliases page

The aliases page for a server is displayed when Aliases in the server's options submenu of the control centre menu is clicked. Aliases are displayed in the order vqServer searches them to find the alias matching a request, which is reverse alphabetical order.

The following is displayed for each alias.

Alias

The name of the alias. This is what is compared with the name of a requested file. It always begins with /.
Action How vqServer handles a request which matches this alias.

Real name

The part of the request which matches the alias is replaced with this to determine the real file name.
Settings Displays the settings for this alias.
Parameters Displays the parameters for this alias.
Delete Deletes the alias.

The New alias link on the control centre menu on this page allows you to add a new alias to the list.

Control centre menu

vqServer
Contents
Aliases

Servers and ports
Logs

Alias settings

This form is displayed when a Settings icon is clicked in an aliases page. It provides control over the main characteristics of an alias.

The form is context-sensitive: only options appropriate to the alias are displayed. If different options become appropriate as a result of editing an alias the form is redisplayed with the appropriate options.

Alias

The name of the alias. This is what is compared with the name of a requested file. It must begin with / and must end with / if the alias corresponds to a directory.

Real name

The part of the request which matches the alias is replaced with this to determine the real file name. It must ends with / if the alias corresponds to a directory.

Default file

If a request translates to the name of a directory instead of a specific file, vqServer looks for the default file in the directory and sends it if available. This is the mechanism by which visitors to your web site are sent your index.html file if they don't specify a particular file in their request. Not displayed unless the alias corresponds to a directory.
Allow directory listings This check box determines whether vqServer can send directory listings if these are requested. Directory listings are only generated if the alias corresponds to a directory and no default file is specified. Not displayed unless the alias corresponds to a directory.

Action

How vqServer handles a request which matches this alias.

Filter:

Allows you to specify a filter servlet or a chain of filter servlets through which files matching the alias are passed prior to dispatch. Filters set on this form override any file type specific filters. Filter servlets must be specified by their alias and must begin with /. Several filter servlets can be chained by separating their aliases with ;. Displayed only if the aliases' action is serve file.
Load on startup If this box is checked vqServer will attempt to load and initialise the corresponding servlet when the server starts up. Only displayed if the alias corresponds to a single servlet.
Load now or Unload now

Access control list

If this is not Anyone, vqServer restricts access to files and directories matching this alias to persons listed in the access control list. See the security page.

Choosing New ACL here creates a new access control list, restricts access to files and directories matching this alias to persons listed in the new access control list and takes you to the new access control list's settings page when the Ok button is pressed.

Control centre menu

vqServer
Contents
Aliases

Servers and ports
Logs

Alias parameters

Each alias is associated with a list of parameters. Parameters are meaningful only in the context of Java servlets and CGI scripts:

  • Java servlets: The alias parameters are treated as servlet initialisation parameters which can be accessed using the getParameterNames() and getParameter() methods of the ServletConfig interface. See JavaSoft's servlet documentation for more information about these methods.
  • CGI scripts: The alias parameters are passed to the script as environment variables.

To display the parameters associated with an alias click on the icon in the Parameters column next to the alias in a list of aliases.

The buttons underneath the list of parameters are as follows:

  • New parameter: Add a new parameter to the list. A form allowing editing of the new parameter is displayed. A new parameter can also be added to the list by clicking on the New parameter link in the control centre menu for this page.
  • Edit parameter: Allows editing of the selected parameter. A page allowing editing is displayed.
  • Delete parameter: Deletes the selected parameter from the list.


vqServer version 1.06. Copyright © 1997-98 vqSoft and Steve Shering. Last updated 24 October 1998.
Control centre menu

vqServer
Contents
Aliases

Servers and ports
Logs