Appendix E iPlanet Web Server User Interface

Path to Jar File. Specifies the path from which to import PKCS#11 modules in the form of .jar files.

OK. Saves your entries. You must restart the server in order for your changes to take effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

3.6 Server Root. Specifies the server root of Netscape Enterprise Server 3.6.

Alias. Specifies the alias mapped to the key-pair file and certificate file you associated it with in the Administration Server.

Password. Specifies the certificate key-pair password.

OK. Saves your entries. You must restart the server in order for your changes to take effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

• The Cluster Control Page
• The Add Remote Servers to Cluster Database Page


• The Modify Server Settings in Cluster Database Page


• The Remove Servers from Cluster Database Page

• About Clusters
• Preliminary Guidelines for Using Server Clusters


• Setting up a Cluster

Product selector. Specifies the type of server cluster you want to configure. All servers of that type appear listed by their unique server identifier. For example, if you select Web Server, Enterprise Edition, a list of all iPlanet Web Server, Enterprise Edition instances appear on the page. The cluster page changes to display fields that apply to that server type.

Check servers to control. Allows you the select any of the listed servers, change the information for all servers in the cluster, or unselect any servers you have chosen in the page.

Status. Displays whether the server is running or has stopped.

Start, stop, restart. Starts, stops, or restarts the remote servers.

View access, view error. Displays the specified number of lines from either the server's current access log or the error log.

Transfer. Transfers information in the selected configuration file from the selected server.

Status. Displays whether the server is running or has stopped.

Help. Displays online help.

Admin Server Protocol. Specifies the protocol used when contacting the remote administration server. Choose http for normal administration servers. Choose https if the remote administration server is running under SSL.

Admin Server Hostname. Specifies the host name of the remote administration server. If your DNS cannot resolve host names, enter the fully qualified host and domain name (for example, type www.mozilla.com).

Admin Server Port. Specifies the port number of the remote administration server.

OK. Saves your entries.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Product Selector. Specifies the type of server you want to change. All servers of that type appear listed by their unique server identifier.

Check Servers To Be Modified. Allows you the select any of the listed servers, change the information for all servers in the cluster, or unselect any servers you have chosen in the page.

Admin Server Protocol. Specifies the protocol used when contacting the remote administration server. Choose http for normal administration servers. Choose https if the remote administration server is running under SSL.

Admin Server Hostname. Specifies the host name of the remote administration server. If your DNS cannot resolve host names, enter the fully qualified host and domain name (for example, type www.mozilla.com).

Admin Server Port. Specifies the port number of the remote administration server.

OK. Saves your entries.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Product Selector. Specifies the type of server you want to delete. All servers of that type appear listed by their unique server identifier.

Check Servers To Be Removed. Allows you the select any of the listed servers, change the information for all servers in the cluster, or unselect any servers you have chosen in the page.

OK. Saves your entries.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

1. Click the Servers tab in the Administration Server.
2. Click Manage Servers. The Manage Servers page appears.
3. Select the iPlanet Web Server instance you want to manage, and click Manage. The Server Manager page appears.

http://hostname.domain-name: administration_port/ server_name/bin/index

• The Preferences Tab (Server Manager)
• The Programs Tab


• The Servlets Tab


• The Security Tab (Server Manager)


• The Status Tab


• The Styles Tab


• The Content Management Tab


• The Web Publishing Tab


• The Search Tab

• The Server On/Off Page
• The View Server Settings Page


• The Restore Configuration Page


• The Performance Tuning Page


• The Native Thread Pool Page (NT)


• The Generic Thread Pools Page (NT)


• The Thread Pools Page (Unix/Linux)


• The Global MIME Types Page


• The Network Settings Page


• The Custom Error Responses Page


• The Dynamic Configuration Files Page


• The Limit Symbolic Links Page (Unix/Linux)


• The Access Control List Management Page


• The Encryption On/Off Page (Server Manager)


• The Encryption Preferences Page (Server Manager)


• The Enforce Strong Security Requirements Page

Server On. Starts the server so that all listening ports are waiting for client connections.

Server Off. Shuts the server down and stops all running processes. After you shut down the server, it may take a few seconds for the server to complete its shut-down process and for the status to change to off.

About This Server. Displays server version and third-party software information in the Version Information page.

Help. Displays online help.

Server Root. Specifies the path in which the server's binaries are stored.

Hostname. Specifies the fully qualified host name of this server (for example, www.mozilla.com).

Port. Specifies the port number servicing HTTP requests when no specific port number is specified. The default is port 80.

Error Log. Specifies the location of the error log. The error log captures all the requests which resulted in an error.

User (Unix/Linux). Specifies the user name under which the server runs. The server user should have restricted access to your system resources. You can often use a user named nobody in this situation. On some systems, however, nobody is not a valid user name. You may not want to give the user nobody group access to all files. If you do not use nobody, create a new Unix/Linux user, such as adm, to be the server user.

MTA Host. Specifies the name of the mail server that this server uses to send mail.

DNS. Allows you to enable the server to do a reverse lookup of a client's IP in the DNS database before executing a CGI script. Servlets also depend on this flag to do reverse lookup.

Security. Specifies whether SSL is running on this server.

NSAPI Library. Displays the absolute path to the NSAPI library.

NSAPI Functions. Displays the NSAPI functions called in the obj.conf file.

Additional Document Directory. Lists the additional directory path to the location of the server's web documents.

NSAPI. Displays the names and arguments of the server's NSAPIs.

Primary Document Directory. Specifies the root directory for documents. You need to change this value only if you change the root directory for documents in the Content Management page.

Restrict Access. Specifies whether access control lists (ACLs) are enabled. ACLs allow you to protect files or directories by implementing access control by user name, password, domain name, or IP address.

Index Filenames. Specifies the names of the file that the browser displays when no file name is specified in a URL. The file names are listed in order of preference.

Default MIME Type. Specifies the MIME type used if a file extension does not match any of the MIME types specified in mime.types file.

Directory Indexing. Specifies the default method for displaying the contents of a directory when there is no file matching one of the default file names. Choose a value from the drop-down list:

• Fancy. Displays each directory entry as a hyperlink with the file size, the last modified time, and an icon next to each entry to indicate the file type.
• Simple. Displays directory entries as plain text hyperlinks.
• None. Does not display directory contents.

Access Log. Specifies the path to the server access log. The access log captures all incoming requests to a server.

For the Style. Specifies information regarding the style, such as whether ACLs are enabled, the location of the NSAPI library, and so on.

Help. Displays online help.

The following elements are displayed:

Set number of sets of backups. Specifies the number of sets of backups. Click Change to apply the change.

Help. Displays online help.

https-server_name.acl. Contains the server access control lists.

magnus.conf. Contains global settings that the server uses for initialization.

obj.conf. Defines specific steps that the server takes to process instructions. In this file, you can specify path translations, and define how things such as cgi and servlet programs are handled.

mime.types. Specifies the path to the file containing the mapping of MIME types returned by the server.

jvml2.conf. Contains the configuration for the Java virtual machine (JVM).

servlets.properties. Contains the name of each servlet and its initialization parameters.

rules.properties. Contains virtual paths for servlets.

webpub.conf. Contains the system settings and file paths. In your server's obj.conf file, the search system initialization is mapped to the webpub.conf file. When you use the Search Configuration and Search Pattern Files pages, the data you input is reflected in the webpub.conf file.

Maximum Simultaneous Requests. Specifies an upper limit on the number of simultaneous requests accepted by the server. When a new request arrives, the server checks to see if it is already processing the maximum number of requests. If it has reached the limit, it defers processing new requests until the number of active requests drops below the maximum amount. Default is 512.

DNS Enabled. Allows you to enable the server to do a reverse lookup of a client's IP in the DNS database before executing a CGI script. Servlets also depend on this flag to do reverse lookup. DNS lookups can slow performance, especially on a server that uses extensive CGI. By default, DNS lookups are not allowed. Instead, hosts are identified by IP address in the CGI environment and in log files.

Async DNS Enabled. Specifies whether asynchronous DNS is enabled. DNS causes multiple threads to be serialized when you use DNS services. If you do not want serialization, enable asynchronous DNS. You can enable it only if you have also enabled DNS. Enabling asynchronous DNS can improve your system's performance if you are using DNS.

DNS Cache Enabled. Determines whether to cache DNS entries. If you enable the DNS cache, the server can store hostname information after receiving it. If the server needs information about the client in the future, the information is cached and available without further querying. Caching DNS entries may slow down the server.

