Migrating to Interaction Recording Web Services from Web Services and Applications
This page describes how to upgrade from Web Services and Applications to Interaction Recording Web Services. If you are already using the Interaction Recording Web Services component, refer to Upgrading Interaction Recording Web Services for upgrade instructions.
As of Genesys Interaction Recording 8.5.211.01, the Web Services and Applications prerequisite has been replaced with a GIR component called Interaction Recording Web Services. If you plan to install GIR 8.5.211.01 or later and have a version older than 8.5.211.01 installed, you will need to complete the steps below to migrate from Web Services and Applications to Interaction Recording Web Services.
Upgrading from standalone to embedded Jetty
Complete the following steps for each Web Services node you need to upgrade to Interaction Recording Web Services.
- Stop Web Services on the node.
- If you installed Jetty as a service, disable the service to prevent auto start and potential port conflicts.
- Deploy the new version of Interaction Recording Web Services.
- Copy settings from your existing server-settings.yaml, onpremise-settings.yaml, and cassandra-cluster.yaml configuration files to the serverSettings, onPremiseSettings, and cassandraCluster sections of the application.yaml configuration file. See Configuring Interaction Recording Web Services for more information about this file.
- Copy settings from your existing Jetty configuration files to the jetty section of the application.yaml configuration file.
- Adjust the logging section of the application.yaml configuration file.
- Copy the JVM options from your exiting Jetty initialization script to the JAVA_OPTIONS variable in the /etc/default/gir file.
- Start the new version of Interaction Recording Web Services on the node.
Upgrading the Cassandra Schema for Interaction Recording Web Services
Complete the following steps on one node where you have installed cassandra-cli:
- Make note of your current Web Services and Applications version.
- Copy the Interaction Recording Web Services install CD/data directory to the Cassandra node.
- In the data directory, notice that there are text files (for example, cf-schema-<version>.txt), for each version of Web Services and Applications. Run all the Cassandra upgrade scripts after your currently installed version of Web Services and Applications until the latest file, which is cf-schema-220.127.116.11.txt.
For example, if your Web Services and Applications version is 18.104.22.168, you will need the following scripts:
- For each cf-schema-<version>.txt file, run the following command to update the Cassandra
cassandra_install_dir/bin/cassandra-cli -h cassandra_host --file cf-schema-<version>.txt
...where:cassandra_host is the host name (FQDN) or IP address of the Cassandra node.
cassandra_install_dir is where Cassandra is installed on the node.
Re-importing the Certificate for WebDAV
Complete the following steps if you used a self-signed certificate to configure TLS for the WebDAV server.
- Make sure you have installed Java 8.
- Retrieve your self-signed CA certificate from the WebDAV server. Run the following command to determine the file used as a certificate for WebDAV access:
grep SSLCertificateFile /etc/httpd/conf.d/ssl.confFor example, this might return the following response: /etc/pki/tls/certs/server.crt
- Re-import the certificate into the new keystore with the following commands: webdav_certificate is the file returned in step 2.
cd $JAVA_HOME/jre/lib/security <br/>../../bin/keytool -import -alias webdav -file ~/webdav_certificate -keystore cacerts
- Restart Interaction Recording Web Services.