Liferay Supportは、特定のサードパーティ製品を他の製品よりも推奨または承認するものではありません。 Liferayは、これらの製品に関して、ここに記載または参照されているいかなる指示に対しても責任を負いません。 これらの原則の実行は、加入者の責任において行われるものとします。
この記事はレガシー記事です。 Liferay製品の旧バージョンにも適用されます。 記事のメンテナンスは終了していますが、情報はまだ通用する可能性があります。
Liferay Portal 5.2、6.0におけるDocument Libraryの使用方法と設定方法について説明します。 ドキュメント・ライブラリーを正しく評価し、活用していただくために、ドキュメント・ライブラリーに関する十分な情報を提供することを目的としています。
解像度
一般的なセットアップ
デフォルトでは、Liferay 5.2および6.0は、ローカルファイルシステムのリポジトリにファイルを保存するFileSystemHookを使用するように構成されています。 このプロパティを使用して、別のDL Hookオプションを選択することで、フックまたはストレージ方法を変更することができます:
dl.hook.impl=。
ドキュメントライブラリ フックオプション
com.liferay.documentlibrary.util.AdvancedFileSystemHook- AdvancedFileSystemHookは、ファイルを複数のディレクトリに分散することで、ファイルシステムの制限を回避しています。 Liferayはファイルレベルのロックを実装していませんので、ファイルロックをサポートするSANを使用している場合のみ使用してください（最近のものはほとんどそうですが、念のためSANのドキュメントを確認してください）。
com.liferay.documentlibrary.util.FileSystemHook - これは5.2EEと6.0EEのデフォルトフックです。 このフックは、ファイルをファイルシステムに保存したいシングルサーバーのLiferayインストールに使用します。
com.liferay.documentlibrary.util.S3Hook- AmazonのSimple Storage Serviceを使用してドキュメントを保存する場合は、このフックを使用します。
liferay.documentum.hook.DocumentumHook- Documentumを使用してドキュメントを保存する場合は、このフックを使用する必要があります。 このフックは、documentum-hookプラグインを導入することで設定されます。 documentum-hookプラグインは、Liferay Enterprise Editionでのみサポートされます。
com.liferay.documentlibrary.util.JCRHook- このフックは、JCR-170に準拠したものです。 このフックは、ファイルを保存するSANを持たない小規模なデプロイメントに使用することができます。 ファイルシステムに保存する場合、Jackrabbitはファイルロックの問題を扱わないので、クラスタ環境では、Jackrabbitをトランザクションデータベースと組み合わせて使用します。 portal.propertiesにいくつかのjcrプロパティがあり、追加の設定は ${liferay.home}/data/jackrabbit/repository.xml を通して行われます。このオプションを選択する場合、必ずトランザクショナルデータベースを使用してください。
クラスタセットアップテスト
Document Libraryのファイルリポジトリが正常に共有されているかどうかは、どのように確認するのですか？ Node1とNode2という2つのノードを使い、簡単なテストを行うことができます。 Node1では、Document Libraryにファイルをアップロードします。 今度はNode2にアクセスして、ファイルがダウンロードできるかどうかを確認します。 何らかの理由でダウンロードできない場合は、設定の再確認が必要です。
ファイルの移行
移行ツールは5.2EE SP3から存在するので、それ以前のバージョンのLiferayを使用している場合は、アップグレードが必要です。 適切な移行を行わずにDocument Library Hooksを切り替えると、以前にアップロードしたファイルにアクセスできなくなります。
ベストプラクティス
本番に入る前に、クラスタリングの可能性があるかどうかを判断しておく必要があります。 ある場合は、クラスタ環境に適したDocument Library Hookを選択することで、移行を気にする必要がなくなります。 例えば、FileSystemHookはローカルファイルシステムにのみファイルを保存するため、クラスタ環境では使用できません。
すでにファイルのアップロードを開始している場合は、ドキュメント・ライブラリ・フックを切り替えることは避けてください。 その結果、以前使用していたHookにアップロードしたファイルが失われることになります。
ファイルがデータベースやファイルシステムに物理的に保存されている場合、これらのファイルを決して編集しないように注意する必要があります。 ドキュメント・ライブラリは、物理ファイルのパスをデータベース上に保存するため、物理ファイルやディレクトリの名前やパスを変更すると、ドキュメント・ライブラリはそのファイルを見つけることができなくなります。
バックエンド
Document Libraryでは、一般的にファイルデータをデータベースとファイルシステムの2か所に保存します。 ファイルのパスからファイルシステム上の実際のファイルの場所までを含むメタデータは、データベースに格納されます（dl*テーブルを参照）。 物理的なファイルは、ファイルシステム上で、利用するドキュメントライブラリHookの種類に応じたディレクトリ構造で保存されます。