Verificar Prontidão de Upgrade e Corrigir Problemas de Pré-verificação

A Oracle executa periodicamente algumas pré-verificações para determinar sua prontidão de upgrade para que seu upgrade seja executado sem problemas. Se as pré-verificações não forem aprovadas, talvez seja necessário executar tarefas para corrigir os problemas.

Depois de corrigir quaisquer problemas de pré-verificação, configure suas definições de upgrade.

Exibir Seu Status de Pré-verificação

Para ver o status de pré-verificação ou executar a verificação novamente, execute as seguintes etapas:

  1. No painel de navegação, clique em Definições e, em seguida, em Fazer Upgrade.

    Você pode ver quando a última pré-verificação foi concluída acima da tabela de verificação de prontidão.

    A tabela de verificação de prontidão mostra as seguintes informações sobre o status dos itens de pré-verificação.

    Coluna Descrição
    Condição de Elegibilidade A condição que deve ser atendida para estar pronta para upgrade. Algumas condições incluem links para a documentação associada.
    Proprietário Quem é responsável por gerenciar a condição.
    Data de Vencimento A data até a qual a condição deve ser atendida.
    Status de Elegibilidade O status da condição, incluindo explicações para condições que não foram atendidas. Expanda Mais detalhes... para ver informações adicionais sobre a falha da condição. Para copiar os detalhes para a área de transferência, clique em ícone Copiar.
  2. Se houver pré-verificações que não foram aprovadas, execute as tarefas associadas para corrigir os problemas.
  3. Para executar a pré-verificação novamente, clique em Verificar novamente.

    Demora cerca de uma hora para a pré-verificação ser concluída.

Observação

Se a Oracle tentar fazer upgrade da sua instância, você verá os detalhes dessa tentativa no Resumo do Upgrade diretamente abaixo da tabela de verificação de prontidão.

Pré-verificações do Agente de Conectividade

Condição de elegibilidade Proprietário típico Aplicável à região do Governo Tarefas a serem concluídas

Versão do Java do Agente

Equipe de Operações de Desenvolvimento Sim Certifique-se de que seus agentes de conectividade usem o JDK 17 e o PKCS12 KeyStore. Expanda Mais detalhes para ver os agentes de conectividade que precisam de revisão. Para copiar os detalhes para a área de transferência, clique em ícone Copiar. Você também pode exibir a seção Status do Agente de Conectividade para ver o status de todos os agentes de conectividade em sua instância.
  1. Para qualquer agente de conectividade que ainda não esteja usando o JDK 17, instale o JDK 17 no servidor que hospeda o agente.
  2. Para qualquer agente que ainda esteja usando o JKS KeyStore, converta o KeyStore em PKCS12 KeyStore. Você pode fazer a conversão de uma destas duas maneiras:
    • Automaticamente, durante o upgrade: Seu JKS KeyStore será convertido automaticamente para o PKCS12 KeyStore durante o upgrade.
    • Manualmente, antes do upgrade: Você pode converter o JKS KeyStore para o PKCS12 KeyStore manualmente, antes do upgrade, seguindo as etapas abaixo.
    Observação

    A conversão do JKS KeyStore para o PKCS12 KeyStore não afeta seu agente de conectividade do Oracle Integration Generation 2 e só entra em vigor depois que você faz upgrade para o Oracle Integration 3.

    Se você quiser converter manualmente seu JKS KeyStore para o PKCS12 KeyStore, execute as etapas a seguir antes de atualizar. Essas tarefas exigem que você interrompa brevemente e reinicie o agente de conectividade; portanto, escolha um horário em que o agente de conectividade não esteja sendo usado.

    1. No servidor que hospeda o agente de conectividade, crie um backup do arquivo keystore.jks, que está localizado na seguinte pasta:

      Agent_Install_Location/agenthome/agent/cert

    2. Mova o arquivo de backup para uma pasta diferente.
    3. Converta o JKS KeyStore em PKCS12 KeyStore executando o seguinte comando na linha de comando:

      keytool -importkeystore -srckeystore keystore.jks -destkeystore keystore.p12 -srcstoretype JKS -deststoretype PKCS12 -deststorepass changeit -srcstorepass changeit

    4. Interromper o agente de conectividade.
    5. Exclua o arquivo keystore.jks no seguinte local:

      Agent_Install_Location/agenthome/agent/cert

    6. Inicie o agente de conectividade.

