Backup

<< Click to Display Table of Contents >>

Navigation:  Tools > Export & Import >

Backup

The Backup page can be reached from the System page, which can be reached from the Tools menu by administrators.

 

Backup destination

Apresa can backup the call database with all recordings to another network drive, to a local disk, or (advanced) to a location on its own file system.

 

Backup to a Network drive:

 

Windows Domain Name: The domain name where the destination network drive is located.

Username/Password: Fill in the login details if authentication is required to write to the network drive.

Server name: The Windows server name or the IP address of the server of the network drive.

Network share name: The Windows name of the network backup drive.

Backup directory: The subdirectory on the network drive where Apresa must write the backup.

 

Backup to a Directory (mounted disk):

 

Backup to the specified Linux directory. The directory must be a reference to a local or remote disk (it must be a mount point). The mount point could be created by the user using the system shell.

Backup directory: This is the Linux directory path at the Apresa server, where the backup must be written.

 

Backup to a Directory:

 

This method allows the backup to be written to an arbitrary directory, even when it is not a mount point. Use with care. Writing the backup to an unsuitable directory, for example a directory that is located on the main disk partition, can fill up disk space, and cause system malfunction.

 

Backup to a Local disk:

 

Local disk: This selection box lists the detected (USB) disks and partitions.

Backup directory: The subdirectory into which to write the backup (optional).

 

Backup using SFTP:

 

Server name: The SFTP server name or IP address. If the SFTP server is not running on standard port 22, add a colon and the port number. For example: sftp.company.com:2022

Log on method:

- Username/Password: Fill in the credentials for accessing the SFTP server. Export and restore backup currently only supports this type of log-on method.

- Key-based authentication: In this case the password does not need to be filled in, but the username needs to be specified. The key of Apresa will be used. Click on the arrow button to view it.  You will need to add this key at the SFTP server to allow access. It is currently not possible to use a custom key.

Backup directory: The directory at the SFTP server where to write the backup. This can be a relative path from the home directory of the user, or an absolute path. Example: /data/apresa/backup

 

When accessing a new SFTP server for the first time, an entry will be added to the known hosts file. If the server changes without changing the server name, the connection will be blocked. This is to avoid man-in-the-middle attacks. Manually changing the known hosts file is then needed to allow connections to the changed server.

 

Data to backup

You can specify a time range that must be backed up. Recordings that have a start date in this time range are backed up, others are skipped. The database is always copied in its entirety.

 

Select what data to backup:

- Database & Recordings: This option is for creating a backup of all data.

- Database: The database contains the configuration, and meta-data about the calls, but not the recordings itself.

 

Retention period

Delete database backup older than ... days: If backup is run daily, a new database file (apresadb....sql.gz) is created on the backup each day. Specify the number of days after which these database backup files must be deleted by the system, or leave it empty, to keep all files.

Delete calls older than ... from backup: Recordings that are older than the specified number of days are deleted permanently from the backup. Meta-data in the backup is not effected by this setting, because it is in the database backup files (see previous option). This option is only available if the system option "Retain information about calls in the backup" has been enabled and used to keep information about the calls in the backup.

 

When to backup

You can specify the time of the day when the backup must be run. When the update frequency is set to "Once", the backup will be run only once and then stop. Otherwise, the backup will be updated periodically, for example, once every week.

 

Diagnostics

When the backup fails, a diagnostic message is displayed for the administrator, when logged in (after refreshing the page), and if email is configured, it is also sent by email. The email status is also part of the health status page.

 

- Could not resolve address for X: Name or service not known

The lookup of the IP address for the name failed. Use the IP address instead, as "Server name".

 

- Unable to find suitable address

The IP address is incorrect or unreachable

 

- E(2): No such file or directory

The subdirectory is incorrect

 

- E(6): No such device or address

The Network share name does not exist

 

- E(13): Permission denied

Incorrect user name or password

 

- E(16) Mount is denied because the NTFS volume is already exclusively opened

The disk is already mounted. Unmount it first. Or point to the existing mount point, using the option "Directory (mounted)"

 

- E(20): Not a directory

The main directory is incorrect

 

- Protocol negotiation failed: NT_STATUS_CONNECTION_RESET

This could be due to a SMB version mismatch.