連携エンジン HTMLtoPDF のインストール¶
Linux での 連携エンジン HTMLtoPDF のインストール手順を示します。
連携エンジン HTMLtoPDF の圧縮ファイル（htmltopdf.linux.X.X.X.tar.gz - Xの部分はバージョン番号）をインストール先にコピーします。
インストール先を< /usr/local/ >として説明します。
$ cp [ディレクトリ]/htmltopdf.linux.X.X.X.tar.gz /usr/local/
コラム
連携エンジンのバージョンについては、構築する環境に合わせて選択してください。
Web Application Server を起動するユーザで、圧縮ファイルを解凍します。
$ cd /usr/local/ $ tar zxvf htmltopdf.linux.X.X.X.tar.gz
連携エンジン HTMLtoPDF を動作させるために必要な UPower をインストールします。
UPower の動作に必要な依存関係等の設定は、適宜設定してください。
コマンドの例は、次の通りです。
$ yum install gobject-introspection libgudev $ curl -O https://rpmfind.net/linux/centos-stream/9-stream/AppStream/x86_64/os/Packages/upower-0.99.11-11.el9.x86_64.rpm $ rpm -ivh upower-0.99.11-11.el9.x86_64.rpm
連携エンジン HTMLtoPDF を動作させるために必要な Xvfb をインストールします。
Xvfb の動作に必要な依存関係等の設定は、適宜設定してください。
コマンドの例は、次の通りです。
$ yum install -y xorg-x11-server-Xvfb $ yum install -y atk gtk3 pango libXcomposite libXdamage libXrandr mesa-libgbm alsa-lib
変換対象ページに含まれている言語に対応したフォントをインストールします。
システム全体に適用されるようにインストールしてください。
インストール先の例は、次の通りです。
/usr/share/fonts
注意
OSが最小構成などで構築されている環境では、 連携エンジン HTMLtoPDF を動作させるために必要な共有ライブラリが不足している場合があります。
次のコマンドを実行し、必要な共有ライブラリに不足がないことを確認してください。
< %HTMLTOPDF_HOME% >を< /usr/local/htmltopdf >として説明します。
ldd /usr/local/htmltopdf/bin/chromhtmltopdf/chromhtmltopdf
次はコマンド実行時の出力例です。
linux-vdso.so.1 (0x00007ffee9c8f000)
libffmpeg.so => /usr/local/htmltopdf/bin/chromhtmltopdf/libffmpeg.so (0x00007fe91e200000)
libdl.so.2 => /lib64/libdl.so.2 (0x00007fe9286e8000)
libpthread.so.0 => /lib64/libpthread.so.0 (0x00007fe9286e3000)
libgobject-2.0.so.0 => /lib64/libgobject-2.0.so.0 (0x00007fe928682000)
libglib-2.0.so.0 => /lib64/libglib-2.0.so.0 (0x00007fe91e6bd000)
libgio-2.0.so.0 => /lib64/libgio-2.0.so.0 (0x00007fe91e01d000)
libnss3.so => not found
libnssutil3.so => not found
libsmime3.so => not found
libnspr4.so => not found
libatk-1.0.so.0 => /lib64/libatk-1.0.so.0 (0x00007fe928656000)
libatk-bridge-2.0.so.0 => /lib64/libatk-bridge-2.0.so.0 (0x00007fe91e684000)
：
上記の場合、「not found」と出力された< libnss3.so >など4つの共有ライブラリが不足しています。
上記のような共有ライブラリが不足している環境で HTML→PDF変換 機能を利用するとエラーが発生し、次のようなエラーメッセージを含む内容がログに出力されます。
/usr/local/htmltopdf/bin/chromhtmltopdf/chromhtmltopdf: error while loading shared libraries: libnss3.so: cannot open shared object file: No such file or directory
不足している共有ライブラリをインストールしてください。