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

外部サービスの構成

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

重要

Liferay 7.3.xでは、Xugglerの統合は非推奨となっています。ユーザーは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のXuggler統合を使用して、これらのファイルを変換し、プレビューを生成することができます。サーバーに Xuggler がまだインストールされていない場合は、サーバー管理で有効にするとインストールできます。

ヒント

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

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

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

変更を適用するにはサーバーを再起動します。インストールが完了したら、「外部サービス」タブに戻り、Xuggler を有効にします。
[保存]をクリックします。

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