Configuring API Data Store
Developer Portal installation includes the API Data Store that is used to store data. For clustering the API Data Stores of the instances, you must perform standard Elasticsearch clustering. For more information, see Elasticsearch documentation.
You must perform the following steps in all nodes of a cluster.
To configure the API Data Store1. Open the elasticsearch.yml file from the location, SAGInstallDir/InternalDataStore/config/.
The following configuration is a sample of how the configuration appears initially.
cluster.name: SAG_EventDataStore
node.name: Node-92DYMH21631770915192
path.logs: C:\SoftwareAG_DPO\InternalDataStore/logs
network.host: 0.0.0.0
http.port: 9240
discovery.seed_hosts: ["localhost:9340"]
transport.tcp.port: 9340
path.repo: ['C:\SoftwareAG\InternalDataStore/archives']
cluster.initial_master_nodes: ["Node-92DYMH21631770915192"]
xpack.ml.enabled: false
xpack.security.enabled: false
2. Provide the name of the cluster in the cluster.name property.
Nodes with same cluster names form a cluster. That is, if there are three nodes in the cluster, the value in the cluster.name property must be same across all three nodes. In other words, Elasticsearch forms a cluster with nodes that have the same cluster.name.
For example,
cluster.name: Dev_portal_cluster
3. Provide the names of all participating nodes in the discovery.seed_hosts property in the following format.
host_name:port_name
For example,
discovery.seed_hosts: ["node1:9340","node2:9340","node3":"9340"]
Note:
The host name must be same as the value of the node.name property and the port must be same as it is specified in the http.port property
4. Provide the names of the master-eligible nodes in the initial cluster in the cluster.initial_master_nodes property.
This parameter enables cluster bootstrapping when you start a cluster for the first time . This property must be defined on every master-eligible node in the cluster. This setting helps prevent split-brain, the existence of two masters in a single cluster. For example,
cluster.initial_master_nodes:["portalnode1"]
5. Provide the repository in which you want to save the API Data Store backup snapshots in the path.repo property.
It is important to have a location that is accessible to all the nodes. The location could be network file system, S3 or Azure in the clustered setup.
Sample configuration:
cluster.name: SAG_EventDataStore
node.name: node3
path.logs: C:\SoftwareAG\InternalDataStore/logs
network.host: 0.0.0.0
http.port: 9540
discovery.seed_hosts: ["portalnode1:9541","portalnode2:9541","portalnode3:9541"]
transport.tcp.port: 9541
node.master: true
path.repo:['SAG_root\InternalDataStore/archives']
cluster.initial_master_nodes: ["node1", "node2", "node3"]
xpack.ml.enabled: false
xpack.security.enabled: false
6. Save the file.
The specified API Data Store nodes are clustered.