Size of DNS cache. Specifies the size of the DNS cache if you have enabled DNS. The DNS cache can contain 32 to 32768 entries; the default value is 1024 entries.

Expire entries (sec). Specifies the number of seconds to allow before DNS entries are deleted from the cache if you have enabled DNS. Cache entry expiration time can range from 1 second to 1 year (specified in seconds); the default value is 1200 seconds (20 minutes).

Listen Queue Size. Determines the size of the socket-level parameter that specifies the number of incoming connections the system will accept for that socket. If you manage a heavily used web site, make sure your system's listen-queue size is large enough to accommodate the listen-queue size setting from iPlanet Web Server. Setting the listen-queue size too high can degrade server performance. The listen-queue size was designed to prevent the server from becoming overloaded with connections it cannot handle. If your server is overloaded and you increase the listen-queue size, the server will only fall further behind.

HTTP Persistent Connection Timeout. Specifies the number of seconds the server will allow a client connection to remain open with no activity. A web client may keep a connection to the server open so that multiple requests to one server can be serviced by one network connection. Since a given server can handle a finite number of open connections (limited by active threads), a high number of open connections will prevent new clients from connecting. Setting the timeout to a lower value, however, may prevent the transfer of large files as timeout does not refer to the time that the connection has been idle. For example, if you are using a 2400 baud modem, and the request timeout is set to 180 seconds, then the maximum file size that can be transferred before the connection is closed is 432000 bits (2400 multiplied by 180).

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Minimum Threads. Determines the minimum number of threads in the native thread pool. If unspecified, defaults to 1.

Maximum Threads. Determines the maximum number of threads in the native thread pool. If unspecified, defaults to 128. If you specify 1, you emulate single-threaded behavior.

Queue Size. Determines the number of threads that can wait in the queue for the thread pool. If all threads in the pool are busy, the next request-handling thread that tries to get in the queue is rejected, with the result that it returns a busy response to the client. It is then free to handle another incoming request instead of being tied up waiting in the queue. If unspecified, defaults to an unlimited size.

Stack Size (bytes). Determines the stack size of each thread in the native thread pool. The minimum value you can enter is 65536. Entering 0 specifies the default stack size for the operating system.

OK. Saves your entries. You must click Save and Apply for your changes to take effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Name of Pool. Specifies the thread pool you are adding.

Minimum Threads. Determines the minimum number of threads in the thread pool.

Maximum Threads. Determines the maximum number of threads in the thread pool. If you specify 1, you emulate single-threaded behavior.

Queue Size. Determines the number of threads that can wait in the queue for the thread pool. If all threads in the pool are busy, the next request-handling thread that tries to get in the queue is rejected, with the result that it returns a busy response to the client. It is then free to handle another incoming request instead of being tied up waiting in the queue.

Stack Size (bytes). Determines the stack size of each thread in the thread pool. The minimum value you can enter is 65536. Entering 0 specifies the default stack size for the operating system.

OK. Saves your entries. You must click Save and Apply for your changes to take effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Current Thread Pools. Lists the current thread pools. To modify a thread pool, click Edit in the thread pool row. To delete a thread pool, click Remove in the thread pool row.

Name of Pool. Specifies the thread pool you are adding.

Minimum Threads. Determines the minimum number of threads in the pool.

Maximum Threads. Determines the maximum number of threads in the pool. If you specify 1, you emulate single-threaded behavior.

Queue Size. Determines the number of threads that can wait in the queue for the thread pool. If all threads in the pool are busy, the next request-handling thread that tries to get in the queue is rejected, with the result that it returns a busy response to the client. It is then free to handle another incoming request instead of being tied up waiting in the queue.

Stack Size (bytes). Determines the stack size of each thread in the pool. The minimum value you can enter is 65536. Entering 0 specifies the default stack size for the operating system.

OK. Saves your entries. You must click Save and Apply for your changes to take effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Current Thread Pools. Lists the current thread pools. To modify a thread pool, click Edit in the thread pool row. To delete a thread pool, click Remove in the thread pool row.

New Type. Adds a new MIME type. Fill in the following fields:

Category. Specifies the category of the MIME type. Choose from the following options:

• type. MIME standard set of identifiers for content. MIME is a standard identifier that defines the type of media content and its format so that the heterogeneous client or server applications can interpret the multimedia content that they exchange. The MIME types file contains the default MIME types definitions that will be used for the server.
• enc. A response header field sent with compressed documents in addition to a document's MIME type. It indicates to the client browser the response data has been compressed or modified by a filter, so that the client can decompress the response data before presenting it to the user.
• lang. A language encoding header field specifying the language of the document.

Content-Type. Specifies the nature of the file. For example, the file could be text, video, and so forth. The receiving client (such as Netscape Navigator) uses the header string to determine how to handle the file, (for example, by starting a separate application or using a plug-in application).

File Suffix. Specifies all the file suffixes that will be associated with the content type. To specify more than one extension, separate the entries with a comma. File extensions must be unique; do not map one file extension to two MIME types.

Edit. Allows you to edit the category, content type, or file suffix of the MIME type.

Remove. Removes a MIME type.

Help. Displays online help.

Server Location (Unix/Linux). Displays the absolute path where the server's scripts, icons, and configuration files are stored.

Server User (Unix/Linux). Specifies the user name under which the server runs. The server user should have restricted access to your system resources. You can often use a user named nobody in this situation. On some systems, however, nobody is not a valid user name. You may not want to give the user nobody group access to all files. If you do not use nobody, create a new Unix/Linux user, such as adm, to be the server user.

Server Name. Specifies the fully qualified host name of this server (for example, www.mozilla.com).

Server Port. Specifies the TCP port number to which the server listens to requests. The port number can be any port from 1 to 65535.

Bind To Address. Specifies the IP address of the server.

MTA Host. Specifies the name of the mail server that this server uses to send mail.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Editing. Specifies a resource for which you want to customize error responses. If you choose a directory, the customized error responses apply only when the server receives a URL for that directory or any file in that directory.

Browse. Allows you to browse the file system and choose a portion of the server.

Wildcard. Specifies a wildcard pattern to edit. For information on using wildcard patterns, see Wildcards Used in the Resource Picker.

Error Code. Displays the following error codes which you can customize:

• Unauthorized. Specifies the file to display when users without access permissions try to access a document on the server that is protected by access control. You might send information on how they can get access.
• Forbidden. Specifies the file to display when the server does not have file system permissions to read something, or if the server is not permitted to follow symbolic links.
• Not Found. Specifies the file to display when the server cannot find a document or when it has been instructed to deny the existence of a document.
• Server Error. Specifies the file to display when the server is not configured properly or when a catastrophic error occurs, such as the system running out of memory or producing a core dump.

File. Specifies the files that contain your customized error messages.

CGI. Specifies that the file that you specified is a CGI script, and specifies the absolute path to the file or CGI script that you want to return for that error code.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Editing. Specifies a resource for which you want to customize error responses. If you choose a directory, the customized error responses apply only when the server receives a URL for that directory or any file in that directory.

Browse. Allows you to browse the files in your server.

Wildcard. Specifies a wildcard pattern to edit. For information on using wildcard patterns, see Wildcards Used in the Resource Picker.

Status message: Dynamic Configuration Is/Is Not Enabled for This Resource. Specifies whether dynamic configuration is enabled. You can enable .nsconfig files in iPlanet Web Server, but you have to manually enable .htaccess files.

Base Directory from URL. Specifies the location where the server starts its search for configuration files from the document root.

Base Directory. Specifies the location where the server starts its search for configuration files from the file system directory.

File Name. Specifies the name of the configuration file to search for within the base directory.

Search. Searches for the file name in either subdirectories or in the base directory.

Disabled Types. Specifies the file types to disable in the directories where dynamic configuration is enabled.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Editing. Specifies a resource for which you want to configure symbolic links. If you choose a directory, the symbolic links will apply only when the server receives a URL for that directory or any file in that directory.

Browse. Allows you to browse the file system and choose a portion of the server.

Wildcard. Specifies a wildcard pattern to edit. For information on using wildcard patterns, see Wildcards Used in the Resource Picker.

Allow soft file system links. Specifies whether to allow soft file system links. A symbolic link consists of two files, an original file that contains the data, and another that points to the original file. Symbolic links are more flexible than hard links. Symbolic links can be used across different file systems and can be linked to directories.

Allow hard file system links. Specifies whether to allow hard file system links. A hard link is really two file names that point to the same set of data blocks; the original file and the link are identical. For this reason, hard links cannot be on different file systems.

