Concluir Tarefas de Pré-Upgrade

Resumo de Tarefas de Pré-upgrade

Esta tabela resume as tarefas de pré-upgrade de cada área. Os detalhes de cada tarefa são vinculados na tabela e mostrados nas próximas seções.

Área	Tarefas
Agente de Conectividade	Prepare-se para a conversão para OAuth 2.0 Atualize suas configurações de lista de permissões Definir a propriedade Cache do servidor proxy
Instâncias	Comece a capturar o fluxo de atividades na Console do Oracle Cloud Infrastructure Concluir a configuração das regras de rede
B2B para Oracle Integration	Certifique-se de que todas as senhas B2B do armazenamento de chaves correspondam
Integrações	Determinar o que fazer com instâncias com falha Decida o que fazer com mensagens assíncronas Altere as chamadas de API incorporadas do Oracle Integration da Autenticação Básica para OAuth
Adaptadores	Parar de usar adaptadores Microsoft desativados
Visual Builder	Preparar o Visual Builder para upgrade
Listas de permissões	Atualizar Listas de Permissões
Comunicação	Informar aos Usuários e Partes Interessadas sobre o Upgrade
Trabalho de desenvolvimento	Limitar o Trabalho de Desenvolvimento Antes do Upgrade

Tarefas de Pré-atualização do Agente de Conectividade

Tarefa Proprietário típico Descrição das tarefas

Tarefa	Proprietário típico	Descrição das tarefas
Prepare-se para a conversão para OAuth 2.0	Equipe de Operações de Desenvolvimento	No Oracle Integration Generation 2, o agente de conectividade usa autorização básica para chamar pontos finais do Oracle Integration. Em vez disso, o Oracle Integration 3 usa a autenticação baseada em token OAuth 2.0, que é mais segura. Durante o upgrade, suas conexões de agentes de conectividade são convertidas automaticamente do uso de autenticação básica para o uso do OAuth 2.0, para que você não precise recriar manualmente nenhuma conexão. No entanto, antes do upgrade, prepare-se para essa conversão, permitindo a saída da rede do agente para o design-time e o runtime do Oracle Integration e para o Oracle Identity Cloud Service ou o domínio de identidades, conforme descrito em Atualizar Listas de Permissões. E, após a atualização, como resultado do novo método de autenticação, você verá tráfego adicional no seu firewall. Esse tráfego adicional ocorre porque o agente de conectividade deve se comunicar com o servidor para obter novos tokens. Para obter mais informações sobre o suporte ao OAuth 2.0 no Oracle Integration 3, consulte Quando a Autenticação Básica é Suportada no Oracle Integration 3?.
Atualize suas configurações de lista de permissões	Equipe de Operações de Desenvolvimento	Se sua organização usar listas de permissões, você deverá atualizar suas definições de lista de permissões para seus agentes de conectividade. A coluna Status da lista de permissões na seção Status do Agente de Conectividade mostra 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 tarefas descritas em Atualizar Listas de Permissões. Os agentes que estão off-line durante o upgrade ou 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.
Definir a propriedade Cache do servidor proxy	Equipe de Operações de Desenvolvimento	Defina a propriedade Cache do servidor proxy para que os URLs do Oracle Integration sejam atualizados com a maior frequência possível. Por exemplo, se o servidor proxy usar a propriedade `Cache-ExpiresDefault`, defina-a como `now`.

Prepare-se para a conversão para OAuth 2.0

Equipe de Operações de Desenvolvimento

No Oracle Integration Generation 2, o agente de conectividade usa autorização básica para chamar pontos finais do Oracle Integration. Em vez disso, o Oracle Integration 3 usa a autenticação baseada em token OAuth 2.0, que é mais segura. Durante o upgrade, suas conexões de agentes de conectividade são convertidas automaticamente do uso de autenticação básica para o uso do OAuth 2.0, para que você não precise recriar manualmente nenhuma conexão.

No entanto, antes do upgrade, prepare-se para essa conversão, permitindo a saída da rede do agente para o design-time e o runtime do Oracle Integration e para o Oracle Identity Cloud Service ou o domínio de identidades, conforme descrito em Atualizar Listas de Permissões.

