Micro Focus recommends that you configure your
Performance and Availability Cluster (PAC) using ESCWA. The
PAC and
Scale-Out Repository (SOR) environment variables are documented for reference purposes only.
All enterprise server instances that are part of a
PAC need to have the following environment variable set:
ES_PAC=pacname
Each
SOR within a
PAC needs a specific environment variable set:
ES_SCALE_OUT_REPOS_n=sorName=sorType,connectionDetails##[TMP#][models]
Note: The same environment variable must be specified on each region that joins a
PAC. Only one environment variable can reference the
PAC Scale-Out Repository (PSOR), as only one
PSOR can be associated with any given
PAC.
where:
- n
-
This is the
SOR number and can be a value 1 to 9.
-
sorName
- This is the name of the
SOR and must not contain spaces.
In the context of using Redis, the
sorName is used to retrieve the Redis master from Redis.
- sorType
- This is the type of data store being used. Currently, Redis is the only supported
SOR type.
-
connectionDetails
- This is the host name and port number of the scale out repository, in the form
host:port. For example,
localhost:6379. You can specify multiple connections by using a comma as a delimiter between each connection.
- TMP
- Indicates that this is a
PSOR that stores active resources.
Note: You must specify exactly one
PSOR for each enterprise server instance within a
PAC and each enterprise server instance in the
PAC must use the same
PSOR.
- models
- Take the form:
=ResourceType=model[:model][#ResourceType=model[:model]]
where:
- #
- Delimits the set of models for a model type.
- ResourceType
- The resource type can be Temporary Storage (TS) or Transient Data (TD). Permitted values are TS and TD.
- model
- Specified as a string between 0-16 bytes long. TD names can only be four characters long. TS names can be up to 16 characters
long. The string names support the use of the following wildcards:
- *
- Matches any string of characters.
- +
- Matches any one character.
Note: Trailing + wildcards are used to pad missing characters appropriate for the resource type. For example, if you are specifying
a model for a TD resource type and only specify a single letter "A" then it is treated as "A+++".
- :
- Delimits between each model.
Examples
The following is an example of the ES_SCALE_OUT_REPOS_n environment variable:
ES_SCALE_OUT_REPOS_1=RedisLocal=redis,127.0.0.1:12345##TMP#TD=AC*:TD*:RTDQ:SOR1#TS=A*:B+A:NRQSOR1
where:
- RedisLocal
- This specifies the name that will be used by Redis to identify the Redis master in a sentinel configuration.
- redis
- This specifies that Redis is the type of
SOR being used.
- 127.0.0.1:12345
- This specifies the Redis server connection details: ip address and port for this
SOR.
- ##TMP#
- This specifies that this
SOR is the mandatory
PSOR.
- TD=AC*:TD*:RTDQ:SOR1#TS=A*:B+A:NRQSOR1
-
This specifies that the SOR will contain TDs starting with AC, TD, and a TD called RTDQ as well as all TSs starting with an A, those starting with a
B followed by any character and ending with an A, and a TS called NRQSOR1.
The following is an example of how you can specify more
SORs on a
PAC
ES_SCALE_OUT_REPOS_2=RedisLocal2=redis,127.0.0.1:67891##TD=ATD#TS=T*R2:R*R2
where:
-
RedisLocal2
- This specifies the name that will be used by Redis to identify the Redis master.
- redis
- This specifies that Redis is the type of
SOR being used.
-
127.0.0.1:67891
- This specifies the connection details for a second Redis server: ip address and port for this
SOR.
- ##TD=ATD#TS=T*R2:R*R2
- This specifies that the
SOR will contain a TD called ATD, as well as TS that start with T and end with R2, and that start with R and end with R2.