# Genesys Quality Management Suite 8.1.520 : Restore Tool

Created and last modified by

Restore tool is a part of Media Lifecycle Management (MLM) and provides a function of restoring calls from the archived(zip) files that were created by the Archive Tool. The tool has two operational modes:

- Restore based on UI requests
- Restore based on files

This guide describes usage of these two methods

## Restore based on UI requests

This method is commonly used as a part of planned MLM operation. It uses database records to restore the media files back so it can be accessed via Web UI. Therefore this method can be used only if DB records are available.

Typical use case:

Once the calls were archived and the media files deleted, the calls are not directly accessible from the Web UI. To have the possibility to listen to the call the restore tool needs to be configured. The Restore tool ensures that the media files are unzipped from the archive file. Then the media files are directly accessible from the Web UI for a short time period. By default for 2 days.

### Configuration

Navigate to Settings > Configuration > Maintenance > Restore

1. Select the Enabled checkbox.
2. The Database pool should be set to callrec this is the default. Note that before version 8.1.520 Maintenance had its own pool.
3. Set the Daemon sleep period (min.). Default: 60
4. Restore ZIP from directory - Provide the full path to the directory where your archived media files are located. For example: /opt/callrec/data/archives
5. Restore based on - Select UI requests, so the restore tool will process the requests sent from Web.
6. Archive filename - the field is used in different operational method, please ignore it.
7. Archive file mask - the field is used in different operational method, please ignore it.
8. Temporary directory - directory for the tool's temporary files. Make sure that the directory is different from the Archive Tool's temporary directory. Default: /opt/callrec/tmp/restore
9. If Centera is used then enable Restore from Centera checkbox.
10. Click Save configuration

### Starting the tool

In this operational mode Restore Tool runs as a daemon. The tool is automatically executed every X minutes based on the Daemon sleep period configuration.

To start the tool manually execute the following command via ssh under root's account:

    /opt/callrec/bin/rc.callrec_restore start

## Restore based on files

In this mode Restore Tool takes a zip file(or more zip files) and restores all media files including database records within it.

Typical use case:

Recovery of your server. Let's say your server is down and you lost all data on it, but you have all your archived files somewhere in a safe place (NAS, Centera etc.). Configure the Restore Tool to restore all the files that were archived back to the server as soon as it's reinstalled. The tool will go through all the zip files and extract the media including the DB records.

### Configuration

Navigate to Settings > Configuration > Maintenance > Restore

1. Select the Enabled checkbox.
2. The Database pool should be set to callrec this is the default. Note that before version 8.1.520 Maintenance had its own pool.
3. Set the Daemon sleep period (min.). Default: 60
4. Restore ZIP from directory - the field is used in different operational method, please ignore it.
5. Restore based on - Select UI requests, so the restore tool will process the requests sent from Web.
6. Archive filename - If you have a single zip file to restore then provide the full path to it. For example: /opt/callrec/data/archive/export.zip
7. Archive file mask - if you have more than one zip files then provide a mask to these zip files. For example: /opt/callrec/data/archive/export.*.zip
8. Temporary directory - directory for the tool's temporary files. Make sure that the directory is different from the Archive Tool's temporary directory. Default: /opt/callrec/tmp/restore
9. If Centera is used then enable Restore from Centera checkbox and provide Content Description File address string to the archived file.
10. Click Save configuration

### Starting the tool

In this mode Restore tool is executed once per day at 00:00. To manually start the tool execute the following command via ssh under root's account:

    /opt/callrec/bin/restore

## Restore Request parameters

1. Ensure there is a valid email address and set a subject for the email. If these fields are empty when Save configuration is selected, then the validation fails.
2. Calls are restored to the default restore directory unless another has been created.
3. Click Save configuration.

## Setting the Expiration Time

This sets how long the media file is available.

Navigate to Settings > Configuration> Web UI > Web Interface.

Scroll to Media Restore:

1. Enter a Restore expiration time (Days) for the media in days.
2. Click Save configuration.

## Requesting to restore calls

The following process is handled by the Restore Tool in Restore Based on UI Requests operational mode.

When calls are archived they are marked as archived but they still can be played from the Web UI:

Later on calls can be deleted from the server by the Delete Tool so they are marked as deleted

In order to restore a call click on the restore button . The request will be processed during the next run of the Restore Tool.

You can also request to restore more calls by selecting the calls and pressing the button Restore.

All requested calls that are in the restoring process is marked with the icon

There is a separate calls list called Restored calls that contains all the requests:

When the call is processed by the Restore Tool the speaker icon returns back so you can playback the call and the call additionally marked as restored by the icon :

You can see the same call separately in the Restored Call tab: