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

外部サービスの構成

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以降、LibreOffice/OpenOfficeの設定は、サーバー管理やポータルプロパティではなく、OSGi設定管理画面で行うようになりました。詳細については、 LibreOffice / OpenOffice 統合の有効化を参照してください。

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 を有効にしてください。
をクリックして保存します。

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