Jump to: navigation, search

Data Manager

Data Manager feature provides the following functionality:

  • Support for multiple Genesys and Cisco Adapters.
  • Load balancing across multiple adapters using the same data source in a single Genesys environment.
  • Management of the flow of statistics from Advisors Genesys Adapters (AGA) to both Frontline Advisor (FA) and Contact Center Advisor/Workforce Advisor (CCAdv/WA).
  • Maintenance of the authoritative configuration data. Data Manager monitors Adapters to ensure that the issued statistics conform to its configuration.
  • Use of statistics template definitions to determine the statistics requests that need to be sent to the Genesys Adapters for each Advisors module (such as CCAdv or FA).
  • Use of a handshake protocol to establish connection with all adapters.

In Advisors release 8.1.5, source metric definitions and statistics templates stored in the Adapter database had to be migrated to the corresponding platform tables. The migration included any custom metrics you use in your enterprise and had to be done for all Advisors modules that use Genesys Adapter.

  • The source metrics that migrated to the platform tables were for the CCAdv, WA, and FA modules that require Genesys data sources.
  • The statistics templates that migrated to the platform tables were only for the CCAdv and WA modules. Because the FA statistics templates are of a transient nature, there was no need to migrate them and the migration tool ignored them.
For more information, see the Genesys 8.1 Performance Management Advisors Deployment Guide.

During the installation of any Adapter, the installer optionally prompts for:

  • The connection details for the Platform database.
  • A unique name for the Adapter and the source environment (the source environment is not prompted for in a Genesys environment).
This information, along with the Adapter’s host name, port and type (GENESYS or CISCO) is written to the Platform database. Data Manager uses this configuration information to establish connections to all installed Adapters.

The Adapter type is always set to either GENESYS or CISCO. You must register all Genesys Adapters, although you can choose to bypass Cisco Adapter registration.

Object Configuration User account

You must configure a user account in Configuration Server so that security permissions can be assigned to allow object configuration for the CCAdv module in the Advisors Administration module (Base Object Configuration page). This is the Object Configuration User.

Important
This user must be created in the Configuration Server before you install Advisors Platform. Advisors Platform installer prompts you for the account name.

Object Configuration User—You must create the Object Configuration User account in the Genesys Configuration Layer. You create this user account in Configuration Server as a container for security permissions for objects (Agent Groups, Queues, and Calling Lists). The Object Configuration User requires Read permission for any object that should be considered a configured or monitored object.

Platform Configuration Server User—The Platform Configuration Server user (that is, the Advisors User account) also requires specific permissions to manage object configuration in Configuration Manager related to Data Manager. See Create the Advisors User Account.

The Manage Adapters page is read-only.

  • To make changes to the properties for an Advisors Genesys Adapter, update the configuration in the database (see Update AGA Properties in the Database).
  • To manage objects, use the Base Object Configuration page in the Administration Module.
Base Object Configuration Considerations

  • New3.png Starting in release 8.5.0, you must deploy the Contact Center Advisor application (including XML Generator) and configure the Genesys metric sources before you can use the Genesys Base Object Configuration page in the Administration module. Data manager requests no statistics for pre-configured objects until the CCAdv module, XML Generator, and Genesys metric data sources are deployed and working.
  • The object configuration is done once and independently of any underlying adapters.
  • You can identify and filter objects by object type on both mapping screens.
  • The page displays the count of configured objects. New3.png Calling list objects are counted as queues.
  • The page prevents contradictory configuration. If you select No Filter for an object and then later attempt to assign a filter, you receive an error message. You must de-select No Filter before you can assign a filter to that object.
  • The associations that display on the Base Object Configuration page represent a global configuration for CCAdv/WA.

Data Manager uses the Configuration Server connection provided by Platform to load Genesys object metadata from Configuration Server. Changes in configuration made on the Base Object Configuration page are saved in the Configuration Server for incorporation. Therefore, the Configuration Server system user that is configured on the platform installation (that is, the Advisors user account) should have Change and Change Permissions privileges on the agent groups or queues that are monitored, as well as Read and Read Privilege access permissions for the Advisors User account (see Create the Advisors User Account).

In Genesys Configuration Manager, you create the Object Configuration User account and assign security permissions for objects (agent groups, calling lists, and queues) to the account. The agent groups, calling lists, and queues to which the Object Configuration User has Read access permission are treated as the configured objects for CCAdv/WA. If this user has access to agent groups, calling lists, or queues when Data Manager starts, Data Manager immediately issues statistics requests to the configured Genesys Adapter(s).

Integration with Configuration Server involves a number of aspects, discussed in the following sections:
[+] How Configuration Objects Are Identified


[+] Base Object Configuration Page Users and Permissions
[+] Filter Configuration

For each source environment in which a given object is present, a corresponding object must exist in the Genesys environment.

