MACROMEDIA COLDFUSION MX-CLUSTERCATS, Use Manual

Page: 85 / 156

Persistent session failover in JRun 75
To enable session swapping on Windows:
1 Edit the registry (using regedit) and open the following key:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BrightTiger\
Parameters
2 Add the following
REG_DWORD
value:
SessionSwapping 1
3 Close the registry editor.
4 Repeat this procedure for every server in the cluster.
To enable session swapping on UNIX:
1 Log in as the super user (root).
2 Stop ClusterCATS by issuing the following command:
# /usr/lib/btcats/btadmin stop all
3 Edit the file
/usr/lib/btcats/database/bt.registry
with a text editor.
4 Search for the following string:
hkey_local_machine\system\currentcontrolset\services\brighttiger\
parameters:5
Under the following entry:
Advertise: 0x2; REG_DWORD
Add the following line:
SessionSwapping: 0x1 ; REG_DWORD
5 Save the file and exit your text editor.
6 Restart ClusterCATS with the following command:
# /usr/lib/btcats/btadmin start all
7 Repeat this procedure for every server in the cluster.
Using shared files for session swapping
To use file swapping, the JRun server's
local.properties
file should contain the
following properties:
session.persistence.service=file
session.persistence.file.class=allaire.jrun.session.FileSessionStorage
# See the following paragraph for more on this property.
session.persistence.file.path=/mnt/myothermachine/sessionpool
The
session.persistence.file.path
property must specify a shared path that all
computers can read and write to. For example, on UNIX, you must have server1 export
/
sessionpool
and server1's
file.path=/sessionpool
. Now server2 should mount
server1:/sessionpool
to some mount point — for example,
/mnt/sessionpool
—
and set server2’s
file.path=/mnt/sessionpool
. This assumes that server2 has write
permission.
Note: If JRun runs as an NT service, and you use a mapped drive, JRun does not have
permissions to write to the drive. To correct this problem, edit the properties for the JRun
Service and change the user account for the service to be a user with the necessary
privileges to write to the mapped drive.