Conectividade do Agente para o Oracle Integration 3 - O agente de conectividade deve estar em execução

Equipe de Operações de Desenvolvimento Sim Seu agente de conectividade deve estar ativo e em execução antes do início do upgrade. Expanda Mais detalhes para ver os agentes de conectividade que precisam de revisão. Para copiar os detalhes para a área de transferência, clique em ícone Copiar. Você também pode exibir a coluna Status do Agente na seção Status do Agente de Conectividade para ver o status de todos os agentes de conectividade em sua instância, indicando se cada agente está off-line (indisponível).

Os agentes que não estão acessíveis durante o upgrade ou que não atendem aos requisitos de upgrade não serão submetidos a upgrade; nesse caso, você precisará executar etapas pós-upgrade para recuperar a conectividade.

Conectividade do Agente para o Oracle Integration 3 - Atualize suas definições da lista de permissões

Equipe de Operações de Desenvolvimento Sim Você deve atualizar suas definições da lista de permissões para seus agentes de conectividade antes do upgrade. Expanda Mais detalhes para ver os agentes de conectividade que precisam de revisão. Para copiar os detalhes para a área de transferência, clique em ícone Copiar. Você também pode exibir a coluna Status da lista de permissões na seção Status do Agente de Conectividade para ver o status de todos os agentes de conectividade em sua instância, indicando se a lista de permissões foi atualizada adequadamente.

À medida que a janela de upgrade se aproxima, execute as seguintes tarefas de pré-upgrade:

  • Adicione o endereço IP do Oracle Cloud Infrastructure Identity and Access Management (IAM) à lista de permissões.
  • Adicione os endereços IP de design-time e runtime do Oracle Integration à lista de permissões.
  • Defina a propriedade Cache do servidor proxy para que os URLs do Oracle Integration sejam atualizados com a maior frequência possível.

Os agentes que não estão acessíveis durante o upgrade ou que não atendem aos requisitos de upgrade não serão submetidos a upgrade; nesse caso, você precisará executar etapas pós-upgrade para recuperar a conectividade.

Identificador AgentGroup Não Suportado

Equipe de Operações de Desenvolvimento Sim Se algum dos seus grupos de agentes tiver um espaço em seus identificadores, eles não serão migrados para o Oracle Integration 3. Se você ainda precisar dos grupos de agentes, precisará recriá-los após o upgrade.

Pré-verificações de Instância

Condição de elegibilidade Proprietário típico Aplicável à região do Governo Tarefas a Serem Concluídas

URL de Ponto Final Personalizado

Administrador Sim Dependendo de como seu ponto final personalizado está configurado antes da migração, você executará diferentes etapas e o processo de upgrade tratará o ponto final personalizado de maneira diferente. Expanda Mais detalhes para determinar como prosseguir com o upgrade.
Fluxograma, descrito no texto

  • Se você estiver usando o Visual Builder:
    1. Para continuar a atualização, conclua as Tarefas de Pré-Upgrade do Visual Builder.
    2. Durante o upgrade, o processo de upgrade configura seu ponto final personalizado e qualquer ponto final personalizado alternativo no Visual Builder.
  • Se você não estiver usando o Visual Builder e tiver pontos finais personalizados alternativos, exclua-os da sua instância do Oracle Integration Generation 2. No momento, o Oracle Integration 3 não suporta pontos finais personalizados alternativos.
  • Se você não estiver usando o Visual Builder e seu ponto final personalizado usar SSL:
    1. Para continuar o upgrade, configure um balanceador de carga na frente da instância do Oracle Integration Generation 2 e remova o certificado SSL.
    2. Durante o upgrade, o processo de upgrade configura seu ponto final personalizado no Oracle Integration 3.
    3. Após o upgrade, o acesso de runtime às suas integrações continuará funcionando como no Oracle Integration Generation 2. Para todos os outros pontos de acesso, como design-time e Process Automation, você ainda acessa o ponto final personalizado, mas o ponto final personalizado é redirecionado para o URL apropriado.
  • Se nenhuma dessas situações se aplicar e essa pré-verificação for aprovada, o processo de upgrade configurará seu ponto final personalizado no Oracle Integration 3, e o ponto final personalizado funcionará conforme descrito no marcador anterior para o cenário SSL.

