Siebel Analytics Installation and Configuration Guide > NQClusterConfig.INI File Reference >

About the Siebel Analytics Cluster Configuration File


The Siebel Analytics Server reads the NQClusterConfig.INI file after it reads the NQSConfig.INI file (when CLUSTER_PARTICIPANT is set to YES in the NQSConfig.INI file). Cluster controllers also read this file.

If a Siebel Analytics Server detects a syntax error while reading the file, it logs the error to its NQServer.log file, located in the Log subdirectory in the Siebel Analytics software installation directory. If a Cluster controller detects an error while reading the file, the error is logged to its NQClusterConfig.INI file, located in the Log subdirectory in the Siebel Analytics software installation directory. If a machine is hosting both a Siebel Analytics Server and a cluster controller, messages are written to both logs. There may also be a summary message in the system log relating to the error.

You need to correct the error and start the affected Siebel Analytics Server or cluster controller again. Repeat this process until no errors are detected in the configuration file.

For information about the NQSConfig.INI file, see NQSConfig.INI File Reference.

Siebel Analytics Cluster Configuration File Location

The cluster configuration initialization is the NQClusterConfig.INI file. It resides in the subdirectory $INSTALLDIR/Config. Do not change the name of the file or its location. All Siebel Analytics Servers and Cluster Controllers that are to participate in the cluster need to have configured NQClusterConfig.INI files.

NOTE:  The Siebel Analytics Server administrator needs to make sure that a configured NQClusterConfig.INI file resides in the Config subdirectory of every Siebel Analytics Server and Cluster Controller that is to participate in the cluster. In general, it is easiest to configure the file once, copy it to the Config directories of the machines in the cluster, and then make machine-specific changes when required. If you correct an error, make sure the correction is propagated to the NQClusterConfig.INI files of all affected machines.

Adding Comments to the Siebel Analytics Cluster Configuration File

You can add comments anywhere in the NQClusterConfig.INI file. Comments need to begin with either of the following:

Any text following these comment characters up to the end of the line is ignored when the initialization file is read.

Rules for Siebel Analytics Cluster Configuration File Parameters

Note the following about each parameter entry in the NQClusterConfig.INI file:

Changing Siebel Analytics Cluster Configuration File Parameter Entries

Parameter entries are read upon startup. If, while a Siebel Analytics Server or cluster controller is running, you change an entry that affects the operations of the cluster, you need to shut down the machines in the cluster, propagate the changes to other machines in the cluster, and then restart all affected machines. Your changes take effect then.


 Siebel Analytics Installation and Configuration Guide
 Published: 09 September 2004