Siebel Analytics Server Administration Guide > Clustering Siebel Analytics Servers >

Implementing the Cluster Server Feature

These are the high-level steps to implement the Cluster Server feature:

1. Install Siebel Analytics, including the Cluster Controller component.
2. Set parameters in the NQSConfig.INI file.
3. Set parameters in the NQClusterConfig.INI file.
4. Set up the Siebel Analytics ODBC data source for clustering.
5. Copy the NQClusterConfig.INI file to the Cluster Controllers and Analytics Servers in the cluster.
6. Start the machines in the cluster.

For detailed information about installing and configuring this feature, see Siebel Analytics Installation and Configuration Guide.

Installing the Cluster Server Feature

The Cluster Controller is the only component of the Cluster Server feature that needs to be installed. To install this component, you select the Custom option in the Installation Wizard for machines that will host Cluster Controllers and then select Siebel Analytics Cluster.

You should review the hardware and software requirements for the Cluster Controller before you install it; see Siebel Analytics Installation and Configuration Guide.

Setting Parameters in the NQSConfig.INI File

In the Server section of the NQSConfig.INI file, there are three parameters you need to set for a Siebel Analytics Server that will participate in a cluster. A brief description of each parameter follows:

• CLUSTER_PARTICIPANT. Specifies whether the Analytics Server is a member of a cluster.
• REPOSITORY_PUBLISHING_DIRECTORY. Specifies the location of the repository publishing directory shared by all Analytics Servers participating in the cluster.
• REQUIRE_PUBLISHING_DIRECTORY. Specifies whether the repository publishing directory needs to be available in order for the Analytics Server to start up and join the cluster.

The NQSConfig.INI file is located in the Config directory in the Siebel Analytics software installation folder. For more information about these parameters, see Siebel Analytics Installation and Configuration Guide.

Setting Parameters in the NQClusterConfig.INI File

The NQClusterConfig.INI file contains the cluster configuration parameters. The Analytics Server reads this 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. A brief description of each parameter follows:

• ENABLE_CONTROLLER—Specifies whether the Cluster Controller functionality is enabled. The NO setting allows the Analytics Server administrator to temporarily disable a Cluster Controller if, for example, the machine is being serviced. This parameter only applies to the Cluster Controller on the machine on which it resides.
• PRIMARY_CONTROLLER—Specifies which machine acts as the primary Cluster Controller.
• SECONDARY_CONTROLLER—Specifies which machine will take over the responsibilities of the primary Cluster Controller if the primary becomes unavailable. Specifying a secondary Cluster Controller is optional.
• SERVERS—Specifies the Analytics Servers that belong to the cluster. A cluster can contain a maximum of 16 Analytics Servers. A server can belong to only one cluster.
• MASTER_SERVER—Specifies the Analytics Server to which the Administration Tool connects for online repository changes. Online repository changes are published to the location specified by the REPOSITORY_PUBLISHING_DIRECTORY parameter in the NQSConfig.INI file.
• SERVER_POLL_SECONDS—Specifies the frequency of heartbeat messages between the Cluster Controller and each server in the cluster.
• CONTROLLER_POLL_SECONDS—Specifies the frequency of heartbeat messages between the primary Cluster Controller and the secondary Cluster Controller if one is defined.

The NQClusterConfig.INI file is located in the Config directory in the Siebel Analytics installation folder. For more information about these parameters, see Siebel Analytics Installation and Configuration Guide.

Configuring the Siebel Analytics ODBC Data Source Name

All clients, including Analytics Web clients, need to have a clustered data source name (DSN) configured in order to communicate with a cluster. You set up a DSN by using the Siebel Analytics Server DSN Configuration wizard, described in Connectivity and Third-Party Tools.

Copying the NQClusterConfig.INI File

A configured NQClusterConfig.INI file needs to reside in the Config directory of every Analytics Server and Cluster Controller that is to participate in the cluster.

For detailed instructions on configuring the NQClusterConfig.INI file, see Siebel Analytics Installation and Configuration Guide.

Starting Cluster Controllers and Analytics Servers

When you are using the Administration Tool and have a repository open in online mode, you can use the Cluster Manager to monitor and manage the operations of the cluster, including starting and stopping Analytics Servers and Cluster Controllers. However, opening a repository in online mode does not automatically start a clustered Analytics Server or a Cluster Controller; therefore, you must start one Analytics Server and one Cluster Controller manually. You can then use the Cluster Manager to start additional clustered servers.

NOTE:  On UNIX each server needs to be started manually. After the servers are running, you can use the Cluster Manager to start and stop the Analytics Servers.

To manually start an Analytics Server and Cluster Controller in Windows

1. Navigate to the Services window by selecting Start > Programs > Administrative Tools > Services.
2. Right-click Siebel Analytics Server and click Start.
3. Right-click Siebel Analytics Cluster and click Start.

To start the Analytics Server and Cluster Controller from the Command window

• Open a Command window and type the following:

  net start "SIEBEL ANALYTICS SERVER"

  net start "SIEBEL ANALYTICS CLUSTER"

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

After you start the Analytics Servers and Cluster Controller, use a text editor to examine the log files NQServer.log and NQCluster.log in the Log directories, and verify that all machines started without errors and joined the operational cluster configuration successfully. If the log files indicate errors, correct the errors and restart the servers.

To start the Analytics Server and Cluster Controller from the command line on UNIX

1. Navigate to a command window (xterm).
2. In the Command window, type the following commands (the commands will be slightly different if using csh):

   cd INSTALLDIR/setup

   ./run-sa.sh start

   ./run-ccs.sh start