Garantire l'accesso all'istanza

Subito dopo l'aggiornamento

1. Controllare la nuova istanza di Oracle Integration 3
2. Aggiornare il criterio IAM con il nuovo OCID
3. Recupera l'URL della nuova istanza e condividilo

Garantisci la connettività

Subito dopo l'aggiornamento

1. Completa configurazione regole di rete
2. Carica nuovi certificati di identità per le connessioni
3. Ripristinare la connettività con gli agenti non aggiornati
4. File server: aggiungere l'indirizzo IP del file server alla lista di inclusione interna del firewall

   Completare questo task entro una settimana dall'aggiornamento.

5. File server: aggiorna le integrazioni e i client SFTP per utilizzare i nuovi valori di IP e porta

   Completare questo task entro una settimana dall'aggiornamento.

Garantisci il funzionamento delle integrazioni

Subito dopo l'aggiornamento

1. Modificare le chiamate API integrate di Oracle Integration dall'autenticazione di base a OAuth
2. Controllare le integrazioni se è stata selezionata l'opzione Ignora errori di attivazione o Ignora errori di avvio pianificazione
3. Gestire le richieste rifiutate durante il periodo di inattività dell'upgrade

Completare i task successivi all'aggiornamento per gli errori di controllo preliminare ignorati

Subito dopo l'aggiornamento

Completare le attività successive all'aggiornamento di Visual Builder

Subito dopo l'aggiornamento

Completare i task di automazione dei processi successivi all'aggiornamento

Subito dopo l'aggiornamento

Completa verifica post-aggiornamento

Entro due settimane dall'aggiornamento

Controllare la nuova istanza di Oracle Integration 3

Aggiornamento completato se l'interfaccia è simile al seguente:

Aggiornare il criterio IAM con il nuovo OCID

Amministratore dei criteri IAM

1. Accedi alla console di Oracle Cloud Infrastructure.
2. Recupera il nuovo valore OCID per l'istanza di Oracle Integration 3. Vedere Visualizzazione dei dettagli dell'istanza.
3. Aggiornare l'OCID nel criterio IAM. Per istruzioni sull'aggiornamento delle istruzioni in un criterio esistente, vedere Utilizzo della console nella documentazione di Oracle Cloud Infrastructure.

Recupera l'URL della nuova istanza e condividilo

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

Per ottenere il nuovo URL:

1. Accedi alla console di Oracle Cloud Infrastructure.
2. Aprire il menu di navigazione e fare clic su Servizi per sviluppatori.
3. In Integrazione applicazioni fare clic su Integrazione.
4. Fare clic sul nome della nuova istanza di Oracle Integration 3.
5. A destra del campo URL console servizio, fare clic su Copia.
6. Condividi l'URL con chiunque ne abbia bisogno.

Completa configurazione regole di rete

1. Accedi alla console di Oracle Cloud Infrastructure.
2. Recupera il valore OCID per l'istanza di Oracle Integration 3.

   Vedere Visualizzazione dei dettagli dell'istanza.

3. Seguire le regole per il servizio di destinazione. Ad esempio, per Oracle Autonomous Database Serverless, vedere Configura liste di controllo dell'accesso quando si esegue il provisioning o la copia di un'istanza in Uso di Oracle Autonomous Database Serverless.
4. Se il servizio Oracle Cloud Infrastructure a cui si sta accedendo si trova in un'area diversa dall'istanza di Oracle Integration, inserire nella lista di inclusione l'indirizzo IP in uscita OIC raccolto quando si aggiornano le altre liste di inclusione prima dell'upgrade.

Carica nuovi certificati di identità per le connessioni

Solo una persona dell'organizzazione deve eseguire questi passi

Se l'istanza include connessioni che utilizzano certificati di identità, i certificati di identità sarebbero stati rimossi durante l'aggiornamento, pertanto è necessario generare nuovi certificati di identità e configurare nuovi JKS.

Eseguire i passi riportati di seguito per caricare un nuovo certificato di identità, eseguire il test delle connessioni che utilizzano il certificato di identità e attivare le integrazioni che utilizzano le connessioni.

