Setting Up State Server Based on Redis

Information about installation and basic settings for Redis can be found at the project website http://redis.io/.

NOTE. It supports working with Redis 3.2.8 or earlier.

After installing the Redis application execute the following to set up the application to use as a state server:

1. In the redis.conf configuration file, in the "bind" parameter specify the external IP address, which will be monitored by Redis. This address must match the address, which is specified in the Host parameter of the BI server. This address is specified to grant access from the BI server only. By default, it is 127.0.0.1 if BI server and state server are located at the same workstation.

2. Specify state server parameters at the workstation with installed BI server. In Windows OS, settings are determined in the Settings.xml settings file or in registry. In Linux OS, settings are determined in the registry.reg or settings.xml files (for details about purpose and location of the files, see the Configuration and Setup subsection).
   In the Statable parameter select the Yes value. In the StateServer section specify state server parameters:

   • "Type"="Redis";

   • "Host"="IP address or state server workstation name", to which BI server sends requests to state server. If BI server and state server are located at the same workstation, then "localhost".

   • "Port"="-1". If the value is -1, the default port 6379 is used.

NOTE. To use state server, monikers must be generated by BI server via GUID (the KeyIncr parameter in settings must have 0 value).

The example of the settings.xml configuration file:

<Configuration>
  <Root>
    <Key Name="PP">
      <BIS>
        <Key Name="System">
          <Session KeyIncr="0" Statable="Yes" />
          <StateServer Host="state-server.sample.com" Port="6379" Type="Redis" />
        </Key>
      </BIS>
    </Key>
  </Root>
</Configuration>

See also:

Working with State Server