Troubleshooting

This page contains frequently asked questions/problems and how to fix them.

How do I check whether I run appman in multi-process mode ?

Either start the application-manager with --verbose and look for the output WindowManager: running in Wayland mode, or simply start an application and make sure you can see at least one appman-launcher-qml process running.

How do I check why my appman doesn't support multi-process mode ?

Check the configure output of appman (Most likely you are missing the qtwayland module).

My applications are running slow within appman. What can I do ?

Check whether your applications run with hardware acceleration.

How do I check whether my applications use hardware-acceleration ?

Run appman with the environment variable QSG_INFO=1. You should see output looking similar this, when starting an application:

[DBG  | qt.scenegraph.general | c.p.music] Using sg animation driver
[DBG  | qt.scenegraph.general | c.p.music] Animation Driver: using vsync: 16.95 ms
[DBG  | qt.scenegraph.general | c.p.music] texture atlas dimensions: 1024x1024
[DBG  | qt.scenegraph.general | c.p.music] R/G/B/A Buffers:    8 8 8 8
[DBG  | qt.scenegraph.general | c.p.music] Depth Buffer:       24
[DBG  | qt.scenegraph.general | c.p.music] Stencil Buffer:     8
[DBG  | qt.scenegraph.general | c.p.music] Samples:            0
[DBG  | qt.scenegraph.general | c.p.music] GL_VENDOR:          VMware, Inc.
[DBG  | qt.scenegraph.general | c.p.music] GL_RENDERER:        llvmpipe (LLVM 5.0, 256 bits)
[DBG  | qt.scenegraph.general | c.p.music] GL_VERSION:         3.0 Mesa 17.3.0

If GL_RENDERER is "llvmpipe" you are using software-rendering for your wayland clients.

Note: You will also get this information output for the system-ui itself - make sure to look at the information table that has the application's id in the prefix (in the example above, com.pelagicore.music)

How do I turn on hardware-accerlation ?

This depends on your hardware and the operating system:

In general you need to make sure you have the correct drivers installed:

  • NVIDIA on ubuntu/debian you need: nvidia-egl-wayland-icd
  • Intel on ubuntu/debian you need: libwayland-egl1-mesa

On desktop systems make sure your Qt is configured to use at least OpenGL ES2/ES3 and NOT Desktop OpenGL. Check for the following configure summary line in Qt itself:

OpenGL ES 2.0 ........................ yes

You can force Qt to use Opengl ES2 by using the "--opengl es2" configure option.

Make sure the wayland-egl integration plugin is built: Check for the following file: <QT_DIR>/plugins/wayland-graphics-integration-client/libwayland-egl.so

If that is not available, check the QtWayland configure summary and make sure it does get built.

© 2018 Pelagicore AG. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.