Skip to content

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 .svm images 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:

  1. Stop the Turbo Server service on the Hub server.
  2. Open File Explorer to the old Hub storage path.
  3. Move any remaining Hub database files from subdirectories b-large-files, del, search\index, sys, and user.
  4. Delete or relocate the old Hub storage directory after you confirm all database files were moved.
  5. Start the Turbo Server service and verify the Hub starts.
  6. Pull a few images to confirm Hub functionality.
  7. 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.