テンプレート処理中にエラーが発生しました。
Java method "com.liferay.portal.json.JSONFactoryImpl.createJSONObject(String)" threw an exception when invoked on com.liferay.portal.json.JSONFactoryImpl object "com.liferay.portal.json.JSONFactoryImpl@2ad66ae2"; see cause exception in the Java stack trace.

----
FTL stack trace ("~" means nesting-related):
	- Failed at: navigationJSONObject = jsonFactoryUti...  [in template "17855804202317#32484267#LEARN-ARTICLE-NAV" at line 4, column 9]
----
1<#assign 
2	groupFriendlyURL = themeDisplay.getScopeGroup().getFriendlyURL() 
3	groupPathFriendlyURLPublic = themeDisplay.getPathFriendlyURLPublic() + groupFriendlyURL 
4	navigationJSONObject = jsonFactoryUtil.createJSONObject(navigation.getData()) 
5	navigationMenuItems = 
6
7			"Analytics Cloud": { 
8				"image": "/documents/d${groupFriendlyURL}/analytics_c-svg", 
9				"title": "Analytics Cloud", 
10				"url": "analytics-cloud" 
11			}, 
12			"Commerce": { 
13				"image": "/documents/d${groupFriendlyURL}/commerce_product-svg", 
14				"title": "Commerce", 
15				"url": "commerce" 
16			}, 
17			"DXP": { 
18				"image": "/documents/d${groupFriendlyURL}/dxp_p-svg", 
19				"title": "DXP / Portal", 
20				"url": "dxp" 
21			}, 
22			"Liferay Cloud": { 
23				"image": "/documents/d${groupFriendlyURL}/dxp_c-svg", 
24				"title": "Liferay Cloud", 
25				"url": "liferay-cloud" 
26			}, 
27			"Reference": { 
28				"image": "/documents/d${groupFriendlyURL}/reference-svg", 
29				"title": "Reference", 
30				"url": "reference" 
31
32
33 
34	breadcrumbJSONArray = navigationJSONObject.getJSONArray("breadcrumb") 
35	childrenJSONArray = navigationJSONObject.getJSONArray("children") 
36	parentJSONObject = navigationJSONObject.getJSONObject("parent") 
37	productJSONObject = breadcrumbJSONArray.getJSONObject(breadcrumbJSONArray.length()-1)!navigationJSONObject.getJSONObject("self") 
38	siblingsJSONArray = navigationJSONObject.getJSONArray("siblings") 
39/> 
40 
41<div class="learn-article-nav"> 
42	<#if productJSONObject?has_content && productJSONObject.getString("title")?has_content && navigationMenuItems[productJSONObject.getString("title")]?has_content && navigationMenuItems[productJSONObject.getString("title")].title?has_content> 
43		<div 
44			class="dropdown learn-article-nav-root learn-dropdown" 
45
46			<div class="learn-article-nav-item"> 
47				<div class="d-flex"> 
48					<div class="learn-article-nav-image"> 
49						<img 
50							class="lexicon-icon lexicon-icon-caret-bottom product-icon" 
51							role="presentation" 
52							src='${navigationMenuItems[productJSONObject.getString("title")].image}' 
53							viewBox="0 0 512 512" 
54						/> 
55					</div> 
56 
57					<span class="learn-article-nav-text">${navigationMenuItems[productJSONObject.getString("title")].title}</span> 
58				</div> 
59 
60				<div id="dropdown-icon"> 
61					<svg 
62						class="lexicon-icon lexicon-icon-caret-bottom" 
63						role="presentation" 
64						viewBox="0 0 512 512" 
65
66						<use xlink:href="/o/admin-theme/images/clay/icons.svg#caret-bottom"></use> 
67					</svg> 
68				</div> 
69			</div> 
70 
71			<ul class="dropdown-menu learn-dropdown-menu"> 
72				<#list navigationMenuItems as key, value> 
73					<li> 
74						<a 
75							class="dropdown-item learn-article-nav-item" 
76							href="/w/${navigationMenuItems[key].url}/index" 
77							tabindex="4" 
78
79							<span class="d-flex"> 
80								<span class="learn-article-nav-image"> 
81									<img 
82										class="lexicon-icon lexicon-icon-caret-bottom product-icon mt-0 mr-2" 
83										role="presentation" 
84										src="${value.image}"height: 25px; margin-left: 5px; max-width: none; width: 25px; 
85										viewBox="0 0 512 512" 
86									/> 
87								</span> 
88								<span class="learn-article-nav-text">${value.title}</span> 
89							</span> 
90 
91							<#if navigationMenuItems[productJSONObject.getString("title")].url == value.url> 
92								<span> 
93									<@clay["icon"] symbol="check" /> 
94								</span> 
95							</#if> 
96						</a> 
97					</li> 
98				</#list> 
99			</ul> 
100		</div> 
101	</#if> 
102 
103	<div class="learn-article-nav-content"> 
104		<#if parentJSONObject?has_content && parentJSONObject.getString("url")?has_content> 
105			<div class="learn-article-nav-item learn-article-nav-parent liferay-nav-item p-2"> 
106				<div class="mr-2"> 
107					<a 
108						href='${parentJSONObject.getString("url")}' 
109
110						<svg 
111							class="lexicon-icon lexicon-icon-angle-left" 
112							role="presentation" 
113							viewBox="0 0 512 512" 
114
115							<use xlink:href="/o/admin-theme/images/clay/icons.svg#angle-left"></use> 
116						</svg> 
117					</a> 
118				</div> 
119 
120				<span>${parentJSONObject.getString("title")}</span> 
121			</div> 
122		</#if> 
123 
124		<#if childrenJSONArray.length() gt 0> 
125			<ul class="m-0 p-2"> 
126				<#list 0..childrenJSONArray.length()-1 as i> 
127					<li class="learn-article-nav-item"> 
128						<a 
129							class='liferay-nav-item ${(navigationJSONObject.getJSONObject("self").url == childrenJSONArray.getJSONObject(i).url)?then("selected", "")}' 
130							href="${childrenJSONArray.getJSONObject(i).url}" 
131
132							<span>${childrenJSONArray.getJSONObject(i).getString("title")}</span> 
133						</a> 
134					</li> 
135				</#list> 
136			</ul> 
137		<#elseif siblingsJSONArray.length() gt 0> 
138			<ul class="m-0 p-2"> 
139				<#list 0..siblingsJSONArray.length()-1 as i> 
140					<li class="learn-article-nav-item"> 
141						<a 
142							class='liferay-nav-item ${(navigationJSONObject.getJSONObject("self").url == siblingsJSONArray.getJSONObject(i).url)?then("selected", "")}' 
143							href="${siblingsJSONArray.getJSONObject(i).url}" 
144
145							<span>${siblingsJSONArray.getJSONObject(i).getString("title")}</span> 
146						</a> 
147					</li> 
148				</#list> 
149			</ul> 
150		</#if> 
151	</div> 
152</div> 

クラスタリンクの構成

Cluster Linkを有効にすると、分散キャッシュがアクティブになります。 キャッシュは、同時に実行されている複数のLiferay DXPノードに分散されます。 Cluster Linkは、 Ehcache レプリケーションを使用します。 Ehcacheグローバル設定は portal.properties ファイル にあります。

デフォルトでは、Liferayはノード間でキャッシュされたエンティティをコピーしません。 たとえば、エンティティが削除または変更された場合、クラスターリンクは他のノードに 削除 メッセージを送信して、ローカルキャッシュ内のこのエンティティを無効にします。 他のノードでそのエンティティを要求すると、キャッシュ ミス が発生し、エンティティはデータベースから取得されてローカルキャッシュに格納されます。 1つのノードのローカルキャッシュに追加されたエンティティは、他のノードのローカルキャッシュにはコピーされません。 エンティティがキャッシュされていないノードで新しいエンティティを取得しようとすると、キャッシュ ミス が発生します。 ミスにより、ノードがトリガーされてデータベースからエンティティが取得され、ローカルキャッシュに格納されます。

Liferay DXPのキャッシュアルゴリズムは非常に効率的です。

DXPのクラスタリングは、ネットワークとクラスタノードの場所に応じて、さまざまな方法で構成できます。 まず、クラスタリンクを有効にすることから始めます。

クラスタリンクの有効化

クラスタリンクを有効にするには、次の ポータルプロパティportal-ext.properties ファイルに追加します。

cluster.link.enabled=true

Cluster Linkポータルプロパティ は、ニーズに合わせてオーバーライドできるデフォルト構成を提供します。

デフォルトの多くは、実際のアドレスの代わりに localhost使用します。 ただし、一部の構成では、 localhost は、ホストの実際のアドレスではなく、内部ループバックネットワーク(127.0.0.1 または :: 1)にバインドされています。 それでもこの設定が必要な場合は、DXPにこのプロパティを使用して実際のアドレスを自動検出させることができます。

cluster.link.autodetect.address=www.google.com:80

サーバーから接続可能な他のホストに接続するように設定します。 デフォルトではGoogleを指しますが、サーバーがファイアウォールの背後にある場合は機能しない可能性があります。 各ホストの実際のアドレスを使用する場合、自動検出アドレスを設定する必要はありません。

クラスタリンクは JGroups に 依存し、ノードが通信するためのAPIを提供します。 以下のことが可能です:

  • クラスター内のすべてのノードにメッセージを送信する
  • 特定のノードにメッセージを送信する
  • メソッドを呼び出し、すべて、一部、または特定のノードから値を取得する
  • メンバーシップを検出し、ノードが参加または脱退したときに通知する

クラスタリンクには、ノード間の1対多タイプの通信を提供する拡張アルゴリズムが含まれています。 これはJGroupsのUDPマルチキャストでデフォルトで実装されていますが、ユニキャストとTCPも利用できます。

クラスタリンクの構成

Cluster Linkを有効にすると、DXPのデフォルトのクラスタリング構成が有効になります。 この設定では、 UDP上のIPマルチキャスト を定義します。 独自のノードでマルチキャストを使用できない場合(たとえば、地理的に離れている場合やファイアウォールによって分離されている場合)、代わりにユニキャスト実装を構成できます。 詳細は、 TCPを介したユニキャストの構成 を参照してください。

UDPを介したマルチキャストの使用

DXPは、 JGroupsからのチャネル のグループを2つ使用して、UDPを介したマルチキャストを実装します:コントロールグループとトランスポートグループです。 チャネルのプロパティ をカスタマイズする場合は、次のポータルプロパティを portal-ext.propertiesに追加することにより、カスタマイズできます。

cluster.link.channel.name.control=[your control channel name]
cluster.link.channel.properties.control=[your control channel properties]

チャネルのプロパティについては、 JGroups’s documentation を参照してください。 デフォルトの構成では、そこで説明されている設定を持つ多くのプロパティが設定されます。

マルチキャストは、ネットワーク上のすべてのデバイスにブロードキャストします。 同じネットワーク上のクラスター環境は、デフォルトで互いに通信します。 それらの間で送信されるメッセージと情報(たとえば、スケジュールされたタスク)は、意図しない結果につながる可能性があります。 ネットワーク上で論理的または物理的にそれらを分離するか、各クラスターの portal-ext.properties を構成して、 マルチキャストグループアドレスとポート値の異なるセットを使用するようにして、そのようなクラスター環境を分離します

JGroupsはデフォルトで localhost を使用してバインドアドレスを自動的に設定します。 ただし、一部の構成では、 localhost は、ホストの実際のアドレスではなく、内部ループバックネットワーク(127.0.0.1 または :: 1)にバインドされています。 DXPの cluster.link.autodetect.address ポータルプロパティが接続可能なサーバーを指している限り、DXPはそのサーバーを使用してホストの実際のアドレスを自動的に検出します。 デフォルトの設定は次のとおりです。

cluster.link.autodetect.address=www.google.com:80

サーバーがファイアウォールの内側にある場合、Googleへの連絡が機能しない場合があります。

バインドアドレスのホストアドレスを自動的に検出する代わりに、 portal-ext.properties ファイルでバインドアドレスを手動で設定できます。

  1. cluster.link.autodetect.address プロパティを空の値に設定して、アドレスの自動検出を無効にします。

    cluster.link.autodetect.address=
    
  2. 次のプロパティをホストのIPアドレスに設定します。

    cluster.link.bind.addr["cluster-link-control"]=[place your IP address or host name here]
    cluster.link.bind.addr["cluster-link-udp"]=[place your IP address or host name here]
    

ネットワーク構成により、TCPを介したマルチキャストを使用できない場合があります。これらの状況については、 TCPを介したユニキャストの構成 を参照してください。 これらのメソッドはすべてJGroupsによって提供されることに注意してください。

まとめ

クラスターを構成したら、開始できます。 ログファイルメッセージにクラスターの名前が表示されます(例: cluster=liferay-channel-control):

-------------------------------------------------------------------
GMS: address=oz-52865, cluster=liferay-channel-control, physical address=192.168.1.10:50643
-------------------------------------------------------------------

  クラスタはクラスタリンクを使用しています。

次のステップ

負荷をかけた状態でDXPクラスタをテストし、システムの最適化を調査するのが最善です。 サイトで最も使用されているエンティティを検討し、キャッシュ設定を適切に調整します。 キャッシュの構成については、 Cache Configuration を参照してください。

関連トピック