From Directory. Specifies the path where the server should start looking for file system links. If you enter an absolute path, the server treats the path you give as a prefix. When it recognizes that prefix in a request, the server checks any directories following the prefix for file system links. If you type a partial path, the server looks for the partial path you give as a sub-string of the incoming request. If you enter nolinks, the server looks for a directory called nolinks in the incoming request; if it finds that directory, it checks all following directories for file system links.

OK. Saves your entries. You must click Apply in the upper right portion of the page in order for your changes to take effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

• What Is Access Control?
• How Access Control Works


• Restricting Access to Your Web Site


• Access Control Examples

Editing. Specifies a resource to manage.

Browse. Specifies only a portion of the server.

Wildcard. Specifies a wildcard pattern to edit. For information on using wildcard patterns, see Wildcards Used in the Resource Picker.

Edit Access Control. Edits the access control list for the selected resource.

Editing. Specifies a resource to manage.

Edit Access Control. Edits the selected access control list.

Editing. Specifies a resource to manage.

Edit Access Control. Edits the selected access control list.

Help. Displays online help.

Action. specifies whether to deny or allow access to the users, groups, or hosts.

Users/Groups. Allows you to specify user and group authentication when you click "anyone." The bottom frame allows you to configure User-Group authentication. By default, no users or groups outside of the group admin can access Administration Server resources. For more information, see Specifying Users and Groups.

From Host. Allows you to specify the computers you want to include in the rule when you click "anyplace". In the bottom frame, you can enter wildcard patterns of host names or IP addresses to allow or deny. For more information, see Specifying Host Names and IP Addresses.

Rights. Allows you to specify access rights to files and directories on your web site. In addition to allowing or denying all access rights, you can specify a rule that allows or denies partial access rights. For example, you can give people read-only access rights to your files, so they can view the information but not change the files. This is particularly useful when you use the web publishing feature to publish documents.

Extra. Allows you to specify a customized ACL entry. This is useful if you use the access control API to customize ACLs. For more information, see Writing Customized Expressions.

Continue. Specifies that the next line in the access control rule chain is evaluated before the server determines if the user is allowed access. When creating multiple lines in an access control entry, it's best to work from the most general restrictions to the most specific ones.

Trash Can Icon. Deletes the corresponding line from the access control rules.

Access Control Is On. Specifies whether access control is enabled.

New Line. Adds a default ACL rule to the bottom row of the table. You can use the up and down arrows in the left column to move the rule.

Response when Denied. Specifies the response a user sees when denied access. You can vary the message for each access control object. By default, the user is sent a message saying that the file was not found (the HTTP error code 404 Not Found is also sent).

Submit. Saves your entries.

Revert. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays the online help.

Allow. Allows the user, group, or host access.

Deny. Denies the user, group, or host access.

Update. Saves your entries.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays the online help.

Anyone (No Authentication). Allows everyone access to the resource. No authentication is required.

Authenticated people only. Allows only authenticated users and groups to access the resource. Choose from the following options:

• All in the Authentication Database. Allows all users and groups in the LDAP directory.
• Only the Following People. Allows only the users and groups specified. Click List under Group or User to list or search for groups and users in the LDAP directory.

Prompt for Authentication. Allows you specify message text that appears in the authentication dialog box. You can use this text to describe what the user needs to enter. Depending on the operating system, the user will see about the first 40 characters of the prompt. Netscape Navigator and Netscape Communicator cache the username and password and associate them with the prompt text. This means that if the user accesses areas (files and directories) of the server that have the same prompt, the user will not have to retype usernames and passwords. Conversely, if you want to force users to reauthenticate for various areas, you must change the prompt for the ACL on that resource.

Authentication Methods.. Specifies the method the server uses when getting authentication information from the client.

• Default uses the default method you specify in the obj.conf file, or "Basic" if there is no setting in obj.conf. If you check Default, the ACL rule doesn't specify a method in the ACL file. Default is the best choice because you can easily change the methods for all ACLs by editing one line in the obj.conf file.
• Basic uses the HTTP method to get authentication information from the client. The username and password are only encrypted if encryption is turned on for the server.
• SSL uses the client certificate to authenticate the user. If you use this method, SSL must be turned on for the server. If you have encryption on, you can combine Basic and SSL methods.
• Other uses a custom method you create using the access control API.

Authentication Database. Lets you select a database that the server uses to authenticate users. The default setting means the server looks for users and groups in an LDAP directory. However, you can configure individual ACLs to use different databases. You can specify different databases and LDAP directories in the file server_root/userdb/dbswitch.conf. Then, you can choose the database you want to use in the ACL by selecting it in the drop-down list. If you use the access control API to use a custom database (for example, to use an Oracle or Informix database), you can type the name of the database in the "Other" field in the User/Group window.

Update. Saves your entries.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays the online help.

Any place. Allows any machine access to the resource.

Only from. Allows only the specified host names or IP address access to the resource. You specify this restriction by using wildcard patterns that match the machines' host names or IP addresses. For example, to allow or deny all computers in a specific domain, you would enter a wildcard pattern that matches all hosts from that domain, such as *.iplanet.com.

Update. Saves your entries.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays the online help.

All Access Rights. Allows the user, group, or host all access rights: read, write, execute, delete, list, and info.

Only the Following Rights. Allows the user, group, or host only the selected access rights. Choose from the following:

• Read. Allows a user view a file. Read access right includes the HTTP methods GET, HEAD, POST, and INDEX.
• Write. Allows a user change or delete a file. Write access right includes the HTTP methods PUT, DELETE, MKDIR, RMDIR, and MOVE. To delete a file, a user must have both write and delete privileges.
• Execute. Allows a user to execute server-side applications, such as CGI programs and Java applets.
• Delete. Allows a user who also has write privileges to delete a file or directory.
• List. Allows a user to get directory information. The user can get a list of the files in that directory. This applies to Web Publisher and to directories that do not contain an index.html file.
• Info. Allows a user to get headers (http_head method). This is mainly used by the Web Publisher.

Update. Saves your entries.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays the online help.

Customize Expressions. Allows you to enter custom expressions for an ACL in the text box. You can use this feature if you are familiar with the syntax and structure of ACL files. For more information on customized expressions, see Writing Customized Expressions, and ACL File Syntax.

Update. Saves your entries.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays the online help.

Respond with the Default File (Redirection Off). Displays the HTTP error code 404 Not Found error when the file being requested is not found.

Respond with the Following URL: (Redirection On). Specifies a URL or the absolute path to a text or HTML file in your server's document root that you want to send to users when they are denied access. Be sure the server has read access to this file on your system—it's a good idea to have the file in a directory under the server root.

• About iPlanet Web Server Security
• Using Secure Sockets Layer (SSL)


• Additional Server Security Considerations

Encryption. Specifies whether encryption is activated for the server.

Port Number. Specifies the port number that the server runs on. Port numbers can be any number from 1 to 65535; however, the standard secure server port is 443.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Allow. Specifies which SSL versions the server allows. Choose one or both of the following:

• SSL version 2. An older version of SSL that clients may use.
• SSL version 3. A more recent and more secure version of SSL.

Require Client Certificates (Regardless of Access Control). Specifies whether the server should refuse any client who does not have a client certificate from a trusted CA.

SSL 2.0 Ciphers. Specifies which algorithms for the 2.0 version of SSL to use in encryption.

SSL 3.0 Ciphers. Specifies which algorithms for the 3.0 version of SSL to use in encryption.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

• Specifying Ciphers
• Setting Stronger Ciphers

Editing. Specifies the resource for which you want to require the secret key size.

Browse. Allows you to browse your file system.

Wildcard. Specifies a wildcard pattern. For information on using wildcard patterns, see Wildcards Used in the Resource Picker.

Require 168 Bit or Larger Secret Key Size for Access. Specifies that the client must have a minimum of 168 bits in the secret key in order to successfully gain access to the server. This option is available only in the domestic version of iPlanet Web Server.

Require 128 Bit or Larger Secret Key Size for Access. Specifies that the client must have a minimum of 128 bits in the secret key in order to successfully gain access to the server. This option is available only in the domestic version of iPlanet Web Server.

Require 56 Bit or Larger Secret Key Size for Access. Specifies that the client must have a minimum of 58 bits in the secret key in order to successfully gain access to the server.

No Restrictions on Secret Key Size. Specifies that there are no minimum requirements on the secret key size.

Reject Access with File. Specifies a path to the file that will be served when the secret key size restriction is not met. If no file is specified, the server returns a "Forbidden" error.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

• The CGI Directory Page
• The CGI as a File Type Page


