3 既知の問題と回避策

リリース時での既知の問題について学習します。

この章の内容は次のとおりです。

アクティブ永続性を使用する場合のパーティション数の変更

問題

アクティブ永続性を使用している場合は、パーティション数を変更できません。サービスのパーティション数を変更すると、サービスの再起動時に、アクティブなすべてのデータが永続性のごみ箱に移動するため、元のパーティション数のリストア後にリカバリする必要があります。永続化されるデータは、同じパーティション数で実行されているサービスにのみリカバリできます。

アクティブ永続性が使用されている場合は、パーティション数が変更されていないことを確認します。パーティション数が変更されると、サービスの起動時に、次のようなメッセージが表示されます。

<Warning> (thread=DistributedCache:DistributedCachePersistence, member=1):
Failed to recover partition 0 from SafeBerkeleyDBStore(...); partition-count
mismatch 501(persisted) != 277(service); reinstate persistent store from
trash once validation errors have been resolved

このメッセージは、パーティション数の変更がサポートされておらず、現在アクティブなデータがごみ箱ディレクトリにコピーされたことを示しています。

回避策

データをリカバリするには:

  1. クラスタ全体を停止します。

  2. 各クラスタ・メンバーで影響を受けたクラスタとサービスで現在アクティブなディレクトリの内容を削除します。

  3. アクティブなディレクトリへのサービスごとに、ごみ箱ディレクトリの内容を(再帰的に)コピーします。

  4. パーティション数を元の値にリストアします。

  5. クラスタを再起動します。

旧バージョンとのバイナリの非互換性

Oracle Coherenceリリース14.1.1.0とOracle Coherenceリリース14.1.1.2206の間にはバイナリの互換性がありません。この非互換性により、アップグレードするユーザーは、14.1.1.2206に対してアプリケーションを再コンパイルする必要があります。これは単にバイナリの非互換性であり、APIや機能の非互換性ではありません。

リリース14.1.1.2206より前のCoherenceベースのアプリケーションをそのリリースのcoherence.jarファイルとともに実行すると、実行時に次の例外が発生する場合があります:
java.lang.ClassNotFoundException: com.tangosol.net.NamedCache$Option

たとえば、Session.getCache("<cache name>")コールからです。この例外が発生する原因は、ネストしたクラスOptionが、リファクタリングで14.1.1.0と14.1.1.2206の間にNamedCacheからそのスーパータイプNamedMapに移動したためです。このリファクタリングでは、NamedCache.Optionを使用して以前のコードのAPI互換性を維持しますが、14.1.1.2206のcoherence.jarに対してそのコードを再コンパイルする必要があります。

回避策

Oracle Coherence 14.1.1.2206より前のCoherenceベースのアプリケーションをそのリリースで実行するには、まず14.1.1.2206に対してアプリケーションを再コンパイルする必要があります。再コンパイルによって、実行時にバイナリの非互換性例外が発生することを回避します。