The e-mail address of the person who is responsible for replying to questions and taking care of problems with the server. By convention, this is “webmaster.” The DynaWeb server uses the value of DWEB_ADMINISTRATOR as the address to contact when a client generates an error message.

The pathname to the DynaWeb authentication file. The default is /usr/lib/Insight/dweb/data/security/full.auth.

For information about authentication on DynaWeb servers, see “Administering HTTP Authentication” in Chapter 2.

The pathname of the DynaWeb SGML-to-HTML converter, /usr/lib/Insight/dweb/bin/dwsgml2html. The DynaWeb converter handles data conversion and other specialized tasks for the DynaWeb server.

The fully-qualified hostname of the server, which can be the variable %%LOCALHOST%%, which is replaced automatically with the hostname. A fully qualified hostname must be an official Internet node name, for example www.sgi.com. DynaWeb uses the value of DWEB_HOST when generating the addresses for hypertext (HREF) links.

The default is 88. If you are setting up a multiple DynaWeb configurations, this port may be different (see the section “Running DynaWeb as a Process with Multiple Configurations” in Chapter 2). If you start dynaweb with the -p option, the port specified by the -p option overrides the DWEB_PORT value. Don't use port 80.

Any port below 1024 requires root permission, so the server must run as a superuser in order to access one of these ports.

The full pathname of the DynaWeb root directory. The DynaWeb root directory contains all of the browser-accessible files on the server. To be accessible to browsers, a file must either reside in the DynaWeb root directory or in a symbolically linked directory. By default, the DynaWeb root directory is /usr/lib/Insight/dweb/servroot.

The collections parameter identifies accessible DynaWeb collections. Define DWEB_COLLECTIONS as a list of your collections and short titles that describe them, in the form:

coll_dir=coll_title[;coll_dir=coll_title] 

coll_dir is the pathname of the collection and coll_title is a brief description of the collection that is meaningful to client users. They are specified in one of these ways or as a combination of these ways:

Multiple collection pathnames or symbolic links can be added by separating each collection from the others with a semicolon, for example:

DWEB_COLLECTIONS = %%BOOKSHELVES%%;\
/ftp/www/literature = Literature Collection;\
@mybooks=”My Books”

On receiving a URL that matches the DWEB_COLLECTMAGIC value, a DynaWeb server lists its current collections. The client can select among these collections. You can change the DWEB_COLLECTMAGIC value to a proprietary string.

---

Note: If you change the home page, ensure that it contains a hypertext link to your new DWEB_COLLECTMAGIC value.

---

Controls the maximum number of simultaneous connections. The value can be from 1 to 256.

A code-activating parameter that triggers the server to load a list of optional HTML files that you use for whatever you want. For example, they might provide information to users or gather results from a survey.

This parameter is attached to the “Pubs” button.

Destination of publisher's page button, DWEB_PUBSBUTTON.

Takes a semicolon-separated list of publisher variable definitions, for example:

DWEB_PUBVARS = CITY=Mountain View; STATE=CA; ZIPCODE=94043

The template phrase $CITY, $STATE $ZIPCODE becomes Mountain View, CA 94043. See Chapter 4, “Templates for Server Pages,” for more information about templates.

Specifies the directory that holds all CGI scripts for the DynaWeb server. All DynaWeb CGI scripts must be in this directory.

Defines the string that enables users to access CGI scripts in the directory defined by the DWEB_CGIBINDIR parameter. For example:

DWEB_CGIMAGIC = /DWEB-CGI

To execute a CGI script, the URL must contain /DWEB-CGI after the host and port, for example:

http://www.sgi.com:88/DWEB-CGI/test-cgi.pl

The value of this parameter determines the number of bytes of text, a graphics file, or both, that the server can automatically send per transfer. The purpose of this parameter is to protect clients from being overloaded. The sending of tables of contents is unaffected by the DWEB_MAXBYTES value.

The default value for DWEB_MAXBYTES is 30000 bytes. The minimum value is 5000 bytes.

This parameter controls whether a server asks a client user whether to transmit a block of data that exceeds DWEB_MAXBYTES. The possible settings for DWEB_CONFIRM are

The DynaText data directory.

The DynaText public directory.

The DynaText private directory.

Points to the location of the password file that DynaWeb checks when it receives a request for authentication. The location and name of the password file can be anything you desire, as long as you specify an absolute pathname to the password file, for example:

DWEB_PASSWORD_FILE = \
/usr/lib/Insight/dweb/passwdfile

---

Note: Do not place your password file underneath the servroot directory, because this allows the document to be served out by the DynaWeb server.

---

Acts as an access control list for the DynaWeb server. It lists which hosts are allowed to access the information served by the DynaWeb server, and which hosts are denied access. Whenever the server receives a request for information and DWEB_HOST_ACL is present, it checks to see that the hostname of the requestor matches one of the values in DWEB_HOST_ACL. If either the name of the client can't be found in the list or the name is found, but marked for non-access, the request is denied. If the name is found as a value of DWEB_HOST_ACL, then the server fulfills the request. The next two subsections provide more information about DWEB_HOST_ACL.

Specifies a string that is added to the <BODY> tag for text pages.

A small, transparent .gif file.

Accesses the DynaVerse link.

Defines the destination of the DynaVerse button.

Allows the client to select and use a query form.

Used internally.

Selects the directory for message localization.

Controls the dynamic TOCs that are generated automatically when viewing the content of a document. DynaWeb generates a TOC structure at the top of the document pane showing the location of the section you are viewing in the hierarchy of the document. A listing at the bottom of the pane lists the subsections, if any, of the current selection.

The values of DWEB_MINITOCS are

Controls which pages contain search field. Possible values are

Controls the text found on the Search button next to the search field underneath the TOC-View button bar and on the query forms, if any are supplied.

Controls the showing of TOC lines with zero hits.

Controls what the server does when the Styles button (which accesses any additional stylesheets) is selected from the TOC button bar. If this parameter is commented out, the Styles button is removed from the TOC-View button bar.