第1章 Data Grid 8 のアップグレードに関する注意点

以前のバージョンの Data Grid 8 から 8.5 へのアップグレードを正常に行うには、次の情報をお読みください。

削除

クラスのパッケージの変更

次のクラスは別のパッケージに移動されました。

クラス、メソッド、プロパティーの削除

次のメソッドとプロパティーは削除されました。

メトリクス

names-as-tags が true に設定されている場合、JGroups およびクロスサイトメトリクスの名前が変更され、クラスターの名前とサイトの名前はメトリクス名に表示されなくなり、タグとして表示されます。

name-as-tags が false に設定されている場合、メトリクスがチャネルに基づいて命名され、同じ目的のメトリクスが複数作成されます。

TYPE vendor_jgroups_xsite_frag4_get_number_of_sent_fragments gauge
HELP vendor_jgroups_xsite_frag4_get_number_of_sent_fragments Number of sent fragments
TYPE vendor_jgroups_cluster_frag4_get_number_of_sent_fragments gauge
HELP vendor_jgroups_cluster_frag4_get_number_of_sent_fragments Number of sent fragments

# TYPE vendor_jgroups_xsite_frag4_get_number_of_sent_fragments gauge
# HELP vendor_jgroups_xsite_frag4_get_number_of_sent_fragments Number of sent fragments
vendor_jgroups_xsite_frag4_get_number_of_sent_fragments{cluster="xsite",node="..."} 0.0
# TYPE vendor_jgroups_cluster_frag4_get_number_of_sent_fragments gauge
# HELP vendor_jgroups_cluster_frag4_get_number_of_sent_fragments Number of sent fragments
vendor_jgroups_cluster_frag4_get_number_of_sent_fragments{cluster="cluster",node="..."} 2.0

name-as-tags を true に設定すると、メトリクスが簡素化され、クラスター名とサイト名がタグとして表示されます。

TYPE vendor_jgroups_frag4_get_number_of_sent_fragments gauge
HELP vendor_jgroups_frag4_get_number_of_sent_fragments Number of sent fragments

# TYPE vendor_jgroups_frag4_get_number_of_sent_fragments gauge
# HELP vendor_jgroups_frag4_get_number_of_sent_fragments Number of sent fragments
vendor_jgroups_frag4_get_number_of_sent_fragments{cache_manager="default",cluster="xsite",node="..."} 0.0
vendor_jgroups_frag4_get_number_of_sent_fragments{cache_manager="default",cluster="cluster",node="..."} 2.0

SecurityManager

Java Development Kit (JDK) 17 での SecurityManager の削除による非推奨に合わせて、SecurityManager との統合はサポートされなくなりました。

Jakarta と Java EE

Hot Rod クライアントのデフォルト

Data Grid では、Hot Rod クライアントのプロパティーに変更が導入されました。

さらに、ホスト名の検証が有効になっている場合は、sni_host_name の設定が必須になりました。

検索

Data Grid 8.5 では、検索に次の変更が導入されています。

インデックス作成

アノテーションのインデックス作成

セキュリティー

PrincipalRoleMapper は、グループとユーザープリンシパルの両方ではなく、グループにのみ適用されるようになりました。古い動作を使用するには、cache-manager.security.authorization.group-only-mapping=false 設定を使用します。

PrincipalRoleMapper API の詳細は、ロールおよび権限マッパー を参照してください。

散在 (scattered) キャッシュの削除

散在キャッシュモードは削除されました。代わりに分散キャッシュを使用してください。キャッシュモードの詳細は、キャッシュモード を参照してください。

グローバル状態

デフォルトでは、永続的なグローバル状態で、シャットダウンが正常に行われなかったことを示すダングリングロックファイルが見つかった場合、Data Grid は起動しません。グローバル状態の unclean-shutdown-action 設定を行うことで、デフォルトの動作を変更できます。詳細は、グローバル永続ロケーション を参照してください。

Persistence

availability-interval のデフォルト値が 30 秒に増加されました。以前のデフォルトは 1 秒でした。

Soft-index ファイルストア

セグメント数を計算するには、以前のようにインデックスセグメント設定を使用する代わりに、キャッシュセグメントの数のみが使用されます。

RESP エンドポイント

Data Grid 8.5 では、RESP エンドポイントに次の変更が導入されています。

クライアントリスナー削除イベントの伝播

CacheEventConverter の新しい includeOldValue メソッドに関する変更をサポートするために、クライアントリスナー削除イベントは、イベントが値を削除しない場合でも、伝播されるようになりました。

NearCache SPI の更新

以前の NearCache SPI では、同時更新によって古いエントリーがニアキャッシュに保存される可能性があるという問題がありました。この問題に対処するために、NearCache SPI が更新されました。

最低でも 8.1 からのアップグレード

8.0 からアップグレードする場合は、最初に 8.1 にアップグレードする必要があります。Data Grid 8.0 の永続データは、新しいバージョンのバイナリーではありません。この非互換性の問題に対処するために、Data Grid 8.2 以降では、クラスター起動時に Data Grid 8.1 から既存の永続キャッシュストアを自動的に変換します。ただし、Data Grid は、Data Grid 8.0 からキャッシュストアを変換しません。