When the object already exists in the Genesys environment (that is, it handles interactions monitored by Genesys components, the External ID has the format:

[ Tenant Name ] Employee ID

For all other source environments, the object must be created and an entry must be added to the object’s Annex tab under an Advisors section. The key for each such entry has the format:

ExternalId.SourceEnvironment

The value is the ExternalID itself.

  • For Genesys Adapters, the source Environment is always GENESYS.
  • The Cisco Adapter installer prompts for the environment name, with the default value CISCO.
For example, if you are using a Cisco Adapter and want to set the External ID to the Agent Skill ID, the configuration would look as shown in the following figure:
Setting the External ID for a Cisco Agent to their Agent Skill ID

When two or more Adapters share the same source environment, this indicates that they are connected to the same underlying data provider infrastructure and hence are all able to provide the same set of source metrics. Data Manager is free to select from any Adapter with the same source environment to issue a given statistic. Data Manager attempts to distribute sets of statistics for a given source evenly across all Adapters associated with that source.

New3.png Starting in release 8.5.0, if you add adapters to your deployment after the initially-installed adapters are running, the existing statistics are not automatically re-routed to the newly added adapters. That is, load balancing is not re-distributed among all the adapters, including the ones you added. For the procedure to re-distribute the statistics load balancing to include newly-deployed adapters, see Re-distribute Stats Load when Adapters are Added.

Once a statistic is opened for a given object with an Adapter, all subsequent statistics for that object will be opened using the same Adapter. This helps maintain (but does not guarantee) consistency among related metrics reported for this object.

Statistics for a given object can span multiple Adapters, but only if the associated metrics have different Stat Server Type (SST) attributes. Examples of SST include Core (which all Stat Servers can provide), Interaction Queue, and Open Media. Statistics are partitioned by (object,SST). Each (object,SST) group is issued against the same Adapter. The Adapter requires the following:

  • A source environment that matches the object's External ID
  • A Stat Server Type supported by the Adapter
If a limited number of Adapters support metrics of a specific SST, such as Open Media, statistics of this type constitute the bulk of statistics issued to these Adapters. Statistics for more generally-supported metrics, such as Voice, are concentrated with Adapters that do not support such specialized statistic types.

Cisco Impact
Advisors Cisco Adapter is used with FA only. Because the Cisco Adapter automatically collects metrics for all agents in that source environment, there is no benefit to load balancing across multiple instances. The only scenario in which multiple Cisco Adapters should be installed is if they provide metrics from separate HDS/AWDB source environments.

If you are experiencing issues with Data Manager, check for the following problems:

No Genesys Adapters Installed or Configured
If there are no Genesys Adapters installed or configured for a given module (for example, CCAdv), Data Manager cannot issue statistics for that module. This condition (that there are no supported Adapters) is reported in the geronimo.log file as a warning message.

Important
After installing an Adapter for a module, you must restart the Advisors Suite server.


Genesys Adapter is Unavailable

If there is one or more Genesys Adapter installed and configured for a given module, but the Adapter is not running or is unreachable, Data Manager cannot request statistics for that module. This condition is reported in the geronimo.log file as an error message with an exception (Multiple Adapters Exception). The error is no longer reported after the configured Adapter is started.

New3.png Data Manager does not Re-distribute Stat Requests to other Adapters when one Adapter's Service is Stopped

When one or more adapter (ACA or AGA) instances are installed, ensure that they are always in use. A deployed adapter that is not running can prevent Data Manager from sending requests to the other live adapters. If you have a deployed adapter that is not going to be in use, Genesys recommends that you remove the adapter configuration from the Advisors Platform table ADAPTER_INSTANCES to prevent disruption of service in the active adapters.

If you have a deployed, but inactive adapter, use the following procedure to remove all the objects from its configuration.

1. Determine which objects are associated with the inactive adapter:
  • Run the select adapter_instance_id, name from adapter_instances statement against the Advisors Platform database – this provides the ID value for each adapter instance.
  • Run the <tt>select adapter_instance_id, ss_pair_id from adapter_ss_config where adapter_instance_id = <ID of adapter> statement against the Advisors Platform database – this shows you which Stat Server pairs are associated with the adapter.
  • Run the select distinct objectid, objecttype, from adapter_ss_Mapping where ss_pair_id = <ID of Stat Server> statement against the Advisors Platform database – this shows you which objects are associated with the Stat Server pair for each adapter. Remove the objects associated with the Stat Server pair for the adapter that you must delete from the table. If there is more than one pair, replace = <ID of Stat Server> with IN (Id,Id).
2. To remove the identified objects, run the Delete from adapter_ss_mapping where ss_pair_id = <the pair associated with your inactive Adapter> statement. If there is more than one pair, replace = <the pair associated with your inactive Adapter> with IN (Id,Id).
3. To remove the Stat Server pair rows associated with the adapter, run the Delete from adapter_ss_config where adapter_instance_id = <ID of adapter to delete> statement.
4. To delete the adapter_instance row, run the Delete from adapter_instances where adapter_instance_id = <ID> statement.

No Object Configuration User Specified

For the CCAdv module, an Object Configuration User must be specified when you install Advisors Platform. If configuration of this user name is omitted, no statistics are issued with the Adapters. This is indicated by an information message in the Platform geronimo.log file. The information message indicates that no statistics are requested because no agent groups and queues are found. To correct this:

  1. Update genesys.configServer.objectconfig-username in the Platform GenesysConfig.properties file.
  2. Restart Platform after you update the properties file.

No Object Configuration User Exists

If the Object Configuration User does not exist in the Genesys Configuration Server, an error message is logged in the form of an exception. To correct this issues:

  1. Create the user in Configuration Server.
  2. Update genesys.configServer.objectconfig-username in the Platform GenesysConfig.properties file.
  3. Restart Platform after you update the properties file.

Base Object Configuration page is empty – unable to publish CCAdv base objects

Ensure the Administration user who is logged in to the Administration module (workbench) has been assigned the Read permission for the tenant under which the source objects exist that the user must monitor.


This page was last modified on January 12, 2015, at 12:01.

Feedback

Comment on this article:

blog comments powered by Disqus