Configure nodes.yml

The Clarify_5_Server/tools directory contains an important file - nodes.yml - which requires certain parameters specific to each Server Node in the Cluster. These parameters must be added to the file before further configuration can begin.

These parameters, required for each Server Node in the Cluster, include:
  • hostname
  • netinterface
  • address

Obtaining this information can be done using common command prompt methods, such as nslookup, ipconfig/ifconfig, etc.

This example shows a completed file for Cluster with three Server Nodes.

Clarify-common

The Clarify-common section of the nodes.yml file lists parameters that are common across all Server Nodes in the Cluster. These specific paths must point to the symbolic link path being used. Parameters are listed below and shown as they may appear in the completed section.

Parameters:

  • Install: The fully defined path to Clarify_5_Server
  • Share: The fully defined path to Clarify_5_Share
  • Tools: The fully defined path to clarify-tools*
  • User: The qualified user name with permission to run the services for each Server Node.
  • Pass: (Windows only) The password for the qualified user noted above.**

*Clarify-tools

The clarify-tools folder contains resources used by the by the Cluster to run locally on each Server Node.

Each Server Node will automatically contain this folder after running the clarify_node_setup.

The parameter to be entered for tools needs to be a local path on the Server Node. This path must be accessible by the Cluster; however it cannot be within the SHARED folder.

Important Note for Window Users – must set password ("pass")

The user parameter in the clarify_common section of the nodes.yml file contains an additional password parameter (“pass”), which cannot be left empty. Both user and pass parameters are used as part of system log on configuration for the Cluster services, shown in the example below.

If you were to remove the user and pass parameters from the nodes.yml file (not recommended), you would be required to manually set the appropriate user and password on each service on each server node in the Cluster, after completing the clarify_node_setup.

Note: Windows Local Security Policy may need to be configured to allow this user to Log On as Service, which is needed in order to start the cis-conductor service and prevent the services from shutting down if/when you log off from the system.