• The Query Handler Page


• The WAI Administration Page


• The WINCGI Directory Page (Windows NT)


• The Shell CGI Directory Page (Windows NT)


• The Activate Server-Side JavaScript Page

URL Prefix. Specifies the URL prefix for the CGI directory. The text you type in this field appears as the directory for the CGI programs in URLs.

http://yourserver.domain.com/cgi-bin/program-name

CGI Directory. Specifies the absolute path of the CGI directory. This this directory does not have to be under your document root.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Current CGI Directories. Lists all CGI directories currently defined for the server. To modify a CGI directory, click Edit in the directory row. To delete a CGI directory, click Remove in the directory row.

Editing. Specifies the resource you want to specify as a shell CGI type. If you choose a directory, all the files in that directory will be treated as a shell CGI script.

Browse. Allows you to browse your file system.

Wildcard. Specifies a wildcard pattern. For information on using wildcard patterns, see Wildcards Used in the Resource Picker.

Activate CGI as a File Type. Activates CGI as a file type and associates a file extension with the shell CGI feature in the server, such as an association for files with the .pl extension. When the server gets a request for a file with that extension, the server knows to treat the file as a shell CGI file by calling the executable associated in Windows NT with that file extension. If you activated CGI, WinCGI, and shell CGI file types, you must specify a unique suffix for each type of CGI. For example, you cannot use the suffix .exe for both a CGI program and a shell CGI program.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Editing. Specifies a resource to edit. If you choose a directory, the query handler you specify runs only when the server receives a URL for that directory or any file in that directory.

Browse. Allows you to browse your file system.

Wildcard. Specifies a wildcard pattern. For information on using wildcard patterns, see Wildcards Used in the Resource Picker.

Default Query Handler. Specifies the absolute path for the CGI program used as the default for the resource you chose.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Enable WAI Services. Enables Internet Inter-ORB Protocol (IIOP) support in the server. You may have other (non-WAI) applications that need this support. If you need IIOP support, enable WAI services.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

• Installing Windows NT CGI Programs
• Specifying a Windows NT CGI Directory


• Specifying Windows NT CGI as a File Type

URL Prefix. Specifies the URL prefix you want to use for the WINCGI directory. That is, the text you type appears as the directory for the Windows CGI programs in URLs.

The URL prefix can be different from the real Windows CGI directory you specify in the WINCGI Directory field.

WINCGI directory. Specifies the location of the CGI directory as an absolute path. This directory does not have to be under your document root.

Enable Script Tracing. Specifies whether your server will use script tracing. CGI parameters are passed from the server to Windows CGI programs through files, which the server normally deletes after the Windows CGI program finishes execution. If you enable script tracing, these files are retained in a /temp directory or wherever the environment variables TMP and TEMP are pointing. Also, any window that the Windows CGI program brings up is shown when script tracing is enabled.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

URL Prefix. Specifies the URL prefix associated with your shell CGI directory. For example, suppose you store all shell CGI files in a directory called C:/docs/programs/cgi/shell-cgi, but you want users to see the directory as http://www.yourserver.com/shell/. In this case, you would type shell as the URL prefix.

Shell CGI directory. Specifies the absolute path to the directory you created to store the shell CGI files. Make sure that any files in the shell CGI directory also have file associations set in Windows NT. The server returns an error if it attempts to run a file that has no file-extension association.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help.. Displays online help.

• Overview of Server-Side Programs
• Server-Side JavaScript Programs

The Server-side JavaScript Application Manager is at http://server-id:port/appmgr/. Allows you to access the Application manager. This link appears only after you have activated the server-side JavaScript environment.

Activate the Server-Side JavaScript application environment. Specifies whether the server-side JavaScript application environment is activated.

JavaScript Thread Pool. Allows you to specify a thread pool for server-side JavaScript applications. For information about how to define thread pools, see The Native Thread Pool Page (NT), The Generic Thread Pools Page (NT), or The Thread Pools Page (Unix/Linux).

Require Administration Server Password for Server-Side JavaScript Application Manager. Specifies whether your server-side JavaScript Application Manager will require the Administration Server password for access.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Applications. Lists all the JavaScript applications installed on your server in this left frame. Click the task buttons in the left frame to perform the indicated action on the selected application.

Start. Starts the application.

Stop. Stops the application.

Restart. Restarts the application.

Run. Runs the application on your server.

Debug. Runs the debugging application to debug the application.

Modify. Allows you to edit the installation parameters of the selected application.

Remove. Removes the selected application from the server.

Web File Path. Displays the path of the application .web file on the server.

Default Page. Displays the default page for the application.

Initial Page. Displays the initial page for the application.

Built-in Maximum Database Connections. Displays the number of built-in database connections allowed.

External Libraries. Displays the external libraries used by the application (if any).

Client Object Maintenance. Displays the client object maintenance technique.

Status. Displays whether the application is active or stopped. Users can run only active applications. Stopped applications are not accessible.

Web File Path. Specifies the path of the application .web file on the server.

Default Page. Specifies the default page for the application.

Initial Page. Specifies the initial page for the application.

Built-in Maximum Database Connections. Specifies the default value for the maximum number of database connections that this application can have at one time using the predefined database object. (This is provided for backward compatibility with applications that use database objects; for new applications that use a dbpool object, ignore this field. See Chapter 8, "Connecting to a Database," in the Server-Side JavaScript Guide for iPlanet Web Server for how to set this parameter for a dbpool object.)

External Libraries. Specifies the external libraries used by the application (if any).

Client Object Maintenance. Specifies the client object maintenance technique. For additional information on client objects, refer to the Writing Server-Side JavaScript Applications guide on http://www.iplanet.com/docs. Choose from one of the following options:

• client-cookie. Specifies that the JavaScript runtime engine on the server should use the Netscape cookie protocol to transfer the properties of the client object and their values to the client. It creates one cookie per client property. The properties are sent to the client once, in the response header of the generated HTML page.
• client-url. Specifies that the runtime engine on the server should transmit the properties of the client object and their values to the client by appending them to each URL in the generated HTML page. Consequently, the properties and their values are sent as many times as there are links on the generated HTML page, resulting in the largest increase in network traffic of all of the maintenance techniques.
• server-ip. Specifies that the server should index the data structure based on the application and the client's IP address. This technique is the fastest, because it does not require sending any information to the client. Since the index is based on both the application and the IP address, this technique creates a separate index for every application/client pair running on the server.
• server-cookie. Specifies that the server should use a long unique name, generated by the runtime engine, to index the data structure on the server. The runtime engine uses the Netscape cookie protocol to store the generated name as a cookie on the client. It does not store the property names and values as cookies. For this reason, this technique creates a single cookie, whereas the client cookie technique creates a separate cookie for each property of the client object.
• server-url. Specifies that the server should use a long unique name, generated by the runtime engine, to index the data structure on the server. In this case, rather than making that generated name be a cookie on the client, the server appends the name to each URL in the generated HTML page. Consequently, the name is sent as many times as there are links on the generated HTML page. (Property names and values are not appended to URLs, just the generated name.)

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Cancel. Erases your changes and resets the elements in the page to the values they contained before your changes.

Name. Specifies the name of the application.

Web File Path. Specifies the path of the application .web file on the server.

Default Page. Specifies the default page for the application.

Initial Page. Specifies the initial page for the application.

Built-in Maximum Database Connections. Specifies the default value for the maximum number of database connections that this application can have at one time using the predefined database object. (This is provided for backward compatibility with applications that use database objects; for new applications that use a dbpool object, ignore this field. See Chapter 8, "Connecting to a Database," in the Server-Side JavaScript Guide for iPlanet Web Server for how to set this parameter for a dbpool object.)

External Libraries. Specifies the external libraries used by the application (if any).

Client Object Maintenance. Specifies the client object maintenance technique. Choose from one of the following options:

• client-cookie. Specifies that the JavaScript runtime engine on the server should use the Netscape cookie protocol to transfer the properties of the client object and their values to the client. It creates one cookie per client property. The properties are sent to the client once, in the response header of the generated HTML page.
• client-url. Specifies that the runtime engine on the server should transmit the properties of the client object and their values to the client by appending them to each URL in the generated HTML page. Consequently, the properties and their values are sent as many times as there are links on the generated HTML page, resulting in the largest increase in network traffic of all of the maintenance techniques.
• server-ip. Specifies that the server should index the data structure based on the application and the client's IP address. This technique is the fastest, because it does not require sending any information to the client. Since the index is based on both the application and the IP address, this technique creates a separate index for every application/client pair running on the server.
• server-cookie. Specifies that the server should use a long unique name, generated by the runtime engine, to index the data structure on the server. The runtime engine uses the Netscape cookie protocol to store the generated name as a cookie on the client. It does not store the property names and values as cookies. For this reason, this technique creates a single cookie, whereas the client cookie technique creates a separate cookie for each property of the client object.
• server-url. Specifies that the server should use a long unique name, generated by the runtime engine, to index the data structure on the server. In this case, rather than making that generated name be a cookie on the client, the server appends the name to each URL in the generated HTML page. Consequently, the name is sent as many times as there are links on the generated HTML page. (Property names and values are not appended to URLs, just the generated name.)

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Cancel. Erases your changes and resets the elements in the page to the values they contained before your changes.

