The data server configuration is specified in
data-server-cluster element in the
appian-topology.xml file, located in both the
1 2 3 4 5 6 <topology> ... <data-server-cluster> <data-server host="machine1.example.com" port="5400" rts-count="2"/> </data-server-cluster> </topology>
For a high availability configuration, specify three instances of data server on different machines:
1 2 3 4 5 6 7 8 <topology> ... <data-server-cluster> <data-server host="machine1.example.com" port="5400" rts-count="2"/> <data-server host="machine2.example.com" port="5400" rts-count="2"/> <data-server host="machine3.example.com" port="5400" rts-count="2"/> </data-server-cluster> </topology>
data-server-cluster configuration is not specified in
appian-topology.xml, it will run on the first node of Kafka listed in the
kafkaCluster configuration. The
appian-topology.xml file must be copied from
<APPIAN_HOME>/data-server/conf/ before starting the data server. Copies of the topology file in each location must always be in sync, irrespective of the configurations specified.
host attribute in the
data-server element to the name of the machine hosting the data server. If no value is provided for the
host attribute, it will default to
localhost. Note that support for running with
host="localhost" was deprecated in 19.1. If the host is not specified, the following warning is printed in
WARN com.appian.data.TopologyFactory - DataServer host is empty, defaulting to 'localhost'. This behavior is deprecated and will be removed in the future, and this topology will be considered invalid. You should not leave the host blank.
port attribute can be defined on both the
data-server-cluster and the
data-server elements. If defined on both, the
data-server element takes precedence. If not supplied, the default port number is
In order for the data server to function properly, make sure that you open all of the required ports. See Port Usage for more information.
rts-count attribute determines the number of real-time stores in the data server. Multiple real-time stores provide horizontal read scalability. Appian supports running exactly 2 instances of the real-time store only. When configuring the attribute value, set it to
When you want to add or remove data server nodes, change the host name, or change the port, you'll need to make configuration changes to the
data-server-cluster parameter by taking the following steps:
<APPIAN_HOME>/data-server/bin/stop.shon Linux or
<APPIAN_HOME>/ae/data-server/node/electiondirectory from all the servers. This directory contains runtime data that needs to be deleted when certain topology changes are made.
<APPIAN_HOME>/data-server/bin/start.shon Linux or
On This Page