Fields on the Server Groups page

If you are unsure of how to complete the fields on the Server Groups page, use the information provided here.

Table 1. Server Groups page: Servers tab
Field Description
Synchronize with changed streams configuration Click to refresh the list of servers and stream instances.
Table 2. Server Groups page: Database Connections tab
Tip: If a database connection error occurs, verify that the information entered in these fields is correct.
Field Description
Add Click to open a panel where you can add a database connection.
Name Enter a descriptive name for this database.
Database Type Select a database type from the drop-down list of supported databases.
Database Name Enter the name of the database as shown in your database management client. This must exactly match the name as shown in the client. Case-sensitive.
Server Name Enter the fully qualified name or IP address of the machine that hosts the database server. For example, machine.mycompany.com.
Port Enter the port on which the database listens. The default port for DB2 is 50000.
User Id Enter the user name of the database account you want Opportunity Detect to use to access to this database.
Password, Confirm Password Enter the password for the account you entered in the User ID field.
Table 3. Server Groups page: Data Source Connectors tab
Field Description
Add Click to select the type of connector to add. The options are:
  • File
  • Queue
  • Table
Batch file connector
Name Enter a descriptive name for the file connector.
File Name Click the link in this field to open a pop-up window, and complete the following fields.
  • Name - Enter the base file name for this flat file.

    Permitted characters are ASCII letters, numbers, and underscore. Do not use spaces or any other special characters.

  • Audience Level - Select from a drop-down list of available audience levels.

Opportunity Detect constructs a complete file name from the base name you provide. The name of your file must match the name that Opportunity Detect constructs.
Description Enter a description of this file.
Delimiter Select a delimiter for data within records. Options are:
  • Pipe
  • Comma
  • Semicoloin
  • Tab
File Encoding Select the encoding used in the file from the drop-down list. Options are:
  • Chinese Traditional (Big 5)
  • Unicode (Little endian)
  • Unicode (Big endian)
  • Western European (ISO)
  • Central European (ISO)
  • Latin 3 (ISO)
  • Latin 9 (ISO)
  • Korean (EUC)
  • Chinese (GB 18030)
  • Unicode (UTF-7)
  • Unicode (UTF-8)
Date Locale Select from a drop-down list of supported locales. Options are:
  • English (United States)
  • Chinese (China)
  • English (United Kingdom)
  • French
  • German
  • Italian
  • Japanese (Japan)
  • Korean
  • Portuguese (Brazil)
  • Russian
  • Spanish
  • Thai
Currency Select from a drop-down list of supported locales. Options are the same as for Date Locale.
Queue connector
Note: For additional information on setting up queue data source connectors, see Real time processing in Opportunity Detect.
Name A descriptive name for the queue connector.
Queue type Select the type of queue server you are using: Active MQ, WebSphere MQ, or Rabbit MQ.
Queue Name Name of the queue as configured on the queue server. Active MQ and WebSphere MQ only.
Connection URL An example value appropriate for the queue type you selected is provided. Active MQ and WebSphere MQ only.
Connection Factory An example value appropriate for the queue type you selected is provided. Active MQ and WebSphere MQ only.
Connection Factory Identifier An example value appropriate for the queue type you selected is provided. Active MQ and WebSphere MQ only.
Exchange Name The name of the direct exchange configured on the Rabbit MQ server. Rabbit MQ only.
Host Name The host name of the Rabbit MQ server. Rabbit MQ only.
Port The port of the Rabbit MQ server. Rabbit MQ only.
User Id The user name for the account that the system uses to access the queue server.

If this value changes after deployment, you must redeploy any workspaces that use this connector.
Password The password for the account that the system uses to access the queue server.

If this value changes after deployment, you must redeploy any workspaces that use this connector.
Confirm Password The password for the account that the system uses to access the queue server.
Description A description for this queue connector.
Sharable Select this check box if you want to be able to use this queue connector on more than one server group. Active MQ and WebSphere MQ only. Rabbit MQ connectors are not sharable because with Rabbit MQ the input is consumed in a round robin pattern.
Real time file connector

Fields are the same as for Batch file connector, with the following additional fields.
File Name Use a POSIX regular expression to specify the name pattern for the files in the input directory. The input directory is specified on the Properties tab of a deployment.
Data source Select a data source defined on the Settings > Detect Settings > Data Sources page. The Field definition details grid is populated with the fields defined for the data source.
Enable Bloom filter The Bloom filter eliminates duplicate data based upon user-defined filter fields, as follows.
  • Time interval - Controls the time span over which the filter looks for the duplicate data, based on the timestamps of the records..
  • Maximum unique - Sets the maximum number of unique records to store in memory. Valid choices are between 1-99999999999999.
  • Probability - Sets the probability of finding duplicate records, to minimize the number of false positive matches from the Bloom filter. Valid values are any decimal value greater than 0 and less than 1.

When a Bloom filter is applied, the ID and timestamp fields are automatically selected as filter fields and cannot be unselected. You can choose to add additional fields as part of the filter criteria.

Field definition details Define the start position and length of each field, and, if the Bloom filter is enabled, whether to apply the Bloom filter to the field.
Table Connector
Name Enter a descriptive name for this table connector. It is a good practice to align this name with the name of the database you plan to associate with the connector.
Type Select a type from the drop-down list. The options are:
  • State
  • Profile
  • Outcome
  • Expanded Outcome
Table Name Enter the name of the table as shown in your database management client. This must exactly match the name as shown in the client. Case-sensitive.
Description Enter a description of the table.
Sharable Select this check box if you want to be able to use this table connector on different server groups.
Table 4. Server Groups page: Server Groups tab
Field Description
Add Click to open a panel where you can define a server group.
Properties tab
Name Enter a descriptive name for the server group.
Stream Instance Select a stream instance ID. See your administrator if you are not sure which one to select.
Usage Enter a brief description of how this server group is used. For example, Production or Development.
For Production Select this check box if you want to restrict user's ability to run workspaces on this server, based on their permissions.
Servers tab
Fully Qualified Name Double-click in the # of Engines column to set the number of Opportunity Detect engines to run on this machine.
Database tab
Select Runtime database connection The run time database holds the tables where your run, run details, and run status data is stored. Select the run time database that you want this server group to be able to access.
Select database connections for table connector mapping The database connections you check here are the ones that are available when you map a table data source to a connector in the Table Data Source Connector Mapping window.
Data Source Mapping tab
List of datasources Click the name of a data source to open a pop-up window where you can map the data source to a connector.

Only sharable table connectors are available for mapping in the server group page.

A connector can be mapped to only one data source.
Data Source Connector Mapping tab
Data Source Name This is a read-only field that contains the name of the data source you clicked to open this window.
Connector Type Select from a list of data source connector types.
Connector Select from a list of previously configured connectors of the type selected.
Database connection For table connectors only, select from a list of previously configured database connections.