Configuration parameters

IMPORTANT
Read more about Data Workbench’s End-of-life announcement.

Set the parameters in the Insight.cfg file to specify your network connection and Data Workbench configuration settings.

The following example contains only the parameters included in the Insight.cfg file by default.

New Layout view

Original Layout view

Some of the parameters available in the new Insight.cfg file may not available in your version of the Insight.cfg file. If one of these parameters is needed, you must add it to the Insight.cfg file using Add Custom Key, by right-clicking on a parameter, then specifying the name and type. You can also add parameters by opening the .cfg file (located in the Data Workbench installation directory) using a text editor.

Following is an example of all of the parameters available for the Insight.cfg file that you can use as a model for adding parameter entries:

Licensing = serverInfo:
  Proxy Address = string:
  Proxy Port = int: 8080
  Proxy User Name = string:
  Proxy Password = string:
Servers = vector: 1 items
  0 = serverInfo:
    Address = string: VS02
    Name = string: Insight Server
    Port = int: 443
    Proxy Address = string:
    Proxy Password = string:
    Proxy Port = int: 8080
    Proxy User Name = string:
    SSL Client Certificate = string: Named User.pem
    SSL Server Common Name = string: VS02
    Use Address File = bool: false
    Use SSL = bool: true
Color Set = int: 0
Default to Online = bool: false
Fonts = vector: 0 items
Gamma = float: 1.6
Maximum Sample Size (MB) = double: 0
Network Location = string:
Unhide All = bool: false
Unlock = bool: false
Update Software = bool: true
User Folder = string: User\\
Toolbar Icons = bool: false

The following table provides descriptions of the available Insight.cfg file parameters in alphabetical order.

Parameter
Description
Address

The host name or numeric IP address of your Data Workbench server computer.

Example: vsServer.mycompany.com or 192.168.1.90

If Address is not specified, the client uses the common name specified in the SSL Server Common Name parameter when Use Address File is set to false.

Note: If the Use Address File parameter is set to true, the text entered in the Address parameter can be removed after the first profile is opened on the client. Then the setting for Network Location Parameter determines which addresses from the Address file for the cluster are used for connecting to the master server.

Color Set

Specifies the background color of your client application. The options are as follows:

0 = black

1 = white

2 = monochrome

The default value is 0, black.

Default Online Level

Optional. Enables you to make your instance of Data Workbench work by default as streaming, offline or online each time it opens. The options are Streaming, Online, or Offline. The default configuration for Data Workbench is to work Offline.

Note: Before deciding to work online by default, make sure to weigh the benefits and consequences outlined in Working Offline and Online.

Fonts

Optional. Vector listing the fonts that the client should use to render UTF8-based unicode special characters. The number of fonts in the list is unlimited.

The first font should always be Lucida Sans Console. If this parameter is not included in the Insight.cfg file, Data Workbench uses only Lucida Sans console to display text.

Data Workbench uses the first font in the list to render all characters until it encounters a character that it cannot render. It uses the second font in the list to render that character. If that font does not render the character, Data Workbench uses the third font in the list to render that character, and so on, until it reaches the end of the font list. If the correct font is not listed in the vector, Data Workbench displays the hexadecimal value for the character.

Note: Do not change this parameter while Data Workbench is running.

Gamma
Gamma setting for the Data Workbench display. The default value is 1.6. Adobe does not recommend changing this value.
Licensing

Optional. You need to modify the parameters in the Licensing vector only if you are contacting Adobe’s license server through a proxy server.

Section identifier for parameters that enable your client to contact the Adobe License Server through a proxy server. Expand the Licensing node and complete the following parameters.

Proxy Address
Optional. The address of the proxy server that client must use to access the Adobe License Server.
Proxy Port
Optional. The port of the proxy server.
Proxy User Name
Optional. The user name for the proxy server.
Proxy Password
Optional. The password associated with the Proxy User Name.
Maximum Sample Size (MB)

Specifies the maximum size allowed in the data cache used by the client running on a single computer.

