Configuration parameters
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.
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.
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.
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.
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.
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.
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.
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.”
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.
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.
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.
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.
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.