Running Tracealyzer on Linux
This guide is for Tracealyzer 4.9.0 and later on Linux hosts. If you are running an older version, we strongly recommend updating to version 4.9.2 or later.
Tracealyzer is designed to work on any Linux distribution. Since version 4.9.0, it is regularly tested on distributions like Ubuntu, Linux Mint, OpenSUSE, Manjaro, CentOS and Rocky Linux.
The instructions below is a quick-start guide that is usually sufficient for most users. More details can be found in the file RunningOnLinux.txt in the Tracealyzer installation folder. This includes known issues/limitations on Linux and describes some warnings that may appear in the terminal from the dependencies. They are usually benign and safe to ignore.
If you have questions or encounter any issues, feel free to contact us via https://percepio.com/contact-us.
Starting with Tracealyzer 4.9.0 we offer two packages for Linux users. Both are provided as tgz archives.
Package “linux-standalone-x86-64”
When using the “standalone” package, no additional packages are typically required. Just unpack the Tracealyzer tarball into a suitable location, for example like this:
$ tar xvf Tracealyzer-4.9.0-linux-standalone-x86-64.tgz
This package has only one installation step, running the included cert-sync tool to import CA certificates into the application (see note below). For convenience, the Mozilla Firefox CA certificate bundle is provided in the package. Import them like this:
$ cd Tracealyzer-4.9.0 $ sudo ./cert-sync cacerts_from_mozilla.pem
Start Tracealyzer using the launch-tz.sh script.
$ ./launch-tz.sh
Finally, you need to activate your license.
Note about cert-sync: Certificate import is needed for online features like online license activation. The Tracealyzer software can be used without this step. If you prefer to use the existing CA certificates already on your computer, that certificate bundle file can be imported instead.
Package “linux64”
This package requires installation of the Mono runtime environment. Most distributions provide a package called mono-complete, though some distributions and package systems may instead use simply “mono”. This package can also be used on Arm-based Linux systems, although this is not yet fully tested.
Make sure to use Mono version 6.12 or later from https://www.mono-project.com. Follow the Download page instructions if applicable, or clone the Github repository and build Mono from source.
Once Mono is installed, you need to unpack the Tracealyzer archive to a suitable location, for example like this:
$ tar xvf Tracealyzer-4.9.0-linux64.tgz
Then start Tracealyzer using the launch-tz.sh script.
$ cd Tracealyzer-4.9.0-linux64 $ ./launch-tz.sh
Finally, you need to activate your license.
When using the linux64 package, you don’t need to import CA certificates using the cert-sync tool. This is handled automatically when installing Mono.
On certain distributions, e.g. Ubuntu, the Linux64 variant may fail to start, since Mono may provide an incompatible build of the libgdiplus and libpng15 libraries. For the stand-alone package we include our own build of these libraries, built without the “Pango” option. These libraries can be provided on request.
If you have questions or encounter any issues, feel free to contact us via https://percepio.com/contact-us.