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

  1. Open the Intelligence Server Configuration Editor.
  2. Select Governing Rules > Default > Temporary Storage Settings.
  3. In the Session Recovery and Deferred Inbox storage directory box, enter .\inbox\ServerDefinition where ServerDefinition is the name of the server definition.

  4. Click OK.
  5. Right-click the configured path file folder, and select Sharing.
  6. 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.

  7. Click OK.
  8. Restart Intelligence Server.

Configure Session Recovery Messages for a Centralized Storage Location

  1. Open the Intelligence Server Configuration Editor.
  2. Select Governing Rules > Default > Temporary Storage Settings
  3. In the Session Recovery and Deferred Inbox storage directory box, enter:

    Copy
    \\<Machine Name>\<Shared Folder Name>

    or

    Copy
    \\<IP Address>\<Shared Folder Name>

  4. 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

  1. Create the folders for Session Recovery messages on the shared device:

    Copy
    mkdir /sandbox/WSRMshare
  2. Restart your Intelligence Servers.

Configure the Server Definition and Project

  1. Right-click the project source and select Configure Server.
  2. Select Governing Rules > Default > Temporary Storage Settings.
  3. In the Session Recovery and Deferred Inbox storage directory box, set the path using the following convention:

    Copy
    //<machine_name>/sandbox/WSRMshare
  4. Click OK.
  5. 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

  1. Start Intelligence Server on UNIX 1.
  2. In Developer, create project sources pointing to UNIX1 and UNIX2.
  3. Connect to UNIX1 using Developer.
  4. Right-click the project source of UNIX1 and select Configure Server.
  5. Select Governing Rules > Default > Temporary Storage Settings
  6. Set the path to ./ClusterInBox in the Session Recovery and Deferred Inbox storage directory
  7. Click OK.

Set Up the UNIX1 Machine

  1. Create a top level folder /UNIX2.

    Copy
    mkdir /UNIX2
  2. In this folder create a sub folder ClusterInBox
  3. Mount the folders from UNIX2 on the UNIX1 machine using the following command:

    Copy
    mount UNIX2:/Build/BIN/SunOS/UNIX2/ClusterInBox

Set Up the UNIX2 Machine

  1. Create a top level folder /UNIX1.

    Copy
    mkdir /UNIX1
  2. In this folder create a sub folder ClusterInBox
  3. Mount the folders from UNIX2 on the UNIX1 machine using the following command:

    Copy
    mount UNIX2:/Build/BIN/SunOS/UNIX1/ClusterInBox