E, após a atualização, como resultado do novo método de autenticação, você verá tráfego adicional no seu firewall. Esse tráfego adicional ocorre porque o agente de conectividade deve se comunicar com o servidor para obter novos tokens.

Para obter mais informações sobre o suporte ao OAuth 2.0 no Oracle Integration 3, consulte Quando a Autenticação Básica é Suportada no Oracle Integration 3?.

Atualize suas configurações de lista de permissões

Equipe de Operações de Desenvolvimento

Se sua organização usar listas de permissões, você deverá atualizar suas definições de lista de permissões para seus agentes de conectividade. A coluna Status da lista de permissões na seção Status do Agente de Conectividade mostra 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 tarefas descritas em Atualizar Listas de Permissões.

Os agentes que estão off-line durante o upgrade ou 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.

Definir a propriedade Cache do servidor proxy

Equipe de Operações de Desenvolvimento

Defina a propriedade Cache do servidor proxy para que os URLs do Oracle Integration sejam atualizados com a maior frequência possível.

Por exemplo, se o servidor proxy usar a propriedade Cache-ExpiresDefault, defina-a como now.

Tarefas de Pré-upgrade da Instância

Tarefa	Proprietário típico	Descrição das tarefas
Comece a capturar o fluxo de atividades na Console do Oracle Cloud Infrastructure	Administrador	Se você ainda não tiver feito isso, inicie a captura do fluxo de atividades na Console do Oracle Cloud Infrastructure. Este é o motivo: O fluxo de atividades não é migrado. Mas se você capturar esses dados na Console do Oracle Cloud Infrastructure, ainda terá acesso a dados históricos. Consulte Capturar o Fluxo de Atividades na Console do Oracle Cloud Infrastructure.
Concluir a configuração das regras de rede	Administrador de rede	Esta tarefa pode ser concluída antes do upgrade ou imediatamente após o upgrade. Se alguma de suas conexões de integração tiver como destino um serviço do Oracle Cloud Infrastructure que suporte regras de rede, como o Oracle Cloud Infrastructure Object Storage ou o Oracle Autonomous Database, e você tiver ativado essas regras, deverá concluir qualquer configuração de regras de rede, incluindo a adição da VCN de Serviço do Oracle Integration à regra. Consulte Garantir Conectividade.

Tarefa

Proprietário típico

Descrição das tarefas

Comece a capturar o fluxo de atividades na Console do Oracle Cloud Infrastructure

Administrador

Se você ainda não tiver feito isso, inicie a captura do fluxo de atividades na Console do Oracle Cloud Infrastructure.

Este é o motivo: O fluxo de atividades não é migrado. Mas se você capturar esses dados na Console do Oracle Cloud Infrastructure, ainda terá acesso a dados históricos. Consulte Capturar o Fluxo de Atividades na Console do Oracle Cloud Infrastructure.

Concluir a configuração das regras de rede

Administrador de rede

Esta tarefa pode ser concluída antes do upgrade ou imediatamente após o upgrade.

Se alguma de suas conexões de integração tiver como destino um serviço do Oracle Cloud Infrastructure que suporte regras de rede, como o Oracle Cloud Infrastructure Object Storage ou o Oracle Autonomous Database, e você tiver ativado essas regras, deverá concluir qualquer configuração de regras de rede, incluindo a adição da VCN de Serviço do Oracle Integration à regra.

Consulte Garantir Conectividade.

B2B para Tarefas de Pré-Upgrade do Oracle Integration

Tarefa	Proprietário típico	Descrição das tarefas
Certifique-se de que todas as senhas B2B do armazenamento de chaves correspondam	Administrador	Certifique-se de que todas as senhas do arquivo de armazenamento de chaves sejam idênticas. Seu arquivo de certificado de identidade (JKS) requer dois conjuntos de senhas: Senhas de Chave e Senha de Armazenamento de Chaves. Todas as senhas devem ser idênticas. Se não forem idênticas, edite as senhas correspondentes e carregue novamente o arquivo da área de armazenamento de chaves. Se você não tiver o arquivo de armazenamento de chaves que foi carregado pela última vez, recrie o arquivo. Ao fazer upload do certificado: Para Tipo, selecione X.509 (Transporte SSL). Para Categoria, selecione Identidade. Consulte Fazer Upload de um Certificado SSL em Usando Integrações no Oracle Integration Generation 2. Cuidado: Se você não concluir esta etapa, o upgrade falhará.

