OCI 中的一般已知問題 GoldenGate

瞭解適用於整個服務的一般已知問題，以及如何解決這些問題。

升級為 Oracle GoldenGate 23.26.x 之後，部署主控台存取可能會發生 502 個無效的閘道錯誤，或者登入後無法列出 GoldenGate 處理作業

從舊版標籤升級至 23.26.x 版本，或在 23.26.x 部署上執行停止 / 啟動作業之後，Oracle Cloud Infrastructure GoldenGate 23.26 部署可能會變得狀況不佳。

解決方法：將受影響的 Oracle 部署升級為 oggoracle:23.26.1.0.0_260331 標籤，以修正此問題。

針對大數據和其他非 Oracle 標籤，我們將盡快發布修正。請聯絡支援中心以取得臨時手動緩解措施，以防止影響。

AdminClient：資訊設定檔命令發生問題

在 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 開始，「路徑」使用預設保留的網域名稱「網路」，因此使用任何其他網域名稱的現有「路徑」失敗，並報告下列錯誤：

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 的問題

從 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

解決方法：

將 JKS 信任存放區和金鑰存放區轉換成 PKCS12。

若為金鑰存放區，應提示輸入密碼。Keytool 是 JDK 中的公用程式。

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

對於信任存放區，應提示輸入密碼。

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

在 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 的「效能度量服務」發生問題。如果您遇到此問題，請聯絡 Oracle Support。
Oracle GoldenGate 處理作業失敗，錯誤為「OGG-02431 checkpoint 檔案中找到無效的記錄標頭 .」

解決方法：將部署升級至系列中最新的 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 位址新增至您的「識別網域應用程式」。若要進行這項變更，您必須是指派給應用程式之使用者群組的一部分。

在 Oracle Cloud 導覽功能表中，選取識別與安全性，然後在「識別」底下，選取網域。
從「網域」清單中選取您的網域。
從網域的識別網域資源功能表中，選取 Oracle Cloud Services 。
從 Oracle Cloud Services 清單中選取您的應用程式。例如，部署 ID：< 部署 OCID> 的 GGS INFRA 應用程式。
在應用程式頁面的 OAuth 組態底下，選取編輯 OAuth 組態。
在重新導向 URL 中，輸入部署的主控台 URL 與部署的 IP，以取代網域。例如：https://<deployment-ip>/services/adminsrvr/v2/authorization。
儲存所做的變更。

選項 2：在從屬端主機檔案中新增項目，以將 127.0.0.1 對應至您的部署 FQDN (將 <region> 取代為適當的區域)。舉例而言：

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

無法更新 IAM 部署的自訂憑證

此服務會禁止更新 FQDN，因為它會影響跨區域存取，而且需要更新目標區域中的 IAM 資源。

解決方法：若要解決此問題，請建立新的部署以使用更新的 FQDN。

Oracle GoldenGate REST API 會傳回 302 次重導至索引頁面

您可以使用 GoldenGate REST API 管理 OCI GoldenGate 部署。對於熟悉 Oracle GoldenGate 的人員，請注意，OCI GoldenGate 中不會顯示 Service Manager，而對 Service Manager 進行的任何呼叫將無法返回。

AdminClient：無法協商：找不到相符的主機金鑰類型

在 Cloud Shell 中使用 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

解決方法：請完成下列步驟：

開啟新的 Cloud Shell 階段作業。
使用下列命令建立檔案：
```
cat .ssh/config
```

在 .ssh/config 檔案中輸入下列內容，然後儲存：

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

如果已經有 .ssh/known_hosts 檔案，請將它刪除。
關閉 Cloud Shell 階段作業。
在您的部署詳細資料頁面上選取啟動管理用戶端。