Completa task precedenti all'aggiornamento

Riepilogo dei task precedenti all'aggiornamento

Questa tabella contiene un riepilogo delle attività preliminari all'aggiornamento per ciascuna area. I dettagli di ogni task vengono collegati nella tabella e visualizzati nelle sezioni successive.

Aree	Attività
Agente di connettività	Preparati per la conversione a OAuth 2.0 Aggiorna le impostazioni della lista di inclusione Impostare le proprietà Cache del server proxy
Istanze	Inizia ad acquisire il flusso di attività nella console di Oracle Cloud Infrastructure Completa configurazione regole di rete
B2B per Oracle Integration	Assicurarsi che tutte le password B2B per il keystore corrispondano
Integrazioni	Determinare le operazioni da eseguire con le istanze non riuscite Decidere cosa fare con i messaggi asincroni Modificare le chiamate API integrate di Oracle Integration dall'autenticazione di base a OAuth
Adattatori	Interrompi l'utilizzo degli adattatori Microsoft disattivati
Visual Builder	Prepara Visual Builder per l'upgrade
Liste di inclusione	Aggiorna liste di inclusione
Comunicazione	Informa utenti e parti interessate sull'upgrade
Sviluppo del lavoro	Limitare il lavoro di sviluppo prima dell'aggiornamento

Task di preaggiornamento dell'agente di connettività

Attività Proprietario tipico Descrizione task

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`.

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à.

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à.

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.

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. 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` 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.

Documentazione di Oracle Cloud Infrastructure