eFix (APAR): pq47372
Status: efix

For Release: WebSphere 3.5.3

For Operating System: Solaris only

Supercedes eFixes: N/A

CMVC defect: pq47372

Byte size of APAR: 535KB 

Date: 6/5/01

Abstract: Enhancement in dispatching algorithm for the Web server plugin; Added caching of clone IP addresses.

Description/sypmtom of problem:

- Enhancement in dispatching algorithm for the Web server plugin
- Added caching of clone IP addresses (performance improvement)

DIRECTIONS TO APPLY EFIX:

1) Stop the Web Server(s).
2) Stop all WebSphere clones
3) Stop WebSphere Admin Server and Nanny process
4) Verify that all java processes are stopped
5) Save the old versions of the affected "*.so" files in /opt/WebSphere/Appserver/bin
6) Copy the new *.so files into /usr/WebSphere/AppServer/bin
7) Restart the web server(s) and restart WebSphere AdminServer


ADDITIONAL INFORMATION:


Notes on configuration parameters:
----------------------------------
a. In bootstrap.properties file the parameter ose.refresh.interval specifies
   how often the properties files are checked for any changes. For production
   environments this should be increased from the default of 20 seconds.
   (suggested value greater than 60)

b. In bootstrap.properties file the parameter ose.failure.retry_timer specifies
   how often clones should be re-checked after an error condition. When an
   error is detected on a clone, new requests are not sent to it until this
   timer expires. Any down clones will also be checked after the propreties
   files have been re-loaded, as controlled by a) above. (suggested value 20)

c. The clone selection can be configured to be random by adding a parameter 
   to the queues.properties file as follows (example is for queue ibmoselink): 
   ose.srvgrp.ibmoselink.clone.selection=RANDOM. If this parameter is not 
   specified it will default to round-robin clone selection.


The following files are included in the fix:
--------------------------------------------
    libascommon.so
    libascommonst.so
    libasoutc.so
    libasoutcst.so
    libasoutsj.so
    libdomino.so
    libdomino5.so
    libgo46.so
    libns35.so
    libns36.so
    libns40.so
    libstubj.so
    mod_app_server.so
    mod_ibm_app_server.so
    
Notes on configuration parameters:
----------------------------------
a. In bootstrap.properties file the parameter ose.refresh.interval specifies
   how often the properties files are checked for any changes. For production
   environments this should be increased from the default of 20 seconds.
   (suggested value greater than 60)

b. In bootstrap.properties file the parameter ose.failure.retry_timer specifies
   how often clones should be re-checked after an error condition. When an
   error is detected on a clone, new requests are not sent to it until this
   timer expires. Any down clones will also be checked after the propreties
   files have been re-loaded, as controlled by a) above. (suggested value 20)

c. The clone selection can be configured to be random by adding a parameter 
   to the queues.properties file as follows (example is for queue ibmoselink): 
   ose.srvgrp.ibmoselink.clone.selection=RANDOM. If this parameter is not 
   specified it will default to round-robin clone selection.


Notes on running two iPlanet 4.1 web servers on same host:
----------------------------------------------------------
a. Under the /usr/WebSphere/AppServer directory, create three new directories:
   props2, temp2 and logs2. Copy the contents of properties to props2, and
   the contents of temp to temp2. Make sure all the directories under 
   /usr/WebSphere/AppServer have full permissions (777).

b. In the obj.conf file of one of the iPlanet web servers, specify the file
   /usr/WebSphere/AppServer/properties/bootstrap.properties. For the other 
   iPlanet web server, change it's obj.conf file to use the other copy at
   /usr/WebSphere/AppServer/props2/bootstrap.properties.

c. In the file /usr/WebSphere/AppServer/props2/bootstrap.properties change
   the parameter ose.tmp.dir=/usr/WebSphere/AppServer/temp2

d. In the file /usr/WebSphere/AppServer/props2/bootstrap.properties change
   the parameter ose.logs.dir=/usr/WebSphere/AppServer/logs2