Ação do ID da Instância

Administrador Sim O ID da instância de integração gerada pelo sistema que é exibido na página Instâncias e no fluxo de atividades de uma instância de integração foi alterado de um valor numérico para um valor alfanumérico no Oracle Integration 3. O tipo de dados do valor permanece inalterado; ele permanece um tipo de dados de string. A alteração em um valor alfanumérico pode afetar qualquer sistema utilizado que dependa do ID ocorrência de integração ser um valor numérico. Por exemplo, se você analisar o ID da instância de integração de uma API REST e armazenar o ID da instância de integração em um banco de dados como um campo numérico, será necessário atualizar o campo do banco de dados.

Se você tiver integrações que usam IDs de instância de integração, a pré-verificação mostrará um aviso. Expanda Mais detalhes para ver as integrações que precisam ser revisadas. Para copiar os detalhes para a área de transferência, clique em Ícone Copiar.

Se precisar de mais tempo para fazer as atualizações necessárias para essa alteração, você poderá manter o ID da instância de integração como numérico temporariamente (seis meses após o upgrade). Consulte FlowId Suporte a Conversão. Certifique-se de observar quais integrações são afetadas copiando os detalhes conforme descrito acima.

Observação: Essa pré-verificação verifica apenas a existência de integrações que usam IDs de instância, não a precisão dos IDs de instância. O aviso permanecerá depois que você atualizar suas integrações, mas não afetará seu upgrade.

Limite de E-mail Diário

Administrador Sim O Oracle Integration 3 pode enviar um limite de 10.000 e-mails em uma janela contínua de 24 horas, conforme descrito em Limites do Serviço. Se sua implantação precisar enviar mais do que isso, você poderá usar sua tenancy do cliente. Consulte Configurar E-mails de Notificação.

Escopos personalizados no IDCS

Administrador Não O Oracle Integration 3 adiciona um escopo padrão (/ic/api/ , urn:opc:resource:consumer::all) ao Oracle Identity Cloud Service (IDCS) quando a instância é criada. Ele não suporta outros escopos personalizados adicionados ao IDCS. Se você tiver criado escopos personalizados no IDCS, deverá removê-los.

Outras Falhas

Varia Sim Se houver outros problemas que bloquearão o upgrade sem pré-verificações específicas, eles serão incluídos em outras falhas. Expanda Mais detalhes para ver os problemas que precisam de ação. Para copiar os detalhes para a área de transferência, clique em ícone Copiar.

B2B para Pré-verificações do Oracle Integration

Condição de elegibilidade Proprietário típico Aplicável à região do Governo Tarefas a Serem Concluídas

B2B Período de Retenção

Administrador Não Embora você não precise fazer nada para corrigir esse status de pré-verificação, lembre-se de que as edições Standard e Enterprise do Oracle Integration 3 suportam 32 dias de retenção de dados por padrão. Durante o upgrade, apenas os 32 dias mais recentes de dados retidos serão migrados. Expanda Mais detalhes para ver quantos dias de dados retidos você tem no momento. Para copiar os detalhes para a área de transferência, clique em ícone Copiar.

Após o upgrade para o Oracle Integration 3, você poderá aumentar o período de retenção de dados se quiser; ou fazer upgrade para a edição Healthcare, que suporta 184 dias de retenção de dados.

Pré-verificações de Integrações

Condição de elegibilidade Proprietário típico Aplicável à região do Governo Tarefas a Serem Concluídas

Resposta Atrasada (Assíncrona)

Equipe de desenvolvimento Sim O padrão de resposta atrasada (assíncrona) era suportado anteriormente nos seguintes adaptadores:
  • Oracle CX Sales and B2B Service Adapter
  • Oracle ERP Cloud Adapter
  • Oracle HCM Cloud Adapter
  • Oracle Field Service Cloud Adapter
  • Salesforce Adapter
  • ServiceNow Adaptador
Se você tiver integrações usando resposta atrasada (assíncrona) com um desses adaptadores, retrabalhe-os criando duas conexões de chamada para obter uma funcionalidade semelhante:
  1. Crie uma chamada simples para callbacks bem-sucedidos.
  2. Crie uma chamada adicional para callbacks de falha no handler de falha para capturar a falha correta.

