MicroStrategy ONE
Configure Session Recovery Message Sharing in a Cluster
In a clustered Intelligence Server environment, additional configuration is required for the cluster nodes to be able to share Session Recovery functionality for sessions that existed on other cluster nodes. This configuration is similar to the configuration required to share caches, cubes, and history list messages. The repository can be located either locally or in a shared network location. In localized storage, each cluster node will retain the recovery files for sessions hosted by that node. The file location will be shared to the other cluster nodes so that each node can access other node's recovery files. In centralized storage, all cluster nodes will store their repository files in a central shared network location.
Configure Session Recovery Message Repository Sharing in a Cluster on Windows
The domain user running the remote Intelligence Servers must have full read and write access to this shared location.
Shared network locations should be set up before configuring the Intelligence Servers for centralized storage.
Shared network locations should be accessible via a Universal Naming Convention (UNC) path, in the format of \\machinename\path
.
Configure Session Recovery Messages for Localized Storage
- Open the Intelligence Server Configuration Editor.
- Select Governing Rules > Default > Temporary Storage Settings.
-
In the Session Recovery and Deferred Inbox storage directory box, enter
.\inbox\
ServerDefinition
whereServerDefinition
is the name of the server definition. - Click OK.
- Right-click the configured path file folder, and select Sharing.
- On the Sharing tab, select the Shared as option. In the Share Name box, delete the existing text and type
ClusterWSRM
.This folder must be shared with the name "ClusterWSRM". This name is used by Intelligence Server to look for Session Recovery messages on other nodes.
- Click OK.
- Restart Intelligence Server.
Configure Session Recovery Messages for a Centralized Storage Location
- Open the Intelligence Server Configuration Editor.
- Select Governing Rules > Default > Temporary Storage Settings
-
In the Session Recovery and Deferred Inbox storage directory box, enter:
Copy\\<Machine Name>\<Shared Folder Name>
or
Copy\\<IP Address>\<Shared Folder Name>
- Click OK.
Configure Session Recovery Message Repository Sharing in a Cluster on UNIX/Linux
The domain user running the remote Intelligence Servers must have full read and write access to this shared location.
Shared network locations should be set up and mounted to the local file system on each Intelligence Server before configuring for centralized storage.
Configure Session Recovery Messages for a Centralized Storage Location
Create the Session Recovery Folder on the Shared Device
-
Create the folders for Session Recovery messages on the shared device:
Copymkdir /sandbox/WSRMshare
- Restart your Intelligence Servers.
Configure the Server Definition and Project
- Right-click the project source and select Configure Server.
- Select Governing Rules > Default > Temporary Storage Settings.
-
In the Session Recovery and Deferred Inbox storage directory box, set the path using the following convention:
Copy//<machine_name>/sandbox/WSRMshare
- Click OK.
- Repeat for each Intelligence Server.
Configure Session Recovery Messages for Localized Storage
This procedure makes the following assumptions:
- The Linux machines are called UNIX1 and UNIX2.
- Intelligence Server is installed in
MSTR_<HOME_PATH>
on each machine. - The
MSTR_<HOME_PATH>
for each machine is/Build/BIN/SunOS/
.
Configure the Server Definition and Project
- Start Intelligence Server on UNIX 1.
- In Developer, create project sources pointing to UNIX1 and UNIX2.
- Connect to UNIX1 using Developer.
- Right-click the project source of UNIX1 and select Configure Server.
- Select Governing Rules > Default > Temporary Storage Settings
- Set the path to
./ClusterInBox
in the Session Recovery and Deferred Inbox storage directory - Click OK.
Set Up the UNIX1 Machine
-
Create a top level folder /UNIX2.
Copymkdir /UNIX2
- In this folder create a sub folder ClusterInBox
-
Mount the folders from UNIX2 on the UNIX1 machine using the following command:
Copymount UNIX2:/Build/BIN/SunOS/UNIX2/ClusterInBox