1. Caricare un nuovo certificato di identità.

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

2. Eseguire il test delle connessioni che utilizzano il certificato di identità in modo che il relativo stato passi da Bozza a Configurato.

   Fare riferimento alla sezione Test della connessione in Uso delle integrazioni in Oracle Integration 3.

3. Attiva tutte le integrazioni che utilizzano le connessioni.

   Fare riferimento alla sezione Attiva un'integrazione in Uso delle integrazioni in Oracle Integration 3.

Ripristinare la connettività con gli agenti non aggiornati

Prerequisiti

Garantisci la connettività dagli agenti di connettività a Oracle Cloud Infrastructure Identity and Access Management (IAM) e Oracle Integration 3:

• Prima di eseguire l'upgrade, dovresti aver aggiunto gli indirizzi IP IAM e Oracle Integration 3 alle liste di inclusione, come descritto in Aggiorna liste di inclusione.
• Aggiungere l'indirizzo IP della fase di progettazione di Oracle Integration 3 alle liste di inclusione. Utilizzare il seguente comando per ottenere l'indirizzo IP in fase di progettazione, sostituendo region con l'area dall'URL di Oracle Integration 3:

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

Per aggiornare manualmente gli agenti e riconnetterli:

1. Arrestare l'agente di connettività.
2. Assicurarsi che i prerequisiti dell'agente siano stati completati:
   1. Assicurarsi che l'agente di connettività utilizzi JDK 17. In caso contrario, impostare le variabili di ambiente JAVA_HOME e PATH su JDK17.
   2. Assicurarsi che l'agente utilizzi PKCS12 KeyStore. In caso contrario, convertirlo utilizzando i passaggi seguenti.
      1. Sul server che ospita l'agente di connettività, creare un backup del file keystore.jks, che si trova nella seguente cartella:

         Agent_Install_Location/agenthome/agent/cert

      2. Spostare il file di backup in una cartella diversa.
      3. Convertire JKS KeyStore in PKCS12 KeyStore eseguendo il comando seguente dalla riga di comando:

         keytool -importkeystore -srckeystore keystore.jks -destkeystore keystore.p12 -srcstoretype JKS -deststoretype PKCS12 -deststorepass changeit -srcstorepass changeit

      4. Eliminare il file keystore.jks nella seguente posizione:

         Agent_Install_Location/agenthome/agent/cert

3. Scaricare il file ZIP del programma di installazione dell'agente da Oracle Integration 3.
   1. Nel riquadro di navigazione fare clic su Progetta, quindi su Agenti.
   2. Fare clic su Scarica, quindi su Agente di connettività.
4. Estrarre oic_conn_agent_installer.zip in una nuova directory sul server dell'agente di connettività.
5. Eliminare la cartella lib dell'agente di connettività esistente in Agent_Install_Location/agenthome/ e sostituirla con la cartella lib dal file ZIP.
6. Eliminare il file version esistente in Agent_Install_Location/agenthome/ e sostituirlo con il file version dal file ZIP.
7. Eliminare il file connectivityagent.jar esistente in Agent_Install_Location e sostituirlo con il file connectivityagent.jar dal file ZIP.
8. Eliminare il file cpi_upgradeutility.jar esistente in Agent_Install_Location e sostituirlo con il file cpi_upgradeutility.jar dal file ZIP.
9. In Oracle Integration 3, nella pagina Agenti, passare il puntatore del mouse sul gruppo di agenti, fare clic su Azioni , quindi selezionare Scarica configurazione.

   In questo passo viene scaricato un file InstallerProfile.cfg preconfigurato per il gruppo di agenti.

10. Eliminare il file InstallerProfile.cfg esistente in Agent_Install_Location e sostituirlo con il file InstallerProfile.cfg scaricato nel passo precedente.
11. Riavviare l'agente di connettività eseguendo il comando seguente:

    java -jar connectivityagent.jar

12. Riattivare le integrazioni presenti nel gruppo di agenti aggiornato.

