|Maintenance Notice - PDF Generation|
|Dynamic PDF generation for web-based content is temporarily unavailable. This maintenance affects dynamic PDF files that are generated from either the HTML-based page or manual that you are viewing. Links that normally allow this functionality have been hidden, and will reappear as soon as the feature is restored.
<multistep> |-| LRM Deployment Overview= Use this overview of the deployment to serve as a License Reporting Manager (LRM) deployment quick reference. Select a link for more information or click Next Step to view details of each step. The browser back button is not supported on this page.
- Install initial Management Framework components.
- Confirm platform support.
- Confirm installation requirements.
- Install GAX.
- Install the LRM Plug-in for GAX and add the LRM application to the Connections list for GAX.
- Import the LRM application template.
- Create a LRM DB and add a DAP.
- Create and configure the LRM application.
- Install LRM.
- Set the timezone to GMT on the LRM server and the GVP Reporting Server.
- Schedule the statistics gathering job.
- Plan data backup.
- Configure LRM High Availability (Optional).
- Enable Secure Connection Features (Optional).
- Complete Management Framework Installation.
- Configure Interaction Concentrator (ICON) and Interaction Workspace options.
- Install ICON.
- Add a DAP object for each ICON DB.
- Create a cron job to clean up old ICON data.
- Configure GVP Reporting Server for LRM.
- Start LRM.
|-| Install initial Management Framework components= Before you install LRM 8.5.x, you must install a portion of Management Framework 8.5.x components. However, until LRM is installed, Configuration Server interacts only with Management Framework. When you start LRM for the first time after installation, it connects to Configuration Server, and this enables Configuration Server functionality.
See the Management Framework installation.
|-| Confirm platform support=
The Platforms Supported by LRM table lists the operating systems, databases, and virtualization that are supported by LRM in this release.
|OS||Red Hat Linux||
|Database||Microsoft SQL Server||
|-| Confirm installation requirements=
Confirm hardware sizing and performance information in the Genesys Hardware Sizing Guide.
Confirm you are using:
- Management Framework 8.5 or later
- Customer Interaction Management 8.5 or later
- Genesys Interaction Concentrator 8.1.x
- Genesys Voice Platform Reporting Server 8.1.5 or later
- Sun Java Runtime Environment (JRE) 7.0 or later
Any additional functionality not shown in the above diagram is designed to support ease of installation.
|-| Install GAX= Genesys recommends you install GAX release 8.1.4 or later. See the GAX Deployment Guide available on the Genesys Administrator page.
|-| Install LRM Plug-in for GAX= The LRM Plug-in for GAX is an add-on component that is hosted by an existing Genesys Administrator Extension (GAX) installation. The LRM Plug-in for GAX accesses data from the LRM database to provide on-demand reporting to Service Providers and tenant administrators in the GAX graphical user interface (GUI) application .
- Install the LRM plug-in files into the existing GAX directories to enable report generation of LRM statistics from GAX. See Installing a GAX compatible plug-in for details.
- In Configuration Manager, add the LRM Application object on the Connection tab of the GAX object.
- To use the plug-in, open GAX and select License Reporting from the reports menu.
- Refer to GAX online help for:
- Report Generation – System Reports, Tenant reports, Agent and Place Group reports
- Bundle upload
- Viewing Entitlements
|-| Import the LRM application template= To import the required application templates before you configure License Reporting Manager to work in your Genesys environment. Configuration Manager or Genesys Administrator can be used for this and all other procedures that are related to configuration.
- Open the Environment folder and select the Application Templates folder.
- From the File menu, select Import Application Template.
- In the Open window that appears, import the following template from your CD:
- Click Open. The Properties window opens.
- Click OK. The template is imported into the Application Templates folder.
|-| Create a LRM DB and add a DAP=
- Create your LRM database.
- Configure the DAP object on the General tab as a JDBC connection with the correct database server credentials for the DAP object.
- Set the role configuration option in the [lrm] section to main.
Exactly one of your DAPs must have the role value set to main for the LRM DAP. At least one of your DAPs must have the role value set to icon.
|-| Create and configure the LRM application=
- Open the Environment folder and select the Applications folder.
- From the File menu, select New > Application. The Browse window opens, listing all application templates that are present in the Configuration Database.
- Choose the License Reporting Manager application template.
- Click OK. The Properties window appears.
- On the General tab, add a unique name to the Name field for this instance of LRM.
- Select the Server Info tab. In the Host Name field, add the name of the host on which you are installing the application.
- Select the Start Info tab, and add “...” to each of the following fields:
- Working Directory
- Command Line
These fields are automatically filled with the correct information when LRM is installed.
- Select the Connections tab. Right-click and select New. In the Server field, enter the name of each DAP. Add:
- A DAP for the LRM database. Set the value of role to main in the DAP Application.
- Select the Security Tab. Under Log On As, select
This Account. Click
Open fileto display a list of names and select a user with full control permissions over the Environment tenant. This enables LRM to write the entitlement information into the Transactions of the Environment tenant when it imports the license file.
- Click OK. Configuration of your LRM instance is complete.
|-| Install LRM=
|-| Set the timezone to GMT= You must configure LRM server and GVP Reporting Server to use the GMT timezone, because LRM uses the GMT time zone to keep track of the days in the system.
|-| Schedule the statistics gathering job= Schedule the nightly statistics gathering job to run at the time each day when there is a low volume of interactions in the contact center (for example, at night).
Set the schedule option in the [lrm] section to an appropriate value for your contact center. The default value is 01:00 (1am GMT).
|-| Plan data backup= It is important to regularly backup the data in your License Reporting Manager database to prevent data loss. Backup of the LRM database is the responsibility of the Database Administrator. The following LRM tables can be backed up using the tools in your particular RDBMS:
|-| Configure LRM High Availability (Optional)=
You can set up LRM as a pair of primary-backup applications. Both applications must be installed, configured, and started. If both of these applications are up and running, the Solution Control Server determines which of the applications act as the Primary, while the other acts as the backup.
To configure the system, the system administrator must:
- Install and configure two separate instances of LRM.
- Select the Server Info tab in the Application object for the primary LRM application.
- Click the open folder icon next to the Backup Server field to choose the LRM application which is to serve as the backup.
|-| Enable Secure Connection Features (Optional)=
You can secure connections from LRM to Configuration Server. All of the security features are optional.
- Enable Transport Layer Security (TLS) protocol.
- UNIX only: Install the Genesys Security Pack on the LRM server host, and set the applicable environment variable to specify the path to the Security Pack libraries. See "Security Pack Installation" in the Genesys 8.1 Security Deployment Guide.
- Create and install certificates on the LRM server host and Configuration Server host. See "Certificate Generation and Installation" in the Genesys 8.1 Security Deployment Guide.
- If required, change the configurations of the Configuration Server applications:
- Add a new port for secure connections. On the Configuration Server Application object, select the Auto Detect mode.
- Use a host certificate.
See "Genesys TLS Configuration" in the Genesys 8.1 Security Deployment Guide.
- On the LRM Application object, add connections to Configuration Server. When you add the connection(s), you must use the port that you created in the previous step.
- Enable client-side port definition.
- When you install LRM, select the connection parameters that LRM will use for the initial connection to Configuration Server. See "Client-Side Port Definition" in the Genesys 8.1 Security Deployment Guide.
- In the LRM Application object, add or modify the connection to Configuration Server, to specify the connection parameters (port number and, optionally, IP address) that LRM uses to reconnect to Configuration Server after a switchover or disconnection. Configure the parameters in the Transport Protocol Parameters text box on the Advanced tab of the connection properties. See "Client-Side Port Definition" in the Genesys 8.1 Security Deployment Guide.
- Enable the SSL protocol on the JDBC connections between LRM and its source and target databases. When you configure the extraction DAP(s) and the LRM DAP, use the jdbc-url option to specify the URL information as required by your RDBMS to implement JDBC over SSL.
|-| Complete Management Framework Installation=
|-| Configure ICON and Interaction Workspace options= In order for LRM to calculate statistics it is important that certain Interaction Concentrator and Interaction Workspace options be set correctly.
- [role]—This option specifies the type of data that the Interaction Concentrator instance processes and stores in the Interaction Concentrator database.
For Interaction Concentrator release 8.1 and later, the ICON instance can be configured to store your LRM-specific data. You must set the role option to lrm. Do not combine the lrm role with any other in the same instance of ICON.
See the Interaction Concentrator 8.1 Deployment Guide for more information about using ICON for License Reporting Data.
- [use-dss-monitor]—This option must be used with LRM for the usage data gap processing. Set this option to 1 to populate the G_DSS_GLS_PROVIDER and G_DSS_GOS_PROVIDER tables with Interaction Concentrator release 8.0.000.25 or later.
See the Interaction Concentrator 8.1 Deployment Guide for more information on the use-dss-monitor option.
- [dss-no-data-tout]— This option must be used with LRM for the usage data gap processing. Set this option to the preferred value. This option enables you to set the time interval after which Interaction Concentrator provides the NoData indication in the G_DSS_GLS_PROVIDER and G_DSS_GOS_PROVIDER tables. The NoData indication enables you to distinguish cases in which there was no data from those in which a connection problem prevented the data from being properly recorded.
See the Interaction Concentrator 8.1 Deployment Guide for the default and valid values for the dss-no-data-tout option.
Make sure that the gls data options are set to their default values (equal to 0).
See the Interaction Concentrator 8.1 Deployment Guide for the full description of the filter-data options.
- [license.lrm-enabled]—This option must be added and set to true to enable Interaction Workspace to support LRM. This feature might not work if Interaction Workspace is customized. Changes take effect after you restart Interaction Workspace.
|-| Install ICON= Install ICON and create a database for ICON if necessary. See the ICON Deployment Guide on the Interaction Concentrator page
|-| Add a DAP object for ICON=
To configure the LRM solution properly, you must define Database Access Point (DAP)objects that describe the databases to which LRM has access. Create a DAP object for each ICON to which you connect, and you cannot reuse the corresponding DAP object already in use by ICON, because LRM uses the JDBC options to configure the connection to the databases. The LRM application extracts data from these ICON databases used to prepare the reporting data.
- Configure the DAP object on the General tab as a JDBC connection with the correct database server credentials for the DAP object.
- Set the role configuration option in the [lrm] section to icon.
|-| Create a cron job to clean up old ICON data=
Create a cron job to clean up old ICON data by using the DB purge script. See the ICON User's Guide on the Interaction Concentrator page for details.
|-| Configure GVP Reporting Server for LRM=
- Historical reporting must be enabled on the GVP Reporting Server for LRM and GVP to work together. To enable historical reporting on GVP Reporting Server, do not run GVP Reporting Server in nodb mode; that is, set the [persistence] rs.nodb.enabled option to false (the default value).
- GVP Reporting Server must be running for LRM to collect data.
- Select the Connections tab. Right-click and select New. In the Server field, enter the name of the GVP Reporting Server. If your GVP Reporting Server is set up as an HA pair, add only the primary instance and not the backup.
|-| Start LRM=
When the installation of License Reporting Manager (LRM) has been verified, and the LRM databases have been initialized, start LRM in Genesys Administrator.
- In Genesys Administrator, select Operations > Applications > <LRM Application>.
- Right click on the LRM application name and select Start applications.