Web File Path. Specifies the path of the application .web file on the server.

Default Page. Specifies the default page for the application.

Initial Page. Specifies the initial page for the application.

Built-in Maximum Database Connections. Specifies the default value for the maximum number of database connections that this application can have at one time using the predefined database object. (This is provided for backward compatibility with applications that use database objects; for new applications that use a dbpool object, ignore this field. See Chapter 8, "Connecting to a Database," in the Server-Side JavaScript Guide for iPlanet Web Server for how to set this parameter for a dbpool object.)

External Libraries. Specifies the external libraries used by the application (if any).

Client Object Maintenance. Specifies the client object maintenance technique. Choose from one of the following options:

• client-cookie. Specifies that the JavaScript runtime engine on the server should use the Netscape cookie protocol to transfer the properties of the client object and their values to the client. It creates one cookie per client property. The properties are sent to the client once, in the response header of the generated HTML page.
• client-url. Specifies that the runtime engine on the server should transmit the properties of the client object and their values to the client by appending them to each URL in the generated HTML page. Consequently, the properties and their values are sent as many times as there are links on the generated HTML page, resulting in the largest increase in network traffic of all of the maintenance techniques.
• server-ip. Specifies that the server should index the data structure based on the application and the client's IP address. This technique is the fastest, because it does not require sending any information to the client. Since the index is based on both the application and the IP address, this technique creates a separate index for every application/client pair running on the server.
• server-cookie. Specifies that the server should use a long unique name, generated by the runtime engine, to index the data structure on the server. The runtime engine uses the Netscape cookie protocol to store the generated name as a cookie on the client. It does not store the property names and values as cookies. For this reason, this technique creates a single cookie, whereas the client cookie technique creates a separate cookie for each property of the client object.
• server-url. Specifies that the server should use a long unique name, generated by the runtime engine, to index the data structure on the server. In this case, rather than making that generated name be a cookie on the client, the server appends the name to each URL in the generated HTML page. Consequently, the name is sent as many times as there are links on the generated HTML page. (Property names and values are not appended to URLs, just the generated name.)

Confirm On. Specifies whether the server should display a confirmation dialog before removing, starting, stopping, or restarting the JavaScript application.

Debug Output. Specifies whether the output from the debugging application should be displayed in the same window or open new browser window.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Cancel. Erases your changes and resets the elements in the page to the values they contained before your changes.

• The Enable Servlets/JSP Page
• The Servlet Directory Page


• The Legacy JSP Directory Page


• The Configure Global Attributes for Servlets Page


• The Configure Servlet Attributes Page


• The Configure Servlet Virtual Path Translation Page


• The Configure JVM Attributes Page


• The Delete Version Files Page

Activate the Servlet Engine. Specifies whether the server can serve servlets. If the servlet engine is not activated, the server cannot serve servlets. Disabling the servlet engine also disables JavaServer Pages (JSP), so the next time you enable the servlet engine you must enable JSP again if desired.

Servlet Thread Pool. Allows you to specify a thread pool for servlets. For information about how to define thread pools, see The Native Thread Pool Page (NT), The Generic Thread Pools Page (NT), or The Thread Pools Page (Unix/Linux).

Enable JSP. Specifies whether iPlanet Web Server will parse and display JavaServer Pages (JSP). JSP files must have a .jsp extension. If JSP is not enabled, accessing a .jsp file generates a server error.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

URL Prefix. Specifies the prefix used in URLs for accessing the servlet directory. For example, if you want the URL http://server_name/plans to map to the directory D:/netscape/server4/docs/plans then enter plans in this field.

Servlet Directory. Specifies the absolute path to the directory to be registered as a servlet directory. Servlets in this directory are invoked by URLs that use the URL prefix specified in the previous field. iPlanet Web Server treats all files in these directories as servlets.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Current Servlet Directories. Lists the current servlet directories. To modify a servlet directory, click Edit in the servlet directory row. To delete a servlet directory, click Remove in the servlet directory row.

URL Prefix. Specifies the prefix used in URLs for accessing the legacy JSP directory. For example, if you want the URL http://server_name/plans to map to the directory D:/netscape/server4/docs/plans then enter plans in this field.

Legacy JSP Directory. Specifies the absolute path to the directory to be registered as a legacy JSP directory. JSPs in this directory are invoked by URLs that use the URL prefix specified in the previous field. iPlanet Web Server treats all files in these directories having the .jsp extension as version 0.92 JSPs.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Current JSP Directories. Lists the current legacy JSP directories. To modify a JSP directory, click Edit in the legacy JSP directory row. To delete a JSP directory, click Remove in the legacy JSP directory row.

Startup Servlets. Specifies the servlets that will be loaded upon starting the server. Do not include the .class extension.

Session Manager. Specifies the session manager class value.

Session Manager Args. Specifies the session manager arguments. Separate multiple name=value parameters with a comma. Input must be in the format name=value,name2=value2, and so on.

Reload Interval. Specifies the interval (in seconds) in which the servlets and JSP are reloaded. If the servlet class file changes, a servlet instance (reflecting the changes) can be reloaded. Enter an integer value between 0 and 600 inclusive.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Choose Servlet. Specifies the servlet to edit. Upon choosing the servlet from this drop-down list, the servlet's information is displayed in the lower portion of this page (Ignore this field if you are adding a new virtual path entry).

Servlet Name. Specifies an identifier for the servlet. This identifier is used internally by iPlanet Web Server; it is not used in the URL for accessing the servlet. This identifier can be the same name or a different name than the servlet class name.

Servlet Code (class name). Specifies the name of the servlet's main class file. The .class extension is not required. Do not specify any directories in this field.

Servlet Classpath. Specifies the absolute path or URL to the classpath for the servlet. The classpath can point anywhere in the file system. The servlet classpath may contain a directory, a .jar or .zip file, or a URL to a directory (You cannot specify a URL as a classpath for a .zip or .jar file.). If the servlet classpath is not a registered servlet directory, you must provide a servlet virtual path translation (in the The Configure Servlet Virtual Path Translation Page) to make the servlet accessible to browsers.

Servlet Args. Lists optional initial arguments passed to the servlet. Input must be in the format name=value [,name=value], for example, name1=arg1, name2=arg2.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Choose Virtual Path Entry. Specifies a virtual path to modify. Upon choosing the servlet from this drop-down list, the virtual path information will be displayed in the lower portion of this page (Ignore this field if you are adding a new virtual path entry).

Virtual Path. Specifies a new virtual path to add, or an existing one to modify. If you want to add a new path, you can overwrite the text (if any) in this field. If you want to modify the virtual path, choose the path from the list in Choose Virtual Path Entry above this field.

Servlet. Specifies an identifier for the servlet, as entered in The Configure Servlet Attributes Page. You can create the servlet identifier in this field before specifying it in the The Configure Servlet Attributes Page, but you must specify it in The Configure Servlet Attributes Page before the virtual path will work.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Remove. Deletes the selected virtual path from the rules.properties file.

Option. Specifies any options allowed by the vendor's JVM.

Profiler. Specifies a value for the optimizer. Enter "optimizeit" if you are using the Optimizeit! 3.0 profiler from Intuitive Systems.

OPTITDIR. Specifies the absolute path for the directory where Optimizeit! resides, for example, D:/App/IntuitiveSystems/OptimizeIt30D if you are using the Optimizeit! 3.0 profiler from Intuitive Systems.

Minimum Heap Size. Specifies the minimum heap size for the interpreter.

Maximum Heap Size. Specifies the maximum heap size for the interpreter. This setting has the same fuctionality as the command-line option -mx in Java.

Compiler. Specifies whether the Just-in-time (JIT) complier is on or off.

