Jump to: navigation, search

Prerequisites for CCAdv and WA

Before you deploy Contact Center Advisor (CCAdv), Workforce Advisor (WA), or Alert Management (AM) Administration, it is helpful to answer the following questions:

  • Will you deploy the software on a Linux Red Hat or a Windows platform?
  • Each of the modules associated with a CCAdv/WA installation (CCAdv web services, CCAdv XML Generator, CCAdv-ME, WA server, WA web services, and Alert Management Administration) can be installed on a different machine, or multiple modules can be installed on the same machine. If you are installing multiple modules, on which system will you install each module?
  • Some of these modules require integration with SCS. For details see Integration with Solution Control Server and Warm Standby. Ensure you understand the limitations and special configuration requirements when planning which Advisors applications to install on a server.
  • Will you install the CCAdv application, and if so, will you install it with XMLGenerator and CCAdv Web Services on the same system? Or will you install it in distributed mode, with CCAdv Web Services on different system(s) than the XML Generator? If distributed, which systems will host the XML Generator, and which will host the Web Services?
  • Each system on which you installXMLGen is a unique cluster node. What will you use for the node ID?
  • Will you install the WA application, and if so, will you install it with WA Server and WA Web Services on the same system? Or will you install it in distributed mode, with WA Web Services on different system(s) than the WA Server? If distributed, which systems will host the WA Server, and which will host the Web Services?
  • If you will install WA, what are your workforce management data sources and how many do you require?
  • Will CCAdv or WA send e-mail notifications about alerts?
  • Will you deploy CCAdv–ME?
  • Will you deploy AM Administration? You should deploy it on the same system as the Administration Workbench.
  • Where did you install Advisors Platform on this system? When installing a module that depends on Platform, its installation directory must be the same as the directory where Platform was installed.

Prerequisites

Ensure you have completed all the tasks in the following Table before you begin Contact Center Advisor/Workforce Advisor deployment.

If you have already installed Advisors Platform on the same system, then you will have done many of these tasks. If you are installing CCAdv XML Generator on a system on which Platform is not installed, then you must do them.

Y or N Prerequisite
All Modules
A verified Genesys environment must be ready and available.
In a Genesys environment, you have established connection to the Genesys Configuration Server.
If you primarily use Genesys Administrator as your management user interface, ensure you also have access to Configuration Manager. You can use Configuration Manager or Genesys Administrator to define and maintain roles, and associate roles with users (Role-Based Access Control). There are limitations, however, that prevent you from viewing and editing privileges and permissions for Advisors roles; for those tasks, you require Configuration Manager.
You have configured the Advisors User account in the Genesys Configuration Server. For more information see Creating the Advisors User.
You have configured the Object Configuration User in the Genesys Configuration Server. For more information, see Data Manager.
You have initialized databases—databases must be present and at the current version prior to running the installation files. The following list shows the databases required by each component:
  • Contact Center Advisor: Platform database and metric graphing database
  • Workforce Advisor: Platform database and metric graphing database
  • Contact Center Advisor–ME: Platform database and metric graphing database
  • AM Administration: Platform database

You have configured administrator accounts that can be used by applications to access the databases.

Advisors Platform is successfully installed on each system on which you will install all modules (it is no longer required for CCAdv XML Generator).

(For Cisco installations, no adapter is required.)

You have located the ccawa-installer-<version>.jar file on the installation CD and have copied it to the local drive of your server.
CCAdv XML Generator
In a Genesys environment, you have established connection to the Genesys Solution Control Server and to its backup if there is one.
You have installed the Local Control Agent (LCA). See Integration with Solution Control Server and Warm Standby and Deploying Components Controlled by Solution Control Server for more information.
You have created the required Application and Host objects in Genesys Administrator or Configuration Server. If you are configuring Advisors in warm standby mode, then you have configured both primary and backup Applications and associated each primary Application with its backup for failover. See Integration with Solution Control Server and Warm Standby and Deploying Components Controlled by Solution Control Server for more information.
There is a database-level connection between the Advisors Platform database and the datasource database (a Genesys metrics database and/or a Cisco ICM AWDB database).

