この記事では、分散キャッシュのためのLiferayの構成と、カスタムチューニング構成の導入方法について概説します。 キャッシュのチューニングや特定の環境に最適な設定の発見については、Ehcacheのウェブサイト 、ドキュメントとサポートをご覧ください。
解像度
分散キャッシングの設定方法
この記事では、クラスタ環境向けにEhcacheを複製する2つのアプローチについて説明します。 旧来のアプローチは、Ehcacheのデフォルトのレプリケーション技術を利用するものです。 新しいアプローチでは、Liferay プラットフォームに内蔵されている Cluster Link Replicationを利用します。 Ehcacheのデフォルトのレプリケーションは、ウォームアップ後にLiferayの Cluster Link Replicationを上回る、少なくとも100以上のレプリケーションスレッドを持つことになります。
クラスターリンク
Liferayプラットフォームの Cluster Link Replication は、6.2.x EE, 6.1.x EE, 6.0 EE SP2 で利用できます。 キャッシュを分散させるこの手法が、Ehcacheのデフォルトのキャッシュレプリケーション手法よりも本番環境にとって優れているかどうかを評価する。
6.2.x EE および 6.1.x EEでは、portal-ext.properties に以下を設定してください：
cluster.link.enabled=true
ehcache.cluster.link.replication.enabled=true
デフォルトのEhcache - RMIレプリケーションメカニズム
Ehcacheのデフォルトのレプリケーション技術は、特にクラスタリンクレプリケーションのオプションがない古いバージョンのポータルでまだ利用できます。
6.2.x EE および 6.1.x EE では、portal-ext.properties で以下を設定します。
cluster.link.enabled=true
ehcache.cluster.link.replication.enabled=false
Liferay PortalにCache Tuningの設定を導入する方法
hibernate, multivm, singlevm caches tuning configurations をポータルに読み込ませるために、デプロイする必要がある特定のファイルがあります。 ユーザーは、2つの異なる方法のいずれかでポータルを構成することができます：
- カスタムプラグインポートレットをコンフィグレーションでデプロイする
- portal-ext.propertiesでポータルを直接設定する。
前述の通り、6.0 EE SP2、6.1.x EE以上でのクラスターレプリケーションやキャッシュチューニングは、デプロイ可能なプラグインで行うことができます。 管理者がサーバーを再起動する必要がないという利点があります。
- プラグインを作成し、portlet.propertiesの以下のプロパティでファイルやパスを指定するだけです：
ehcache.multi.vm.config.location=ehcache.single.vm.config.location=net.sf.ehcache.configurationResourceName=上記設定は、portal.propertiesでご確認ください。 デフォルトのチューニング設定を含むサンプルxmlファイルがあることに注意してください。 サンプルのxml設定をカスタムのxmlファイルにコピーし、要件に応じた適切な修正を加えます（例：：キャッシュの要素数、キャッシュの有効期限、キャッシュがディスクにオーバーフローするかどうか、など）。 上記設定において、カスタムxmlファイルのパスを必ず指定してください（カスタムxmlは、プラグインのディレクトリ構造内に配置する必要があります）。 プラグインのデプロイ時に、ポータルがファイルを読み込み、指定されたキャッシュを設定します。
このキャッシュチューニングの詳細については、ユーザーガイドの プラグインでEhcacheの設定を変更する のセクションを参照してください。
- もう一つの方法は、ポータルを直接設定する方法です。 設定を有効にするためには、サーバーを停止して再起動する必要があります。 6.1.x EEおよび6.2.x EEでは、portal-ext.propertiesで以下を介してファイルとパスを指定します。
ehcache.multi.vm.config.location=ehcache.single.vm.config.location=net.sf.ehcache.configurationResourceName=上記設定は、portal.propertiesでご確認ください。 デフォルトのチューニング設定を含むサンプルxmlファイルがあることに注意してください。 サンプルのxml設定をカスタムのxmlファイルにコピーし、要件に応じた適切な修正を加えます（例：：キャッシュの要素数、キャッシュの有効期限、キャッシュがディスクにオーバーフローするかどうか、など）。 上記設定において、カスタムxmlファイルのパスを必ず指定してください（カスタムxmlファイルは、ポータルがアクセスできる場所に配置する必要があります）。 ポータルは、起動時にファイルを読み込み、指定されたキャッシュ を設定します。 このキャッシュチューニングの詳細については、ユーザーガイドの Ehcacheの設定を直接変更する のセクションを参照してください。
以下の情報は、レガシー製品またはエンドオブライフ製品に適用されます。 このドキュメントは現在では保守されていませんが、これらの製品バージョンのユーザーには、まだ情報が適用される可能性があります。
6.0 EE SP2の場合、portal-ext.propertiesに以下のように設定します：
cluster.link.enabled=true ehcache.cluster.link.replication.enabled=true net.sf.ehcache.configurationResourceName=/ehcache/hibernate-clustered.xml ehcache.multi.vm.config.location=/ehcache/liferay-multi-vm-clustered.xml
6.0 EE SP1の場合、portal-ext.propertiesに以下を設定します：
cluster.link.enabled=true ehcache.cluster.link.replication.enabled=true net.sf.ehcache.configurationResourceName=/ehcache/hibernate-clusterlinked.xml ehcache.multi.vm.config.location=/ehcache/liferay-multi-vm-clusterlinked.xml
注）クラスタリンクのレプリケーションを有効にするためにあらかじめ設定されているhibernate-clusterlinked.xmlとliferay-multi-vm-clusterlinked.xml（6.0 EE SP1用独自）を添付資料からダウンロードしてください。
追加情報
この記事はLiferayユーザーガイドの延長線上にあります。 上記の「 関連記事 」の項目でリンクを紹介しています。
Ehcacheのメリットを最大限に活かすには、キャッシュのチューニングが欠かせません。 キャッシュをチューニングする方法については、Ehcacheのドキュメントにすべての利点と詳細が記載されていますので、そちらを参照してください： Ehcache ドキュメント. DXP でのチューニングについては、 DXP 7.0 の Ehcache 設定を参照してください。
添付ファイル