Expanda Mais detalhes para ver quais integrações precisam ser revisadas. Para copiar os detalhes para a área de transferência, clique em ícone Copiar.

Certificados de Identidade

Equipe de desenvolvimento Sim Os certificados de identidade estabelecem a identidade do cliente durante a comunicação SSL bidirecional. As conexões baseadas no Adaptador AS2 e no Adaptador REST podem usar certificados de identidade.

Expanda Mais detalhes para ver os nomes dos certificados de identidade e as conexões que os usam. Para copiar os detalhes para a área de transferência, clique em ícone Copiar.

Se você tiver certificados de identidade, após o upgrade, precisará fazer upload de novos certificados de identidade conforme descrito em Garantir Conectividade:

Nome do Aplicativo Duplicado de Roteamento Básico

Equipe de desenvolvimento Sim Se sua instância contiver integrações básicas de roteamento que tenham os mesmos nomes de ponto final de origem e destino, execute as seguintes etapas:
  1. Edite sua integração básica de roteamento, exclua o ponto final de destino e adicione-o novamente com outro nome.
  2. Salve a integração.

Expanda Mais detalhes para ver as integrações que precisam de revisão. Para copiar os detalhes para a área de transferência, clique em ícone Copiar.

Vários Arquivos de Leitura

Equipe de desenvolvimento Sim A operação Ler Vários Arquivos foi descontinuada no Oracle Integration Generation 2.

Se você tiver integrações que incluam uma operação para ler vários arquivos, retrabalhe as integrações para que elas não usem esse padrão. Por exemplo, use uma operação listFile para listar os arquivos e use uma ação for-each para ler cada arquivo individualmente. Expanda Mais detalhes para ver as integrações que precisam de revisão. Para copiar os detalhes para a área de transferência, clique em ícone Copiar.

Publicar/Assinar Integrações

Equipe de desenvolvimento Sim

Se sua instância incluir integrações que publicam mensagens ou assinam mensagens do Oracle Integration, lembre-se de que as integrações de publicação/assinatura (ou pub/sub) precisam ser convertidas em orquestrações orientadas a eventos. As integrações serão tratadas de forma diferente, dependendo de sua configuração:

  • As integrações de publicação/sub que usam anexos não podem ser convertidas automaticamente no momento. Se quiser continuar com o upgrade, você poderá remover essas integrações ou ignorar falhas de pré-verificação. Após o upgrade, você poderá recriá-los, enviando o anexo para o servidor FTP ou o Object Storage em sua tenancy e informando a referência ao fluxo do assinante. Consulte Definir Filtragem de Assinatura Baseada em Cabeçalho em Usando Integrações no Oracle Integration 3.
  • Todas as outras integrações pub/sub ativas são convertidas automaticamente durante a atualização. As integrações Pub/sub em um estado preliminar não podem ser migradas e ficarão em branco após o upgrade.
  • Se você tiver mapeado dados no fluxo do assinante, os mapeamentos serão convertidos com a maior precisão possível. No entanto, após a atualização, você deve revisar os mapeamentos e corrigi-los, se necessário.
  • Se aparecer o erro Somente assinantes estão presentes, nenhum editor, você tem assinantes órfãos que devem ser excluídos antes do upgrade.

Expanda Mais detalhes para ver as integrações que não podem ser convertidas automaticamente. Para copiar os detalhes para a área de transferência, clique em ícone Copiar.

Nota: Talvez você queira aproveitar esta oportunidade para excluir qualquer fluxo de Publicação preliminar.

Ação Autenticação Básica da API DT para OAuth

Equipe de desenvolvimento Sim Se sua instância incluir integrações que acessam APIs incorporadas de DT (design-time) usando uma conexão REST com autenticação básica, você deverá alterá-las para usar OAuth.

No Oracle Integration Generation 2, você pode usar a Autenticação Básica para usar a API REST do Oracle Integration e a API REST do File Server. No Oracle Integration 3, você deve usar OAuth. Você precisa atualizar quaisquer clientes, scripts, integrações e comandos que usem a API REST do Oracle Integration ou a API REST do File Server para estabelecer conexão usando OAuth. Para obter mais informações sobre suporte ao método de autenticação, consulte Quando a Autenticação Básica é Suportada no Oracle Integration 3. Para obter detalhes sobre como usar o OAuth com a API REST do Oracle Integration, consulte Segurança, Autenticação e Autorização ou com a API REST do File Server, consulte Segurança, Autenticação e Autorização.

