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

Spectrum Installation Guide for Linux
Product type
Software
Portfolio
Integrate
Locate
Verify
Product family
Spectrum
Product
Spectrum > Spectrum Platform
Version
23.1
Language
English
Product name
Spectrum Technology Platform
Title
Spectrum Installation Guide for Linux
Topic type
Installation
Overview
Configuration
How Do I
First publish date
2007
Last edition
2023-11-17
Last publish date
2023-11-17T17:30:19.950257

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 installdb.sh.
  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/spectrum-container.properties file as described in Cluster Properties for a Configuration Database Cluster.
    2. Save and close spectrum-container.properties.
    3. Confirm that the property settings in the DatabaseDirectory/repository/neo4j.template match the following settings: 
      dbms.active_database=graphdb
dbms.default_database=graphdb
dbms.default_listen_address=0.0.0.0
causal_clustering.discovery_advertised_address=${spectrum.agent.address}
causal_clustering.enable_pre_voting=false
dbms.routing.enabled=true
dbms.routing.listen_address=0.0.0.0
dbms.routing.advertised_address=${spectrum.agent.address}
  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.
    Important:
    • 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/spectrum-container.properties. The port is specified in the spectrum.repository.server.connector.bolt.port property.
  7. On each node, configure settings in the SpectrumDirectory/server/conf/spectrum-container.properties file.
    1. Edit the properties in file spectrum-container.properties, as described in Cluster Properties.
    2. Save and close the spectrum-container.properties 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.