Classpath. Specifies the Java classpath where the classes for the servlet engine are located and any additional classpath information needed by servlets or JSP. Each path must be separated by semicolons (for example, /directory/directory:/directory/directory). For example, if a JSP uses a bean that is packaged in a JAR, add the JAR path to the classpath. You can add values to an existing classpath, but do not delete values from a classpath.

Enable Class GC. Specifies whether or not to enable class garbage collection.

Verbose Mode. Specifies whether the logging collection (if enabled) will be in verbose mode.

Enable Debug. Enables remote debugging.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Delete the SessionData Version File. Deletes the version file for the session data. When you apply this change, the version file is deleted immediately. The next time the server starts up, it deletes the session data cache and recreates the version file. The next time the server serves a JSP or servlet while using the MMapSessionManager session manager, it recreates the session data cache.

Delete the ClassCache Version File. Deletes the class cache version files for JSP. when you apply this change, the version file is deleted immediately. The next time the server starts up, it deletes the JSP class cache and recreates the version file. The next time the server serves a JSP, it recreates the class cache if necessary.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

• The Create a Trust Database Page (Server Manager)
• The Request a Server Certificate Page (Server Manager)


• The Install a Server Certificate Page (Server Manager)


• The Change the Key Pair File Password Page (Server Manager)


• The Manage Server Certificates Page (Server Manager)


• The Migrate a 3.x Cert Page (Server Manager)

Database Password. Specifies the certificate database password.

Password (again). Confirms the password specified in the Database Password field. If what you enter is different from what you entered in the Database Password field, you will be prompted to try again.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

New certificate. Specifies that the certificate being requested is new.

Certificate renewal. Specifies that the certificate being requested is a renewal of an existing certificate.

List of available certificate authorities. Lists the certificate authorities from which you can get server certificates.

Submit to Certificate Authority via. Specifies the manner in which to submit the certificate request. If you wish to contact the certificate authority via email, select CA Email Address and enter the email address in the field.

Select the module to use with the Certificate. Specifies one of the following:

• Cryptographic Module. Specifies the module to be used with the certificate.
• Key Pair File Password. Specifies the certificate database password.

Requestor name. Specifies the name under which the certificate will be issued.

Telephone number. Specifies the telephone number of the requestor.

Common name. Specifies the fully qualified hostname used in DNS lookups (for example, www.iplanet.com). This is the hostname in the URL that a browser uses to connect to your site. It is important that these two names are the same. Otherwise, a client is notified that the certificate name does not match the site name, which often makes uses doubt the authenticity of your certificate.

Email address. Specifies the business email address used for correspondence between you and the CA.

Organization. Specifies the official, legal name of your company, educational institution, organization, and so on. Most CAs require that you verify this information with legal documents (such as a copy of a business license).

Organizational Unit. Specifies a description of an organizational unit within your company. This field is optional.

Locality. Specifies a description of the city, principality, or country for the organization. This field is optional.

State or Province. Specifies the state or province in which the business is located.

Country. Specifies the two-character abbreviation of your country name (in ISO format). The country code for the United States is US.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Certificate For. Specifies where the certificate will be used. Select from the following options:

• This Server. Specifies that the server will use the key-pair file password you specify to decrypt the certificate when you install it.
• Server Certificate Chain. Allows the SSL connection to continue at the client's discretion when the client does not recognize the certificate's CA. Certificate chaining is the process of presenting your CA's certificate in addition to your own. If the client trusts the CA who issued the certificate to your CA, the transaction will continue. In this way, a chain of trust is created: the client trusts the second CA, who trusts the first CA, who trusts you. Therefore, the client trusts you.
• Trusted Certificate Authority (CA). Accepts the certificate of a CA as a trusted CA for client authentication.

Select the module to use with the Certificate. Specifies one of the following:

• Cryptographic Module. Specifies the module to be used with the certificate.
• Key Pair File Password. Specifies the certificate database password.

Certificate Name. Specifies the common name of the certificate. Enter the certificate name only if it differs from the fully qualified hostname of your server used in DNS lookups (for example, www.iplanet.com).

Message is in this file. Specifies the file that contains the CA certificate.

Message text (with headers). Contains the content of the CA certificate. If you copy and paste the text, be sure to include the headers "Begin Certificate" and "End Certificate."

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Old Password. Specifies the current key pair password.

New Password. Specifies the new key pair password.

Password (again). Confirms the password specified in the New Password field. If what you enter in this field is different from what you entered in the New Password field, you will be prompted to try again.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Certificate Name. Specifies the name of the certificate authority.

Type. Specifies the type of certificate.

Expires (Time in UTC). Displays the date and time that the certificate expires. Once a certificate has expired, you must renew it to use it again.

Help. Displays online help.

3.6 Server Root. Specifies the server root of Netscape Enterprise Server 3.6.

Alias. Specifies the alias mapped to the key-pair file and certificate file you associated it with in the Administration Server.

Password. Specifies the certificate key-pair password.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

• The View Access Log Page
• The View Error Log Page


• The Monitor Current Activity Page


• The Archive Log Files Page


• The Log Preferences Page


• The Generate Report Page


• The SNMP Configuration Page


• The SNMP Subagent Control Page (Unix/Linux)

• About Log Files
• Viewing an Access Log File

View this logfile. Specifies which log file to display. Active log files for resources and archived log files appear in the drop-down list.

Number of entries. Specifies the number of entries to retrieve (starting with the most recent).

Only show entries with. Specifies a string or a character to filter the log entries. Case is important; the case of the string or character specified in this field must match the case of the entry in the access log. For example, if you want to see only access log entries that contain POST, type "POST."

OK. Displays the log entries in the lower section of this page.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Last number accesses to access. Displays the access log entries with the parameters specified in the upper section of this page.

• About Log Files
• Viewing the Error Log File

Number of errors to view. Specifies the number of entries to retrieve (starting with the most recent).

Only show entries with. Specifies a string or a character to filter the log entries. Case is important; the case of the string or character specified in this field must match the case of the entry in the error log. For example, if you want to see only those error messages that contain warning, type "warning."

OK. Displays the log entries in the lower section of this page

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Last number errors. Displays the error log entries with the parameters specified in the upper section of this page.

• Bad requests. Total number of requests that are not processing successfully.
• 2xx. Total number of status codes ranging from 200 to 299 that the server is handling.
• 3xx. Total number of status codes ranging from 300 to 399 that the server is handling.
• 4xx. Total number of status codes ranging from 400 to 499 that the server is handling.
• 5xx. Total number of status codes of 500 and higher that the server is handling.
• xxx. Total number of 2xx, 3xx, 4xx, and 5xx status codes the server is handling minus timeouts and other errors that did return an HTTP status code
• 200. Total number of successful transactions the server is processing.
• 302 (Redirects) status codes. Total number of redirected URL status codes the server is processing because the original URL moved.
• 304 (Not Modified) status codes. Total number of requests for which the requesting client used a local copy of the requested document, rather than retrieving it from the server.
• 401. Total number of unauthorized requests the server is handling.
• 403. Total number of forbidden URL status codes the server is handling.

Help. Displays online help.

Internal daemon log rotation. Specifies whether to use iPlanet Web Server internal system daemon log settings for log rotation.

• rotation start time. Specifies the time used as a basis to rotate log files and start a new log file. For example, if the rotation start time is 12:00 a.m., and the rotation interval is 1440 minutes (one day), a new log file will be created immediately upon save regardless of the present time and collect information until the rotation start time. The log file will rotate every day at 12:00 a.m., and the access log will be stamped at 12:00 a.m. and saved as access.24Apr-12AM. Likewise, if you set the interval at 240 minutes (4 hours), the 4 hour intervals begin at 12:00 a.m. such that the access log files will contain information gathered from 12:00 a.m. to 4:00 a.m., from 4:00 a.m. to 8:00 a.m., and so forth.
• rotation interval (minutes). Specifies the number of minutes until the next log rotation when a new log file is started. You must specify an interval of at least 30 minutes or more.

Cron based log rotation. Specifies whether to use the operating system's cron (or job scheduling) facility to schedule log archiving.

• Archive the log files now. Archives the log file that is currently being written to and restarts the server when you click Archive. Note that clicking "Archive the log files now" archives both the access and error logs.
• rotate log at. Specifies the time and day of the week on which log archiving will occur. To select multiple times, hold the Control key when clicking on the time.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Editing. Specifies a resource to which custom logging is applied. If you choose a directory, custom logging applies only when the server receives a URL for that directory or any file in that directory.

Browse. Allows you to browse your file system.

Wildcard. Specifies a wildcard pattern. For information on using wildcard patterns, see Wildcards Used in the Resource Picker.

Log client accesses. Specifies whether to include client accesses in your log files.

