Garantir o acesso à instância

Imediatamente após o upgrade

1. Verifique a nova instância do Oracle Integration 3
2. Atualizar a política do IAM com o novo OCID
3. Obtenha o URL da nova instância e compartilhe-o

Garanta a conectividade

Imediatamente após o upgrade

1. Concluir a configuração das regras de rede
2. Fazer upload de novos certificados de identidade para conexões
3. Recupere a conectividade com agentes que não foram atualizados
4. Servidor de Arquivos: adicione o endereço IP do Servidor de Arquivos à sua lista de permissões interna de firewall

   Conclua esta tarefa dentro de uma semana após a atualização.

5. Servidor de Arquivos: atualize integrações e clientes SFTP para usar os novos valores de IP e porta

   Conclua esta tarefa dentro de uma semana após a atualização.

Garanta o trabalho de integrações

Imediatamente após o upgrade

1. Altere as chamadas de API incorporadas do Oracle Integration da Autenticação Básica para OAuth
2. Verifique as integrações se você selecionou Ignorar falhas de ativação ou Ignorar falhas de início da programação
3. Cuide de todas as solicitações que foram rejeitadas durante o tempo de inatividade do upgrade

Concluir tarefas pós-upgrade para falhas de pré-verificação ignoradas

Imediatamente após o upgrade

Conclua as tarefas de pós-atualização do Visual Builder

Imediatamente após o upgrade

Concluir tarefas pós-upgrade do Process Automation.

Imediatamente após o upgrade

Concluir verificação após o upgrade

Dentro de duas semanas de atualização

Verifique a nova instância do Oracle Integration 3

O upgrade será concluído se a interface for semelhante a esta:

Atualizar a política do IAM com o novo OCID

Administrador de políticas do serviço IAM

1. Acesse a Console do Oracle Cloud Infrastructure.
2. Obtenha o novo valor do OCID da instância do Oracle Integration 3. Consulte Exibindo Detalhes da Instância.
3. Atualize o OCID na sua política do serviço IAM. Para obter instruções sobre como atualizar as instruções em uma política existente, consulte Usando a Console na documentação do Oracle Cloud Infrastructure.

Obtenha o URL da nova instância e compartilhe-o

https://design.integration.region.ocp.oraclecloud.com/?integrationInstance=query_parameter_repersenting_instance

Para obter o novo URL:

1. Acesse a Console do Oracle Cloud Infrastructure.
2. Abra o menu de navegação e clique em Serviços ao Desenvolvedor.
3. Em Integração de Aplicativo, clique em Integração.
4. Clique no nome da nova instância do Oracle Integration 3.
5. À direita do campo URL da console de serviço, clique em Copiar.
6. Compartilhe o URL com quem precisar.

Conclua a configuração das regras de rede

1. Acesse a Console do Oracle Cloud Infrastructure.
2. Obtenha o valor do OCID da instância do Oracle Integration 3.

   Consulte Exibindo Detalhes da Instância.

3. Siga as regras do seu serviço de destino. Por exemplo, para o Oracle Autonomous Database Serverless, consulte Configurar Listas de Controle de Acesso ao Provisionar ou Clonar uma Instância em Usando o Oracle Autonomous Database Serverless.
4. Se o serviço do Oracle Cloud Infrastructure que você está acessando estiver em uma região diferente da instância do Oracle Integration, inclua na lista de permissões o endereço de IP de Saída do OIC coletado quando você atualizou suas outras listas de permissão antes do upgrade.

Fazer upload de novos certificados de identidade para conexões

Apenas uma pessoa da sua organização precisa executar estas etapas

Se sua instância incluir conexões que usam certificados de identidade, os certificados de identidade teriam sido removidos durante o upgrade; portanto, você precisará gerar novos certificados de identidade e configurar novos JKS.

Execute as seguintes etapas para fazer upload de um novo certificado de identidade, testar as conexões que usam o certificado de identidade e ativar todas as integrações que usam as conexões:

1. Carregue um novo certificado de identidade.

   Consulte Fazer Upload de um Certificado SSL em Usando Integrações no Oracle Integration 3.

2. Teste as conexões que usam o certificado de identidade para que seu status mude de Preliminar para Configurado.

   Consulte Testar a Conexão em Usando Integrações no Oracle Integration 3.

3. Ative todas as integrações que usam as conexões.

   Consulte Ativar uma Integração em Usando Integrações no Oracle Integration 3.

Recupere a conectividade com agentes que não foram atualizados

Pré-requisitos

Garanta a conectividade de seus agentes de conectividade com o Oracle Cloud Infrastructure Identity and Access Management (IAM) e o Oracle Integration 3:

