[DOC] Missing font packages for Chromium (post 6.5) leading to "Caught error spawning Chromium" (#29940)

It might occur that users hit the `Caught error spawning Chromium` error.
This is usually linked to missing font packages on the system.

This sub-list has been extracted from [the puppeteer troubleshooting page](https://github.com/GoogleChrome/puppeteer/blob/master/docs/troubleshooting.md) and as a follow up of the issue https://github.com/elastic/kibana/issues/28123

Let me know if I should review the package list or the text.
I might also add directions on how to check Chromium debug logs if necessary.
This commit is contained in:
Luca Belluccini 2019-02-19 19:56:56 +01:00 committed by Tim Sullivan
parent 15863c7647
commit 57439f2d19

View file

@ -62,4 +62,21 @@ and if applicable, that the filesystem is mounted with the `exec` option.
[float]
==== `Caught error spawning Chromium`
Ensure that the `headless_shell` binary located in your Kibana data directory is owned by the user who is running Kibana, that the user has the execute permission,
and if applicable, that the filesystem is mounted with the `exec` option.
and if applicable, that the filesystem is mounted with the `exec` option.
Another possible reason of such error might be the fact the `headless_shell` binary requires dependencies which are not installed at the operating system level.
.On CentOS/RHEL systems, the following packages should be installed:
* `ipa-gothic-fonts`
* `xorg-x11-fonts-100dpi`
* `xorg-x11-fonts-75dpi`
* `xorg-x11-utils`
* `xorg-x11-fonts-cyrillic`
* `xorg-x11-fonts-Type1`
* `xorg-x11-fonts-misc`
* `fontconfig`
* `freetype`
.On Ubuntu/Debian systems, the following packages should be installed:
* `fonts-liberation`
* `libfontconfig1`