Fazer Upgrade para o Oracle Integration 3: Fase 1
Saiba mais sobre as etapas na fase 1 do upgrade em fases. Conclua estas etapas para fazer upgrade de integrações e aplicativos Visual Builder para o Oracle Integration 3.
Pré-requisitos
Certifique-se de concluir os pré-requisitos antes do upgrade da sua instância para evitar qualquer interrupção.
Oracle Integration Generation 2
- Um novo nome de host será criado para sua instância do Oracle Integration Generation 2. Você precisará usar esse novo nome de host para todo o acesso baseado em browser à instância Processar no Oracle Integration Generation 2 daqui para frente.
- O novo nome do host será exibido em Mais detalhes na seção de pré-verificações do Process Automation na página Upgrade.
Visual Builder
Se você tiver aplicativos do Visual Builder que chamam o Processo, conclua as etapas a seguir para atualizar os aplicativos do Visual Builder.- Na console do Visual Builder, navegue até Settings, Services, Backends, Process Applications e, em seguida, Servers.
- Para o servidor do Processo do Oracle Integration Generation 2, clique em Editar.
- No campo URL da Instância, atualize o nome do host para o nome do host fornecido na etapa acima.
- No campo Autenticação, altere o valor de Conta do Oracle Cloud para OAuth 2.0 - Asserção do Usuário. Atualize o campo Escopo para usar o escopo do ponto final REST do Oracle Integration com o URL do Público principal. Você pode obter o escopo do aplicativo de confidencialidade OAuth da instância do Oracle Integration da sua tenancy. O escopo será definido nesse aplicativo de confidencialidade. Consulte Configurar Autenticação do OAuth 2.0 Usando Credenciais do Cliente para obter informações sobre como criar o aplicativo de confidencialidade OAuth no Oracle Integration Generation 2. Exemplo de um URL do Público principal:
https://E213D785B536427D9E7E0BE1C5D85300.integration.ocp.oraclecloud.com:443. - Para cada um dos aplicativos Visual Builder criados, execute as seguintes etapas:
Observação
Você precisará executar as etapas a para c somente se o Visual Builder for usado para processar as tarefas usando a IU externa. Para obter informações sobre a conexão de IU externa, consulte Criar uma Conexão de IU Externa.- Abra as definições de segurança do aplicativo Visual Builder.
- Defina o campo Incorporação como Permitir incorporação em domínios especificados.
- No campo URL do Domínio, adicione o novo URL do Processo do Oracle Integration Generation 2.
- Se um aplicativo Web do Visual Builder tiver alguma referência à página de componentes do Processo, por exemplo,
VB_SERVER + "/ic/pub/components/pages/applist.html", você poderá criar uma nova variável de sistema para PCS, pois o Oracle Integration Generation 2 PCS agora terá um novo URL. - Reimplante os aplicativos Visual Builder.
- Abra o aplicativo Processar e vá para Formulários.
- Abra o formulário de IU externo e use o URL do aplicativo Visual Builder preparado ou ativo, por exemplo,
https://oicvb-vb-axkbv4jfb37h.builder.toronto-1.ocp.oraclecloud.com/ic/builder/rt/ExternalUI_1_0/1.0/webApps/webapp/. - Publique e ative o aplicativo.
- No espaço de trabalho, abra a tarefa usando o formulário da IU externa. A página Visual Builder agora está disponível.
- Depois de atualizar os aplicativos Visual Builder usando as etapas acima, verifique se as chamadas do Visual Builder para Process estão funcionando corretamente.
- A conclusão das etapas de pré-atualização para atualizar os aplicativos Visual Builder garantirá o seguinte:
- Verificação da conectividade do Visual Builder com o Process antes do upgrade real, evitando o tempo de inatividade após o upgrade.
- Depois de atualizar o Visual Builder para usar o novo nome de host e a nova política de autorização, você não precisará revertê-lo.
- Se a atualização do Visual Builder não for bem-sucedida: Reverta as alterações de configuração e envie uma SR (solicitação de serviço) no My Oracle Support para evitar uma interrupção prolongada.
- Se você não executar nenhuma ação antes do upgrade: Você precisará executar as etapas para atualizar os aplicativos Visual Builder após o upgrade, o que resultará em período de indisponibilidade. É altamente recomendável concluir essas etapas antes da atualização.
As chamadas do PCS para objetos do Visual Builder precisam usar conexões REST configuradas apenas com a política de segurança de Autenticação Básica.
Outros Aplicativos Front-End
Se você estiver usando outros aplicativos front-end com APIs de Processo, deverá atualizá-los para usar o novo nome de host. Se você não atualizar o nome do host, poderá encontrar erros de redirecionamento HTTP.
Oracle Content Management
Se você estiver usando o Process integrado ao Oracle Content Management (OCM), precisará atualizar o nome do host do Process Automation nas configurações de integração do OCM. Com a alteração abaixo, a integração entre o OCM e o Processo funcionará até que o OCM atinja o fim da vida útil.
- Se o Processo for usado apenas para suportar o OCM: Entre em contato com a equipe da sua conta para reprogramar o upgrade até que você tenha saído do OCM (deve ser feito até dezembro de 2025).
- Caso contrário: Sua instância será submetida a upgrade usando a atualização em fases do Process. A integração entre o OCM e o Processo funcionará até que o OCM atinja o fim da vida útil.
Processar
- Recomenda-se pausar ou limitar o novo trabalho de desenvolvimento até depois do upgrade.
- Para que o registro de serviço funcione conforme o esperado, certifique-se de que seu trigger REST utilize a política de segurança OAuth 2.0 e Autenticação Básica.
- Se você tiver integrações chamadas por processos, então:
- Antes do upgrade: Ative OAuth e Autenticação Básica para essas integrações. O trigger REST para essas integrações precisa ter a política de segurança OAuth e Autenticação Básica ativada. Se ele estiver usando somente OAuth ou somente Autenticação Básica, atualize-o para usar OAuth e Autenticação Básica para evitar falhas após o upgrade.
Observação
Você só precisa usar uma conexão de trigger REST do tipo trigger. - Após o upgrade: Verifique se as integrações chamadas por processos usam OAuth e Autenticação Básica como política de segurança.
- Antes do upgrade: Ative OAuth e Autenticação Básica para essas integrações. O trigger REST para essas integrações precisa ter a política de segurança OAuth e Autenticação Básica ativada. Se ele estiver usando somente OAuth ou somente Autenticação Básica, atualize-o para usar OAuth e Autenticação Básica para evitar falhas após o upgrade.
- Se você tiver algum processo dinâmico no Oracle Integration Generation 2 que chame integrações, use conectores REST para implantar esses processos no Oracle Integration 3. Se você usar adaptadores nativos em vez de conectores REST para implantar esses processos no Oracle Integration 3, isso poderá causar falhas.
Tarefas de Pós-atualização
Saiba o que acontece após a conclusão do upgrade da fase 1 e certifique-se de concluir as tarefas de pós-upgrade.
As informações a seguir se aplicam apenas aos clientes que foram migrados usando a atualização em fases do Process.
Após a conclusão do upgrade da fase 1, veja o que acontece e o que você precisa fazer:
Oracle Integration Generation 2
Você ainda pode acessar seu ambiente do Oracle Integration Generation 2 após o upgrade.
Por exemplo: https://<original instance ID>-process.integration.ocp.oraclecloud.com/ic/home/.
Todas as transações existentes (em andamento e concluídas) estarão disponíveis.
- Na sua instância do Oracle Integration Generation 2, somente a funcionalidade Process estará disponível; todos os outros componentes foram atualizados.
- Nenhum novo trabalho de desenvolvimento deve ocorrer no Oracle Integration Generation 2 a partir deste ponto.
- A instância do Oracle Integration Generation 2 não estará mais disponível na Console do Oracle Cloud, portanto, as ações de gerenciamento (como iniciar/interromper) da sua instância do Oracle Integration Generation 2 não são mais possíveis.
- Você poderá descobrir integrações no Oracle Integration 3 se precisar aplicar qualquer correção em seus processos existentes.
- As chamadas do Processo Dinâmico que usam a atividade de integrações não funcionarão após o upgrade. Dessa forma, você precisará atualizar seus processos dinâmicos para usar uma conexão de atividade de serviço para chamar suas integrações. Se você não fizer isso antes do upgrade, poderá ocorrer interrupção do serviço após o upgrade.
- Se você estiver chamando qualquer processo usando seus pontos de extremidade SOAP, observe que os pontos de extremidade do web service não mostrarão o endereço correto no designer. No entanto, durante o runtime, as chamadas serão redirecionadas corretamente pela instância do Oracle Integration 3. Se quiser atualizar manualmente seus clientes para usar o ponto final WSDL correto, você poderá fazer isso executando as seguintes etapas:
- Na instância do Oracle Integration Generation 2, no painel de navegação, clique em Processos e depois clique em Processar Aplicativos.
A página Processar Inscrições é exibida.
- Na página Processar Aplicativos, clique em Ativar.
A página Ativar é exibida listando os aplicativos que você pode gerenciar.
- Clique em Ações
e selecione Serviços Web.
A caixa de diálogo Gerenciar Web Services é exibida.
- Na caixa de diálogo Gerenciar Web Services, a guia Exposto exibe o URL de web services que o aplicativo ativo está expondo. Atualize o nome do host neste URL do web service manualmente para usar o novo nome do host.
- Na instância do Oracle Integration Generation 2, no painel de navegação, clique em Processos e depois clique em Processar Aplicativos.
Oracle Integration 3
- O processo não será ativado no Oracle Integration 3 após o upgrade.
- As integrações que chamam Processo foram migradas e ativadas.
- Você poderá descobrir novos processos no Oracle Integration Generation 2 se precisar aplicar correções às soluções existentes.
- As integrações de programação com uma ação de processo que chama o Processo não são iniciadas automaticamente após a atualização em fases. É necessário iniciar essas integrações de programação após a atualização em fases.
Visual Builder e outros aplicativos front-end
- Se você tiver aplicativos Visual Builder chamando o Processo e não tiver concluído as etapas de pré-upgrade, deverá concluí-las agora.
- Os Processos do Oracle Integration Generation 2 não poderão mais ser descobertos ou estarão disponíveis para chamadas em cadeias de ação. Você precisa usar o Processo do Oracle Integration 3 para todas as novas iniciativas de desenvolvimento do Visual Builder.
Validação
- Execute verificações de integridade para validar a conectividade entre integrações, aplicativos front-end e Processo.
- Realizar testes funcionais em seu ambiente de Processo.
Retomar Operações
- Uma vez concluída a validação, os usuários de negócios podem retomar a criação de instâncias de processo e a execução de tarefas.