Log File. Specifies the absolute path for the access log file. As a default, the log files are kept in the logs directory in the server root. If you specify a partial path, the server assumes the path is relative to the logs directory in the server root.

Record. Specifies whether the server should record domain names or IP addresses of the systems accessing the server in the access log.

Format. Specifies which type of log file format to use in the access log. You can select from the following:

• Use Common Logfile Format. Includes client's host name, authenticated user name, date and time of request, HTTP header, status code returned to the client, and content length of the document sent to the client, or
• Only Log. Allows you to choose which information will be logged. You can choose from the following:

• Client hostname. The hostname (or IP address if DNS is disabled) of the client requesting access.
• Authenticate user name. If authentication was necessary, you can have the authenticated user name listed in the access log.


• System date. The date and time of the client request.


• Full request. The exact request the client made.


• Status. The status code the server returned to the client.


• Content length. The content length, in bytes, of the document sent to the client.


• HTTP header, "referer". The referer specifies the page from which the client accessed the current page. For example, if a user was looking at the results from a text search query, the referer would be the page from which the user accessed the text search engine. Referers allow the server to create a list of backtracked links.


• HTTP header, "user-agent". The user-agent information—which includes the type of browser the client is using, its version, and the operating system it's running on—comes from the User-agent field in the HTTP header information the client sends to the server.


• Method. The HTTP request method used (GET, PUT, POST, etc.).


• URI. Universal Resource Identifier. The location of a resource on the server. For example, for http://www.a.com:8080/special/docs, the URI is special/docs.


• Query string of the URI. Anything after the question mark in a URI. For example, for
  http://www.a.com:8080/special/docs?find_this, the query string of the URI is find_this.


• Protocol. The transport protocol and version used.

Custom Format. Allows you to create a customized format for your access log. For more information about the parameters you should use for your custom format, see theonline documentation web site at http://www.iplanet.com/docs

Do not log client accesses from. Specifies the hostnames and the IP addresses whose accesses will not be logged.

• Hostnames. Specifies all hostnames from which your server will not log client accesses. You can use a wildcard pattern to signify which hosts to leave out of the access log. For example, use *.iplanet.com if you do not want to log accesses from the domain iplanet.com.
• IP Addresses. Specifies all IP addresses from which your server will not log client accesses. You can use a wildcard pattern to signify which IP addresses to leave out of the access log. For example, use 208.12.* if you do not want to log access from IP addresses beginning with 208.12.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Server name. Specifies the name of the server for which to generate the report.

Output type. Specifies whether the report should be output to an HTML file or to a plain text (ASCII) file.

Log File. Specifies the log file or files to generate the report from. To select more than one file, hold the Control key when clicking on the file.

Output file. Specifies the absolute path to where the report should go. If you leave this field blank, the analyzer displays the results on the screen. For large log files, you should save the results to a file because displaying the output on the screen may take a long time.

Totals. Specifies whether you want to generate totals for statistics. Choose "Do not generate totals" if you do not want to generate totals for statistics. If you choose to generate totals, specify the items from the following list for which you would like to generate totals:

• Total hits. Number of requests the server received since access logging was enabled.
• 304 (Not Modified) status codes. Number of times the requesting client used a local copy of the requested document, rather than retrieving it from the server.
• 302 (Redirects) status codes. Number of times the server redirected to a new URL because the original URL moved.
• 404 (Not Found) status codes. Number of times the server could not find the requested document or the server did not serve the document because the client was not an authorized user.
• 500 (Server Error) status codes. Number of times server-related error occurred.
• Total unique URL's. Number of unique URLs accessed since access logging was enabled.
• Total unique hosts. Number of unique client hosts who have accessed the server since access logging was enabled.
• Total kilobytes transferred. Number of kilobytes the server transferred since access logging was enabled.

General Statistics. Specifies whether to generate general statistics. Choose "Do not generate general statistics" if you do not want to generate general statistics. If you choose to generate statistics, choose from the following:

• Find top number seconds of log. Generates statistics based on information from the most recent number of seconds.
• Find top number minutes of log. Generates statistics based on information from the most recent number of minutes.
• Find top number hours of log. Generates statistics based on information from the most recent number of hours.
• Find number users (if logged). Generates statistics based on information from the number of user.
• Find top number referers (if logged). Generates statistics based on information from the number of referers.
• Find top number user agents (if logged). Generates statistics based on information from the number of agents.You can create predefined agents that run on the server and bring information back to you, such as email notification that a specific document has changed.
• Find top number miscellaneous logged items (if logged). Generates statistics based on information from the number of user.

Generate Lists. Specifies whether to generate lists. Choose Do not generate any list if you do not want to generate any lists. If you choose to generate lists, specify the items from the following list for which you would like to generate lists:

• number most commonly accessed URL. Displays the most commonly accessed URLs or URLs that were accessed more than a specified number of times.
• URLs that were accessed more than number times. Displays the URL that were accessed more times than the number specified.
• number hosts most often accessing your server. Displays the hosts most often accessing your server or hosts that have accessed your server more than a specified number of times
• Hosts that accessed your server more than number times. Displays the hosts that accessed your server more times than the number specified.

Output Order. Specifies the order of the output. Prioritize the following items from 1 to 3 in the order that you would like each section to appear in the report. If you chose to not generate any of them, the section will automatically be left out.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Description. Specifies the description of the server (including operating system information).

Organization. Specifies the organization responsible for the server.

Location. Specifies the absolute path for the server.

Contact. Specifies the person responsible for the server and the person's contact information.

Enable SNMP Statistic Collection. Specifies whether the SNMP statistic collection is enabled.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Start. Start the SNMP subagent for this server instance.

Stop. Stops the SNMP subagent for this server instance.

Restart. Stops and then starts the SNMP subagent for this server instance.

• The Create a New Style Page
• The Remove a Style Page


• The Edit a Style Page


• The Assign a Style Page


• The List Assignments Page

Style Name. Specifies the name of the style you are creating.

OK. Creates a new style with the specified name and displays the Edit a Style page so that you can configure the new style. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Remove. Specifies the name of the style to delete.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Style. Select a style from the drop-down list and Click Edit this style.

Edit. Click the configuration style category.

