Troubleshooting and FAQ

Why isn’t the PDF report item working in a Linux environment?

Reason

To use the PDF report item on a Linux machine, the libdl.so library must be available to enable access to the PdfiumNative assembly.

When running the PDF custom report item on Linux, you may encounter the following error:

TypeInitializationException: Type initializer for "Syncfusion.PdfToImageConverter.PdfiumNative" threw an exception.

Solution

Follow these steps to create the libdl.so library:

  1. Locate the libdl.so library by running:

    sudo find /usr -name 'libdl.so*'

  2. If the libdl.so library is found, no further steps are required. If it is not found, proceed to step 3.

  3. If a different version such as libdl.so.2 is found, create a symbolic link named libdl.so in the located directory by running:

    sudo ln -s /usr/lib/x86_64-linux-gnu/libdl.so.2 /usr/lib/x86_64-linux-gnu/libdl.so

  4. Verify that the symbolic link was created successfully by running:

    ls -l /usr/lib/x86_64-linux-gnu/libdl.so

    The output should be:

    /usr/lib/x86_64-linux-gnu/libdl.so -> /usr/lib/x86_64-linux-gnu/libdl.so.2

Note: If libdl.so.2 is found in multiple locations, create the symbolic link in the /usr/lib/x86_64-linux-gnu directory. If it is not found there, use /usr/lib64. Otherwise, create the symbolic link in the directory where libdl.so.2 is located. If libdl.so.2 is not found, check for libdl.so.2.1 or any other available version.