Problemas gerais conhecidos no OCI GoldenGate

Saiba mais sobre problemas gerais conhecidos que se aplicam a todo o serviço e como contorná-los.

Após o upgrade para o Oracle GoldenGate 23.26.x, o acesso à console de implantação poderá encontrar 502 erros de Gateway Inválido ou falhar na lista de processos do GoldenGate após o log-in

As implantações do Oracle Cloud Infrastructure GoldenGate 23.26 podem ficar insalubres após o upgrade de labels anteriores para a versão 23.26.x ou após a execução de uma operação de interrupção/inicialização em uma implantação do 23.26.x.

Solução alternativa: O upgrade afetou as implantações da Oracle para rotular o oggoracle:23.26.1.0.0_260331, a fim de corrigir esse problema.

Para Big Data e outros rótulos não Oracle, uma correção será anunciada em breve. Entre em contato com o Suporte para obter a mitigação manual provisória para evitar impacto.

AdminClient: Problema com comando do perfil de informações

O uso do comando info profile no AdminClient retorna o erro 302.

Solução alternativa: Use o seguinte comando da API REST:

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

Os Caminhos de Distribuição e Receptor podem falhar após as implantações 21.x atualizadas para 21.17

A partir do Oracle GoldenGate versões 21.17 e 26ai, os Caminhos usam o nome de domínio reservado padrão, "Rede", de modo que os Caminhos existentes que usam qualquer outro nome de domínio falham com o seguinte erro reportado:

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.'

Solução alternativa: Na console de implantação do OCI GoldenGate, edite cada Caminho e altere o nome do domínio para "Rede" e reinicie o Caminho. Para verificar, verifique o domínio do usuário de autenticação de Caminho na seção de armazenamento de Credenciais da página Configuração.

Se preferir usar o Admin Client, execute os comandos a seguir para atualizar o nome do domínio. Certifique-se de substituir os placeholders <path_name> e <alias>:

Para caminhos iniciados por origem:

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

Para caminhos iniciados por destino:

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

Problemas de upgrade para o Oracle GoldenGate 21.17 for Big Data

Os usuários que fazem upgrade do Oracle GoldenGate versões 21.14, 21.15 ou 21.16 do Big Data para a versão 21.17 com propriedades de conexão de armazenamento confiável e/ou armazenamento de chaves configuradas estão falhando com os seguintes erros reportados:

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

Solução Alternativa:

Converta o armazenamento confiável e o keystore JKS em PKCS12.

No caso da área de armazenamento de chaves, ela deverá solicitar uma senha. O Keytool é um utilitário do JDK.

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

Para o armazenamento confiável, ele deve solicitar uma senha.

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

No arquivo de propriedades do produtor Kafka, defina o seguinte:
```
ssl.truststore.type=PKCS12
ssl.keystore.type=PKCS12
```

Problemas durante a reversão de builds 21.15 ou 23.x para 21.14

Ao tentar reverter uma compilação 21.15 ou 23.x para uma das seguintes compilações:

O 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)

Você pode encontrar um dos seguintes problemas:

Problema de Conexões/Credenciais ausente devido ao novo recurso de criptografia da wallet introduzido na versão 21.15 em diante.

Solução alternativa: você deve cancelar a designação e reatribuir as conexões existentes à implantação e recriar os usuários ausentes necessários para qualquer caminho de Distribuição ou Receptor em uso.
Falha ao iniciar o Service Manager devido a um problema com o Serviço de Métricas de Desempenho em rollbacks de 23.x para 21.14. Entre em contato com o Suporte Técnico da Oracle caso encontre esse problema.
Falha nos processos do Oracle GoldenGate com o erro "OGG-02431 Cabeçalho de registro inválido encontrado no arquivo de checkpoint."

Solução alternativa: Faça upgrade da implantação para o build 21.14 mais recente disponível na série. Entre em contato com o Suporte Técnico da Oracle se o problema persistir.

Erro de url de redirecionamento inválido ao tentar acessar uma implantação ativada para o IAM usando um IP

Ao tentar acessar uma implantação ativada para o IAM usando o endereço IP da implantação, você encontra o seguinte erro:

{"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"}

Solução alternativa: você pode executar uma das seguintes ações:

Opção 1: Adicione o endereço IP de implantação ao seu Aplicativo de Domínio de Identidades. Para fazer essa alteração, você deve fazer parte do grupo de usuários atribuído ao aplicativo.

No menu de navegação do Oracle Cloud, selecione Identidade e Segurança e, em Identidade, selecione Domínios.
Selecione seu domínio na lista Domínios.
No menu de recursos do Domínio de Identidades do domínio, selecione Oracle Cloud Services.
Selecione seu aplicativo na lista Oracle Cloud Services. Por exemplo, Aplicativo GGS INFRA para Id de Implantação:<OCID de Implantação>.
Na página do aplicativo em configuração do OAuth, selecione Editar configuração do OAuth.
Para URL de Redirecionamento, informe o URL da Console da implantação com o IP da implantação no lugar do domínio. Por exemplo: https://<deployment-ip>/services/adminsrvr/v2/authorization.
Salve as alterações.

Opção 2: Adicione uma entrada no arquivo de hosts do cliente para mapear 127.0.0.1 para seu FQDN de implantação (substitua <region> pela região apropriada). Por exemplo:

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

Não é possível atualizar certificados personalizados em implantações do IAM

O serviço proíbe atualizações no FQDN, pois afeta o acesso entre regiões e requer atualizações nos recursos do IAM na região de destino.

Solução alternativa: para contornar esse problema, crie uma nova implantação para usar o FQDN atualizado.

As APIs REST do Oracle GoldenGate retornam 302 redirecionamentos para uma página de índice

Você pode usar as APIs REST do GoldenGate para gerenciar suas implantações do OCI GoldenGate. Para aqueles familiarizados com o Oracle GoldenGate, observe que o Service Manager não é exposto no OCI GoldenGate e nenhuma chamada feita ao Service Manager poderá ser retornada.

AdminClient: Não é possível negociar: nenhum tipo de chave de host correspondente encontrado

Quando você usa AdminClient no Cloud Shell para estabelecer conexão com sua implantação, pode encontrar a seguinte mensagem:

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

Solução alternativa: Conclua as seguintes etapas:

Abra uma nova sessão do Cloud Shell.
Crie um arquivo usando o seguinte comando:
```
cat .ssh/config
```

Informe o seguinte no arquivo .ssh/config e salve-o:

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

Se houver um arquivo .ssh/known_hosts existente, exclua-o.
Feche a sessão do Cloud Shell.
Selecione Iniciar Admin Client na página de detalhes da implantação.