Installing a Cluster with a Separated Configuration Database - spectrum_platform - 23 - 23.1

Spectrum Installation Guide for Linux

Product type
Product family
Spectrum > Spectrum Platform
Product name
Spectrum Technology Platform
Spectrum Installation Guide for Linux
Topic type
How Do I
First publish date

This procedure creates two clusters: one for the server nodes and one for configuration database nodes. The nodes in the server cluster point to the servers in the configuration database cluster for their configuration data. The nodes in the configuration database cluster replicate their data between each other.

The following diagram illustrates this installation scenario:

To install a separate configuration database, you first install the configuration database on servers in a cluster, then install the server on nodes in a separate cluster. At least one configuration database must be running before you can install the server.

Note: In the case of a separated database configuration cluster setup, as shown here, you can apply load balancing only to the Spectrum server cluster. You cannot apply load balancing to the separated database cluster.
  1. Place the Spectrum Technology Platform installer on the server where you want to install the configuration database.
    Note: We recommend a minimum of three nodes per cluster.
  2. Run
  3. Install the configuration database on each node in the cluster.
  4. Configure property settings on each node in the cluster.
    1. Configure properties in the DatabaseDirectory/repository/ file as described in Cluster Properties for a Configuration Database Cluster.
    2. Save and close
    3. Confirm that the property settings in the DatabaseDirectory/repository/neo4j.template match the following settings:
  5. Start each configuration database node in the cluster consecutively.
    To start a configuration database node, run the DatabaseDirectory/server/bin/server.start script.
    Note: Verify that the configuration database is fully started before continuing by opening the log file DatabaseDirectory/repository/logs/debug.log.
  6. Install Spectrum Technology Platform on each node in the cluster.
    For instructions, see Installing a New Server.
    • Do not start the server when the installation completes. You must complete the remaining steps before starting the server.
    • When installing each server select the Server only option in the installer and provide the host and port of one or more of the configuration database servers. You can find the port in the file SpectrumDirectory/Database/repository/ The port is specified in the spectrum.repository.server.connector.bolt.port property.
  7. On each node, configure settings in the SpectrumDirectory/server/conf/ file.
    1. Edit the properties in file, as described in Cluster Properties.
    2. Save and close the file.
    3. Some modules have module-specific settings that you must configure to enable the module to work in a cluster.
      Module Cluster Configuration Settings
      Context Graph

      Context Graph models are stored on an external Neo4j Graph Database Server. For instructions about how to configure and connect to Neo4j Graph Database Server in a clustered configuration, see Installing a Cluster for Context Graph.

  8. On each node, configure settings for Search Index.
    1. Open the file SpectrumDirectory/index/opensearch.template and scroll down to the Node Address section.
    2. Remove the hash character # to uncomment this line:
      cluster.initial_master_nodes: ${seeds}

      Then edit it to specify the node names in the cluster:

      cluster.initial_master_nodes: node-1,node-2,node-3,...
      Important: This setting must be uncommented when you start the cluster for the first time.
    3. Insert the hash character # to comment out this line:
      #discovery.type: single-node
  9. Start each server in the cluster.
    Run the SpectrumDirectory/server/bin/server.start script.
    For more information, see Starting a Cluster.