The Recording Plug-in template XML file includes the role privilege data that must be imported into Genesys Administrator Extension. This data is imported when the IP and template files are imported into Genesys Administrator Extension.
Installing the Plug-in from within Genesys Administrator Extension
Be prepared to enter the directory path to an installation directory, or to a zipped file.
Required software: Genesys Administrator Extension 8.1.4 or later.
To install the Plug-in:
Select Installation Packages from the Administration menu.
Click the "plus" icon (+) at the upper right of the Installation Packages window.
The Software Installation Wizard dialog appears to the right of the current
window, offering these Import Type Selection choices as radio buttons:
Select the radio button that matches your installation source and click the Next button.
The next dialog will request input according to your choice in the previous step:
Installation Package Upload (includes templates) requires you to choose a zipped IP file.
Installation Package Upload (template uploaded separately) requires you to select a zipped IP file, an XML template and an APD template (all three).
Each of the three choices that begin with UNC Path requires a directory path that you may type or paste into the entry field. You may see a request to correct an error; type or paste your correction. When GAX is ready to install, the Finish button will be enabled.
Click the Finish button and wait for the upload to complete.
When you see the message, Import has started. You may now close this
wizard, close the Software Installation Wizard dialog by clicking
the Close button at the bottom right or the X icon at the top right.
The Plug-in is ready to install.
Select the item that you imported from the Installation Packages window.
A dialog with that title appears to the right.
The Genesys Interaction Recording Plug-in for GAX dialog offers these actions:
Download—Downloads the installation package to your computer.
Delete—Erases the IP.
Copy to Tenants—Copies the IP to the tenant(s) that you specify.
Select a tenant and click Finish.
Deploy Profile: install—Displays the IP Deployment Wizard start
dialog. All following steps in this procedure are the result of this
Click Next to display a list of host computers for possible installation.
Select one or more hosts for installation using the check box to the left of
each host name, then click Next.
At the Application Parameters dialog, complete these fields:
Application name for host
Primary Configuration Server
Backup Configuration Server
Skip IP Re-install
Click the Information (i) icon to the right of each field title, for tool tip help.
A red * indicates a mandatory entry.
Click Next when you have completed all mandatory fields.
Perform this step depending on the OS:
For Windows, at the Installation Parameters (silent.ini) dialog, complete the IPCommon: InstallPath field. This is the path where the IP binaries will be extracted to, and the directory must exist on the machine. The default answer offered is C:\genesys\GCTI\.
For Linux, at the Installation Parameters (silent.ini) dialog, complete the following steps:
The IPCommon: InstallPath field. This is the path where the IP binaries will be extracted to, and the directory must exist on the machine. The default answer offered is /home/genesys/GCTI.
The RecPluginGAX: GAX_Directory field, which corresponds to the installation root folder for the GAX installation. The Recording Plugin for GAX jar file should be placed in <GAX_ROOT>/webapp/WEB-INF/lib directory.
At the Deployment dialog, verify that the answers you gave are all correct.
If they are correct, click Finish and wait for the installation to complete.
Restart Genesys Administrator Extension.
Upgrading the Plug-in
Using GAX 8.1.4
If you are using Genesys Administrator Extension version 8.1.4, perform the following steps:
The previous version of the Plug-in must be uninstalled.
Be prepared for these information requests and choices:
You will need the full path to your Genesys Administrator Extension installation.
You will either confirm the default installation directory, or enter a new one.
If the target installation directory is populated, you will choose an action:
Back up all files in the directory.
Overwrite only the files contained in this package.
Wipe the directory clean.
Perform Steps 1 to 5 of the "Installing the Plug-in from within Genesys Administrator Extension" section. This step is required to add the plugin metatdata to Genesys Administrator Extension.
Stop Genesys Administrator Extension.
Run the installation executable.
For Windows, this file is <IP plugin directory>/setup.exe.
For Linux, this file is <IP plugin directory>/install.sh.
Perform the installation steps, using the information that you gathered for the prerequisites.
For the Recording Plug-in connection to the Recording Crypto Server in the Genesys Administrator Extension application connections, add a connection to the Recording Crypto Server application. If the Recording Crypto Server is setup in HA mode where there are multiple Recording Crypto Server instances behind a load balancer, set this connection to the Recording Crypto Server cluster application.
Configure for Screen Recording
Using Genesys Administrator Extension, navigate to Configuration > Applications > <Genesys Administrator Extension Application Object> > Application Options.
Under the RCS section, set the htcc_base_url parameter to the Interaction Recording Web Services server URL (or Web Services server URL if you're using version 8.5.210.02 or earlier); for example; http://<Interaction Recording Web Services IP Address>:8081
Using Genesys Administrator Extension, navigate to Configuration > Tenant> <Tenant Object> > Options.
Under the recording section, set the htcc_base_url parameter to the Tenant-specific Interaction Recording Web Services load balancer URL (or Web Services server URL if you're using version 8.5.210.02 or earlier); for example; http://<Interaction Recording Web Services IP Address>:8081
If this parameter does not exist or has an empty value, the Recording Plug-in retrieves the Interaction Recording Web Services (Web Services) base URL from the htcc section of the configured Recording Crypto Server parameters.
Add a CA certificate to the trust store by executing the following command line:
keytool -importcert -file <root_ca certificate of rcs/rws> -keystore keystore
Configure the trust store location for GAX by updating the Java environment. For example, on Linux or Windows you can configure this by adding the following lines to the setenv.sh or setenv.bat script, respectively:
set JAVA_OPTS=%JAVA_OPTS% -Djavax.net.ssl.trustStore="<path to keystore file which is generated using above command>"
set JAVA_OPTS=%JAVA_OPTS% -Djavax.net.ssl.trustStorePassword="<password>"
Enable Transport Layer Security (TLS) certificate validation by using the following parameters:
trusted_ca_rcs - Configures whether or not the certificate will be validated when making a secure outbound connection to Recording Crypto Server (RCS). This parameter can be configured in the [rcs] section of the GAX application object or in the [recording] section of a specific tenant object. If this parameter is configured in both sections, then the tenant level configuration takes higher priority than the application level. Valid values are true or false. This parameter is optional, and defaults to true.
trusted_ca_rws - Configures whether or not the certificate will be validated when making a secure outbound connection to Interaction Recording Web Services (RWS). This parameter can be configured in the [rcs] section of the GAX application object or in the [recording] section of a specific tenant object. If this parameter is configured in both sections, then the tenant level configuration takes higher priority than the application level. Valid values are true or false. This parameter is optional, and defaults to true.
When validation is disabled, all the certificates are not validated, thereby ignoring the following:
Certificates with missing chain
No trusted CA installed in case of self signed certificate