home

Restoring a Backup Procedure

To restore a backup, navigate to RTLS Studio → Backup/Restore and follow these steps:

Simplified Backup Restore in Studio 3.4

Starting with Studio 3.4, restoring a backup is much easier with the Data-Only Restore feature. For more details, see the Product Tour: Studio 3.4.

This feature significantly simplifies backup restoration in Docker deployments.


Compatibility Warning

Be aware that a backup made on Studio 2.6 and lower is not possible to restore in Studio 3.0! Contact our CX team if support or consultation required → open a ticket.

Steps to Restore a Backup

1) Upload the Backup File:

  • Use UPLOAD EXISTING BACKUP to upload a backup file from your device.
  • Alternatively, select an existing backup stored on the RTLS Server.

 

2) Select and Restore:

  • Choose the desired backup from your backup list.
  • Click the RESTORE or DATA-ONLY RESTORE button, depending on your needs.

Data-Only Restore (Studio 3.4 and Later)

Starting with Studio 3.4, you can use Data-Only Restore to transfer critical configuration and data, such as:

  • Configuration, plans, and databases (Sensmapserver, RTLS Studio, Trackables-DB)
  • Logins and anchor passwords
  • DeviceCare configuration (e.g., license files, telegraf configuration)
  • RTLS-IO setup

This method allows for restoring these elements without needing a complete backup transfer.

In this scenario, an RTLS administrator could migrate from an existing Ubuntu 18.04 server running e.g. RTLS Studio 3.3 to a new Ubuntu 22.04 server running RTLS Studio 3.4 directly without using any midsteps. The goal is to seamlessly transfer all critical configurations and data without performing intermediate installations or multiple backups/restores.

Contact our CX team if support or consultation required → open a ticket.

 3) Wait for Completion:

  • Wait until the buttons become available again. In RTLS Studio 2.0 and newer, a notification will confirm the process has started.

Avoid Process Disruption

Interrupting the restore process can cause database damage. Ensure the process completes before proceeding.

 4) Finish:

  • Your backup is now restored.

 

Restoring a Backup on a Different Host Machine

If you need to migrate RTLS Studio from a virtual machine to a native server, the Backup/Restore feature allows for seamless data transfer:

  1. Create a Backup:

    • Generate a new backup on your existing deployment.

  2. Download the Backup File:

    • Locate the backup file in the directory: /home/sewiortls/backups.
    • Use a file transfer method (e.g., SCP) to download it.

  3. Transfer to a New Server:

    • Copy the backup file to the same directory (/home/sewiortls/backups) on the new server using SCP or another transfer method.

  4. Restore the Backup:

    • Use the Backup/Restore utility in RTLS Studio to restore the backup on the new server.

This process is ideal for migrating data and settings while maintaining consistency across different systems.