Introduction
This is a description of a recommended workflow to backup and restore data.
Note: If you only want to move the Datasets (with alignment, maps and NavGraph), it is easier to use Bundles to transfer the data.
Scope
Solution applies to: NavVis IVION On-Premise
Procedure
Back up and restore from local instance:
This workflow applies when you want to move the data such as POIs and it's contents, permissions and users.
Create instance backup (without datasets)
sudo navvis-instance backup INSTANCE_NAMERestore the backup using the flag
-d -->this creates a new instance which doesn't contain the datasets, datasets can be copied in the data location of the instance separatelysudo navvis-instance restore INSTANCE_NAME -d /mnt/localdisk/test_restore/datasets_web/ -f /srv/backup/backup_ts.se664_2020-03-17_13.40.09.tar.bz2
It is important that the -d flag can be used only when the backup does not contain data. If the backup contains data, and you want to restore it into a specific datasets_web folder that already exists, this is not supported. This is why you see this message during restore:
Note: restoring an instance with option
--data-dir, data files contained in backup (if any) will not be unpacked.
Extra (less efficient): Alternatively to the workflow above, you could restore the backup with data into a new folder if you use the flag -r, this will create a new root directory for the project in the specified location.
sudo navvis-instance restore INSTANCE_NAME -f /mnt/localdisk/backup.tar -r /mnt/localdisk/folder_restore2Result will be an instance with the following data path:
/mnt/localdisk/folder_restore2/web_ts.restoredata2/datasets_webFAQ
What is the purpose of the recommended workflow described?
The workflow is designed to backup and restore data.
Can I use Bundles to transfer Datasets?
Yes, using Bundles is an easier method to transfer Datasets, including alignment, maps, and NavGraph.
What does the backup procedure apply to?
The backup procedure applies to NavVis IVION On-Premise.
What is the command to create an instance backup without datasets?
The command is 'sudo navvis-instance backup INSTANCE_NAME'.
Is it possible to restore a backup that contains data into an existing datasets_web folder?
No, restoring a backup with data into an existing datasets_web folder is not supported.
What happens if I use the '-d' flag during restoration?
The '-d' flag can only be used when the backup does not contain data, creating a new instance without datasets.
What is an alternative method to restore a backup with data?
You can use the '-r' flag to restore the backup with data into a new folder, creating a new root directory.
What will be the data path if I restore using the '-r' flag?
The data path will be '/mnt/localdisk/folder_restore2/web_ts.restoredata2/datasets_web'.