Helpdesk Portal

Sometimes processing in Agisoft Metashape is terminated with the error message. In this article we will describe the most common errors that occur when working on Linux and approaches for solving these problems:

• Problem with libc
• Problem with OpenGL
• Problem during import video
• Linux dependencies

Problem with libc

Observed error message:

can't launch, errors like "version 'CLIBC_2.15' not found" 
or "version 'GLIBCXX_3.4.20' not found"

Reason: Metashape requires at least glibc 2.19, so:   

• Ubuntu: at least 16.04 LTS xenial
• CentOS: at least CentOS 8 required   

Generic way to check libc version via terminal: 

ldd --version

Problem with OpenGL

Observed error message:

can't launch with GUI, erros like "QXcbIntegration: Cannot create platform OpenGL context, neither GLX nor EGL are enabled" and "QOpenGLWidget: Failed to create context" 

Reason: Metashape requires at least OpenGL 2.0+ (i.e. shaders required)  

Check the output of the following command in the terminal: 

glxinfo | grep version

Pay attention to 'OpenGL version string'.

GUI over SSH remote access is not supported - instead, we recommend using TurboVNC for remote access. Check the recommendations here: https://github.com/agisoft-llc/cloud-scripts

Problem during import video

Observed error message:

video doesn't playing   
Question: please provide errors from terminal (from which Metashape was launched), and what is the output of "QT_DEBUG_PLUGINS=1 ./metashape.sh"?

You can get different error text messages for this problem. Below we describe examples with common error messages and solutions for each case: 

Example 1:

On Ubuntu re-start Metashape using the following command: 

LD_PRELOAD='/usr/lib/x86_64-linux-gnu/libgmp.so.10' /path/to/metashape.sh

On CentOS re-start Metashape using the following command:

LD_PRELOAD='/usr/lib64/libgmp.so.10' /path/to/metashape.sh

For permanent fix add LD_PRELOAD line with export keyword in metashape.sh file (like it is already done with LD_LIBRARY_PATH variable).

Example 2: 

On Ubuntu 20.04 and 21.04 execute the following commands in the terminal to install missing dependencies:

sudo add-apt-repository universe
sudo apt install gstreamer1.0-libav

Example 3:

On CentOS 8 execute the following command in the terminal to install missing dependencies: 

sudo yum install xcb-util-wm xcb-util-image xcb-util-keysyms xcb-util-renderutil

Linux dependencies

Observed error message:

can't launch with error "libgomp.so.1: cannot open shared object file"

Solution: install libgomp. 

On CentOS: 

yum install libgomp

On Ubuntu: 

apt install libgomp1

------------------------------------

Observed error message:  

can't launch with error "libquadmath.so.0: cannot open shared object file"

Solution: install libquadmath. 

on CentOS: 

yum install libquadmath

on Ubuntu 20.04: 

"apt install libquadmath0"

------------------------------------

Observed error message:

can't launch "./metashape.sh" with error "This application failed to start because it could not find or load the Qt platform plugin"

Check the output of the following terminal command:

QT_DEBUG_PLUGINS=1 ./metashape.sh  

Possible reason: on Ubuntu 16.04, 20.04 and 20.10 not found libxcb-xinerama.so.0 

Solution: 

apt install libxcb-xinerama0

------------------------------------

Observed error message:   

not-rich python console (due to 'Failed to import qtconsole.inprocess: libffi.so.6: cannot open shared object file')

Solution: on Ubuntu 20.04 execute the following terminal commands: 

wget http://mirrors.kernel.org/ubuntu/pool/main/libf/libffi/libffi6_3.2.1-8_amd64.deb

apt install ./libffi6_3.2.1-8_amd64.deb

(check related StackOverflow article for additional information)

Observed error message:

can't launch "./metashape.sh" with error "error while loading shared libraries: libGLU.so.1"

Solution: install mesa-libglu. 

For example on CentOS 8: 

yum install mesa-libGLU

------------------------------------

Observed error message:   

can't launch "./metashape.sh" with error "symbol lookup error: /lib64/libhogweed.so.4: undefined symbol: __gmpn_cnd_sub_n"

Solution: delete lib/libgmp.so.10 bundled with Metashape (see GitHub article for additional information)