Configuring a Profile to Run on a Cluster

When you configure a dataset profile to run on an Insight Server cluster, all of the machines in the cluster share all of the dataset configuration files for that profile.

Therefore, the entries for the parameters in these files must be applicable to all Insight Servers in the cluster. For example, the locations of the log files to be read, the lookup files to be used by Insight Server, and the location of the data output by Insight Server must be the same on all machines in the cluster.

You perform all configuration tasks on the cluster’s master Insight Server, which is the Insight Server you use to edit your configuration files. All saved configuration file changes made on the master Insight Server are synchronized automatically to the files on the processing Insight Servers in the cluster.

To run a dataset profile on an Insight Server cluster, you must perform the following processes in the order listed:

  1. Determining Which Insight Servers Process Event Data
  2. Specifying the Processing Servers in Profile.cfg
  3. (If necessary) Modifying the Dataset Configuration Files for the Profile

Determining Which Insight Servers Process Event Data

It is not required that all Insight Servers in the cluster process event data. You can designate one Insight Server in the cluster as a File Server Unit that stores the source files (VSL and log files) and serves the files to all of the Data Processing Units (processing servers) in the cluster. This setup provides the benefit of a single event data repository and leverages the processing power of all the processing servers in the cluster. The processing servers divide the data files among them and guarantee that the same file is not processed more than once.

For more information about designating an Insight Server to run as a File Server Unit, see the Log Processing Configuration File chapter of the Dataset Configuration Guide.

If you decide to store source data files on each of the processing servers rather than on a single File Server Unit, you must divide the files equally among the processing servers. Do not store all of the dataset’s source files on each of the processing servers. If multiple copies of the same file are available to multiple processing servers, the data is read multiple times (once by each machine) and skews your data.

For help determining which Insight Servers should process log files, please contact Adobe Consulting.

Specifying the Processing Servers in Profile.cfg

In the profile.cfg file, specify the processing servers that process the data for the profile.

To access the profile.cfg file

You access the profile configuration file using the Profile Manager in Insight.

  1. While working in your dataset profile, open the Profile Manager by right-clicking within a workspace and clicking Admin > Profile > Profile Manager, or by opening the Profile Management workspace on the Admin tab.
  2. In the Profile Manager, right-click the check mark next to profile.cfg and click Make Local. A check mark for this file appears in the User column.
  3. Right-click the newly created check mark and click Open > in Insight. The profile configuration window appears.
To add the Processing Servers
  1. In the profile.cfg file, click Profile, then click Processing Servers to display its contents.
  2. Right-click Processing Servers and click Add new > Processing Server.
  3. In the Common Name parameter, type the common name for the first processing server in the cluster. For example: server1.mycompany.com
  4. Repeat Steps 2 and 3 until you have added the common names of all of the processing servers in the cluster.
    Note: If the master Insight Server processes data, you must add it as well.
  5. Right-click (modified) at the top of the window and click Save.
  6. Right-click the check mark in the User column next to profile.cfg. Click Save to > <dataset profile name>.

Modifying the Dataset Configuration Files for the Profile

To modify the dataset configuration files

If you need to make changes to the dataset configuration files (Log Processing.cfg, Transformation.cfg, dataset include files, Log Processing Mode.cfg, and so forth), do so only on the master Insight Server.

  1. Access the files you want to modify:

    For instructions to access the files, see the Dataset Configuration Guide.

  2. Make your changes. See the Dataset Configuration Guide for details regarding the parameters within the configuration file(s).
  3. Save the file.
    1. Right-click (modified) at the top of the window and click Save.
    2. Right-click the check mark in the User column next to the file name.
    3. Click Save to and select the desired profile.
Note: Insight users who access a dataset profile running on a cluster identify only the master Insight Server in the Insight configuration file (insight.cfg). From the perspective of the Insight user, the profile is accessible on only one Insight Server (the master Insight Server); however, query requests from analysts can be directed to any of the Insight Servers in the cluster.

An Insight Server cluster permits the centralized storage of .vsl log files (from Sensor) on a single Insight Server machine called a File Server Unit (FSU). For information about installing an FSU, see Installation Procedures for an Insight Server FSU. For information about configuring an FSU, see the Dataset Configuration Guide.