To configure the connectivity, see Configure Oracle Metrics Data Sources.

For Genesys installations, the Advisors Genesys Adapter is installed.
You have set the Regional and Language options to the locale for which you want the servers to be deployed.
Workforce Advisor Server
In a Genesys environment, you have established connection to the Genesys Solution Control Server.
You have installed the Local Control Agent (LCA). See Integration with Solution Control Server and Warm Standby and Deploying Components Controlled by Solution Control Server for more information.
You have created the required Application and Host objects in Genesys Administrator or Configuration Server. If you are configuring Advisors in warm standby mode, then you have configured both primary and backup Applications and associated each primary Application with its backup for failover. See Deploying Advisors in Warm Standby Mode for information.
Verified workforce management data sources must be ready and available.

For Workforce Advisor installations connecting to Genesys WFM, the server running WA must be able to access your Genesys WFM installation.

To verify this access, ensure you can do all of the following from your WA server machine:

  1. Successfully ping the server name or IP address specified in the base WFM URL.
  2. Successfully telnet the server name or IP address and the port specified in the base WFM URL.
  3. Successfully ping the host name of your Genesys WFM instance as it appears in your WFM server's Configuration Manager application.

Your WA server must have access to the WFM server by its associated Configuration Manager host name. If it does not, an UnknownHostException occurs because the SOAP API's service locator provides a host name that is not reachable by the WA server.

If you cannot ping or access the Genesys WFM instance using the associated Configuration Manager host name from the machine hosting the WA server, then you must add the following lines to the hosts file on the machine that will host the WA server:
# For WA connectivity with WFM
[IP address of WFM server] [Associated Configuration Manager host name for the WFM instance]

Example: 192.168.98.229 demosrv.genesyslab.com
The hosts file is OS-specific. For example, for Windows 2003, the host file resides in the following location:
%SystemRoot%\system32\drivers\etc\

Collect Information

During deployment of Contact Center Advisor/Workforce Advisor, the installer will prompt you for the information in the following Table. Default values provided by the installer are entered in the Table.

Information Input
All Modules
Location and name of the base directory in which you will install Advisors.

The installation directory for CCAdv/WA modules must be the same as the directory where Advisors Platform was installed. Contact Center Advisor XML Generator does not require Platform, so can be installed independently.

Default on Windows:
C:\Program Files\GCTI\Advisors

Default on Linux:
/opt/gcti/advisors
Location of the Java Development Kit (root directory).
Contact Center Advisor XML Generator
Connection details to the Genesys Configuration Server:
  • The name of the Configuration Server (the Application name, obtained from Genesys Administrator). If you have Configuration Servers configured in High Availability mode, enter the name of the primary Configuration Server.
  • The name or IP address of the machine that hosts the Configuration Server.
  • The port that the configuration server is listening on (if you are not using a TLS connection). If you use a TLS connection, identify the TLS port number.
  • The name of the application that XML Generator will use to log in to the Configuration Server (for example, default).
  • The user name and password of the account that XML Generator will use to connect to the Configuration Server. This is the 'Advisors User'.

If you will connect to the Configuration Server using TLS, then you also require the following information:

  • The TLS port number for the Configuration Server.
  • The location of the TLS properties file.

If you use a backup Configuration Server, you require the following information, as well:

  • The name of the backup Configuration Server (the Application name, obtained from Genesys Administrator).
  • The name or IP address of the machine that hosts the backup Configuration Server.
  • The port on which the backup Configuration Server listens.
Defaults are:
  • Configuration server name: confserv
  • Configuration server port: 2020
  • Application name: default