URL prefix wildcard. Specifies files or directories, or the wildcard pattern (for example, * gif). If you enter /* after the directory, the configuration style will be applied to all the directory's contents.

Style. Specifies the configuration style you want to apply. The None configuration style can be applied to files or directories to remove any configuration style previously applied to the resource.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Style Assignments. Lists all configuration style assignments

Pattern. displays files or directories, or the wildcard pattern, this style is applied to.

Style. Displays the name of the configuration style.

Edit this style. Click this link to edit or remove the configuration style assignment. Clicking this link takes you to the The Assign a Style Page. A Remove this Style link appears at the top of the page.

Help. Displays online help.

• The Primary Document Directory Page
• The Additional Document Directories Page


• The User Document Directories Page (Unix/Linux)


• The File Manipulation Page


• The Document Preferences Page


• The URL Forwarding Page


• The Hardware Virtual Servers Page


• The Software Virtual Servers Page


• The International Characters Page


• The Document Footer Page


• The Parse HTML Page


• The Cache Control Directives Page

Primary directory. Specifies the absolute path of the server's primary document directory.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

URL prefix. Specifies the URL prefix you want to map. For example, a mapped URL could be http://www.mozilla.com/marketing/index.html where marketing/ is the prefix you specify. Enter a nickname that maps the URL to the additional document directory you want to define such as the word, plans.

Map To Directory. Specifies the absolute path of the directory you want the URL prefix to map to, for example,
C:\Netscape\marketing\pubdocs\index.html.

Apply Style. Specifies a configuration style to apply to the additional directory's configuration.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Current Additional Directories. Displays all additional document directories on your server. To modify a directory's mapping, click Edit in the directory row. To delete a directory's mapping, click Remove in the directory row.

User URL Prefix. Specifies the URL prefix for the user directory (~ is the default).

Subdirectory. Specifies the user's subdirectory (public_html is the default).

Password File. Specifies whether you want the server to use the system's password file or a user file you have created to look up users.

• System file. Specifies the path to the system's password file.
• This file. Specifies the absolute path to user file.
• Load entire database on start-up. Specifies whether you want to load the entire password file on start-up.

Apply Style. Specifies the configuration style to apply to the additional directory's configuration.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Editing. Specifies a resource to which you want to enable remote file manipulation. If you choose a directory, the remote file manipulation applies only when the server receives a URL for that directory or any file in that directory.

Browse. Allows you to browse your primary document directory.

Wildcard. Specifies a wildcard pattern. For information on using wildcard patterns, see Wildcards Used in the Resource Picker.

Activate file manipulation commands. Determines whether remote file manipulation is enabled.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Index Filenames. Specifies the file your server will look for and display if a user does not specify a document name in a URL. The server assumes that this file is the index file. The default files are index.html and home.html. If you enter more than one file name in this field, the server looks for the files in the order they are listed in the field until it finds one. For example, if your index file names are index.htmland home.html, the server first searches for index.html, and if the server does not find the file, it then searches for home.html. You can specify any file as an index file for a directory by naming it one of these default names, which means you can also use a CGI program as an index if CGI is activated.

Directory Indexing. Determines what type of directory index to generate if the server cannot find one of the index file names specified in the Index Filenames field. The generated index has one of the following formats:

• Fancy. Fancy directory indexing includes a graphic that represents the type of file, the date the file was last modified, and the file size.
• Simple. Simple directory indexing displays directory entries as plain text hyperlinks and takes less time to generate than fancy indexing.
• None. This setting specifies that no dynamic directory listing be generated if the server looks for index files and cannot find any. If the server does not find any index files, it will not display a directory listing and will return an error message.

Home Page. Designates whether users will see a specified home page or an index file when they access your server. If you select Home Page, you must enter the URL of the home page in the field to the right of the radio button.

Default MIME Type. Specifies the default MIME type the server returns if a client accesses a file with an extension that has not been set up as a MIME type on your server.

Parse Accept Language Header. Determines whether the server should parse accept language headers. Accept language headers are headers sent by clients using HTTP 1.1. These headers contain information describing the languages the clients accept.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

URL prefix. Specifies the URL prefix you want to redirect. For example, if the URL you want to map is http://www.iplanet.com/info/movies, you'd type /info/movies in this field. This setting forwards requests to a URL prefix, keeping the absolute path, and substituting one prefix for another. For example, if you forward
http://www.iplanet.com/info/movies to a prefix mozilla.com, the URL http://www.iplanet.com/info/movies redirects to
http://mozilla.com/info/movies.

Forward requests to. Specifies the destination URL.

• URL prefix.
• Fixed URL. Specifies that the text in this field is a fixed URL. If the directory structure on the new server is not the same as the directory structure on the mapped URL, you could forward the URL to a fixed URL. For example, you could forward http://www.iplanet.com/info/movies to:

http://mozilla.com/new-files/info/movies.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

• Setting Up Hardware Virtual Servers
• Setting Up Hardware Virtual Servers for ISPs

IP Address. Specifies your server's IP address that you want to map to a specific document root.

Document Root. Specifies the document root to which the IP address is to be mapped.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Current Virtual Servers. Displays all virtual servers currently defined on your server. To modify a virtual server, click Edit in the virtual server row. To delete a virtual servers, click Remove in the virtual server row.

Edit the default home page. Click this link to edit the document preferences for the default home page.

URL host. Specifies the name of the URL host whose custom home page you want to set up.

Home page. Specifies the path to the home page you want to use for this virtual server. If you type an absolute path, the server uses that specific document. If you type a partial path, the server interprets it as relative to your primary document directory.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Current mappings. Displays all URL mappings currently defined on your server. To modify a URL mapping, click Edit in the URL mapping row. To delete a URL mapping, click Remove in the URL mapping row.

Editing. Specifies a resource to which you want to assign a character set. If you choose a directory, the character set applies only when the server receives a URL for that directory or any file in that directory.

Browse. Allows you to browse your primary document directory.

Wildcard. Specifies a wildcard pattern. For information on using wildcard patterns, see Wildcards Used in the Resource Picker.

Character set. Specifies the name of the character set to be used for the specified resource.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Editing. Specifies a resource to which you want to apply the document footer. If you choose a directory, the document footer applies only when the server receives a URL for that directory or any file in that directory.

Browse. Allows you to browse your primary document directory.

Wildcard. Specifies a wildcard pattern. For information on using wildcard patterns, see Wildcards Used in the Resource Picker.

For files of type. Specifies the type of files to include in the footer. The default is text/html.

Date Format. Specifies the date format.

Custom Date Format. Specifies a custom date format specified in the field to the right of the radio button.

Footer Text. Specifies the text that will appear in the footer. The maximum number of characters for a document footer is 765. If you want to include the date the document was last modified, type the string :LASTMOD:. Any entities (for example, &copy) are contracted after you save your changes.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Editing. Specifies a resource to which the server will parse HTML. If you choose a directory, the server will parse HTML only when the server receives a URL for that directory or any file in that directory.

Browse. Allows you to browse your primary document directory.

Wildcard. Specifies a wildcard pattern. For information on using wildcard patterns, see Wildcards Used in the Resource Picker.

Activate server-parsed HTML. Specifies whether server-parsed HTML is activated. The choices are:

• No. The server does not parse HTML.
• Yes, with exec tag. The server parses HTML and allows HTML files to execute arbitrary programs on the server.
• Yes, without exec tag. The server parses HTML, but does not allow HTML files to execute arbitrary programs on the server. You might not want to allow the exec tag for security or performance reasons.

Parse which files. Specifies which files the server will parse. The choices are:

• Files with the extension .shtml. The server parses only files with the extension .shtml. In this case, all files you want to parse must have the .shtml extension. This is the most common (and default) choice.
• All HTML files. The server parses all its HTML files. Choosing this option can slow your server's performance.
• Unix/Linux. Parse files whose Unix/Linux permissions specify that the execute bit is on. Using the execute permissions can be unreliable because some files that are not executable have the bit set.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

http://www.ietf.org/html.charters/http-charter.html

Editing. Specifies a resource to which you want to set cache-control directives. If you choose a directory, the server will set cache-control directives only when the server receives a URL for that directory or any file in that directory.

Browse. Allows you to browse your primary document directory.

Wildcard. Specifies a wildcard pattern. For information on using wildcard patterns, see Wildcards Used in the Resource Picker.

Cache Control Response Directives. Specifies what type of information is cachable. The choices are as follows:

• Public. The response is cachable by any cache. This is the default.
• Private. The response is only cachable by a private (non-shared) cache.
• No Cache. The response must not be cached anywhere.
• No Store. The cache must not store the request or response anywhere in nonvolatile storage.
• Must Revalidate. The cache entry must be revalidated from the originating server.
• Maximum Age (sec). The client does not accept a response that has an age greater than this age.

OK. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

• The Set Up Netshare Page
• The Create Netshare Page


• The Web Publishing State Page


• The Choose Web Publishing Language Page


• The Maintain Web Publishing Data Page


• The Unlock File Page


• The Add Custom Property Page


• The Manage Properties Page


• The Index and Update Properties Page

Netshare Document Root. Specifies the path for where the Netshare parent directory and all the individual Netshare home directories are located. The drop-down list displays the absolute path for all the document root directories defined for your server.

Netshare Parent Directory. Specifies the path for the Netshare parent directory that is to contain the individual Netshare home directories. By default, this is /netshare, so when you create the default Netshare home directory for a user, it is named the /netshare/userID directory. Netshare creates any directory in the path that does not exist.

Name of Template. Specifies the absolute path to the file that contains the names of the files used in creating the Netshare home pages. The default is netshare.lst, which is located in server_root/bin/https/admin/html.

Save. Saves your entries. You must click Apply on the top right side of the page for your changes to take effect. If you do not click Apply after you update information, your changes are retained so that you can view and edit it, even though the changes have not taken effect.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Create Netshare For. Specifies the type of Netshare account. You can create the following types of accounts:

• A single user. Marks the user as licensed if not yet marked as such, creates the user's Netshare home directory, and assigns ownership of the files and folders in that directory to the user ID that was specified. If you attempt to create a home directory that already exists, you receive an error message.
• A group. Marks the group's owner as a licensed user if not yet marked as such, creates the group's Netshare home directory, and assigns ownership of the files and folders in that directory to the owner's user ID. This also gives all users in the group read-write access permission for all files and folders in the home directory. If you attempt to create a home directory that already exists, you receive an error message.This restarts the server because you have added a new ACL, granting special access to the members of the group. When you add a single user's Netshare, the default ACL is sufficient.
• All users marked as licensed. Searches through the local or LDAP user directory for your server and creates a Netshare home directory for each user who has been marked as licensed but who does not yet have a Netshare directory. If you attempt to create a home directory that already exists, you receive an error message.

User ID or Group Name. Specifies the user ID (if this account is for a single user) or the group name (if this account is for a group).