Installing a Cluster with a Separated Configuration Database

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 database repository, 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.
  2. Double-click installdb.exe.
  3. Follow the prompts to install the configuration database.
    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. Edit the file Database/repository/spectrum-container.properties as described in Cluster Properties for a Configuration Database Cluster.
  5. Save and close spectrum-container.properties.
  6. Start the configuration database. To start the configuration database, right-click the Spectrum Technology Platform icon in the Windows system tray and select Start Spectrum. Alternatively, you can use the Windows Services control panel to start the configuration database by starting the Spectrum Database service.
  7. Install the configuration database on additional servers as needed to complete the configuration database cluster.
  8. Install the server cluster.
    1. Install Spectrum Technology Platform on a server where you want to host a node. For instructions, see Installing a New Server.
      Important: 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.
    2. If the Spectrum Technology Platform server is running, stop it. To stop the server, right-click the Spectrum Technology Platform icon in the Windows system tray and select Stop Spectrum.
    3. Edit the properties in file server/conf/spectrum-container.properties, as described in Cluster Properties.
    4. Save and close the spectrum-container.properties file.
    5. Some modules have module-specific settings that you must configure to enable the module to work in a cluster.
      Module Cluster Configuration Settings
      Advanced Matching These settings configure clustering for full-text search indexes. If you do not use full-text search indexes you do not need to configure these settings.

      Open this file in a text editor:

      ..\server\modules\searchindex\es-container.properties

      Configure these properties:

      es.index.default_number_of_replicas
      Enter the number of additional copies you want created for each search index. This number should be the number of nodes in your cluster minus 1. For example, if your cluster has five nodes, you would enter "4" in this property.
      es.index.default_number_of_shards
      Enter the number of shards you want your index to have in the distributed environment. The more nodes that are in your cluster, the higher this number should be.
      Save and close es-container.properties when you are done editing these properties.
      Context Graph Open this file in a text editor:

      ..\server\modules\hub\hub.properties

      Configure these properties:
      hub.models.path.base
      Specifies the folder where models are stored. By default, each model is placed in a subdirectory under the ..\server\modules\hub\db folder. If you want to store models in a different location, uncomment this property and specify the folder where you want to store models.
      hub.neo4j.database.type
      Change the value of this property to ha. The default value embedded is for non-clustered installations.
      hub.servers.per.cluster
      Uncomment this line. Set the value of this property to the number of Spectrum Technology Platform servers in the cluster.

      Save and close hub.properties when you are done editing these properties.

      The ..\server\modules\hub\db\neo4j.properties controls how the graph databases are configured, using Neo4j Enterprise. This file is used as a template for each model. If needed, each model can be configured separately by placing a copy of the neo4j.properties file into the store directory for that model.

    6. Start the server. To start the server, right-click the Spectrum Technology Platform icon in the Windows task bar and select Start Server.
    7. Repeat this procedure to install additional nodes in the server cluster.
  9. After installing all the nodes in the server cluster, go back to the first node you installed in the server cluster and add the other nodes as seed nodes.
    1. On the first node you installed, open the properties file server/conf/spectrum-container.properties.
    2. In the property spectrum.cluster.seeds, add the host name or IP address of the other nodes in the cluster, separating each with a comma.
    3. Save and close the spectrum-container.properties file. You do not need to restart the server.