Completa task precedenti all'aggiornamento

È necessario completare diversi task man mano che si avvicina la data di upgrade per evitare errori durante l'upgrade e per consentire la transizione alla nuova istanza di Oracle Integration 3 dopo l'upgrade.

Task di preaggiornamento dell'agente di connettività

Attività Proprietario tipico Descrizione task

Preparati per la conversione a OAuth 2.0

Team di Development Operations In Oracle Integration Generation 2, l'agente di connettività utilizza l'autorizzazione di base per richiamare gli endpoint Oracle Integration. Oracle Integration 3 utilizza invece l'autenticazione basata su token OAuth 2.0, che è più sicura. Durante l'aggiornamento, le connessioni degli agenti di connettività vengono convertite automaticamente dall'utilizzo dell'autenticazione di base all'utilizzo di OAuth 2.0, in modo da non dover ricreare manualmente le connessioni.

Tuttavia, prima di eseguire l'upgrade, è necessario prepararsi a questa conversione consentendo l'uscita dalla rete dell'agente alla fase di progettazione e al runtime di Oracle Integration e a Oracle Identity Cloud Service o al dominio di Identity, come descritto in Aggiorna liste di inclusione.

E, dopo l'aggiornamento, come risultato del nuovo metodo di autenticazione, vedrai traffico aggiuntivo al tuo firewall. Questo traffico aggiuntivo si verifica perché l'agente di connettività deve comunicare con il server per ottenere nuovi token.

Per ulteriori informazioni sul supporto OAuth 2.0 in Oracle Integration 3, vedere Quando è supportata l'autenticazione di base in Oracle Integration 3?.

Aggiorna le impostazioni della lista di inclusione

Team di Development Operations Se l'organizzazione utilizza liste di inclusione, è necessario aggiornare le impostazioni della lista di inclusione per gli agenti di connettività. La colonna Stato elenco di inclusione della sezione Stato agente di connettività mostra lo stato di tutti gli agenti di connettività nell'istanza, indicando se l'elenco di inclusione è stato aggiornato in modo appropriato.

Man mano che la finestra di aggiornamento si avvicina, eseguire le attività descritte in Aggiorna liste di inclusione.

Gli agenti non in linea durante l'aggiornamento o che non soddisfano i requisiti di aggiornamento non verranno aggiornati, nel qual caso sarà necessario eseguire passi successivi all'aggiornamento per riconquistare la connettività.

Impostare le proprietà Cache del server proxy

Team di Development Operations Impostare la proprietà Cache del server proxy per aggiornare il più frequentemente possibile gli URL di Oracle Integration.

Ad esempio, se il server proxy utilizza la proprietà Cache-ExpiresDefault, impostarla su now.

Task precedenti all'aggiornamento dell'istanza

Attività Proprietario tipico Descrizione task

Inizia ad acquisire il flusso di attività nella console di Oracle Cloud Infrastructure

Amministratore Se non lo fai già, inizia ad acquisire il flusso di attività nella console di Oracle Cloud Infrastructure.

Ecco perché: il flusso di attività non viene migrato. Tuttavia, se acquisisci questi dati nella console di Oracle Cloud Infrastructure, avrai comunque accesso ai dati cronologici. Vedere Acquisisci il flusso di attività nella console di Oracle Cloud Infrastructure.

Completa configurazione regole di rete

Amministratore di rete Questa attività può essere completata prima dell'aggiornamento o immediatamente dopo l'aggiornamento.

Se una qualsiasi delle connessioni di integrazione è destinata a un servizio Oracle Cloud Infrastructure che supporta le regole di rete, ad esempio Oracle Cloud Infrastructure Object Storage o Oracle Autonomous Database, e tali regole sono state abilitate, è necessario completare qualsiasi configurazione delle regole di rete, inclusa l'aggiunta della VCN del servizio Oracle Integration alla regola.

Vedere Garantire la connettività.

B2B per i task di pre-aggiornamento di Oracle Integration

Attività Proprietario tipico Descrizione task

Assicurarsi che tutte le password B2B per il keystore corrispondano

Amministratore Assicurarsi che tutte le password per il file keystore siano identiche. Il file del certificato di identità (JKS) richiede due set di password: Password chiave e Password keystore. Tutte le password devono essere identiche. Se non sono identici, modificare le password in modo che corrispondano e ricaricare il file del keystore.

Se non si dispone del file keystore caricato per l'ultima volta, ricreare il file.

Quando si carica il certificato:

  • Per Type, selezionare X.509 (SSL Transport).
  • Per Categoria, selezionare Identità.

Vedere Carica un certificato SSL in Uso delle integrazioni in Oracle Integration Generation 2.

Attenzione:

Se non si completa questo passaggio, l'aggiornamento non riuscirà.

Task precedenti all'aggiornamento delle integrazioni

Attività Proprietario tipico Descrizione task

Determinare le operazioni da eseguire con le istanze non riuscite

