外部サービスの構成

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

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

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

ImageMagickとGhostscriptを有効にする

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

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

1. グローバル メニュー () を開き、 コントロール パネル → 構成 → サーバー管理に移動します。

2. ［外部サービス］ タブをクリックします。

3. ImageMagickとGhostscriptの 有効 をチェックします。

4. パス フィールドに ImageMagick および Ghostscript 実行可能ファイルへの正しいパスが設定されていることを確認します。 別々のパスにある場合は、区切り文字としてセミコロンを使用します。

   たとえば、インストールした場所に応じて、Windows サーバー上の正しいパスは次のようになります。

   C:\\Program Files\\gs\\gs10.1.0\\bin;C:\\Program Files\\ImageMagick
   

   デフォルトでは、両方の実行ファイルは Linux の /usr/bin/ にインストールされます。

5. リソース制限を構成します。

6. 完了したら、 「保存」 をクリックします。

Xugglerを有効にする

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

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

1. グローバル メニュー () を開き、 コントロール パネル → 構成 → サーバー管理に移動します。

2. ［外部サービス］ タブをクリックします。

3. Xuggler の 有効 をチェックします。

4. (Xuggler がインストールされていない場合) OS に適した JAR を選択し、 インストールをクリックします。

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

   

5. [保存]をクリックします。

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

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

ImageMagickとGhostscriptを有効にする

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

Xugglerを有効にする

portal-ext.properties ファイルを使用してXugglerを有効にするには、そのファイルに以下のコードを追加します。

xuggler.enabled=true

アプリケーションサーバーを再起動して、Xugglerの有効化を完了します。

関連トピック

• ドキュメントとメディアプレビューの設定
• 音声とビデオのプレビュー用にFFmpegを有効にする