• Você deve ter adicionado os endereços IP do IAM e do Oracle Integration 3 às suas listas de permissões antes do upgrade, conforme descrito em Atualizar Listas de Permissões.
• Adicione o endereço IP em tempo de design do Oracle Integration 3 às suas listas de permissões. Use o seguinte comando para obter o endereço IP em tempo de design, substituindo region pela região pelo URL do Oracle Integration 3:

  nslookup design.integration.region.ocp.oraclecloud.com

Para atualizar manualmente seus agentes e recuperar a conectividade com eles:

1. Interromper o agente de conectividade.
2. Certifique-se de que os pré-requisitos do agente estejam concluídos:
   1. Certifique-se de que o agente de conectividade esteja usando o JDK 17. Caso contrário, defina as variáveis de ambiente JAVA_HOME e PATH como JDK17.
   2. Certifique-se de que o agente esteja usando o PKCS12 KeyStore. Caso contrário, converta-o usando as etapas a seguir.
      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. Exclua o arquivo keystore.jks no seguinte local:

         Agent_Install_Location/agenthome/agent/cert

3. Faça download do arquivo ZIP do instalador do agente no Oracle Integration 3.
   1. No painel de navegação, clique em Design e, em seguida, em Agentes.
   2. Clique em Fazer Download e, em seguida, em Agente de conectividade.
4. Extraia oic_conn_agent_installer.zip para um novo diretório no servidor do agente de conectividade.
5. Exclua a pasta lib do agente de conectividade existente em Agent_Install_Location/agenthome/ e substitua-a pela pasta lib do arquivo ZIP.
6. Exclua o arquivo version existente em Agent_Install_Location/agenthome/ e substitua-o pelo arquivo version do arquivo ZIP.
7. Exclua o arquivo connectivityagent.jar existente em Agent_Install_Location e substitua-o pelo arquivo connectivityagent.jar do arquivo ZIP.
8. Exclua o arquivo cpi_upgradeutility.jar existente em Agent_Install_Location e substitua-o pelo arquivo cpi_upgradeutility.jar do arquivo ZIP.
9. No Oracle Integration 3, na página Agentes, passe o mouse sobre o grupo de agentes, clique em Ações e selecione Fazer download da configuração.

   Esta etapa faz download de um arquivo InstallerProfile.cfg pré-configurado para o grupo de agentes.

10. Exclua o arquivo InstallerProfile.cfg existente em Agent_Install_Location e substitua-o pelo arquivo InstallerProfile.cfg que você baixou na etapa anterior.
11. Reinicie o agente de conectividade executando o seguinte comando:

    java -jar connectivityagent.jar

12. Reative as integrações que estão no grupo de agentes submetidos a upgrade.

File Server: adicione o endereço IP do File Server à sua lista de permissões interna de firewall

O endereço IP do Oracle Integration Generation 2 continua funcionando por quatro meses após o upgrade; em seguida, a Oracle os torna obsoletos. No entanto, a Oracle recomenda atualizar sua lista de permissões de firewall para usar o novo endereço IP agora. Dessa forma, você não corre o risco de esquecer de atualizar a lista de permissões no futuro.

Para obter o endereço IP do File Server:

1. Acesse o Oracle Integration 3.
2. No painel de navegação, clique em Definições, em File Server e em Definições.
3. Em Geral, obtenha o endereço IP do servidor SFTP do File Server.

File Server: atualize integrações e clientes SFTP para usar os novos valores de IP e porta

Os valores de IP e porta do Oracle Integration Generation 2 continuam funcionando por quatro meses após o upgrade; em seguida, a Oracle os torna obsoletos. No entanto, a Oracle recomenda atualizar suas integrações e clientes SFTP para usar os novos valores agora. Dessa forma, você não corre o risco de esquecer de atualizar esses valores no futuro.

1. Acesse o Oracle Integration 3.
2. No painel de navegação, clique em Definições, em File Server e em Definições.
3. Em Geral, obtenha os valores de IP e porta do servidor SFTP do File Server.
4. Atualize todas as integrações que chamam o File Server para que usem os novos valores de IP e porta.
5. Atualize todos os clientes SFTP de modo que eles usem os novos valores de IP e porta.

Altere as chamadas de API incorporadas do Oracle Integration da Autenticação Básica para 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.

Verifique as integrações se você selecionou Ignorar falhas de ativação ou Ignorar falhas de início da programação

