Sun Java System Web Server 6.1 2005Q4 SP5 Release Notes

Documentation and Online Help

The following table lists the known issues in Documentation and Online Help.

Table 13 Known Issues in Documentation

Problem ID 

Description 

6359385 

Administrator's Configuration File Reference should document the magnus.conf variable MaxKeepAliveConnections value range for 64–bit server.

Additional Information: magnus.conf MaxKeepAliveConnections directive values range from 0 - 1048576 for the 64-bit server.

6358849 

Administrator's Configuration File Reference should document the MaxOpenFiles attribute in the nsfc.conf configuration file.

Additional Information: Details of the MaxOpenFiles attribute are as follows:

  • Attribute: MaxOpenFiles

  • Default Value: 1024

  • Description: Limit on the number of cached open file descriptors.

4964908 

No documentation available regarding feature upgrades.  

5065188 

6173274 

Administrator's Guide incorrectly describes a Find menu Passage Search option in the Advanced Search section. This menu option is not available.

6155266 

Administrator's Guide incorrectly describes the config log level.

Correction: The Web Server config level should be defined as follows:

Message indicate a misconfiguration.

6206074 

Administrator's Configuration File Reference describes an incorrect default value for the ChildRestartCallback directive.

Correction: The default value is no directive.

6170766 

Installation and Migration Guide describes an incorrect method of upgrading a newer version of Web Server in the Before You Install Sun One Web Server section.

Correction: To upgrade Sun One Web Server 6.1, which is a part of the Sun Java Enterprise System 1, users must use patchadd.

6170769 

Administrator's Configuration File Reference has incorrect information about the AdminLanguage directive.

Correction: The AdminLanguage directive is only applicable to the language displayed in the log messages and not the GUI.

6173273 

Administrator's Guide has a typo error under section Choosing MIME Types.

Correction: The sentence should be read as follows: For more information, see the MIME Types page in the online help and Using Virtual Servers.

6173133 

NSAPI Programmer's Guide describes an incorrect example of a NSAPI Function Reference.

Correction: The example should be read as follows:

FilterMethods methods = FILTER_METHOD_INITIALIZED;

6173272 

Administrator's Guide incorrectly documents the supported version of Java as `1.4.1_03'.

Correction: Sun Java System Web Server supports Java 2 Platform, Standard Edition (J2SE) 1.4.2_04 and greater (32-bit only; 64-bit is not supported). J2SE software is bundled with the Web Server and installed during installation, if you choose to install it.

You can also install your own JDK at a later time, following installation of the Web Server. If you plan to use the Administration server, a JDK must be installed.  

5016571 

Online Help page under Generic Thread Pools gives invalid information.

5029460 

Administrator's Guide documents an incorrect certmap.conf configuration.

The description of certmap.conf in the guide contains the following text:

The first line specifies a name for the entry and the attributes that form the distinguished name found in the CA certificate. The name is arbitrary; you can define it to be whatever you want. However, issuerDN must exactly match the issuer DN of the CA who issued the client certificate. For example, the following two issuerDN lines differ only in the spaces separating the attributes, but the server treats these two entries as different:  

certmap sun1 ou=Sun Certificate Authority,o=Sun, c=UScertmap sun2 ou=Sun Certificate Authority,o=Sun, c=US

Correction: The two lines should be read as follows:

certmap sun1 ou=Sun Certificate Authority,o=Sun, c=UScertmap sun2 ou=Sun Certificate Authority, o=Sun, c=US

5031366 

Invalid links in the online version of Administrator's Guide

4968568 

Administrator's Configuration File Reference guide's description on the ConnQueueSize directive is not clear.

4975161 

Administrator's Configuration File Reference does not document the optional parameter `block-size' for pool-init.

5002190 

Administrator's Guide doesn't contain information about the htpasswd command utility.

Additional Information: The htpasswd command is used to generate or modify a password file suitable for use with the htaccess access control mechanism.

htpasswd Usage:

htpasswd [-c] passwordfile username [password]

-c creates a new password file.  

As noted, -c creates a new password file by overwriting an old one if it already exists. Without -c, the command will modify the existing file by either updating the user's password (if user already exists) or adding a new user with the given name.

If the optional password argument is not given, it will prompt interactively for the password to assign.  

Note that htaccess is not the preferred access control mechanism in Web Server. Wherever possible, use ACLs instead. 

5002192 

Administrator's Configuration File Reference has incorrect information about the loglevel attribute.

Correction: The loglevel description should be read as follows:

Controls the default type of messages logged by other elements to the error log. Allowed values are as follows, from highest to lowest: finest, finer, fine, info, warning, failure, config, security, and catastrophe. 

5020640 

NSAPI Programmer's Guide does not document the %duration% flex-log format variable.

5029321 

Administrator's Configuration File Reference documents the <Client uri="*foo*" uri="*~bar*"> directive incorrectly.

Correction: In some cases the evaluation can be rewritten to occupy a single evaluation statement:

<Client uri="*foo*~*bar*">.

It is functionally the same as  