Tarefa

Proprietário típico

Descrição das tarefas

Certifique-se de que todas as senhas B2B do armazenamento de chaves correspondam

Administrador

Certifique-se de que todas as senhas do arquivo de armazenamento de chaves sejam idênticas. Seu arquivo de certificado de identidade (JKS) requer dois conjuntos de senhas: Senhas de Chave e Senha de Armazenamento de Chaves. Todas as senhas devem ser idênticas. Se não forem idênticas, edite as senhas correspondentes e carregue novamente o arquivo da área de armazenamento de chaves.

Se você não tiver o arquivo de armazenamento de chaves que foi carregado pela última vez, recrie o arquivo.

Ao fazer upload do certificado:

Para Tipo, selecione X.509 (Transporte SSL).
Para Categoria, selecione Identidade.

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

Cuidado:

Se você não concluir esta etapa, o upgrade falhará.

Tarefas de Pré-upgrade de Integrações

Tarefa	Proprietário típico	Descrição das tarefas
Determinar o que fazer com instâncias com falha	Equipe de Operações de Desenvolvimento	As instâncias de integração com falha se enquadram em uma das seguintes categorias, o que determina como você pode lidar com elas: Instâncias assíncronas com falha - recuperáveis Submeta novamente as instâncias com falha e limpe a fila. Consulte Ressubmeter Mensagens com Falha. Se houver uma instância assíncrona com falha quando a sua instância for submetida a upgrade, você não poderá submeter novamente a instância com falha no Oracle Integration 3 — pelo menos imediatamente. Não é possível ressubmeter porque os dados de runtime, incluindo erros e todos os dados do fluxo de atividades, não foram migrados para o Oracle Integration 3 como parte do upgrade. No entanto, após a conclusão do upgrade, você pode executar a integração no Oracle Integration 3, coletar dados de erro e, em seguida, submeter novamente. Instâncias síncronas com falha - não-recuperáveis Não é possível ressubmeter instâncias de integração síncronas; por isso, elas não são recuperáveis. Observação Se você capturar dados de fluxo de atividades na Console do Oracle Cloud Infrastructure, ainda poderá exibir a atividade histórica da integração. Consulte Capturar o Fluxo de Atividades de Integrações na Console do Oracle Cloud Infrastructure.
Decida o que fazer com mensagens assíncronas	Equipe de Operações de Desenvolvimento	Decida o que fazer com mensagens assíncronas do lado do cliente durante o tempo de inatividade. Este é o motivo: Durante o período de indisponibilidade, o Oracle Integration rejeita todas as solicitações de entrada. Para se preparar, você tem as seguintes opções: Antes do início do upgrade, suspenda todas as mensagens assíncronas no cliente. Com essa abordagem, o cliente não envia as mensagens e o Oracle Integration não as rejeita. Se você escolher essa opção, certifique-se de saber o horário de início e fim do upgrade. Depois que o upgrade terminar, determine as próximas etapas apropriadas para as mensagens rejeitadas.
Altere as chamadas de API incorporadas do Oracle Integration da Autenticação Básica para OAuth	Desenvolvedor	Se você ainda não atualizou suas chamadas de API para usar OAuth ao concluir os pré-requisitos, faça isso agora ou imediatamente após o upgrade. 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.

Tarefa

Proprietário típico

Descrição das tarefas

Determinar o que fazer com instâncias com falha

Equipe de Operações de Desenvolvimento

As instâncias de integração com falha se enquadram em uma das seguintes categorias, o que determina como você pode lidar com elas:

Instâncias assíncronas com falha - recuperáveis
Submeta novamente as instâncias com falha e limpe a fila. Consulte Ressubmeter Mensagens com Falha.

Se houver uma instância assíncrona com falha quando a sua instância for submetida a upgrade, você não poderá submeter novamente a instância com falha no Oracle Integration 3 — pelo menos imediatamente. Não é possível ressubmeter porque os dados de runtime, incluindo erros e todos os dados do fluxo de atividades, não foram migrados para o Oracle Integration 3 como parte do upgrade. No entanto, após a conclusão do upgrade, você pode executar a integração no Oracle Integration 3, coletar dados de erro e, em seguida, submeter novamente.
Instâncias síncronas com falha - não-recuperáveis
Não é possível ressubmeter instâncias de integração síncronas; por isso, elas não são recuperáveis.

