Genesys Quality Management Suite 8.1.520 : Fresh Installation of a New Version

In some cases we recommend that you back up all of your data, reinstall your server and migrate the data back.

Data Backup

System Configuration Files and Call Recording Configuration Files

To back up your system and Call Recording configuration files we recommend that you use our Configuration Migration tool. It contains files that may be required during the reinstallation process.

Database Backup

We recommend that you create at least two dumps of your database: An SQL dump file and an archived dump file.

SQL File:

pg_dump -U postgres callrec -f /mnt/backup/callrec.dump.sql

To verify whether the dump has been created properly, check the head and tail of the file:

head /mnt/backup/callrec.dump.sql
tail /mnt/backup/callrec.dump.sql

Archived Dump File:

pg_dump -U postgres callrec -Fc -f /mnt/backup/callrec.dump.tar
Icon

Based on your database size, the dump process can take hours. Therefore, we recommend that you run the command in a screen session. To learn how to run a command in a screen session, see this guide

Media File Backup

Copy or move your media files. Media files can be:

TypeExtensionDefault location
CallsMP3/WAV/opt/callrec/data/calls
Mixed video filesmp4/opt/callrec/data/calls
Unprocessed video filesrecd/opt/callrec/data/calls
SpeechREC indexesidx/opt/callrec/data/calls

The location of your media files may differ. Find out where they are located:

  1. Calls:
    Find out where your calls are located in two ways:

    1. CLI – Run this command:

      grep pathToSave /opt/callrec/etc/decoders.xml

      Example of the command's output:

      <Value name="pathToSave">/mnt/cluster1/calls</Value>
    2. Web UI – Open the server's Web UI. Go to Settings > Configuration > Decoders > Decoder Servers Configuration and find the field "Path to save recordings":

                    You can have many decoder servers. This directory is a local one of the specified decoder.

  1. Unprocessed video files:

    1. CLI: Run this command.

      grep fileSrcDirectory /opt/callrec/etc/screenrec.xml
    2. Web UI – Open the server's Web UI. Go to Settings > Configuration > Screen Capture > Screen Capture.
      Find the section "Output Files Settings":
  2. Mixed video files:
    1. CLI – Run this command:

      grep pathToSave /opt/callrec/etc/screenrec.xml

      You will get two rows. Ignore the first. It is used for unprocessed video files. The second has the desired setting. Example of the command's output:

                  <Value name="pathToSave">/opt/callrec/data/recd</Value>
                  <Value name="pathToSave">/opt/callrec/data/mp4</Value>
    2. Web UI – Open the server's Web UI. Go to Settings > Configuration > Screen Capture > Media Encoder.
      Go to the the section where your media encoders are configured. You can have many. The configured path is local for each media encoder. Fnd this field:

Reinstall your server

Icon

Before this step, ensure that all your data is moved/copied from the server to a safe space. The reinstallation process can format all the local disks on the server.

To install a new GQM version to your server, use the Installation Guide. To restore your data, go to the next step.

Restore the backed-up data

Configuration

If you used the Configuration Migration Tool to back up your data, go to Restoring the Configuration when Upgrading to New Hardware.

Database

Create a new database during the installation and configuration processes. To restore the old database, delete or rename the new one. Create another and restore the old dump into it. Finally, upgrade the scheme version.

  1. Stop all Call Recording services:

    service callrec stop
  2. Rename your existing database:

    psql -U postgres -c "alter database callrec rename to callrec_new;"
  3. Create a new database:

    createdb -U postgres -l en_US.UTF8 -T template0 -O callrec -E UTF8 callrec
    

    -l is your locale.

  4. Restore your old database dump:

    pg_restore -U postgres -d callrec /tmp/backup/callrec.dump.tar
  5. Set search_path:

    psql -U postgres -d callrec -c "ALTER DATABASE callrec SET search_path=callrec, wbsc,public;"
  6. Use the guide Upgrading the database version to upgrade the scheme version.

Media

Copy your media files (mp3, wav, recd,  mp4) to the location set in your configuration.

Post Upgrade Checks and Tests

See Post Upgrade Tasks.