Confluence Data Center のドキュメント変換



アトラシアン コミュニティをご利用ください。


When you insert a file into a page (for example a Word document, or Excel spreadsheet), Confluence will convert the contents to a format that can be viewed inline in the page, in the preview, or in some macros. This can be quite memory and CPU intensive, and has been known to cause out of memory errors when processing very complex files. 

Confluence Data Center では、Confluence が管理する独立したプロセス プールである外部プロセス プールで変換を処理することで、影響を最小限に抑えることができます。これらのプロセス (サンドボックス) はクラッシュまたは終了する可能性がありますが、Confluence アプリケーションに影響を与えることなく、Confluence によって自動的に再起動されます。  

For example, If you insert a very complex file, and the process crashes or is terminated, thumbnail generation will fail. When this happens, a placeholder thumbnail will be used on the page, and a download option will be provided in the file preview. Confluence Data Center doesn't re-attempt to generate thumbnails for failed files.  A good example of a complex file, is a PowerPoint presentation that contains 50 embedded Excel charts. Most files will be processed without any problems. 

The external process pool is used for the following conversions:

  • thumbnail generation for images and documents inserted into a page, or viewed in the preview.
  • HTML conversion for Word and Office documents viewed using the Office Word and Office Excel macros. 

外部プロセス プールは Confluence Data Center でのみ利用できます

In Confluence Server, thumbnail generation and HTML conversion is handled by Confluence, so the information on this page does not apply. 

外部プロセス プールを設定する

ほとんどの場合は既定値が適していますが、システム管理者はシステム プロパティを使用して動作を変更できます。たとえば、プールのサイズ (利用可能なプロセスの数) を増やしたり、プロセスが終了するまでの時間を増やしたりすることができます。変更が必要な場合がある 3 つの主なプロパティは次のとおりです。

  • conversion.sandbox.pool.size
    プール内のプロセス (サンドボックス) の数を増やすには、このプロパティを使用します。追加するそれぞれのプロセスについて、各ノードで追加メモリを許可する必要があります。 
  • conversion.sandbox.memory.limit.megabytes 
    Use this property to limit the amount of memory each thumbnail generation process in the pool can consume. 
  • document.conversion.sandbox.memory.requirement.megabytes
    Use this property to limit the amount of memory each HTML conversion process in the pool can consume. 

  • document.conversion.sandbox.request.time.limit.secs 
    Use this property to change the amount of time (in seconds) that the sandbox will wait for the conversion process to complete, before terminating the process.

これらのプロパティの完全な説明と、サンドボックスの微調整や完全な無効化に使用できるいくつかの追加プロパティについては、「認証済みのシステム プロパティ」を参照してください。 


Confluence は、サムネイル生成に失敗した添付ファイルでの再試行は行いません。添付されたファイルをエディターに再度挿入しても、プロセスはトリガーされません。 


ドキュメントの変換に影響するその他のシステム プロパティ

このページの一覧に記載されているシステム プロパティは、特に外部プロセス プールに適用されます。ただし、Confluence Server と Confluence Data Center の両方に適用されるいくつかの追加プロパティがあります。

  • confluence.document.conversion.imaging.enabled.tif
    TIFF ファイルのドキュメント変換を有効化するには、このプロパティを使用します。デフォルトでは無効になっています。 
  • confluence.document.conversion.imaging.enabled.psd
    Photoshop PSD ファイルのドキュメント変換を有効化するには、このプロパティを使用します。デフォルトでは無効になっています。 
  • confluence.document.conversion.imaging.convert.timeout
    複雑な画像ファイル (ICO、EMF、WMF など) のドキュメント変換を実行するときに適用されるデフォルトの 30 秒の制限を変更するには、このプロパティを使用します。
  • confluence.document.conversion.slides.convert.timeout
    複雑なプレゼンテーション ファイル (PPT、PPTX など) のドキュメント変換を実行するときに適用されるデフォルトの 30 秒の制限を変更するには、このプロパティを使用します。

これらのプロパティの既定値を上書きするには、 システム プロパティを使用して、外部プロセス プールを構成する JVM にプロパティを渡す必要があります。


この例では、TIFF ファイルと PSD ファイルのサムネイル生成を有効化します。

  1. <install-directory>/bin/setenv.bat ファイルを編集します。
  2. 以下の行を追加します。

    set -Dconfluence.document.conversion.imaging.enabled.psd=true %CATALINA_OPTS%

    この方法で外部プロセス プールの JVM に複数のプロパティを渡すことができます。 

Confluence を Windows サービスとして実行しているか、AWS で実行している場合、このプロパティを追加する方法について「システム プロパティの設定」を参照してください。 


この例では、TIFF ファイルと PSD ファイルのサムネイル生成を有効化します。

  1. <install-directory>/bin/ ファイルを編集します。
  2. 以下の行を追加します。この例では、TIFF と PSD ファイルのドキュメント変換を有効化します。 

    CATALINA_OPTS=" -Dconfluence.document.conversion.imaging.enabled.psd=true ${CATALINA_OPTS}"

    この方法で外部プロセス プールの JVM に複数のプロパティを渡すことができます。 

Confluence を AWS で実行している場合、このプロパティを追加する方法について「システム プロパティの設定」を参照してください。 

document.conversion.sandbox.request.time.limit.secs システム プロパティを使用して外部プロセス プールでサムネイルを生成する際のタイムアウトを増やす場合は、上記のシステム プロパティを使用して、複雑な画像ファイルまたはプレゼンテーションのタイムアウトを変更することもできます。既定のままにして、これらのタイプのファイルの変換をより早く失敗させることもできます。 

最終更新日 2020 年 9 月 29 日


Powered by Confluence and Scroll Viewport.