File server: aggiungere l'indirizzo IP File server alla lista di inclusione interna del firewall.

L'indirizzo IP di Oracle Integration Generation 2 continua a funzionare per quattro mesi dopo l'aggiornamento e successivamente il ritiro da parte di Oracle. Tuttavia, Oracle consiglia di aggiornare la lista di inclusione firewall per utilizzare il nuovo indirizzo IP ora. In questo modo, non si rischia di dimenticare di aggiornare la lista di inclusione in futuro.

Per ottenere l'indirizzo IP del file server:

1. Accedi a Oracle Integration 3.
2. Nel riquadro di navigazione fare clic su Impostazioni, su File server, quindi su Impostazioni.
3. In Generale, ottenere l'indirizzo IP per il server SFTP File Server.

File server: aggiorna le integrazioni e i client SFTP per utilizzare i nuovi valori di IP e porta

I valori degli IP e delle porte di Oracle Integration Generation 2 continuano a funzionare per quattro mesi dopo l'aggiornamento e dopo che Oracle li ha ritirati. Tuttavia, Oracle consiglia di aggiornare le integrazioni e i client SFTP per utilizzare i nuovi valori ora. In questo modo, non si rischia di dimenticare di aggiornare questi valori in futuro.

1. Accedi a Oracle Integration 3.
2. Nel riquadro di navigazione fare clic su Impostazioni, su File server, quindi su Impostazioni.
3. In Generale, ottenere i valori di IP e porta per il server SFTP File Server.
4. Aggiornare tutte le integrazioni che chiamano File server in modo che utilizzino i nuovi valori IP e porta.
5. Aggiornare tutti i client SFTP in modo che utilizzino i nuovi valori di IP e porta.

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

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.

Controllare le integrazioni se è stata selezionata l'opzione Ignora errori di attivazione o Ignora errori di avvio pianificazione

• Se è stata selezionata l'opzione Ignora errori di attivazione, verificare lo stato di tutte le integrazioni e attivare le integrazioni in base alle esigenze.
• Se è stata selezionata l'opzione Ignora errori di avvio pianificazione, controllare le pianificazioni delle integrazioni e avviarle manualmente, se necessario.

Gestire le richieste rifiutate durante il periodo di inattività dell'upgrade

Oracle Integration ha rifiutato tutte le richieste inviate durante il periodo di inattività dell'upgrade. Se necessario, eseguire azioni sulle richieste inviate da qualsiasi client a Oracle Integration durante il periodo di inattività.

Modifica nome istanza servizio

