OCI GoldenGateの一般的な既知の問題

サービス全体に適用される一般的な既知の問題とその回避方法について学習します

Oracle GoldenGate 23.26.xにアップグレードした後、デプロイメント・コンソール・アクセスで502 Bad Gatewayエラーが発生するか、ログイン後にGoldenGateプロセスのリストに失敗する可能性があります

Oracle Cloud Infrastructure GoldenGate 23.26デプロイメントは、以前のラベルからバージョン23.26.xにアップグレードした後、または23.26.xデプロイメントで停止/起動操作を実行した後に異常になる可能性があります。

回避策:アップグレードによって影響を受けるOracleデプロイメントをラベルoggoracle:23.26.1.0.0_260331に変更して、この問題を修正します。

Big Dataおよびその他のOracle以外のラベルについては、まもなく修正が発表されます。影響を防ぐために、暫定的な手動緩和についてサポートに連絡してください。

AdminClient: info profileコマンドの問題

AdminClientでinfo profileコマンドを使用すると、エラー302が返されます。

回避策: 次のREST APIコマンドを使用します:

GET https://<deployment URL>/services/adminsrvr/v2/config/types/ogg:managedProcessSettings/values/ogg:managedProcessSettings:Default

21.xデプロイメントを21.17にアップグレードした後、配布パスおよび受信パスが失敗することがあります

Oracle GoldenGateバージョン21.17および26ai以降、パスではデフォルトの予約済ドメイン名「Network」が使用されるため、他のドメイン名を使用する既存のパスは失敗し、次のエラーが報告されます。

ERROR\| Exception Message: The network connection could not be established: 'OGG-10351' - 'Generic error -1 noticed. Error description - credential store alias not found in domain.'

回避策: OCI GoldenGateデプロイメント・コンソールで、各パスを編集し、ドメイン名を「ネットワーク」に変更してから、パスを再起動します。確認するには、「構成」ページの「資格証明ストア」セクションでパス認証ユーザーのドメインを確認します。

管理クライアントを使用する場合は、次のコマンドを実行してドメイン名を更新します。<path_name>および<alias>プレースホルダを必ず置き換えてください。

ソース開始パスの場合:

ALTER DISTPATH <path_name> TARGET AUTHENTICATION USERIDALIAS <alias> domain
    Network

ターゲットで開始されるパスの場合:

ALTER RECVPATH <path_name> SOURCE AUTHENTICATION USERIDALIAS <alias> domain
    Network

Oracle GoldenGate 21.17 for Big Dataへのアップグレードに関する問題

Big Data用のOracle GoldenGateバージョン21.14、21.15または21.16から、トラストストアまたはキーストア接続プロパティ(あるいはその両方)が構成されたバージョン21.17にアップグレードするユーザーは、次のエラーが報告されて失敗します。

Caused by: oracle.goldengate.util.GGException: An exception occurred when creating the Kafka Producer object.
Caused by: org.apache.kafka.common.KafkaException: Failed to construct kafka producer
Caused by: org.apache.kafka.common.KafkaException: Failed to load SSL  keystore /u02/connections/<connection OCID>/trustStore of type JKS
Caused by: java.io.IOException: keystore password was incorrect

回避方法:

1. JKSトラストストアおよびキーストアをPKCS12に変換します。

   1. キーストアの場合は、パスワードの入力を求められます。keytoolは、JDKのユーティリティです。

      keytool -importkeystore -srckeystore [MY_KEYSTORE.jks] -destkeystore [MY_KEYSTORE.p12] -srcstoretype JKS -deststoretype PKCS12 -deststorepass [PASSWORD_PKCS12]

   2. トラストストアの場合は、パスワードの入力を求められます。

      keytool -importkeystore -srckeystore [MY_TRUSTSTORE.jks] -destkeystore [MY_TRUSTSTORE.p12] -srcstoretype JKS -deststoretype PKCS12 -deststorepass [PASSWORD_PKCS12]

2. Kafkaプロデューサ・プロパティ・ファイルで、次を設定します:

   ssl.truststore.type=PKCS12
   ssl.keystore.type=PKCS12

21.15または23.xビルドから21.14へのロールバック中の問題

21.15または23.xビルドを次のいずれかのビルドにロールバックしようとする場合:

• Oracle(21.14.0.0.0_240525)

• ビッグデータ(21.14.0.0.0_240515)

• MySQL(21.14.0.0.0_240404)

• MSSQL(21.14.0.0.0_240404)

次のいずれかの問題が発生する可能性があります。

