連携エンジン HTMLtoPDF のインストール¶

Linux での連携エンジン HTMLtoPDF のインストール手順を示します。

連携エンジン HTMLtoPDF の圧縮ファイル< htmltopdf.linux.XXX.tar.gz >、または、< htmltopdf.arm.XXX.tar.gz >をインストール先にコピーします。

インストーラを< htmltopdf.linux.XXX.tar.gz >、インストール先を< /usr/local/ >として説明します。
```
$ cp [ディレクトリ]/htmltopdf.linux.XXX.tar.gz /usr/local/
```
コラム

連携エンジンのバージョンについては、構築する環境に合わせて選択してください。
コラム

インストーラについては、構築する環境のCPUアーキテクチャに合わせて選択してください。
- x64の場合：< htmltopdf.linux.XXX.tar.gz >
- ARM64の場合：< htmltopdf.arm.XXX.tar.gz >
Web Application Server を起動するユーザで、圧縮ファイルを解凍します。
```
$ cd /usr/local/
$ tar zxvf htmltopdf.linux.XXX.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
```
注意

Wayland 環境の場合、手順は不要です。
連携エンジン HTMLtoPDF を動作させるために必要な Xvfb をインストールします。

Xvfb の動作に必要な依存関係等の設定は、適宜設定してください。

コマンドの例は、次の通りです。
```
$ yum install -y xorg-x11-server-Xvfb
```
注意

Wayland 環境の場合、手順は不要です。
連携エンジン HTMLtoPDF を動作させるために必要な依存関係のパッケージをインストールします。

コマンドの例は、次の通りです。
```
$ yum install -y nss 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

不足している共有ライブラリをインストールしてください。

目次

連携エンジン HTMLtoPDF のインストール¶

目次