Sun Java System Web Proxy Server 4.0.2 2005Q4 Release Notes

Known Issues

This section lists the more important known issues and limitations at the time of the Sun Java System Web Proxy Server 4.0.2 release. The issues are listed by category:

Administration

The following table lists the known issues related to the administration user interface.

Table 5 Known Issues in Administration

ID  

Summary  

6213012 

ROTATELOGS event on Windows is not triggered at the time specified. 

6213014 

RESTART event on Windows is not triggered at the time specified. 

6213017 

RECONFIG event on Windows is not triggered at the time specified. 

6224535 

The timeout and retries parameters for the HTTP client cannot be configured through the administration interface.

Workaround

The default value for the timeout parameter is five minutes and can be overridden by including the parameter, timeout= number of seconds in the http-client-config SAF of the obj.conf file.

The default value for the retries parameter is three. The number of request retries can be configured by including the parameter retries=number of retries in the http-client-config SAF of the obj.conf file.

The effective timeout is timeout x retries

6231297 

The Restart Required link disappears if changes are made to the SOCKS configuration and the Proxy Server is restarted instead of the SOCKS Server. 

6241978 

There maybe errors while accessing the administration interface on Windows. 

Workaround

Ensure that the system32 directory on your system contains libnspr4.dll of version 4.5.1 or later else, copy the file from the %install_dir%\\bin\\proxy\\bin directory into the system32 directory and restart the administration server.

6303619 

An ACL with a database that is registered with a name other than default does not work properly.

Workaround

Add a new element, USERDB id=xyz in the proxy server instance server.xml file.

6328678 

Cannot set ICPtimeout value to less than 400 milli seconds through the administration interface. Workaround

Edit the icp.conf file of the proxy instance to change the value of the timeout parameter.

Caching

The following table lists the known issues related to caching.

Table 6 Known Issues in Caching

ID  

Summary  

6229823 

When a new partition is added a default section s0.0 is also created irrespective of the partition size. Warning messages are logged in the errors file. 

Workaround

Use the cbuild utility to add the new partition or delete the s0.0 folder under the new cache partition, and restart the proxy server.

The error messages can be ignored. 

6275141 

The File Cache feature is shown in the GUI and documented for the Server Manager > Caching > Configure File Cache page, but the feature is not implemented. 

6289188 

When you install proxy server 4.0 as non-root user and administration server as root user, any changes you make to the cache settings in the administration user interface result in the permissions for cache file and cache directory changing from non-root to root.  

Workaround

After changing the cache settings in the administration user interface, login to the machine and apply chown -R command on the proxy cache directory.

Documentation

The following table lists the known issues related to documentaion.

Table 7 Known Issue in Documentation

ID  

Summary  

6313959 

In the Proxy Server 4.0.2 Administration Guide, in Chapter 12, the section “To configure the file cache” provides wrong description for step 1. The correct description is, “From the Server Manager, click the Caching tab”.

6313960 

In the Proxy Server 4.0.2 Administration Guide, in Chapter 12, the section “To create a batch update” includes step 10 that refers to a “Timing section”. This step is an error. The Set Cache Batch Updates page does not have a Timing section.

6316289 

In the Proxy Server 4.0.2 Administration Guide, in Chapter 12, the section “Building the Cache Directory Structure” includes an example that refers to figure 12-1 instead of 12-2.

6331044 

In the Proxy Server 4.0.2 Administration Guide, in the preface, the section “Using the Documentation” specfies the location of the Proxy Server 4 documentation.

http://docs.sun.com/app/docs/prod/s1.webproxys#hic

The section should point to Proxy Server 4.0.2 documentation at: http://docs.sun.com/app/docs/coll/1311.2

6331050 

In the Proxy Server 4.0.1 Administration Guide, in Chapter 1, the section “New in This Release” specfies the location of the Proxy Server 4 Release Notes.

http://docs.sun.com/app/docs/prod/s1.webproxys#hic

The section should point to Proxy Server 4.0.2 Release Notes at : http://docs.sun.com/app/docs/coll/1311.2

6350957 

In the Proxy Server 4.0.2 Administration Guide, in Chapter 5, the section “Enabling Security for Listen Sockets” does not mention that security can only be enabled in reverse proxy mode and not in forward proxy mode.

Also, in Chapter 8, the section “Specifying Users and Groups” does not mention that security can only be enabled in reverse proxy mode and not in forward proxy mode. 

6295286 

In the Proxy Server 4.0.2 Administration Guide, in Chapter 14, the section “Setting up a Reverse Proxy” needs to note in Step 5 that the “/” mapping is added only if the user doesn't change the contents of the “Map Source Prefix” text box provided automatically by the Administration GUI.

Installation

The following table lists the known issues related to installation.

Table 8 Known Issues in Installation

ID  

Summary  

6205683 

Windows console installation fails. 

6255325 

The installer throws an exception and the installation fails on Linux if the user installs the Proxy Server as a non-root user and the /var/opt/sun/install directory does not exist.

6353576 

Silent upgrade installation does not work. 

Internationalization

The following table lists the known issues related to internationalization.

Table 9 Known Issues in Internationalization

ID  

Summary  

6233080 

The Disable Proxying option does not work for the URL with multibyte data (URL encoded) when routing is set through another proxy server. 

6233090 

A URL with multibyte data (URL encoded) cannot be mapped. 

6233093 

A filter cannot be created for a URL with multibyte data (URL encoded). 

6233100 

Multibyte strings from the page being retrieved cannot be rewritten. 

6246562 

Controlling a set of servers installed on different locales and platforms through clusters fails when stopping the set of servers. 

Workaround

Stop each server individually. 

6253844 

Online Help is not displayed when zh-cn is specified as one of the preferred languages for Simplified Chinese in the browser. 

Workaround

Specify zh-cn as the only preferred language for Simplified Chinese in the browser. 

6300615 

The meta tag is missing in localized core messages. 

Monitoring

The following table lists the known issues related to monitoring.

Table 10 Known Issues in Monitoring

ID  

Summary  

6268536 

SNMP on Windows does not work if the libnspr4.dll file is not present in the system32 directory.

Workaround

Ensure that the system32 directory on your system contains libnspr4.dll of version 4.5.1 or later else, copy the file from the %install_dir%\\bin\\proxy\\bin directory into the system32 directory and restart the administration server.

SOCKS

The following table lists the known issues related to SOCKS.

Table 11 Known Issues in SOCKS

ID  

Summary  

6245453 

The Quench Updates feature is shown in the GUI and documented for the Server Manager > SOCKS > Configure SOCKS v5 page, but the feature is not implemented. 

6263389 

No error is reported when two instances of SOCKS are started using the same port on Windows. 

6285791 

Cannot start SOCKS process by using command line. 

Workaround

Use administration GUI for starting SOCKS server.  

Or, set LD_LIBRARY_PATH with the required shared component locations. For example,

export LIBRARY_PATH=/usr/lib/lwp:/usr/lib/mps/secv1:/usr/lib/mps:/usr/lib/mps/sasl2:/opt/sun/private/lib:/opt/sun/private/share/lib:/opt/sun/lib:$LD_LIBRARY_PATH