ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

外部サービスの構成

Liferayは、ファイルの変換やファイルのプレビューを生成するための外部サービスとの統合を提供します。これらのサービスのうち 3 つは、サーバー管理設定で有効にできます。 ImageMagick、 Ghostscript、および Xuggler (Liferay 7.3 以前で利用可能)。

重要

XugglerはLiferay 7.3で非推奨となり、Liferay 7.4で削除されました。これらの手順は、Liferay 7.3以前のバージョンに適用されます。 Liferay 7.4以降では、代わりにLiferayのFFmpeg統合機能を使用してください。詳細については、オーディオおよびビデオのプレビューで FFmpeg を有効にするを参照してください。

［外部サービス］タブからImageMagick、Ghostscript、およびXugglerを有効にします。

各外部サービスは、Liferayインスタンスで有効にする前に、サーバー（またはDockerコンテナ）にインストールしておく必要があります。 Liferay DXPでは古いバージョンが正しく動作しない可能性があるため、サービスをインストールするときは、オペレーティングシステムに最新の安定バージョンを使用してください。

これらのサービスをインストールしたら、コントロールパネルの［サーバー管理］ページでLiferayインスタンスがこれらのサービスを使用するように設定します。

注

Liferay 7.1では、OpenOffice/LibreOfficeは、サーバー管理やポータルのプロパティではなく、OSGi Configuration Adminで設定されます。詳細については、 OpenOffice/LibreOffice統合の有効化を参照してください。

ImageMagickとGhostscriptを有効にする

デフォルトでは、ドキュメントとメディアは PDFBox を使用してプレビューを生成します。 ImageMagick と Ghostscript は、より高速で高品質なプレビューと変換を提供し、より多くの画像ファイル形式をサポートします。動作させるには、両方のサービスを一緒にインストールして有効にする必要があります。

注

お使いのOSによっては、これらのサービスがすでにインストールされている場合があります。 Linuxをお使いの方は、すでに両方ともインストールされていると思います。ただし、Windowsにはインストールされていない可能性が高く、macOSにはインストールされている可能性があります。

ImageMagickとGhostscriptの両方がサーバーにインストールされたら、以下の手順でLiferayインスタンスのこれらのサービスを有効にします。

注

ImageMagickは、Liferay DXP 2025.Q2.9以降のすべてのLiferay Dockerイメージおよびそれ以降の四半期ごとのリリースから削除されます。以前の四半期のパッチリリースでは、2025.Q2.9 以降にリリースされた場合でも、これらのツールが保持されます。

ImageMagickはコンテナ内に手動でインストールすることも可能です。詳細については、 ImageMagick と Gifsicle を手動でインストールするを参照してください。

グローバルメニュー () を開き、 コントロールパネル → 設定 → サーバー管理 に移動します。
［外部サービス］ タブをクリックします。
ImageMagickとGhostscriptの有効をチェックします。
パスフィールドに ImageMagick および Ghostscript 実行可能ファイルへの正しいパスが設定されていることを確認してください。別々のパスにある場合は、セミコロンを区切り文字として使用してください。

例えば、インストール場所によっては、Windowsサーバー上の正しいパスは次のようになる場合があります。
```
C:\\Program Files\\gs\\gs10.1.0\\bin;C:\\Program Files\\ImageMagick
```
デフォルトでは、Linux では両方の実行ファイルが /usr/bin/ にインストールされます。
リソース制限を構成します。
完了したら、 をクリックして保存 をクリックしてください。

Xugglerを有効にする

Liferay 7.3以前

デフォルトでは、［ドキュメントとメディア］では、オーディオファイルやビデオファイルのプレビューは生成されません。 LiferayのXuggler統合を使用して、これらのファイルを変換し、プレビューを生成することができます。サーバーにXugglerがまだインストールされていない場合は、サーバー管理画面で有効化する際にインストールできます。

ヒント

Xugglerは、Linuxではglibcバージョン2.6以降が必要です。

以下の手順で、LiferayインスタンスにXugglerをインストールして有効にします。

グローバルメニュー () を開き、 コントロールパネル → 設定 → サーバー管理 に移動します。
［外部サービス］ タブをクリックします。
Xuggler のが有効になっているか確認してください。
(Xugglerがインストールされていない場合) OSに適したJARを選択し、 インストール をクリックします。

変更を適用するには、サーバーを再起動してください。インストールが完了したら、外部サービスタブに戻って Xuggler を有効にしてください。
［Save（保存）］をクリックします。

portal-ext.properties ファイルを使用して外部サービスを有効にする。

コントロールパネルに加えて、portal-ext.properties ファイルを使用してこれらの外部サービスを有効にできます。

portal-ext.propertiesを使用してImageMagickとGhostscriptを有効にするには、 imagemagick.enabled と imagemagick.global.search.path プロパティをファイルに追加してください。検索パスがImageMagickとGhostscriptの実行ファイルのあるディレクトリを指していることを確認してください。 macOSまたはUnix環境でGhostscriptが使用するフォントのパスを構成する必要がある場合もあります。

imagemagick.enabled=true
imagemagick.global.search.path[apple]=/opt/local/bin:/opt/local/share/ghostscript/fonts:/opt/local/share/fonts/urw-fonts
imagemagick.global.search.path[unix]=/usr/local/bin:/usr/local/share/ghostscript/fonts:/usr/local/share/fonts/urw-fonts
imagemagick.global.search.path[windows]=C:\\Program Files\\ImageMagick