How to Change CloneSeparator
 Technote (FAQ)
 
Problem
How to change the Clone Separator from ":" to "+" for pervasive devices
 
Solution
WebSphere® Application Server V4.0 Advanced Edition: Scalability and Availability Page 459 (Appendix B)

The configuration file for the HTTP transport plug-ins is a single XML file. It is installed in the install_root/config directory by default and is normally named plugin-cfg.xml.
The location of the config file is configurable with all the Web servers supported except for Microsoft® IIS and Lotus® Domino Server. For these servers, the plugin-cfg.xml should be located as follows:

Lotus Domino Server

On NT/2000, the location of the config file is specified in the registry. The variable that is checked is HKEY_LOCAL_MACHINE/SOFTWARE/IBM/WebSphere Application Server/4.0/Plugin Config.

On UNIX™ platforms, the environment variable WAS_HOME is checked. If it is set, then /config/plugin-cfg.xml is appended to the value and that file must exist. If it is not set, it must exist at the default location.

On AIX®, this location is: /usr/WebSphere/AppServer/config/plugin-cfg.xml

On Solaris and HP-UX, this location is: /opt/WebSphere/AppServer/config/plugin-cfg.xml

Microsoft IIS

On NT/2000, the location of the config file is specified in the registry. The variable that is checked is HKEY_LOCAL_MACHINE/SOFTWARE/IBM/WebSphere Application Server/4.0/Plugin Config

A description and explanation of the CloneSeparatorChange applicable to the HTTP Transport plug-ins follows.

CloneSeparatorChange (WebSphere Application Server V4.0.2)
The plug-in expects the colon (:) character by default to separate the CloneIDs when using session affinity. Several pervasive devices did not work well with the colon, so by setting this attribute to true the plug-in will expect the separator to be the plus (+) character. In order to successfully use this, you must set the appropriate property in the application server JVM so that
the session manager uses the + character instead of the : character.

Default value:
False
Expected value:
True or false


Example for Default Clone ID separator
http://hostname/servlet/SessionSnoop;

jsessionid=0000RSBDPECORDN0ZL3ZIF3YALA:tpgp78i6

After Adding "CloneSeparatorChange" argument to JVM
http://hostname/servlet/SessionSnoop;

jsessionid=0000RSBDPECORDN0ZL3ZIF3YALA+tpgp78i6

How to Modify the JVM Settings

1. In the Admin Console select the Application Server to change (Ex: Default Server)
2. From the right side panel select "JVM Settings" tab
3. Under "System Properties" enter following

Name: CloneSeparatorChange
Value: True

4. Click on "Apply" button
5. Wait for Confirmation Message (Console Event Message)
6. Stop and Start the Application Server for the changes to be in effect.

 
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > Sessions and Session Management
Operating system(s): HP-UX
Software version: 4.0.3
Software edition:
Reference #: 1054494
IBM Group: Software Group
Modified date: Jun 11, 2003