Backup and Restore
Your Revolution installation includes a Backup and Restore utility.
Which task do you need to perform?
- Back up your Revolution environment – Follow the steps in Back up your environment.
- Move Revolution to a new server – Follow the steps in Back up your environment and Move your environment.
- Restore the Revolution environment on the same server because it became corrupted or you had hardware failure – Follow the steps in the Reinstall Revolution on the same server section. (This scenario is rare.)
- Roll back to a previous version of Revolution after an upgrade – See Contacting Support. (This scenario is infrequent.)
Tip: You can run a backup from a command line or include it in a script that runs automatically.
Important: The database schema for Revolution is not public and Intrado does not support direct access to the database by customers. The only supported method is through the use of the Published APIs. See Revolution API
Make sure you back up Revolution while it is in a working state.
.
- Log in to the Revolution server. (For a redundancy environment, log into any of your servers)
- From the Start menu, search for backup, and select Backup and Restore.
- Within the Backup and Restore utility:
- Select Backup.
- Specify the location of the backup file. Select Browse to select the folder and provide a name for the resulting ZIP file.
- Review the summary screen: This is a read-only screen that simply provides info on what is being backed up.
- Select Next then select Run.
- Should an error occur, the backup stops and presents an error message that you must acknowledge before the backup can attempt to proceed.
- This process will back up: Any custom WAV files, registry settings, and any SQL users.
You can run a backup from a command line or include it in a script that runs automatically. When running from a command prompt, it must be run as an administrator. If you are running a script, be sure to include the appropriate permission attribute.
-
Navigate to c:/Program Files (x86)/Syn-Apps/BackupAndRestore
- Open a Command Prompt window.
- Drag BackupRestoreCLI.exe to the Command Prompt window and hit Enter.
Here’s what you need to know:
- .zip is automatically added to the file name if you don’t include it.
- -v still writes to the log file.
- The utility checks for a valid file name and path.
- -o creates a copy of the existing file name and appends it with an incremental number so you still have older versions of your backup.
- If an error is encountered during the backup process, the error message is written to the log and the backup process quits. We recommend checking the log file after scheduled backups for error messages.
Did you Back up your environment?
Note: If you want to move your installation of Revolution to a new server you may need to contact Support so they can update your license with new information about your server. See Updating your Licensing.
These are the basic steps:
- Move these files from the old server to the new one.
- the environment you backed up on the old server to the new server
- the license key from the old server to the new server
- Install Revolution on the new server using the same license file and SQL passwords that you used for the original install.
- Restore the Revolution environment and custom files on the new server.
- Configure the newly installed Revolution.
- Update your DHCP server option 72 and your call manager with the new Revolution server IP address.
- Log into the old Revolution server and stop Revolution services.
- Log into the new Revolution server and restart Revolution services.
- Create a test notification and send it to make sure everything is working properly.
Refer to the Help topic for your PBX system if you need assistance updating these settings.
Note: Customers running in a redundancy environment, please see the Redundancy Environment Notes below.
Tip: You can run a restore from a command line if you prefer.
- Log in to the new Revolution server.
- From the Start menu, search for backup, and select BackupUI.
- Choose Restore and click through the Wizard prompts.
- The restore process automatically shuts down Revolution services and the restarts them when the restore is finished.
- All media is restored.
- SQL users are restored.
- (Optional; good practice) Reboot the server again.
- Restore the environment to the primary server first. Revolution will failover to the secondary server during this process because Revolution must restart after restoring the environment.
- After the restart, it takes a few minutes for Revolution to recognize that it's running in a redundancy environment. Be patient and let the sync happen between the secondary and primary server.
- Once the two are in sync, on the primary server, go to the Status > System Status page. Under Redundancy Server > Advanced Settings select deprovision.
- Once deprovisioning is complete, reinstall Revolution on the secondary server. See Build your secondary server.
- Update your DHCP server option 72 with the new Revolution server IP address and reboot all your IP devices so they can re-register with Revolution.
- Update your call manager with the new Revolution server IP address.
- CUCM – Update the Authentication URL.
- Mitel – Update Trunk, Authorized Server, and SIP Server Host.
- Avaya – Update 46xxsettings.txt and/or 96xxsettings.txt configuration files.
You can restore a broken Revolution, provided the last backup occurred when Revolution was in a working state.
- The backup environment can have missing tables and data. However, it cannot be entirely missing, except in the scenario when you are moving Revolution to a new server.
- Restore can handle missing registry keys.
- Restore can handle missing modules.
- Restore must be performed on the Revolution server.
These are the basic steps:
- Back up the SQL database, if you can. If you can't back up the database, you'll restore from the most recent backup you have.
- Uninstall Revolution using the standard Windows uninstall.
- Install a fresh version of Revolution with the same license files and SQL passwords that you used for the original install.
- Reboot the server.
- Delete the old SQL database and restore it from the most recent backup.
- Restart the Revolution services or reboot the server.
Tip: You can run a restore from a command line if you prefer.
- Log in to the Revolution server.
- From the Start menu, search for backup, and select BackupUI.
- Choose Restore and click through the Wizard prompts.
- The restore process automatically shuts down Revolution services and the restarts them when the restore is finished.
- All media is restored.
- SQL users are restored.
- Create a test notification and send it to make sure everything is working properly.
- Restore the backup environment to the primary server first. Revolution will failover to the secondary server during this process because Revolution must restart after restoring the environment.
- After the restart, it takes a few minutes for Revolution to recognize that it's running in a redundancy environment. Be patient and let the sync happen between the secondary and primary server.
- Once the two are in sync, on the primary server, go to the Status > System Status page. Under Redundancy Server > Advanced Settings and click deprovision.
- Once deprovisioning is complete, reinstall Revolution on the secondary server. See Build your secondary server
You can run the restore utility from a command line. When running from a command prompt, it must be run as an administrator. If you're running a script, be sure to include the appropriate permission attribute.
-
Go to c:/Program Files (x86)/Syn-Apps/BackupAndRestore
- Open a command line window.
- Drag BackupRestoreCLI.exe to the command window.
- When the restore process is finished, configure Revolution.
- Create a test notification and send it to make sure everything is working properly.
Here’s what you need to know:
- You must include .zip with the file name.
- -v still writes to the log file.
- -o creates a copy of the existing file name and appends it with an incremental number so you still have older versions of your backup.
- The restore process automatically shuts down Revolution services and the restarts them when the restore is finished.
If for some reason the services did not automatically restart, manually restart them using the standard Windows Services utility.
If the Revolution restore utility cannot successfully stop the services, it may be because the server is bogged down, for whatever reason, and the stop service request from the restore utility timed out before the Windows Services utility finished updating.
- Check the Windows Services utility to see if the services are still running.
- If they are, manually stop them, then start the Revolution restore utility again.
If you're unable to successfully run the Backup & Restore utility, follow the steps in the Manual Backup and Restore topic.
Once log.txt reaches 10MG, it is renamed to append an incremental number (for example, log1.txt) and the Backup and Restore Utility starts a new log.txt.