Server:/
| ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Setting | Explanation | Default / Example | Data Type | Access R,W,A,D | ||||||||||
AutoStart | Set to TRUE to cause PowerWeb to load this service upon startup. If it is set to FALSE, the service must be manually started through the "Service Pause and Resume" page. | Yes | Integer | R,W | ||||||||||
DocumentRoot |
The default directory from which to serve documents or files. When
the client requests a resource, it is always relative to this drive
and directory. This is a very simple and effective security mechanism. Users cannot access documents outside of the document root directory tree, unless you specifically define aliases to map URLs to those locations.
VERY IMPORTANT: To redirect a client request to another drive or directory outside of the "DocumentRoot" directory, use an "Alias" for the specified resource. This is most easily achieved through the Directory Tree. | /powerweb/docs | Text | R,W | ||||||||||
Port |
Your server has many TCP/IP "ports" which it uses to distinguish how to process
incoming client requests with different protocols. You can pick any number
from 1 to 65535, but make sure no other service is using it. It makes sense to tell your server to listen on standardised port numbers, because using a non-default port affects your users. For example, if your HTTP server runs on port 8000, users will need to use a URL similar to "http://www.widget.com:8000" to access your server.
| 80 | Integer | R,W | ||||||||||
Protocol | The protocol supported by this server. eg "HTTP/1.0", "FTP" or "POP3". Each client request is specified in similar fashion and is available in the variable "Request:/Protocol". | HTTP/1.0 | Text | R,W |
Setting | Explanation | Default / Example | Data Type | Access R,W,A,D |
---|---|---|---|---|
Address | The server's address in numeric IP form. For a symbolic name for the address, use the "Host" variable. Note that each separate service that is active can operate on a different IP address and a different port number. | 12.34.56.78 | Text | R,W |
AddressRestrict | Set to Yes to force the server to accept connections only on the IP address specified by the "Address" setting. Use "No" if you are running a multi-homed server, or if you wish to allow localhost connections too. | No | Integer | R,W |
Admin | The e-mail address of the user responsible for administering this server. This address is displayed within notification messages so that users can contact the webmaster with suggestions or problems. | WebMaster@xyz.com | Text | R,W |
Host |
This is the server's address in text form. The numeric IP address is contained
in the "Address" variable. Set this variable in the
Configuration editor if you wish to override the automatic DNS lookup
and provide an alternative alias fully qualified host name for your site. PowerWeb uses the name you give here as the main Uniform Resource Locator (URL) when users access your site. The server name is built from your domain name, and the name of your server. You must include both your domain name and the machine name to specify a fully qualified host name.
Your system administrator may have already set up a Domain Name Server (DNS)
alias for your server such as
For example, if your machine was named | www.widget.com | Text | R,W |
ErrorFile | The name of the file to which error messages should be sent. The Error Log server hook can be used to store error messages in alternative formats and destinations such as a database server. | http.err | Text | R,W |
QueueLength | Defines the size of the incoming request queue for a Service. Setting a low value means that TCP/IP will reject client requests if the server is very busy, instead of queuing them until they can be serviced. The minimum value is 1, and with the current implementation of IBM OS/2 TCP/IP, the maximum value is 5. | 5 | Integer | R,W |
UserDir |
Each user is allowed their own home directory for files.
This parameter specifies the location of the user's directory when
a URI of the format /~UserName is received.
There are two special keywords within this parameter: If the ~ServerRoot keyword is not used, and the "UserDir" is not an absolute path name, then the "UserDir" is assumed to be relative to the document root of the server service. If you use the default setting of "~ServerRoot/usr", then both HTTP and FTP will access a common directory when serving documents. This allows users to have their own HTML directories and update the files in those directories through using FTP. For write access, only the user who owns the directory is permitted. This rule is automatic and does not need to be setup manually through access control rules. If this setting is empty, then user directories are disallowed. | ~ServerRoot/usr | Text | R,W |
Each server is given its own sub-directory underneath the global "Config:/Servers/" directory. When a server hook is called, the relevant sub-directory corresponding to the current server is passed over as an argument.
This means that the server data is accessible through two different paths. The one relates to the current server that is requesting the hook to perform an action, and the other allows a hook global access to all servers (typically used for remote administration or statistics to allow a summary of all activity to be presented).
Setting | Explanation | Data Type | Access R,W,A,D |
---|---|---|---|
ErrorOutput | Any text written to this variable is automatically directly output to the log, after which the variable is emptied. | Text | A |
LastAccept |
Timestamp of the last accepted connection.
The format is "yyyy/mm/dd hh:mm:ss". | Text | R |
LastIdle |
Timestamp of the last time the server entered an idle state (had no
connected client).
The format is "yyyy/mm/dd hh:mm:ss". | Text | R |
LastReset |
Timestamp of the last time the server was told to reset itself.
The format is "yyyy/mm/dd hh:mm:ss". | Text | R |
Software | The name and version of the server software. Example "PowerWeb/2.01". | Text | R |
Started |
The timestamp when the server was most recently started.
The format is "yyyy/mm/dd hh:mm:ss". | Text | R |