<Client uri="*foo*" uri="~*bar*">.

5038534 

Administrator's Configuration File Reference has incorrect default value for the LogFlushInterval directive.

Correction: The correct default value for the LogFlushInterval directive is 2 seconds.

5043491 

Incorrect online help content. 

4781137 

Administrator's Guide has the following incorrect information:

  • The path where libdigest-plugin.ldif exist is not defined in the guide.

    Additional Information:libdigest-plugin.ldif is available at <server-root>/plugins/digest/libdigest-plugin.ldif.

  • Information to configure the Web Server to process digest authentication (set the digestauth property of the database definition in dbswitch.conf) is given without describing the procedure to do it.

  • libdigest-plugin.so is incorrectly mentioned as libdigest-plugin.lib.

  • Description of iplanetReversiblePassword is missing.

4823362 

Administrator's Guide needs to be updated with additional information regarding ACL.

Additional Information: If there are more than one ACLs that match, the server uses the last statement that matches. The default ACL is bypassed as the uri ACL is the last statement that matches.

4862795 

Administrator's Guide's description on the Archive Log File page is not clear.

Correction: The following note to be added to the document to make the description more clear: The user can archive or delete the old log files (this activity is not done by the Web Server).

5046588 

Installation and Migration Guide incorrectly documents the supported version of Sun accelerator hardware.

Correction: The supported version of Sun accelerator hardware is 500 and 1000.

5052605 

The NSAPI Programmer's Guide does not clearly specify that content-type needs to be in lower case.

5053339 

Online Help — Directory Indexing information is missing in Administrator's Guide and online help.

5062560 

Installation and Migration Guide does not document the method of disabling the start-on-boot option.

Additional Information: Users can disable the start-on-boot option as follows:

On Solaris and HPUX — Turn off by editing the S1WS_START_ONBOOT variable in the webserver01 script.

[Solaris] 

/etc/init.d/webserver01

[HPUX] 

/sbin/init.d/webserver01

On Linux — Delete the following links to disable it: 

/etc/rc.d/rc3.d/S75webserver01

/etc/rc.d/rc5.d/S75webserver01

6067059 

In Administrator's Guide any tags without content body should have `/' before the end `>' tag.

4928287 

All documents do not inform user the nonexistence of <instance>/lib directory.

Additional Information:This directory is not created by the installer. Users have to create the directory if it does not exist.

4970961 

Administrator's Configuration File Reference doesn't explain ChunkedRequestTimeout in detail.

6308091 

Administrator's Configuration File Reference — Wildcard pattern with tilde in ppath doesn't work as documented.

Correction: Users have to configure either of the followings:

Config 1

<Object ppath="*~*.gif*">AddLog fn=flex-log name="access"</Object>

Config 2

<Object ppath="*~*(.gif|.gif/)">AddLog fn=flex-log name="access" </Object>

6285234 

Administrator's Configuration File Reference incorrectly describes the default value of the StrictHttpHeaders directive as on.

Correction: The default value of the StrictHttpHeaders directive is off.

6067318 

Administrator's Configuration File Reference has insufficient information about the set-variable error parameter.

Correction: The description of the set-variable error parameter should be read as follows:

Sets the HTTP status code and aborts the request by returning REQ_ABORTED. To set the HTTP status code without aborting the request, use the set-variable error parameter along with the noaction parameter.

To rewrite an HTTP status code, use a <Client> tag to match the original status code and an Output directive to set the new status code. For example, the following would rewrite all 302 Moved Temporarily responses to 301 Moved Permanently responses: 

<Client code="302">Output fn="set-variable" error="301 Moved Permanently" noaction="true"</Client>

6281323 

Release Notes for Sun Java System Web Server 6.1 2005Q1 SP4 documents the incorrect version of Windows 2003 operating system.

Correction: The supported version of Windows 2003 for Web Server 6.1 SP4 is

Windows Server 2003, SP1 Enterprise Edition

6237209 

Release Notes for Sun Java System Web Server 6.1 2004Q3 SP3 doesn't include complete information regarding various RedHat Linux kernels.

6237303 

Release Notes for SUN ONE Web Server 6.1 does not list all patches that are required for Solaris SPARC.

Additional Information: 109326-09 is a required patch for Web Server 6.1 on Solaris 8.

6230379 

Administrator's Configuration File Reference incorrectly describes a remove-file() SAF.

Correction: The remove-file() is renamed to delete-file().

6208955 

NSAPI Programmer's Guide incorrectly documents the description of SERVER_SOFTWARE as MAGNUS_VERSION_STRING.

Correction: The NSAPI variable for SERVER_SOFTWARE is system_version().

4673436 

To have iWS recognize remote shares within Domain Controller environment. 

4841310 

Can't get REMOTE_USER variable when authenticated by .htaccess.

5059527 

Web Server configuration files and scripts are writable by webservd. 

6320016 

Administrator's Configuration File Reference doesn't clearly define the default value of listenQ on Windows.

Correction: The default value of listenQ on Windows is 200.