While the Sample Bytes parameter in the Server.cfg file specifies the data cache size for all clients connecting to a Data Workbench server (250e6 bytes by default), the Maximum Sample Size parameter enables you to further limit the data cache size for a particular computer. This is useful when the client is installed on a computer with limited storage or computing power.

Note: This parameter limits the size of a local data sample queried locally by the client program. In contrast, the cache.db file contains data for each profile the client connects to, plus the element names and their dimensions. These element names and dimensions in the cache.db files are required to run local queries. Consequently, there is no way to limit its size other than reducing the number of elements in the data set.

Name
Optional. The name that the client uses to identify the server.
Network Location

Optional. The network location that client uses to resolve the Data Workbench server common name to an IP address. The available network locations are defined in the address file on the server. For more information, see the Server Products Installation and Administration Guide.

If you do not specify a network location, client resolves common names using the default network location, “Insight.”

Port
The port to which the client sends requests. This port number must match the port on which the Data Workbench server is listening for requests. This is usually 443 for secure connections.
Proxy Address

If a proxy server is required to connect to your Data Workbench server computers, you must complete at least this parameter and the Proxy Port parameter. You can optionally complete the Proxy User Name and Proxy User Password parameters.

The address of the proxy server that the client must use to access the Data Workbench server.

Proxy Password
Optional. The password to the proxy server.
Proxy Port
The port of the proxy server. The default value is 8080.
Proxy User Name
Optional. The user name for the proxy server.
Search

In the Insight.cfg (or any .cfg file), you can search by key name, key type, or value to quickly locate an entry, to remove the need to scroll through expanded, large files for nested information. You can locate dimension names, server names, and so on.

Type a search phrase into this field to locate the data. Depending on the success of a match, the color of the field changes. Matches are shown highlighted and non-matches are dimmed. If there are no matches, the background of the search field turns red. When you press Enter, the config tree expands every place where there is a match and collapses where there is not a match.

You can also use regular expressions in the Search field. For example, you can use re: *zip.* for any entry containing the word “zip.”

To clear a search, press Escape.

Servers
Vector heading for client to server connections.
SSL Client Certificate

Optional unless you have more than one certificate. The name of the file that contains the digital certificate for this copy of Data Workbench. This is the file that you downloaded in Downloading and Installing the Digital Certificate.

Example: Samantha Smith.pem

If you leave this parameter blank, the client uses whatever certificate is present.

SSL Server Common Name
The common name of the Data Workbench server (as assigned on its digital certificate).
Toolbar Icons
False turns off the icons in the workstation user interface and displays text in the toolbar.
Use Address File
Specifies whether any settings in the address file override the Address parameter setting. The options are true or false. If set to true, the settings in the address file, if present, override the Address parameter setting. The default value is true.
Use SSL
Specifies whether SSL is used for secure communication between the Data Workbench server and the client. The options are true or false. The default value is true.
Unhide All

Optional. Enables you to temporarily unhide all metrics, dimensions, and filters that have been hidden using any of the following functionality:

  • [Exclusive] setting in order.txt files
  • Hide option in order.txt files
  • Show parameter in .metric, .dim, and .filter files.
  • Hidden parameter in the Transformation.cfg file.

For more information about these methods, see Hide a menu item.

The options are true or false. The default setting is false. Change this parameter to true to temporarily unhide hidden metrics, dimensions, and filters.

Unlock
Optional. Specifies whether you are allowed to unlock locked workspaces. The options are true and false. True enables you to unlock any locked workspace, while false does not. The default value is false. For more information about locked workspaces, see Unlocking a Workspace.
Update Software
Optional. Specifies whether to allow this the client software to be updated by the Data Workbench server. The options are true or false. The default value is true.
User Folder

Optional. Specifies the name and location of the folder that contains the local copies of any workspaces, metrics, dimensions, or configuration files for each profile. The default setting is User\\, which specifies the User folder within the Data Workbench installation directory.

Changing this setting is useful when two users are sharing the same computer. To accommodate both users, you can specify a shared folder to which both users have access.

6586dc9d1b0434ed2e627930