Bookshelf v7.5.2: Configuring Clustered Servers and Cluster Controllers

Siebel Analytics Installation and Configuration Guide > Installing the Siebel Analytics Cluster Server Feature >

Configuring Clustered Servers and Cluster Controllers

After installing the Clustering feature, you need to configure the Siebel Analytics Servers and Cluster Controllers that will participate in a cluster.

To configure clustered servers and cluster controllers

Stop any Siebel Analytics Servers and Cluster Controllers that are running. This can be done from the Services control panel applet on each computer, or by using the net command from a Windows command window; for example:

net stop "Siebel Analytics Server"
net stop "Siebel Analytics Cluster"

On each computer that is hosting a Siebel Analytics Server, edit the NQSConfig.ini file located in the Config folder in the Siebel Analytics software installation folder and set the parameter CLUSTER_PARTICIPANT to Yes. Uncomment and supply valid values for the parameters CLUSTER_PARTICIPANT and REPOSITORY_PUBLISHING_DIRECTORY referring to the instructions given in NQSConfig.ini File Reference.

In order for a Siebel Analytics Server to communicate with a DCOM-based client, the MAX_SESSION_LIMIT and CLIENT_SERVER_SHARED_MEMORY_SIZE parameters in the NQSConfig.ini file must be updated on every clustered Siebel Analytics Server.

MAX_SESSION_LIMIT = 100 ; // May be increased, but if set too high, will cause server startup to fail.

CLIENT_SERVER_SHARED_MEMORY_SIZE = 32 KB ;

Non-clustering parameters, such as those set in the Cache and Repository sections of the NQSConfig.ini file, should be substantially identical across all Siebel Analytics Servers in a cluster. You may find it easiest to edit one copy of the NQSConfig.ini file and then copy it to the Config folders of the remaining computers, and then make computer-specific changes where necessary.

Edit one copy of the NQClusterConfig.ini file to supply valid values for the clustering parameters. For detailed instructions, refer to NQSConfig.ini File Reference.

Copy the NQClusterConfig.ini file to the Config folders of each computer hosting a Siebel Analytics Server or a Cluster Controller.

Configure Siebel Analytics Server data source names (DSNs) for clustering, using the wizard described in Siebel Analytics Server Administration Guide. Consult the online Help for assistance.

Manually start all the Siebel Analytics Server and Siebel Analytics Cluster Server services in the cluster. This can be done from the Services control panel applet on each computer, or by using the net command from a Windows command window.

For example, use:

net start "Siebel Analytics Server"

net start "Siebel Analytics Cluster"

You can also use a third-party tool designed for remote service manipulation.

Use a text editor to examine the NQServer.log file and the NQCluster.log in the Log folders, and verify that all computers started without errors and joined the operational cluster configuration successfully. Correct any errors noted in the log files and start the computers again.

NOTE: The log entries are written in UTF-8 format. To view the contents of these files, set your viewer to UTF-8. If you do not, you may see garbled text.

When you are using the Siebel Analytics Server Administration Tool and have a repository open, you can use the Cluster Manager to monitor and manage the operations of the cluster, including starting and stopping Siebel Analytics Servers and Cluster Controllers. Access the Cluster Manager by choosing the menu option Manage > Clusters.