Observação

Se você capturar dados de fluxo de atividades na Console do Oracle Cloud Infrastructure, ainda poderá exibir a atividade histórica da integração. Consulte Capturar o Fluxo de Atividades de Integrações na Console do Oracle Cloud Infrastructure.

Decida o que fazer com mensagens assíncronas

Equipe de Operações de Desenvolvimento

Decida o que fazer com mensagens assíncronas do lado do cliente durante o tempo de inatividade.

Este é o motivo: Durante o período de indisponibilidade, o Oracle Integration rejeita todas as solicitações de entrada. Para se preparar, você tem as seguintes opções:

Antes do início do upgrade, suspenda todas as mensagens assíncronas no cliente.
Com essa abordagem, o cliente não envia as mensagens e o Oracle Integration não as rejeita.

Se você escolher essa opção, certifique-se de saber o horário de início e fim do upgrade.
Depois que o upgrade terminar, determine as próximas etapas apropriadas para as mensagens rejeitadas.

Altere as chamadas de API incorporadas do Oracle Integration da Autenticação Básica para OAuth

Desenvolvedor

Se você ainda não atualizou suas chamadas de API para usar OAuth ao concluir os pré-requisitos, faça isso agora ou imediatamente após o upgrade.

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.

Tarefas de Pré-upgrade de Adaptadores

Tarefa	Proprietário típico	Descrição das tarefas
Parar de usar adaptadores Microsoft desativados	Equipe de desenvolvimento	A Microsoft desativou as APIs REST do Microsoft Outlook em novembro de 2022. Se você usar qualquer um dos adaptadores a seguir, deverá usar as APIs REST do Microsoft Graph. Microsoft Office 365 Calendar Adapter Consulte a Página Chamar Operações em Usando o Microsoft Microsoft Office 365 Calendar Adapter com o Oracle Integration 3. Microsoft Office 365 People Adapter Consulte a Página Chamar Operações em Usando o Microsoft Microsoft Office 365 People Adapter com o Oracle Integration 3. Microsoft Office 365 Outlook Adapter Consulte a Página Chamar Operações em Usando o Microsoft Office 365 Outlook Adapter com o Oracle Integration 3.

Tarefas de Pré-atualização do Visual Builder

Tarefa	Proprietário típico	Descrição das tarefas
Preparar o Visual Builder com ponto final personalizado usando SSL para upgrade	Administrador	Se o Visual Builder estiver ativado, você usará um ponto final personalizado ou pontos finais personalizados alternativos e estará usando SSL, execute as seguintes etapas: Para permitir o acesso ao segredo do certificado SSL para upgrade, adicione as seguintes políticas, substituindo MySecretCompartment pelo compartimento que inclui os segredos do certificado SSL: `allow service vb-vbprod to manage secrets in compartment MySecretCompartment allow service vb-vbprod to manage keys in compartment MySecretCompartment allow service vb-vbprod to manage vaults in compartment MySecretCompartment allow service vb-vbprod to read secret-bundle in compartment MySecretCompartment` Atualize suas definições de tenant e aplicativo do Visual Builder e quaisquer aplicativos de integração, para que eles apontem para o URL original do Oracle Integration Generation 2 em vez do ponto final personalizado. Durante o upgrade, o ponto final personalizado será configurado no Visual Builder; portanto, após o upgrade, somente os aplicativos do Visual Builder estarão acessíveis por meio do ponto final personalizado.
Preparar o Visual Builder para atualização	Equipe de Operações de Desenvolvimento	Conclua as tarefas descritas em Preparar o Visual Builder para o Upgrade em Administrando o Oracle Visual Builder no Oracle Integration 3.
Verificar problemas conhecidos	Equipe de Operações de Desenvolvimento	Analise Problemas Conhecidos para Aplicativos Ativos/Temporários Após o Upgrade para o Oracle Integration 3 em Problemas Conhecidos para o Oracle Integration 3 para saber quais problemas podem resultar em aplicativos ativos ou preparados não funcionarem corretamente após o upgrade para o Oracle Integration 3.

Documentação do Oracle Cloud Infrastructure