• Se você selecionou Ignorar falhas de ativação, verifique o status de todas as integrações e ative as integrações conforme necessário.
• Se você selecionou Ignorar falhas de programação inicial, verifique as programações de suas integrações e inicie-as manualmente, se necessário.

Cuide de todas as solicitações que foram rejeitadas durante o tempo de inatividade do upgrade

O Oracle Integration rejeitou todas as solicitações enviadas durante o período de indisponibilidade do upgrade. Se necessário, tome medidas sobre solicitações que qualquer cliente tiver enviado para o Oracle Integration durante o período de indisponibilidade.

Alterar nome da instância do serviço

Após o upgrade do Oracle Integration Generation 2 para o Oracle Integration 3, o nome da tenancy é anexado ao final do nome da instância de serviço (nome para exibição da instância de serviço) no seguinte formato: <service instance name>-<tenancy name>. Por exemplo, se o nome da instância de serviço for myinstance e o nome da tenancy for mytenancy, ele será alterado para myinstance-mytenancy após o upgrade para o Oracle Integration 3. Portanto, se suas integrações usarem o nome da instância de serviço, atualize as integrações para que elas usem o novo nome da instância de serviço; caso contrário, elas falharão.

• Adaptador de Serviço do Oracle CX Sales and B2B
• Oracle ERP Cloud Adapter
• Oracle HCM Cloud Adapter
• Oracle Field Service Cloud Adapter
• Salesforce Adapter
• ServiceNow Adapter

Integrações básicas de roteamento: As integrações básicas de roteamento não são suportadas no Oracle Integration 3 e mostrarão uma tela em branco. Você deve excluir essas integrações e recriá-las como integrações orientadas por aplicativos.

• 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

Você deve criar conexões do Adaptador REST para substituir as conexões do adaptador não suportadas excluídas.

Você deve retrabalhar essas integrações usando as seguintes etapas:

1. Exclua a chamada correspondente à conexão do adaptador não suportada e substitua-a pela nova conexão do Adaptador REST.
2. Depois que a integração for configurada e ativada, inicie a programação.

Crie novas conexões usando adaptadores equivalentes do Oracle Integration 3 para substituir as conexões de adaptador personalizado excluídas.

Você deve retrabalhar essas integrações usando as seguintes etapas:

1. Exclua a chamada correspondente à conexão do adaptador personalizado e substitua-a pela nova conexão criada.
2. Depois que a integração for configurada e ativada, inicie a programação.

Você deve retrabalhar essas 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.

• URL do Catálogo de Metadados
• URL de Definição do Swagger
• URL de Definição de RAML

Você deve atualizar essas conexões usando um dos seguintes métodos:

• Se você estiver usando RAML ou o catálogo de metadados Oracle, poderá solicitar ao provedor de serviços REST uma definição do Swagger (se disponível). O Oracle Fusion Applications deve ter uma opção Swagger disponível, pois essa é uma diretriz para todos os Oracle Fusion Applications.

  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 da API de destino usando o Assistente de Configuração do Ponto Final do Adaptador.

• Outra opção, se você estiver usando RAML, é converter RAML em uma especificação OpenAPI.
• Se você estiver usando o URL de definição do Swagger, poderá usar a nova opção unificada do Adaptador REST para especificar todas as especificações OpenAPI em um único campo. Esta opção fornece suporte mais robusto e completo para as especificações Swagger/OpenAPI.

Consulte Configurar Propriedades de Conexão para Chamar Conexões em Usando o REST Adapter com o Oracle Integration 3.

Você deve retrabalhar essas integrações usando as seguintes etapas:

1. Ativar a integração
2. Depois que a integração for ativada, inicie a programação.

Você deve recriar seu ponto final personalizado.

Se você estiver usando o Visual Builder e tiver um ponto final personalizado ou pontos finais personalizados alternativos, atualize o CNAME do registro de DNS do ponto final personalizado com o nome do host da instância do Visual Builder.

Observação: Você não pode usar o mesmo ponto final personalizado para o Visual Builder e o Oracle Integration após o upgrade. Se você usar o mesmo ponto final personalizado, poderá encontrar problemas.

Concluir tarefas adicionais pós-upgrade

Atualizações completas necessárias para alteração do ID da instância de integração para alfanumérico

Essa alteração afeta os fluxos de integração que se baseiam no ID da instância de integração ser um inteiro (por exemplo, quando o ID da instância de integração é analisado em uma coluna de banco de dados com um tipo de dados numérico). Após o upgrade, se você executar essas integrações inalteradas, sem selecionar Ativar flowid como pós-upgrade numérico nas definições de upgrade, você receberá um erro de exceção de conversão.

