Jump to: navigation, search

Prerequisites for FA

Before you deploy Frontline Advisor (FA), it is helpful to answer the following questions:

  • Will you install the FA application in standalone or distributed mode? If distributed, which FA instance (on which server) will be responsible for data aggregation, and which will be presentation nodes?
  • Will you deploy the FA application on a Linux Red Hat or a Windows platform?
  • Where are you installing Advisors (in which directory)? The default location is C:\ProgramFiles\GCTI\Advisors.
  • Do you want the FA application to send email notification messages? From what address will an application send notifications (for example, DONOTREPLY@<your enterprise>.com)? To what email address will an application send notifications? What is the subject line for such email messages (for example, Frontline Advisor notification)?
  • The FA Server requires integration with the Solution Control Server. 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.


Ensure you have completed all the tasks in the following Table before you begin Frontline Advisor deployment.

Y or N Prerequisite
The Advisors Genesys Adapter is installed.
You have initialized databases—databases must be present and at the current version prior to running the installation files. You have configured administrator accounts that can be used by applications to access the databases.
Advisors Platform is successfully installed on each physical server on which you will install the Frontline Advisor or Agent Advisor application.
You have installed the Local Control Agent (LCA). See Integration with Solution Control Server and Warm Standby and Overview: Configuring Advisors Application Objects and Deploying Modules that are Controlled by SCS 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 Overview: Configuring Advisors Application Objects and Deploying Modules that are Controlled by SCS for more information.
In a Genesys environment, you have established connection to the Genesys Solution Control Server.
The FA hierarchy is configured on the Genesys Configuration Server and you can identify the following:
  • the tenant(s) associated with the hierarchy
  • the path to the hierarchy root folder(s) in Genesys Configuration Server
You have located the fa-server-installer-<version>.jar file on the installation CD and have copied it to the local drive of your server. Copy the installation file to the Advisors home directory.
[+] Show additional information for Linux environments
While you can use any Genesys configuration interface to import Advisors privileges into a Role, or to assign Role-based permissions to Users or Access Groups for access to the Advisors business attributes, you can view the Advisors privileges associated with a Role only in Genesys Configuration Manager. If you need to view the Advisors privileges associated with Roles regularly, then ensure you have access to Genesys Configuration Manager.

Collect Information

During deployment of Frontline Advisor, the installer will prompt you for the information in the following Table.

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

(The installation directory for Frontline Advisor server must be the same as the directory where Advisors Platform was installed.)

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

Default on Linux:
Are you running FA in standalone or distributed mode? If distributed, which FA instance (on which server) will be responsible for data aggregation? Only one FA instance in a cluster can be responsible for data aggregation; you must enable the rollup engine on this instance. In a warm standby configuration, however, you must enable the rollup engine on both the primary and backup applications. The two applications do not run simultaneously, and in the event of failover, the backup must be able to continue the data aggregation processes.
You require the following information to integrate with the Genesys Management Layer if you are installing the FA Server (FA that includes the rollup engine):
  • The FA Server Application name exactly as it appears in Configuration Server.
  • The port number on which the server's LCA listens.
  • The name, in Configuration Server, of the Solution Control Server Application that you will use with Advisors.
Default LCA port is 4999.

Default name of the SCS is SCServer.

Information about your hierarchy. You require one of the following:
  • The name of the tenant(s) in the Genesys Configuration Server in which the monitoring hierarchy resides, and the path to the hierarchy root folder(s).
  • The name of a Person folder in your Genesys configuration interface (for example, Genesys Administrator), and the path to that Person folder. Selecting this option restricts the hierarchy view that is loaded at startup (or reloaded using the reload feature) to the team of agents belonging to that person (supervisor).
Default tenant name is Resources.

Default path to the hierarchy is Agent Groups\\Enterprise.

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 on which the database listens (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 an Oracle installation) and password associated with the account that FA will use to access the Platform database.
  • For clustered databases, the location of the file that contains the JDBC URL (you should have the freeform JDBC URL in a text file).
Default database server name is localhost.
Default values for port number:
  • Oracle: 1521
  • MS SQL: 1433

If you will send email notifications from the application, you require the following details for the SMTP (mail) service that you will use to send the notification messages:

  • The address from which to send application notification email.
  • The address to which to send application notification email.
Advisors modules store the email addresses that you enter on the installation wizards and use those addresses to notify support staff about operating issues. The email addresses are stored in the relevant properties file. A user's email address persists in the properties file even after a user's Person object is removed from Configuration Server. An email address that contains an employee's full name can be considered to be personally identifiable information (PII) and therefore, to be compliant with the General Data Protection Regulation (GDPR), you must remove the user's email address from the properties files if the user makes a "forget me" request. The need to update the properties file(s) to remove email addresses can be avoided if you always use an email alias for support staff, rather than user-identifying email addresses. For example, use advisors.support@yourcompany.com instead of john.doe@yourcompany.com. For more information about PII and the GDPR, see the Genesys Security Deployment Guide.
This page was last edited on May 22, 2019, at 14:53.
Comments or questions about this documentation? Contact us for support!