Migrating IVION on-premise instances to Ubuntu 22.04

Customers who have NavVis IVION on-prem instances installed on Ubuntu 18.04 workstations or servers, should migrate to Ubuntu 22.04 to be able to use the latest update of IVION Docker instances or utilize a common setup with NavVis Desktop Processing (SiteMaker).

Scope

This procedure covers all the important data backup and restore operations that need to be executed before migrating NavVis IVION On-Prem instances from Ubuntu 18.04 to Ubuntu 22.04.

Prerequisities

• Ubuntu 18.04 installation

• Packages docker and docker-compose installed

• NavVis IVION docker image running

It is recommended that the latest version of NavVis IVION is installed before starting the migration (at least version 10.9.0 or above).

Procedure

Perform the following to update NavVis IVION On-Prem instances on docker from Ubuntu 18.04 to 22.04.

Create a Backup

1. Open a terminal and stop each instance by running docker-compose down, refer here.

   Important: To avoid corruption of the backup, you need to stop the instance before the backup. If you are running into errors running docker commands, use sudo before each command as described here.

2. Navigate to the directory where NavVis IVION is hosted.

3. Compress each instance folder, which contains /storage, docker-compose.yml and .env file.

   

   Note: An error message might be displayed when compressing this folder, as the db folder has restricted read permissions.

   

   

   To solve this, please open a new terminal, navigate to the parent folder and execute sudo chmod -R 777 ./storage/* to grant all permissions for these instance files and folders. Compress the whole IVION instance folder again, and it should be completed without any errors now.

4. Transfer all compressed instance folders to a secure external hard drive as back-up.

Setup Ubuntu 22.04 and NavVis IVION

1. If you are running IVION on Ubuntu, please refer to the following recommendations for installation: Ubuntu Installation Links and tips

2. Then setup NavVis IVION by following our installation guide: Installing NavVis IVION locally via Docker

3. Make sure you have Docker and Docker Compose installed (Installing Docker Engine and Installing Docker Compose) as well as latest IVION and postgresql images available on Ubuntu 22.04 ready if you are working offline (Working Offline).

Restore your Backup

1. Copy the compressed file that you have backed up from Ubuntu 18.04, to the directory where NavVis IVION is hosted.

2. Right-click on the compressed file to extract the NavVis IVION Instance. If you would like to extract it somewhere else, then choose ‘Extract to…’

   

3. Open the instance folder and check if all relevant files exist: /storage, docker-compose.yml and .env file.

   

4. Open a terminal and run the command docker-compose up -d under the instance folder where the .env file is located, to initiate the IVION instance.

5. NavVis IVION will now be served locally on your Ubuntu 22.04 machine http://localhost:{INSTANCE_PORT}/{INSTANCE_NAME} that is defined in .env file.

References

Official instructions how to backup and restore IVION instance within NavVis documentation remain valid. However, this specific migration instruction will retain POIs, IVION user group permission assignments as well as API related settings on top and accordingly requires less effort.