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

Spectrum Installation Guide for Windows

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 Windows
Topic type
How Do I
Overview
Installation
Configuration
First publish date
2007
ft:lastEdition
2023-11-03
ft:lastPublication
2023-11-03T19:05:52.996250

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. Double-click installdb.exe.
  3. Install the configuration database on each node in the cluster.
    Important: When prompted with the option to start Spectrum Technology Platform after the installation, you must disable this option so that the database does not start automatically when the installation completes.
  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, right-click the Spectrum Technology Platform icon in the Windows system tray and select Start Server.
    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.
    Important:
    • The installer will provide the option to auto start the Spectrum Technology Platform server. By default this option is not selected. Do not enable this option if installing a clustered environment.
    • 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.
    Right-click the Spectrum Technology Platform icon on the Windows task bar, and click Start Spectrum.
    For more information, see Starting a Cluster.