• 新しいウォレット暗号化機能により21.15以降が導入された接続/資格証明の欠落の問題。

  回避策: 既存の接続を割当て解除してデプロイメントに再割当てし、使用中の配布パスまたは受信パスに必要な欠落ユーザーを再作成する必要があります。

• 23.xから21.14へのロールバックでPerformance Metrics Serviceに問題があるため、Service Managerの起動に失敗します。この問題が発生した場合は、Oracle Supportに連絡してください。

• Oracle GoldenGateプロセスは、"OGG-02431無効なレコード・ヘッダーがチェックポイント・ファイルに見つかりました"というエラーで失敗します。

  回避策: デプロイメントを、シリーズで使用可能な最新の21.14ビルドにアップグレードします。問題が続く場合は、Oracle Supportに連絡してください。

IPを使用してIAM対応デプロイメントにアクセスしようとして、無効なリダイレクトURLエラーが発生しました

デプロイメントのIPアドレスを使用してIAM対応デプロイメントにアクセスしようとすると、次のエラーが発生します:

{"error":"invalid_redirect_uri","error_description":"Client
        xxxxxxxx1ocioraclecloudcom_APPID requested an invalid redirect URL: https://192.x.x.x/services/adminsrvr/v2/authorization. ECID:
        xxxx"}

回避方法:次のいずれかを実行できます。

オプション1: アイデンティティ・ドメイン・アプリケーションにデプロイメントIPアドレスを追加します。この変更を行うには、アプリケーションに割り当てられたユーザー・グループに属している必要があります。

1. Oracle Cloudのナビゲーション・メニューで、「アイデンティティとセキュリティ」を選択し、「アイデンティティ」で「ドメイン」を選択します。

2. 「ドメイン」リストからドメインを選択します。

3. ドメインの「アイデンティティ・ドメイン」リソース・メニューから、「Oracle Cloud Services」を選択します。

4. 「Oracle Cloud Services」リストからアプリケーションを選択します。たとえば、GGS INFRA Application for Deployment Id:<deployment OCID>です。

5. 「OAuth構成」の下のアプリケーション・ページで、「OAuth構成の編集」を選択します。

6. 「リダイレクトURL」に、デプロイメントのコンソールURLを、ドメインのかわりにデプロイメントのIPとともに入力します。例: https://<deployment-ip>/services/adminsrvr/v2/authorization。

7. 変更を保存します。

オプション2:クライアントのhostsファイルにエントリを追加して、127.0.0.1をデプロイメントFQDNにマップします(<region>を適切なリージョンに置き換えます)。たとえば:

127.0.0.1 xx.deployment.goldengate.<region>.oci.oraclecloud.com

IAMデプロイメントでカスタム証明書を更新できません

このサービスは、クロス・リージョン・アクセスに影響し、ターゲット・リージョンのIAMリソースの更新が必要であるため、FQDNの更新を禁止します。

回避策:この問題を回避するには、新しいデプロイメントを作成して、更新されたFQDNを使用します。

Oracle GoldenGate REST APIは、索引ページへの302リダイレクトを返します

GoldenGate REST APIを使用して、OCI GoldenGateデプロイメントを管理できます。Oracle GoldenGateに精通している場合は、サービス・マネージャがOCI GoldenGateで公開されておらず、サービス・マネージャに対して行われたコールは戻れないことに注意してください。

AdminClient: ネゴシエートできません。一致するホスト・キー・タイプが見つかりません

クラウド・シェルでAdminClientを使用してデプロイメントに接続すると、次のメッセージが表示される場合があります:

FIPS mode initialized.
Unable to negotiate with <ip-address> port 22: no matching host key type found. Their offer: ssh-ed25519
Action completed. Waiting until the work request has entered state: ('SUCCEEDED',)
FIPS mode initialized.
Unable to negotiate with <ip-address> port 22: no matching host key type found. Their offer: ssh-ed25519
Cannot create ssh tunnelnel

回避方法:次の手順を実行します。

1. 新しいCloud Shellセッションを開きます。

2. ファイルを作成するには、次のコマンドを使用します。

   cat .ssh/config

3. .ssh/configファイルに次のように入力し、保存します。

   HostkeyAlgorithms ssh-rsa,ssh-ed25519
   PubkeyAcceptedKeyTypes ssh-ed25519,ssh-rsa

4. 既存の.ssh/known_hostsファイルがある場合は、削除します。

5. Cloud Shellセッションを閉じます。

6. デプロイメントの詳細ページで「管理クライアントの起動」を選択します。