Knowlege base

The Backup/Restore Tool

Article ID: 26
Last updated: 15 Mar, 2017

Imagicle AppSuite has an integrated tool which can be used to schedule backups towards a local folder or a network share.
The backup includes the configuration and, optionally, the fax and the calls.
With an AppSuite backup, you can:

  • Easily recover the system, by reinstalling the package and restoring the backup
  • Revert the system to a previous state, in case of wrong configuration
  • Move the configuration to another server

Backup procedure

You can run the backup and restore tool by logging onto the Application Suite server and selecting this link form the start menu:

“Programs”-> “Imagicle Application Suite” -> “Backup and Restore”

This tool creates a copy of the configuration files (.INI, .XML), audio files, faxes, reports and database contents on a directory. Database contents include the user's list, Speedy contacts, and other application configuration. Those data will be copied on the target directory.

All the application data will be copied at once. You cannot backup or restore the configuration of a single application. E.g. you cannot restore an old status of Stonefax while preserving SSAM configuration. Old SSAM status would be restored as well.

Warning: special customized files received through technical support will NOT be stored.

There is no need to stop Imagicle services during backup. Just click the Backup button.

The destination can be a network folder: just enter the complete network path in the top textbox and ignore the drive selection below.

If you enable the "Include call history" the backup will contain Imagicle Billing complete call history and QME statistics records. In detail: Calls, Discarded Call, Storicoxxxx.txt, BluesRecxxxx.txt Files.

In this case the backup of the database could be larger than 2 Gb, and you need to select a NTFS drive as destination. Performing the backup will take a long time and the interface may freeze for a while. Just be patient and wait for the completion message.

Diagnostic information on the progress of the backup is displayed on the right panel and it is also stored in this folder:

c:\Program files\StonevoiceAS\Var\Log

Backup versions

Backups are forward - compatible. E.g. if you have the backup of a 2012.2.1 configuration, you will be able to restore it over a 2015.3.1 installation.

Scheduled backups

Backups can be easily scheduled by Windows’ Task Scheduler, selecting a destination folder in “Scheduled backups” tab of the Backup/restore tool and entering this command line in the scheduled task “Run” field:

"C:\Program Files\StonevoiceAS\System\BackupRestore.exe" /AUTO

To achieve destination folder rotation, you can add the following constants in the path specified in the upper textbox:

  • $$FULLDATE$$: current date. E.g. '2012-05-18'
  • $$MONTHDAY$$: day of month. E.g. '08'
  • $$WEEKDAYINDEX$$: week day, where 1 is Monday. E.g. Wednesday = '3'
  • $WEEKDAYNAME$$: name of the week day. E.g. 'tuesday'

Restore

Performing a restore is like making your applications return to a past status. Restore can be made for different purposes: crash recovery, application migration...

The crash recovery procedure involves:

  • Complete installation of the OS, prerequisites and package, as described in the Installation section of this guide
  • Restore of an old configuration
  • A new online license activation for each application (same license codes, new response string)

The migration procedure involves:

  • Clean installation of the OS, prerequisites and package on the destination machine
  • Backup of the configuration source machine
  • Restore on the destination machine
  • A new online license activation for each application (same license codes, new response string)

Please look for the detailed update procedures in the Package Update section.

A backup may be taken even if the IAS services are running. On the contrary, the restore procedure requires that all the IAS engines are stopped. So click the “Stop all applications” button first. Should some service fail to stop, please stop it by the web interface.

When this message appears you can go on with the restore:

Note: the Blue's Recorder service files (BluesRecxxxx.txt and Storicoxxxx.txt) will not be restored even if included in the backup. Database call tables will be restored if they were included in the backup. If they were not included, the Calls and Discarded Calls tables will be unaffected by the restore operation.

Other backup options for Imagicle VAI

If your system was deployed through Imagicle VAI, you could use a third party tool to backup the whole virtual machine on which Imagicle Application Suite is installed.

Article ID: 26
Last updated: 15 Mar, 2017
Revision: 5
Views: 3902
Print Export to PDF Subscribe Share
This article was:  
Prev   Next
Advanced Configuration     Basic Troubleshooting