Dopo l'aggiornamento da Oracle Integration Generation 2 a Oracle Integration 3, il nome della tenancy viene aggiunto alla fine del nome dell'istanza del servizio (nome visualizzato dell'istanza del servizio) nel seguente formato: <service instance name>-<tenancy name>. Ad esempio, se il nome dell'istanza del servizio è myinstance e il nome della tenancy è mytenancy, verrà modificato in myinstance-mytenancy dopo l'upgrade a Oracle Integration 3. Pertanto, se le integrazioni utilizzano il nome dell'istanza del servizio, aggiornare le integrazioni in modo che utilizzino il nuovo nome dell'istanza del servizio. In caso contrario, l'operazione non riuscirà.

• Adattatore Oracle CX Sales and B2B Service
• Adattatore Oracle ERP Cloud
• Adattatore Oracle HCM Cloud
• Adattatore Oracle Field Service Cloud
• Adattatore Salesforce
• Adattatore ServiceNow

Integrazioni di instradamento di base: le integrazioni di instradamento di base non sono supportate in Oracle Integration 3 e visualizzeranno un'area di creazione vuota. È necessario eliminare tali integrazioni e ricrearle come integrazioni basate su applicazioni.

• Adattatore automazione ovunque
• Adattatore Evernote
• Adattatore di Oracle Messaging Cloud Service
• Adattatore Oracle Monetization Cloud
• Adattatore Oracle Taleo Business Edition (TBE)
• UiPath Adattatore per automazione robotica dei processi

È necessario creare connessioni dell'adattatore REST per sostituire le connessioni dell'adattatore non supportate eliminate.

È necessario rielaborare le integrazioni utilizzando i passi riportati di seguito.

1. Eliminare il richiamo corrispondente alla connessione di adattatore non supportata e sostituirlo con la nuova connessione di adattatore REST.
2. Dopo aver configurato e attivato l'integrazione, avviare la pianificazione.

Per sostituire le connessioni di adattatori personalizzate eliminate, è necessario creare nuove connessioni utilizzando adattatori equivalenti di Oracle Integration 3.

È necessario rielaborare le integrazioni utilizzando i passi riportati di seguito.

1. Eliminare il richiamo corrispondente alla connessione adattatore personalizzata e sostituirlo con la nuova connessione creata.
2. Dopo aver configurato e attivato l'integrazione, avviare la pianificazione.

È necessario rielaborare tali integrazioni in modo che non utilizzino questo pattern. Ad esempio, utilizzare un'operazione listFile per elencare i file e utilizzare un'azione for-each per leggere ogni singolo file.

• URL catalogo metadati
• URL di definizione Swagger
• URL di definizione RAML

È necessario aggiornare tali connessioni utilizzando uno dei metodi indicati di seguito.

• Se si utilizza RAML o il catalogo di metadati Oracle, è possibile chiedere al provider di servizi REST di specificare una definizione Swagger (se disponibile). Oracle Fusion Applications deve avere un'opzione Swagger disponibile poiché si tratta di una linea guida per tutte le Oracle Fusion Applications.

  Se non è disponibile una specifica alternativa, utilizzare il modello di base nell'adattatore REST selezionando l'URL di base dell'API REST come URL di connessione e definendo la richiesta dell'API di destinazione mediante la Configurazione guidata endpoint adattatore.

• Un'altra opzione se si utilizza RAML è quella di convertire RAML in una specifica OpenAPI.
• Se si utilizza l'URL di definizione Swagger, è possibile utilizzare la nuova opzione unificata dell'adattatore REST per specificare tutte le specifiche OpenAPI in un singolo campo. Questa opzione fornisce un supporto più affidabile e completo per le specifiche Swagger/OpenAPI.

Vedere Configura proprietà di connessione per le connessioni di richiamo in Utilizzo dell'adattatore REST con Oracle Integration 3.

È necessario rielaborare le integrazioni utilizzando i passi riportati di seguito.

1. Attivare l'integrazione
2. Dopo l'attivazione dell'integrazione, avviare la pianificazione.

È necessario ricreare l'endpoint personalizzato.

Se si utilizza Visual Builder e si dispone di un endpoint personalizzato o di endpoint personalizzati alternativi, aggiornare il CNAME del record DNS dell'endpoint personalizzato con il nome host dell'istanza di Visual Builder.

Nota: dopo l'aggiornamento non è possibile utilizzare lo stesso endpoint personalizzato sia per Visual Builder che per Oracle Integration. Se si utilizza lo stesso endpoint personalizzato, è possibile che si verifichino problemi.

Completare task aggiuntivi successivi all'aggiornamento

Aggiornamenti completi richiesti per la modifica dell'ID istanza di integrazione in alfanumerico

Questa modifica interessa i flussi di integrazione basati sul fatto che l'ID dell'istanza di integrazione è un numero intero, ad esempio quando l'ID dell'istanza di integrazione viene analizzato in una colonna di database con un tipo di dati numerico. Dopo l'upgrade, se queste integrazioni vengono eseguite invariate, senza selezionare Abilita flowid come valore numerico dopo l'upgrade nelle impostazioni di upgrade, verrà visualizzato un errore di eccezione di conversione.

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

Per accogliere la modifica, è possibile aggiornare il mapping in ogni integrazione interessata oppure il tipo di dati della colonna in cui sono memorizzati gli ID dell'istanza di integrazione nel database.

Nota: i metodi suggeriti qui sono basati sui servizi di database Oracle (ad esempio Oracle Autonomous Database). Per altri tipi di database potrebbero essere necessari passi aggiuntivi.

Metodo 1: Aggiorna il mapping in ogni integrazione interessata

In ogni integrazione interessata, mappare l'attributo di destinazione che contiene il valore ID dell'istanza di integrazione a un nuovo valore numerico, ovvero l'ora UNIX. Il tempo UNIX è il numero di secondi trascorsi dall'epoca UNIX, a partire dal 1° gennaio 1970 alle ore 00:00:00 UTC. Questo valore aumenta ogni secondo. Il valore può essere analizzato come numero intero, pertanto non richiede alcuna modifica al database.

Prima dell'upgrade, dovresti aver notato quali integrazioni sono interessate, come descritto nel controllo preliminare dell'azione ID istanza.

Eseguire i passi riportati di seguito per ogni integrazione interessata.

1. Non è possibile modificare un'integrazione attiva, pertanto, se l'integrazione è attiva, disattivarla.
2. Aprire l'integrazione.
3. Fare doppio clic sulla mappa che include l'ID dell'istanza di integrazione.
4. Trovare l'attributo di destinazione che contiene il valore dell'ID dell'istanza di integrazione e fare clic su di esso.
5. Nel Builder delle espressioni, fare clic su .
6. Immettere l'espressione seguente:

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

7. Fare clic su per salvare l'espressione.
8. Tornare allo sfondo dell'integrazione e salvare le modifiche.

Metodo 2: aggiornare il tipo di dati della colonna interessata nel database

Nel database, modificare il tipo di dati della colonna contenente l'ID istanza di integrazione in string (CHAR/VARCHAR). Questo approccio non comporta modifiche alle integrazioni.

Nota: la soluzione è limitata alle azioni di database create utilizzando l'operazione Esegui un'istruzione SQL.

Poiché la colonna del database è già popolata, non è possibile modificare solo il tipo di dati della colonna. In alternativa, è possibile eseguire i passi riportati di seguito. Eseguire i passi riportati di seguito in SQL Developer.

1. Prendere nota del nome della colonna ID istanza.
2. Aggiungere una colonna temporanea (ad esempio, TEMP) di tipo VARCHAR.

   Sintassi SQL:

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

   Esempio:

   ALTER TABLE FLOW_MANAGEMENT ADD TEMP VARCHAR2(50);

3. Copiare i valori dalla colonna di origine (quella contenente gli ID istanza) nella colonna temporanea.

   Sintassi SQL:

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

   Esempio:

   UPDATE FLOW_MANAGEMENT SET TEMP = FLOWID;

4. Impostare i valori della colonna di origine su NULL.

   Sintassi SQL:

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

   Esempio:

   UPDATE FLOW_MANAGEMENT SET FLOWID = NULL;

5. Aggiornare il tipo di colonna di origine da NUMBER a VARCHAR.

   Sintassi SQL:

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

   Esempio:

   ALTER TABLE FLOW_MANAGEMENT MODIFY FLOWID VARCHAR2(50);

6. Copiare i valori dell'ID istanza dalla colonna temporanea nella colonna di origine.

   Sintassi SQL:

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

   Esempio:

   UPDATE FLOW_MANAGEMENT SET FLOWID = TEMP;

7. Rimuovere la colonna temporanea.

   Sintassi SQL:

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

   Esempio:

   ALTER TABLE FLOW_MANAGEMENT DROP COLUMN TEMP;

1. Accedere a Oracle Integration come amministratore.
2. Fare clic su Impostazioni, quindi su Varie.
3. Modificare il tipo di ID flusso in alfanumerico, quindi fare clic su Salva.

Completare i task di verifica successivi all'aggiornamento dell'organizzazione

Completare i task di verifica successivi all'aggiornamento dell'organizzazione, ad esempio l'esecuzione dei test di regressione.

Eseguire il test del caricamento dell'integrazione in un'istanza di sviluppo/fase prima di spostare le integrazioni in un'istanza di produzione.