Conversion Exception Description: The object […], of class [class java.lang.String], could not be converted to [class java.math.BigDecimal].

Para acomodar a alteração, você pode atualizar o mapeamento em cada integração afetada ou atualizar o tipo de dados da coluna que armazena os IDs de instância de integração em seu banco de dados.

Observação: Os métodos sugeridos aqui se baseiam nos serviços de banco de dados Oracle (como o Oracle Autonomous Database). Etapas adicionais podem ser necessárias para outros tipos de banco de dados.

Método 1: Atualizar o mapeamento em cada integração afetada

Em cada integração afetada, mapeie o atributo de destino que contém o valor do ID da instância de integração para um novo valor numérico, tempo UNIX. O tempo UNIX é o número de segundos decorridos desde a Época UNIX, começando com 1º de janeiro de 1970 às 00:00:00 UTC. Este valor aumenta a cada segundo. O valor pode ser analisado como um inteiro e, portanto, não requer alterações no banco de dados.

Antes do upgrade, você deve ter anotado quais integrações são afetadas, conforme descrito na pré-verificação Ação do ID da Instância.

Execute as etapas a seguir para cada integração afetada:

1. Não é possível editar uma integração ativa, portanto, se a integração estiver ativa, desative-a.
2. Abra a integração.
3. Clique duas vezes no mapa que inclui o ID da instância de integração.
4. Localize o atributo de destino que contém o valor do ID da instância de integração e clique nele.
5. No Criador de Expressões, clique em .
6. Digite a seguinte expressão:

   floor (((fn:current-dateTime() - xsd:dateTime ("1970-01-01T00:00:00" )) div xsd:dayTimeDuration ("PT1S" )) ) 

7. Clique em para salvar a expressão.
8. Volte para a tela de integração e salve suas alterações.

Método 2: Atualizar o tipo de dados da coluna afetada no banco de dados

No seu banco de dados, altere o tipo de dados da coluna que contém o ID da instância de integração para string (CHAR/VARCHAR). Essa abordagem não envolve nenhuma alteração em suas integrações.

Observação: A solução se limita às ações do banco de dados criadas usando a operação Executar uma Instrução SQL.

Como a coluna do banco de dados já está preenchida, não é possível apenas alterar o tipo de dados da coluna. Ao invés disso, você deve realizar as seguintes etapas. Execute as etapas a seguir no SQL Developer.

1. Anote o nome da coluna ID da instância.
2. Adicione uma coluna temporária (por exemplo, TEMP) do tipo VARCHAR.

   Sintaxe SQL:

   ALTER TABLE table-name ADD temporary-column VARCHAR2(50);

   Exemplo:

   ALTER TABLE FLOW_MANAGEMENT ADD TEMP VARCHAR2(50);

3. Copie os valores da coluna de origem (a que contém IDs de Instância) para a coluna temporária.

   Sintaxe SQL:

   UPDATE table-name SET temporary-column-name = source-column-name

   Exemplo:

   UPDATE FLOW_MANAGEMENT SET TEMP = FLOWID;

4. Defina os valores da coluna de origem como NULL.

   Sintaxe SQL:

   UPDATE table-name SET source-column-name = NULL;

   Exemplo:

   UPDATE FLOW_MANAGEMENT SET FLOWID = NULL;

5. Atualize o tipo de coluna de origem de NUMBER para VARCHAR.

   Sintaxe SQL:

   ALTER TABLE table-name MODIFY source-column-name VARCHAR2(50);

   Exemplo:

   ALTER TABLE FLOW_MANAGEMENT MODIFY FLOWID VARCHAR2(50);

6. Copie os valores de ID da Instância da coluna temporária de volta para a coluna de origem.

   Sintaxe SQL:

   UPDATE TABLE table-name SET source-column-name = temporary-column-name

   Exemplo:

   UPDATE FLOW_MANAGEMENT SET FLOWID = TEMP;

7. Remova a coluna temporária.

   Sintaxe SQL:

   ALTER TABLE table-name DROP COLUMN temporary-column-name;

   Exemplo:

   ALTER TABLE FLOW_MANAGEMENT DROP COLUMN TEMP;

1. Acesse o Oracle Integration como um administrador.
2. Clique em Definições e, em seguida, em Diversos.
3. Altere o tipo de ID do fluxo para Alfanumérico e clique em Salvar.

Conclua as tarefas de verificação pós-atualização da sua organização

Conclua as tarefas de verificação pós-upgrade da sua organização, como executar testes de regressão.

Execute testes de carga de integração em uma instância de desenvolvimento/estágio antes de mover integrações para uma instância de produção.