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：使用 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 开始，Paths 使用默认保留域名 "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 部署控制台中，编辑每个路径并将域名更改为“网络”，然后重新启动路径。要进行验证，请在“配置”页的“身份证明存储”部分中检查路径验证用户的域。

如果您希望使用 Admin Client，请运行以下命令来更新域名。确保替换 <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)
Big Data (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 技术支持联系。
Oracle GoldenGate 进程失败，并显示错误“OGG-02431 检查点文件中找到的记录标头无效”。

解决方法：将部署升级到系列中可用的最新 21.14 构建。如果问题仍然存在，请联系 Oracle 支持部门。

尝试使用 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 导航菜单中，选择身份和安全，然后在“身份”下，选择域。
从“Domains（域）”列表中选择您的域。
从域的“身份域”资源菜单中选择 Oracle Cloud Services 。
从 Oracle Cloud Services 列表中选择应用程序。例如， GGS INFRA Application for Deployment Id：<deployment OCID> 。
在 OAuth 配置下的应用程序页上，选择编辑 OAuth 配置。
对于重定向 URL ，输入部署的控制台 URL 并输入部署的 IP 代替域。例如：https://<deployment-ip>/services/adminsrvr/v2/authorization。
保存所做更改。

选项 2：在客户机 hosts 文件中添加一个条目以将 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 中公开，并且对服务管理器进行的任何调用都无法返回。

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 会话。
在部署详细信息页上选择启动管理客户端。