Read more about Data Workbench’s End-of-life announcement.
Information about configuring the cluster on the Master Insight Server, updating the access control file for a cluster, and more.
To configure the cluster, perform the following steps on the master Insight Server:
Add the processing Insight Servers’ common names and addresses to the address file.
Add all of the Insight Servers to the Cluster Servers group in the Access Control.cfg file.
Update the Synchronize.cfg file in the Components for Processing Servers directory to point to the master Insight Server.
If necessary, modify the Disk Files.cfg file in the Components for Processing Servers directory to specify the location of the temp.db file on the processing Insight Servers.
To complete these steps, you need to know the common names (as specified on the digital certificates for the individual Insight Server) and the IP addresses of each Insight Server in the cluster. If you do not already have this information, obtain it before you proceed.
The procedures described in this section require Insight. If you have not installed Insight, follow the instructions in the Insight User Guide before proceeding.
Use the following procedure to add the processing Insight Servers’ common names and IP addresses to the address file on the master Insight Server. (Although the address file is maintained and administered on the master Insight Server, it is used by all the Insight Servers in the cluster.)
The following assumes that the address file has already been configured for the master Insight Server. If you have not already added the master Insight Server’s IP address(es) to the address file, complete the procedure described in Defining the Server’s Network Location before you begin.
To add the processing Insight Servers to the address file
Start Insight and load the Configuration profile (if it is not already open) by right-clicking the title bar and clicking Switch Profile > Configuration.
In Insight, on the Admin > Dataset and Profile tab, click the Servers Manager thumbnail to open the Servers Manager workspace.
Right-click the icon of the master Insight Server and click Server Files.
In the Server Files Manager, open the Addresses directory and do the following to open the Insight Server’s address file:
Right-click the check mark in the server name column and click Make Local.
Right-click the check mark in the Temp column and click Open > in Insight.
Expand the contents of the Locations structure, then expand NetworkLocation 0, Addresses, and AddressDefinition.
Do the following to add an AddressDefinition to NetworkLocation 0 for each processing Insight Server in the cluster:
Right-click AddressDefinition and click Add New > Address Definition.
In the Name parameter, specify the processing Insight Server’s common name.
In the Address parameter, specify the processing Insight Server’s IP address.
You can use an asterisk as a wildcard in the Address field, such as 10.10.116.*, to simplify clustering. See Understanding Access Levels.
The following example defines a cluster containing two Insight Servers:
If the servers are connected to multiple networks, repeat Step 6 to add the processing Insight Servers to the NetworkLocations for those networks.
The following example shows a cluster of four Insight Servers attached to two networks (“Corporate Intranet” and “Internet”).
Save your changes to the server by doing the following:
Right-click (modified) at the top of the window and click Save.
In the Server Files Manager, right-click the check mark for the file in the Temp column and select Save to > < server name>.
To use Insight Servers in a cluster, each Insight Server in the cluster (including the master Insight Server) must belong to the Cluster Servers access control group. The Cluster Servers group identifies the servers (by IP address) that are allowed to participate in the cluster. Although this file is maintained and administered on the master Insight Server, it is used by all of the Insight Servers in the cluster.
To edit the access control file
In Insight, on the Admin > Dataset and Profile tab, click the Servers Manager thumbnail to open the Servers Manager workspace.
Right-click the icon of the master Insight Server and click Server Files.
In the Server Files Manager, open the Access Control directory.
Do the following to open the Access Control.cfg file:
Right-click the check mark in the server name column and click Make Local.
Right-click the check mark in the Temp column and click Open > in Insight.
Expand the Access Control Groups structure, then expand AccessGroup (Cluster Servers).
For each Insight Server in the cluster (including the master Insight Server), do the following:
Right-click Members and click Add New > New Member.
Specify the Insight Server’s IP address (its numeric IP address, not its name). If the Insight Servers are connected to multiple networks, this AccessGroup should contain only the internal addresses that the Insight Servers use for inter-server communication within the cluster.
The following shows the AccessGroup (Cluster Servers) for a cluster of four Insight Servers.
Save your changes to the server by doing the following:
Right-click (modified) at the top of the window and click Save.
In the Server Files Manager, right-click the check mark for the file in the Temp column and click Save to > < server name>.
You can use the following procedure to configure the central copy of the Synchronize.cfg file. The central copy of this file is maintained on the master Insight Server. The processing Insight Servers in the cluster initiate communication with the master Insight Server to retrieve an updated copy of this file.
The Synchronize.cfg file specifies the location of the master Insight Server. It also identifies the set of administrative files that each of the processing Insight Servers in the cluster retrieves from the master Insight Server. The processing Insight Servers automatically download these files from the master Insight Server when they start. They also dynamically retrieve updated copies of these files from the master Insight Server when the files change.
Although you configure the Synchronize.cfg file on the master Insight Server, the master Insight Server itself does not use this file. You update this file on the master Insight Server so that it is properly configured when the processing Insight Servers retrieve the file.
To update the Synchronize.cfg file on the master Insight Server
In Insight, on the Admin > Dataset and Profile tab, click the Servers Manager thumbnail to open the Servers Manager workspace.
Right-click the icon of the master Insight Server and click Server Files.
In Server Files Manager, open the Components for Processing Servers directory.
Do the following to open Synchronize.cfg:
Right-click the check mark in the server name column and click Make Local.
Right-click the Temp check mark and click Open > in Insight.
Expand the component structure.
In the Cluster Primary Server Address parameter, specify the IP address of the master (primary) Insight Server.
To create a log that records each time synchronization occurs between the master Insight Server and the processing Insight Servers, make sure that the Enable Synchronization Log parameter is set to “true.”
Save your changes to the server by doing the following:
Right-click (modified) at the top of the window and click Save.
In Server Files Manager, right-click the check mark for the file in the Temp column and click Save to > < server name>.
Perform the following procedure if you want the processing Insight Servers to maintain temp.db (the dataset) in a directory or drive different than the default location or if you want to distribute temp.db across multiple drives.
Because the processing Insight Servers all share the same Disk Files.cfg, they all must support the file location(s) you specify in this file. For example, if you assign temp.db to the E: drive, every processing Insight Server in the cluster must have an E: drive.
To configure the location of temp.db
In Insight, on the Admin > Dataset and Profile tab, click the Servers Manager thumbnail to open the Servers Manager workspace.
Right-click the icon of the master Insight Server and click Server Files.
In the Server Files Manager, open the Components for Processing Servers directory.
Do the following to open Disk Files.cfg:
Right-click the check mark in the server name column and click Make Local.
Right-click the check mark in the Tempcolumn and click Open > in Insight.
Expand the DiskSpaceManagerComponent structure, then expand the Disk Files list.
Edit entry 0 to change the location of the temp.db file.
If you want to distribute temp.db across multiple drives, use the steps below to create an additional entry for each additional drive.
Right-click Disk Files and click Add New > Disk File.
In the new entry, specify the location where you want temp.db written.
The following shows temp.db written across four drives.
Save your changes to the server by doing the following:
Right-click (modified) at the top of the window and click Save.
In Server Files Manager, right-click the check mark for the file in the Temp column and click Save to > < server name>.