Pré-verificações de Adaptadores

Condição de elegibilidade Proprietário típico Aplicável à região do Governo Tarefas a Serem Concluídas

Adaptadores Personalizados

Equipe de desenvolvimento Não Se sua instância incluir integrações que usam um adaptador personalizado, o upgrade da instância ainda não poderá ser feito. Aguarde até que a Oracle inicie upgrades para esse recurso. Expanda Mais detalhes para ver os adaptadores personalizados que você está usando. Para copiar os detalhes para a área de transferência, clique em ícone Copiar.

Oracle Utilities Adapter

Equipe de desenvolvimento Sim O Swagger 2.0 não é mais suportado no Oracle Utilities Adapter. Se houver alguma integração existente usando o catálogo REST do Swagger 2.0, o runtime não será afetado. No entanto, se você tentar editar a conexão de design-time, testar novamente a conexão, atualizar os metadados, atualizar os artefatos ou reativar, a integração falhará. Atualize o catálogo para usar a definição OpenAPI 3.x. Expanda Mais detalhes para ver as integrações que precisam de revisão. Para copiar os detalhes para a área de transferência, clique em ícone Copiar. Consulte Usando o catálogo REST do Swagger 2.0 com o Oracle Utilities Adapter versão 24.04.0 ou posterior.

Adaptadores Não Suportados

Equipe de desenvolvimento Sim Se sua instância incluir uma integração que use um dos seguintes adaptadores, que não são suportados no Oracle Integration 3, substitua os adaptadores pelo adaptador REST:
  • Automation Anywhere Adapter
  • Evernote Adapter
  • Oracle Messaging Cloud Service Adapter
  • Oracle Monetization Cloud Adapter
  • Oracle Taleo Business Edition (TBE) Adapter
  • UiPath Robotic Process Automation Adapter

    Observação: Os recursos de automação de processos robóticos (RPA) estão disponíveis no Oracle Integration 3. Consulte Saiba Mais Sobre Robôs e Crie um Robô em Usando Robôs no Oracle Integration 3.

Expanda Mais detalhes para ver quais adaptadores não suportados você está usando. Para copiar os detalhes para a área de transferência, clique em ícone Copiar.

Tipos de REST Não Suportados

Equipe de desenvolvimento Sim Os tipos de conexão a seguir estão obsoletos e não são suportados em uma conexão do REST Adapter. Substitua esses tipos de conexão por outros tipos. Consulte Configurar Propriedades de Conexão para Chamar Conexões em Usando o REST Adapter com o Oracle Integration 3.
  • URL do Catálogo de Metadados
  • URL de Definição do Swagger
  • URL de Definição de RAML

Expanda Mais detalhes para ver quais tipos REST não suportados você está usando. Para copiar os detalhes para a área de transferência, clique em ícone Copiar.

Os desenvolvedores com uma API REST descrita usando RAML ou o catálogo de metadados Oracle devem executar a seguinte ação:
  1. Consulte seu provedor de serviços REST e solicite uma definição do Swagger (se disponível). O Oracle Fusion Applications deve ter uma opção do Swagger disponível. Esta é uma diretriz para todos os Oracle Fusion Applications.
  2. Se uma especificação alternativa não estiver disponível, use o modelo básico no Adaptador REST selecionando o URL Base da API REST como o URL de conexão e definindo a solicitação de API de destino usando o Assistente de Configuração de Ponto Final do Adaptador.

Outra opção é converter RAML em uma especificação OpenAPI para usar com a conexão do Adaptador REST.

Para fornecer suporte mais robusto e completo para as especificações Swagger/OpenAPI, o Adaptador REST inclui uma opção unificada para especificar todas as especificações OpenAPI em um único campo. Essa opção também substitui a opção de fornecer um URL de definição do Swagger, que não está mais disponível.

Pré-verificações do Visual Builder

Condição de elegibilidade Proprietário típico Aplicável à região do Governo Tarefas a Serem Concluídas

URL de Ponto Final Personalizado