The name of the Object Configuration User account (configured in Configuration Server). See Integration with Solution Control Server for information.
The name of the default tenant in the Configuration Server under which the Advisors metadata is maintained.

When multiple Advisors suite installations are deployed to use the same Configuration server, the default tenant selected on each Advisors suite installation must be a different tenant. The default tenant configuration is selected when installing the Advisors Platform server.

The name, in Configuration Server, of the XML Generator Application. See Integration with Solution Control Server and Warm Standby for more information.
The name, in Configuration Server, of the primary Solution Control Server application. Default is SCServer.
The port number on which Local Control Agent listens on this system. Default is 4999.
Node ID for this server in the Advisors cluster. Use letters, numbers, or the dash character. The maximum 16 characters. For details see Advisors Cluster Information.
The IP address or host name that other cluster members will use to contact this node (not localhost or 127.0.0.1).
The local host address (localhost or 127.0.0.1). Default is localhost.
The HTTP port number the members of the cluster will use to communicate with XML Generator.
If you are going to install two different deployments of XML Generator on the same machine see Multiple Advisors Deployments on One System for how to choose this port number.
Default is 8090.
The Java Messaging Service port number the members of the cluster will use to communicate with XML Generator.
If you are going to install two different deployments of XML Generator on the same machine see Multiple Advisors Deployments on One System for how to choose this port number.
Default is 61616.
The port number the cluster's distributed caching will use to communicate with XML Generator.
If you are going to install two different deployments of XML Generator on the same machine see Multiple Advisors Deployments on One System for how to choose this port number.
Defaults are 11211 and 11212.
The maximum number of times that XML Generator should attempt to connect to a database if there is a connection failure.

This parameter is applicable to retry attempts when XML Generator is already running; that is, after establishing connections at startup.

Default is 32 times.
The number of seconds between CCAdv XML Generator’s reconnection attempts in the event of a database connection failure.

This parameter is applicable to retry attempts when XML Generator is already running; that is, after establishing connections at startup.

Default is 30 seconds.
The following details for the SMTP (mail) service that XML Generator will use to send e-mail:
  • The host name or IP address of the SMTP server that XML Generator will use to send e-mail.
  • (Optional) The address from which XML Generator will send notification e-mail about alerts.
  • The address to which to send notification e-mail for support staff concerning issues with XML Generator. This address will also appear in the From: header of these types of e-mail.
Frequency (in seconds) at which CCAdv XML Generator stores metrics and threshold violations for the values calculated for the Medium and Long groups of time profiles.

For example, if you enter 120 seconds for this parameter, XML Generator stores metrics and threshold violations for these time profiles no more often than that. However, XML Generator may store the view data less frequently depending upon load and the complexity of the configuration.

Default is 120 seconds.
The frequency (in seconds) at which snapshots are stored in the metric graphing database.

For example, if you enter 60 seconds for this parameter, XML Generator stores graphable snapshots no more often than that. However, XML Generator may store the snapshots less frequently depending upon load and the complexity of the configuration.

Default is 60 seconds.
Should graphs display values from the previous day? Do not check the Start at midnight box if you want graphs to display values from the previous day.
What are XML Generator's sources of real-time data? Specify the following:
  • the database name or linked server name
  • the source type (Genesys or Cisco)
  • (optional) the display name
  • the threshold update delay—how long CCAdv will wait for new data from this data source before notifying users on the CCAdv dashboard, and, if configured to do so, administrators by e-mail.
  • the Relational Database Management System (RDBMS) type (MS SQL or Oracle)

Up to five data sources may be added to the deployment of XML Generator.

CCAdv–ME Server:
CCAdv–ME server configuration. Specify the following:
  • Will you use a logo link URL (image link)?
  • If yes, what is the URL to which users are re-directed when they click the image or logo?
  • Interval (ms) for purging the charting local cache from the server.
  • Delay for retries on a failed response (ms).
  • Number of retries on a failed response.
  • Device refresh interval (ms) for the client views when auto-refresh is enabled.
