Site Setup

Contents / Administrator Docs / Developer Docs / Index / AdminTool Contents

The Site Setup page allows you to define and change the basic Site settings for services running in the Java^TM Web Server^TM. The Site Setup page has four cards:

Contents - Sets up basic directories and files, such as the document root directory, CGI scripts location, and welcome (index.html) files.
Languages - Defines the default language (for example, American English) and any additional supported languages.
Character Sets - Defines the supported character sets.
Options - Enables additional features, such as security checks and servlet chaining.

Contents Settings

The Contents card has the following fields and settings.

Document Root Directory
The name of the default directory on your machine where your HTML documents are placed. When you first install the Java Web Server, the default document directory is server_root/public_html.

You can change this directory to be any directory you choose, for example, a docs directory inside your own home directory.

Suppose you are the user galileo on the machine venus, you could set your Document Root Directory to /home/galileo/docs. Then, to access this directory, you would simply type the URL:

	http://venus:8080

CGI Script Directory
This defines the directory where CGI scripts are found on your system.

Any directory entered here is understood to be relative to server-root. For example, the default directory is cgi-bin, and the full path is server_root/cgi-bin. (The CgiServlet allows you to run your CGI scripts unchanged. Its bindir argument, which defines where to locate your CGI scripts, is also set by default to the cgi-bin directory.)

Welcome Files
The names of the default HTML files that the Java Web Server will load when a user enters the URL for your machine.

You may specify one or more default files. When someone connects to a directory on your machine without providing a filename, the Java Web Server will search the directory looking for a matching filename to the default files you have listed. It searches for files in the order you have indicated.

For example, if you list myfile.html, Index.html, and Index.htm, whenever someone connects to a directory without specifying a filename, the Java Web Server will search for myfile.html and display it if found. If the directory does not have a myfile.html, the Java Web Server will search for Index.html. If neither file is in the directory, it will search for Index.htm.

To illustrate, if your machine name is venus, and you define the space.html as your default file (and set the Document Root Directory to /home/galileo), then type the URL:

	http://venus:8080

you will display the file /home/galileo/space.html if the file exists in the directory.

If there is no file defined in the Welcome Files field, when a user connects without specifying a filename (to a directory for which Directory Access is on), all files in the directory will be listed by the Java Web Server.

File Name
The names of other files you can specify as Welcome Files.

Languages Settings

The Languages card has the following fields.

Default Language
Defines the default language for the site's documents.

Supported Languages
Displays a list of the languages supported by the Java Web Server.

Language Name
Allows you to add additional languages to the list of supported languages.

Character Set Settings

The Character Sets card has the following fields.

Default Character Set
Defines the default character set for the Java Web Server.

Supported Character Sets
Displays a list of the character sets supported by the Java Web Server.

Character Set
Allows you to add additional character sets to the list of Supported Character Sets.

Options Settings

The Options card has the following fields.

Security Checks
This setting has to do with basic security checking. It has two choices:

Enabled - Instructs the server to check access controls and permissions before allowing connections to your server document root and index.html file.
Disabled - Tells your server to ignore access controls and permissions when making connections to your server document root and index.html file. For more information on access controls and permissions, see Access Control Lists.

Directory Access
This setting has to do with what gets displayed in your default document root directory. It has two choices:

List Files - If you do not have a file in your document root directory specifically named index.html (or whatever you have entered in the Index.html field) that can be displayed when an HTTP connection is made to your Java Web Server, a list of the files in the directory will be displayed instead.
Do Not List Files - If you do not have an index.html file (or substitute file) to be displayed when an HTTP connection is made, the directory files will not be displayed, and the user attempting to make the connection will not be granted access to your Java Web Server.

Servlet Chains
This setting has to do with allowing servlets to be chained (that is, granting one servlet the permission to call and execute another servlet. For more information see Filters and Servlet Chaining). This setting has two choices:

Enabled - This allows servlets to chain to other servlets.
Disabled - This disables servlet chaining so that only the first servlet in a chain can be executed.

Remove all archived files
This setting has to do with removing the archive directory which contains files deleted or replaced by the HTTP1.1 DELETE and PUT operations, respectively. The archive directory is created the first time such an operation is performed. When you click the delete button, a confirmation dialogue will appear. You then have two choices:

Yes - To continue with the deletion.
No - To cancel the deletion request.

The archives directory is located at server_root/archives. If the server is used a lot for DELETE and PUT operations, the number of files stored in the archives directory can take up a lot of diskspace. That is why the ability to purge the directory is provided.

The only caution in removing the archives directory is to note that this operation deletes them permanently. If you back up your server's file system on a regular basis , deleting the archive directory should not be a concern because your backups will provide a way for you to retrieve the deleted archives files should the need arise.

Buttons

To make changes to the Site Setup page and have those settings take affect, use the three buttons at the bottom of the screen. These are:

Save - Writes your changes to the Java Web Server and changes the settings.
Revert - Takes you back to the previous settings for all fields in the screen. Use this button to undo changes you have not yet saved.
Defaults - Displays the settings that were active when you entered the Java Web Server Site Setup page.

Top

java-server-feedback@java.sun.com