Appearance
Backup and Recovery
Use this page to plan complete Turbo Server backups and restores, including migrations to new servers.
What You'll Learn
- What to include in a complete Turbo Server backup
- How to protect Hub storage, databases, and configuration files
- How to restore Turbo Server to new infrastructure
Backup
Capture these items for a complete Turbo Server backup:
- Hub storage location: default path
C:\ProgramData\Turbo Server. - Databases: Configuration and Analytics SQL databases.
Settings.xml: Turbo Server service configuration file.- Image cache: cached
.svmimages pushed to the Hub.
You do not need to back up servers hosting only the Application role or Portal role, and you do not need to back up the installation directory or sandbox because they are recreated during restore.
Hub Storage
Back up the Hub storage directory that holds application images and user session data. The default location is C:\ProgramData\Turbo Server\io. Stop the Turbo Server service before you capture the backup to avoid corrupted transactions.
If Hub storage is low on disk space, move it to another disk using the Hub Storage Path setting. Ensure no other processes use the source or destination directories during migration.
If a migration fails and the Hub server does not start, complete the move manually:
- Stop the Turbo Server service on the Hub server.
- Open File Explorer to the old Hub storage path.
- Move any remaining Hub database files from subdirectories
b-large-files,del,search\index,sys, anduser. - Delete or relocate the old Hub storage directory after you confirm all database files were moved.
- Start the Turbo Server service and verify the Hub starts.
- Pull a few images to confirm Hub functionality.
- Delete the old path if you moved it to a temporary location.
If you are not confident resolving the issue, contact [email protected] for assistance.
Databases
Back up the Configuration and Analytics SQL databases that store configuration and analytics data. Use native or purpose-built SQL Server backup tools.
Settings.xml
Back up Settings.xml, which contains the configuration data needed to start Turbo Server. The default location is C:\ProgramData\Turbo Server\Settings.xml.
Image Cache
If you configured an image cache on the Hub server, back it up as well. Clients can pull images directly from the cache to avoid local downloads, so preserve the cached .svm files.
Recovery
To restore Turbo Server you need:
- A new Turbo Server instance.
- SQL databases restored to an accessible location.
- Hub storage directory restored to its original location.
- Post-restore configuration updates.
Turbo Server Installation
Install the same Turbo Server version into the same directory as the previous environment. You can find the prior version and install path in Settings.xml (default C:\ProgramData\Turbo Server\Settings.xml). Follow the Turbo Server Setup guide, and stop the Turbo Server service before proceeding to database and storage restores.
SQL Databases
Restore the SQL databases using native or purpose-built tools. See Turbo Server Setup for installation details.
Hub Storage Directory
Restore the Hub storage directory to the same location as the previous install. Skip this step only if the prior path is unknown.
Image Cache Directory
Restore the Hub image cache directory to the previous path if you use it.
Post Restore Tasks
Update or confirm the SQL database connection strings in Settings.xml (default C:\ProgramData\Turbo Server\Settings.xml) and start the Turbo Server service.
If you skipped the Hub storage restore because the path was unknown:
- Open the Administration Site and go to Domain > Servers.
- Open the Hub / Portal server and note the Hub Storage Path directory.
- Stop the Turbo Server service.
- Restore the Hub storage backup to the Hub Storage Path.
- Start the Turbo Server service.