Defaults are:
  • Interval for purging: 500 ms.
  • Delay for retries: 1000 ms.
  • Number of retries: 10.
  • Device refresh interval: 60000 ms.
Time intervals for trend charting. Defaults are:
  • Period one: 30 min.
  • Period two: 60 min.
  • Period three: 120 min.
Workforce Advisor Server
The name, in Configuration Server, of the WA Server Application.
The name, in Configuration Server, of the Solution Control Server application. Default is SCServer.
The port number on which Local Control Agent listens on this system. Default is 4999.
Specify your workforce management data sources (IEX TotalView, Aspect eWFM, Genesys WFM).
The 'From' address WA puts in e-mail it sends about alerts to users that are members of distribution lists configured in the Administration module.
If you are using WFM data from IEX TotalView, then specify:
  • the port number on which the FTP connection in WA listens for data from TotalView.
Default port number is 6021.
If you are using WFM data from Aspect eWFM, then specify:
  • the URL of the directory from which WA reads data from eWFM. For example file:/// followed by the location of the eWFM files. Additional information is provided in the descriptions of installation screens on the Deploying CCAdv and WA page.
If you are using WFM data from Genesys WFM, then specify:
  • The URL of the WFM server.
  • The Application name of the WFM server as configured in the Configuration Server.
  • The user ID, either a specific numeric user ID to indicate the identity of the requests, or enter 0 (zero) to indicate no user
  • The interval (in ms) at which the Genesys WFM service is polled for forecast data.
  • The number of hours of forecast metrics to get on each polling.
Default values are:
  • Application name: WFM_Server
  • User ID: 0 (no user.)
  • Polling interval: 1800000 ms. (30 minutes.)
  • Number of hours of forecast metric to retrieve: 24 hours.
CCAdv XML Generator, CCAdv Web Services, Workforce Advisor Server, and Workforce Advisor Web Services
The time profile to use for default historical metrics that you want to display for agent groups in Contact Center Advisor and Workforce Advisor. The choices are 5 minute sliding, or 30 minute growing. The same choice applies to both applications.

For metrics imported from CISCO ICM, Advisors always imports agent group metrics with the 5 minute sliding profile. If you are running Advisors with CISCO ICM, and you choose the 30 minute growing option here, then on the dashboards, historical agent group metrics will display as a dash. Genesys recommends that you use the five minute growing setting if you have a CISCO source of data.

Default is 5 minutes sliding.
Type of database used in your enterprise (MS SQL or Oracle), and connection details to the Advisors Platform database:
  • The host name, IP address, or named instance of the server on which the Advisors Platform database is installed.
  • Port number that the database listens on (you do not require this information if the server is a named instance)
  • The Platform database name (the Service name for an Oracle installation)
  • The username (the schema for clustered databases or an Oracle installation) and password associated with the account that modules will use to access the Platform database
  • For Oracle environments, the location of the JDBC driver.
  • For clustered databases, the location of the file that contains the advanced database connection string. If you do not know how to correctly build the advanced database connection string, contact your database administrator.

Use the same database configuration that was specified when the Advisors Platform database was configured.

Default values for port number:
  • Oracle: 1521
  • MS SQL: 1433
Connection details to the Metric Graphing database:
  • The host name, IP address, or named instance of the server on which the Metrics Graphing database is installed.
  • Port number on which the database listens (you do not require this information if the server is a named instance).
  • The Metrics Graphing database name (the Service name}} for an Oracle installation).
  • The username and password associated with the account that modules will use to access the Metrics Graphing database.
  • For clustered databases, the location of the file that contains the advanced database connection string. If you do not know how to correctly build the advanced database connection string, contact your database administrator.
Default values for port number:
  • Oracle: 1521
  • MS SQL: 1433
This page was last edited on August 24, 2018, at 18:48.
Comments or questions about this documentation? Contact us for support!