Team di Development Operations Le istanze di integrazione non riuscite rientrano in una delle seguenti categorie, che determina come gestirle:
  • Istanze asincrone non riuscite - recuperabili

    Risottomettere le istanze non riuscite e cancellare la coda. Vedere Risottometti messaggi non riusciti.

    Se si dispone di un'istanza asincrona non riuscita durante l'upgrade dell'istanza, non è possibile risottomettere l'istanza non riuscita in Oracle Integration 3, almeno non immediatamente. Impossibile eseguire di nuovo la sottomissione perché i dati di runtime, inclusi gli errori e tutti i dati del flusso di attività, non vengono migrati a Oracle Integration 3 nell'ambito dell'aggiornamento. Una volta completato l'upgrade, tuttavia, è possibile eseguire l'integrazione in Oracle Integration 3, raccogliere i dati degli errori, quindi sottomettere di nuovo.

  • Istanze sincrone non riuscite - non recuperabili

    Non è possibile risottomettere le istanze di integrazione sincrona, pertanto non sono recuperabili.

Nota

Se si acquisiscono i dati del flusso di attività nella console di Oracle Cloud Infrastructure, è comunque possibile visualizzare l'attività cronologica per l'integrazione. Vedere Acquisisci il flusso di attività delle integrazioni nella console di Oracle Cloud Infrastructure.

Decidere cosa fare con i messaggi asincroni

Team di Development Operations Decidere cosa fare con i messaggi asincroni dal lato client per la durata del tempo di inattività.

Ecco perché: durante il periodo di inattività, Oracle Integration rifiuta tutte le richieste in entrata. Per prepararsi, sono disponibili le opzioni riportate di seguito.

  • Prima dell'avvio dell'aggiornamento, sospendere tutti i messaggi asincroni sul lato client.

    Con questo approccio, il client non invia i messaggi e Oracle Integration non li rifiuta.

    Se si sceglie questa opzione, assicurarsi di conoscere l'ora di inizio e di fine dell'aggiornamento.

  • Al termine dell'aggiornamento, determinare i passi successivi appropriati per i messaggi rifiutati.

Modificare le chiamate API integrate di Oracle Integration da Autenticazione di base a OAuth

Developer Se le chiamate API non sono state già aggiornate per utilizzare OAuth durante il completamento dei prerequisiti, procedere ora o immediatamente dopo l'aggiornamento.

In Oracle Integration Generation 2 è possibile utilizzare l'autenticazione di base per utilizzare l'API REST di Oracle Integration e l'API REST di File Server. In Oracle Integration 3 è necessario utilizzare OAuth. È necessario aggiornare client, script, integrazioni e comandi che utilizzano l'API REST di Oracle Integration o l'API REST di File Server per connettersi tramite OAuth. Per ulteriori informazioni sul supporto del metodo di autenticazione, vedere Quando è supportata l'autenticazione di base in Oracle Integration 3. Per i dettagli sull'uso di OAuth con l'API REST di Oracle Integration, vedere Sicurezza, autenticazione e autorizzazione oppure con l'API REST di File Server, vedere Sicurezza, autenticazione e autorizzazione.

Task precedenti all'aggiornamento degli adattatori

Attività Proprietario tipico Descrizione task

Interrompi l'utilizzo degli adattatori Microsoft disattivati

Team di sviluppo Microsoft ha disattivato le API REST di Microsoft Outlook nel novembre 2022. Se si utilizza uno degli adattatori riportati di seguito, è necessario utilizzare le API REST di Microsoft Graph.
  • Adattatore calendario Microsoft Office 365

    Vedere Pagina Richiama operazioni in Uso di Microsoft Office 365 Calendar Adapter with Oracle Integration 3.

  • Adattatore Microsoft Office 365 People

    Vedere Pagina Richiama operazioni in Uso di Microsoft Office 365 People Adapter with Oracle Integration 3.

  • Adattatore di Outlook Microsoft Office 365

    Vedere Pagina Richiama operazioni in Uso di Microsoft Office 365 Outlook Adapter with Oracle Integration 3.

Task di pre-aggiornamento di Visual Builder

Attività Proprietario tipico Descrizione task
Preparare Visual Builder con endpoint personalizzato che utilizza SSL per l'upgrade Amministratore Se Visual Builder è abilitato, si utilizza un endpoint personalizzato o endpoint personalizzati alternativi e si utilizza SSL, eseguire i passi riportati di seguito.
  1. Per consentire l'accesso al segreto certificato SSL per l'upgrade, aggiungere i criteri seguenti, sostituendo MySecretCompartment con il compartimento che include i segreti certificato 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
  2. Aggiornare le impostazioni del tenant e dell'applicazione di Visual Builder e tutte le applicazioni di integrazione in modo che puntino all'URL originale di Oracle Integration Generation 2 anziché all'endpoint personalizzato. Durante l'aggiornamento, l'endpoint personalizzato verrà configurato in Visual Builder. Pertanto, dopo l'aggiornamento, solo le applicazioni Visual Builder saranno accessibili tramite l'endpoint personalizzato.

Prepara Visual Builder per l'upgrade

Team di Development Operations Completare i task descritti nella sezione Prepara Visual Builder per l'aggiornamento in Amministrazione di Oracle Visual Builder in Oracle Integration 3.
Esaminare i problemi noti Team Development Operations Rivedere i problemi noti per le applicazioni attive/posizionate nell'area intermedia dopo l'aggiornamento a Oracle Integration 3 in Problemi noti per Oracle Integration 3 per individuare i problemi che potrebbero determinare il funzionamento corretto delle applicazioni attive o posizionate nell'area intermedia dopo l'aggiornamento a Oracle Integration 3.