Administrador Não Isso também foi abordado nas Pré-verificações de Instância, mas é repetido aqui, pois se aplica ao Visual Builder.

Se você tiver um ponto final personalizado e estiver usando o Visual Builder:

  1. Para continuar a atualização, conclua as Tarefas de Pré-Upgrade do Visual Builder.
  2. Durante o upgrade, o processo de upgrade configura seu ponto final personalizado e qualquer ponto final personalizado alternativo no Visual Builder.

VBCS

Administrador Não Se você usar o Visual Builder com sua própria instância de banco de dados Oracle (BYODB), o Autonomous Transaction Processing (ATP) deverá estar ativo e em execução durante o upgrade.

Certifique-se de concluir as tarefas adicionais descritas em Prepare Visual Builder for the Upgrade em Administering Oracle Visual Builder in Oracle Integration 3.

Pré-verificações do Serviço Process Automation

Condição de elegibilidade Proprietário típico Aplicável à região do Governo Tarefas a Serem Concluídas

Process Automation

Administrador Não

Há várias diferenças entre o Processo no Oracle Integration Generation 2 e o Process Automation no Oracle Integration 3. Consulte Perguntas Frequentes do Processo.

Dependendo de como você está usando o Processo no Oracle Integration Generation 2, você usará uma opção diferente para fazer upgrade ou migrar. ConsulteProcessar Opções de Upgrade.

Processar Ação

Administrador Não

Se você estiver usando a ação Processar em qualquer integração, será necessário substituir ou remover a ação Processar antes da atualização. Use o método descrito na Opção Processar upgrade que se aplica à sua situação.

Aplicativos do Processo Administrador Não

Se você tiver instâncias do Processo que não são usadas ativamente, verá essa pré-verificação de aviso.

Sua instância será atualizada sem a Automação de Processos. As transações de tempo de execução (concluídas ou em andamento) serão perdidas. Antes do upgrade, exporte qualquer aplicativo de Processo de design time que você queira reter do Oracle Integration Generation 2. Se você não quer mantê-los, você não precisa fazer nada. Expanda Mais detalhes para ver informações adicionais.

Se quiser manter a auditoria, consulte esta seção que descreve como você pode salvar dados de tempo de execução do Processo do Oracle Integration Generation 2.
Observação

Os dados de backup são mantidos por um período de seis meses após a atualização.

Durante o upgrade, o Processo não será ativado no Oracle Integration 3 e os aplicativos do Processo não serão migrados.

Após o upgrade, você não precisa fazer nada. Mas, se quiser usar Process, você poderá ativá-lo e reimportar seus aplicativos de design time.

Se você não exportou seus aplicativos Process em tempo de design antes do upgrade e se precisar deles após o upgrade, envie uma SR (solicitação de serviço) no My Oracle Support.

Para obter informações sobre como ativar o Processo, consulte Ativar o Process Automation com o Oracle Integration 3.

Corrigir uma Instância com Falhas nas Verificações de Prontidão

Se o upgrade tiver sido programado e sua instância não estiver mais pronta para upgrade, resolva as descobertas para que o upgrade seja concluído com sucesso.

  1. No Oracle Integration, abra a página Fazer Upgrade usando uma das seguintes etapas:
    • No painel de navegação, clique em Definições e, em seguida, em Fazer Upgrade.
    • Clique em Anúncios Ícone Anúncios e, em seguida, clique no link na notificação.
    A página Fazer Upgrade é exibida.

    A captura de tela mostra a página Atualizar com uma mensagem indicando que a verificação de prontidão falhou, seguida por uma lista de condições de elegibilidade e seu status. Há um botão Verificar novamente para executar novamente a verificação de prontidão.

  2. Revise as condições que não foram aprovadas e execute a ação apropriada. Consulte Verificar Problemas de Prontidão de Upgrade e Corrigir Pré-verificação para obter as etapas a serem seguidas.
  3. Depois de tratar todos os problemas, verifique a instância novamente.
    1. Clique em Verificar novamente.
      Demora cerca de uma hora para a verificação ser concluída. Você pode ver quando a última verificação foi concluída acima da tabela de verificação de prontidão.
    2. Continue fazendo correções até que a verificação seja aprovada.
      Se você não tiver certeza de como corrigir um problema, faça uma solicitação de serviço (SR) no My Oracle Support.