Documentation

簡易ファイルシステムストア

簡易ファイルシステムストアは、デフォルトのファイルストアタイプです。 ファイルシステム(ローカルまたはマウントされた共有)を使用してファイルを格納します。 クラスター環境で簡易ファイルシステムストアを使用する場合、そのフォルダはすべてのクラスターノードからアクセス可能で、同時要求を処理し、ファイルロックをサポートしている必要があります。 記憶域ネットワーク またはクラスター化ファイルシステムを使用することをお勧めします。

簡易ファイルシステムストアは、Liferay DXPデータベースにバインドされています。 デフォルトのルートフォルダは[Liferay Home]/data/document_libraryです。 簡易ファイルシステムストアは、次のファイルパス形式を使用してファイルを保存します。

[Liferay Home]/data/document_library/companyId/folderId/numericFileEntryName/versionNumber

簡易ファイルシステムストアのファイル構造の例。

[Liferay Home]/data/document_libraryフォルダのファイル階層の説明は次のとおりです。

companyId:サイトの会社ID。

folderId:ファイルエントリが含まれているアプリのフォルダ(ドキュメントとメディアフォルダなど)のID。

numericFileEntryName:ファイルエントリの数値名。

versionNumber:ファイルエントリのバージョン番号。

注: ドキュメントの数値ファイルエントリ名とドキュメントIDは、次の点で異なります。

  • それぞれ独立したカウンターを持っています。

  • 数値ファイルエントリ名はストレージファイルパスで使用されますが、ドキュメントIDは使用されません。

  • それぞれ異なるDLFileEntryテーブル列に格納されます。 数値ファイルエントリ名はname列に格納され、ドキュメントIDはfileEntryId列に格納されます。

警告

ドキュメントライブラリでデータベーストランザクションのロールバックが発生した場合、トランザクションのファイルシステムの変更は元に戻されません。 ドキュメントライブラリファイルとファイルシステムストア内のファイルとの間に不整合が発生する可能性があり、手動での同期が必要になる場合があります。 DBStore を除くすべてのDXPストアは、この制限に対して脆弱です。

ストアの設定

簡易ファイルシステムストアを構成するには、次の手順に従います。

  1. メニュー(Menu) ボタンをクリックすると、 コントロールパネル が表示されます。

  2. コントロールパネル] → [設定] → [System Settings] に移動します。

  3. プラットフォーム セクションで、 [File Storage] をクリックします。

  4. Simple File System Store] 画面で、 [Root Directory] を Liferay Home パス(絶対または相対)に設定します。

    システム設定のファイル ストレージページでは、ドキュメントリポジトリストレージを設定できます。

  5. Save] をクリックします。

ファイルストアがすぐに新しいフォルダに切り替わります。

別のストアタイプから簡易ファイルシステムストアに切り替える場合は、次のプロパティを使用してportal-ext.propertiesを設定し、DXPを再起動します。

dl.store.impl=com.liferay.portal.store.file.system.FileSystemStore

クラスター環境でのストアの使用

クラスター環境では、すべてのノードがアクセスできるネットワークマウントファイルシステムをストアに指定します。 ネットワーク化されたファイルシステムは、すべてのノードからアクセス可能で、同時要求をサポートし、ファイルロックをサポートしている必要があります。 そのようなファイルシステムなしで簡易ファイルシステムストアを使用し、複数のユーザーが同時に同じファイルに書き込もうとすると、データが破損する可能性があります。