Stellen Sie den Zugriff auf die Instanz sicher

Sofort nach dem Upgrade

1. Neue Oracle Integration 3-Instanz prüfen
2. IAM-Policy mit der neuen OCID aktualisieren
3. URL für die neue Instanz abrufen und freigeben

Konnektivität sicherstellen

Sofort nach dem Upgrade

1. Vollständige Konfiguration der Netzwerkregeln
2. Neue Identitätszertifikate für Verbindungen hochladen
3. Konnektivität mit Agents wiederherstellen, die nicht upgegradet wurden
4. Dateiserver: Fügen Sie die Dateiserver-IP-Adresse zu Ihrer internen Firewall-Ausnahmeliste hinzu

   Schließen Sie diese Aufgabe innerhalb einer Woche nach dem Upgrade ab.

5. Dateiserver: Aktualisieren Sie Integrationen und SFTP-Clients, um die neuen IP- und Portwerte zu verwenden

   Schließen Sie diese Aufgabe innerhalb einer Woche nach dem Upgrade ab.

Integrationen sicherstellen

Sofort nach dem Upgrade

1. Integrierte Oracle Integration-API-Aufrufe von der Basisauthentifizierung in OAuth ändern
2. Integrationen prüfen, wenn Sie "Aktivierungsfehler ignorieren" oder "Startplanfehler ignorieren" ausgewählt haben
3. sich um alle Anforderungen kümmern, die während der Ausfallzeit des Upgrades abgelehnt wurden

Nach dem Upgrade ausgeführte Aufgaben für ignorierte Vorabprüfungsfehler abschließen

Sofort nach dem Upgrade

Visual Builder-Aufgaben nach dem Upgrade ausführen

Sofort nach dem Upgrade

Prozessautomatisierung nach dem Upgrade durchführen

Sofort nach dem Upgrade

Post-Upgrade-Verifizierung abschließen

Innerhalb von zwei Wochen nach dem Upgrade

Prüfen Sie die neue Oracle Integration 3-Instanz

Das Upgrade wurde abgeschlossen, wenn die Schnittstelle wie folgt aussieht:

IAM-Policy mit der neuen OCID aktualisieren

IAM-Policy-Administrator

1. Melden Sie sich bei der Oracle Cloud Infrastructure-Konsole an.
2. Rufen Sie den neuen OCID-Wert für die Oracle Integration 3-Instanz ab. Siehe Instanzdetails anzeigen.
3. Aktualisieren Sie die OCID in der IAM-Policy. Anweisungen zum Aktualisieren der Anweisungen in einer vorhandenen Policy finden Sie in der Oracle Cloud Infrastructure-Dokumentation unter Konsole verwenden.

URL für die neue Instanz abrufen und freigeben

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

So rufen Sie die neue URL ab:

1. Melden Sie sich bei der Oracle Cloud Infrastructure-Konsole an.
2. Öffnen Sie das Navigationsmenü, und klicken Sie auf Entwicklerservices.
3. Klicken Sie unter Anwendungsintegrationauf Integration.
4. Klicken Sie auf den Namen der neuen Oracle Integration 3-Instanz.
5. Klicken Sie rechts neben dem Feld Servicekonsolen-URL auf Kopieren.
6. Teilen Sie die URL allen Benutzern mit, die sie benötigen.

Vollständige Konfiguration der Netzwerkregeln

1. Melden Sie sich bei der Oracle Cloud Infrastructure-Konsole an.
2. Rufen Sie den OCID-Wert für die Oracle Integration 3-Instanz ab.

   Siehe Instanzdetails anzeigen.

3. Befolgen Sie die Regeln für den Zielservice. Beispiel: Informationen zu Oracle Autonomous Database Serverless finden Sie unter Access Control-Listen beim Provisioning oder Klonen einer Instanz konfigurieren in Oracle Autonomous Database Serverless verwenden.
4. Wenn sich der Oracle Cloud Infrastructure-Service, auf den Sie zugreifen, in einer anderen Region befindet als Ihre Oracle Integration-Instanz, listen Sie die ausgehende OIC-IP-Adresse auf, die Sie beim Aktualisieren Ihrer anderen Ausnahmelisten vor dem Upgrade erfasst haben.

Neue Identitätszertifikate für Verbindungen hochladen

Nur eine Person aus Ihrer Organisation muss diese Schritte ausführen

Wenn Ihre Instanz Verbindungen enthält, die Identitätszertifikate verwenden, wurden die Identitätszertifikate beim Upgrade entfernt. Daher müssen Sie neue Identitätszertifikate generieren und neue JKS konfigurieren.

Führen Sie die folgenden Schritte aus, um ein neues Identitätszertifikat hochzuladen, die Verbindungen zu testen, die das Identitätszertifikat verwenden, und alle Integrationen zu aktivieren, die diese Verbindungen verwenden:

1. Laden Sie ein neues Identitätszertifikat hoch.

   Siehe SSL-Zertifikat hochladen in Integrationen in Oracle Integration 3 verwenden.

2. Testen Sie die Verbindungen, die das Identitätszertifikat verwenden, sodass sich ihr Status von "Entwurf" in "Konfiguriert" ändert.

   Siehe Verbindung testen in Integrationen in Oracle Integration 3 verwenden.

3. Aktivieren Sie alle Integrationen, die diese Verbindungen verwenden.

   Siehe Integration aktivieren in Integrationen in Oracle Integration 3 verwenden.

Wiederherstellung der Konnektivität mit Agents, die nicht upgegradet wurden

Voraussetzungen

Stellen Sie die Konnektivität zwischen Ihren Konnektivitäts-Agents und Oracle Cloud Infrastructure Identity and Access Management (IAM) und Oracle Integration 3 sicher:

• Sie sollten die IAM- und Oracle Integration 3-IP-Adressen vor dem Upgrade zu Ihren Ausnahmelisten hinzugefügt haben, wie unter Ausnahmelisten aktualisieren beschrieben.
• Fügen Sie die Entwurfszeit-IP-Adresse von Oracle Integration 3 zu Ihren Ausnahmelisten hinzu. Verwenden Sie den folgenden Befehl, um die Entwurfszeit-IP-Adresse abzurufen und region durch die Region aus der Oracle Integration 3-URL zu ersetzen:

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

So führen Sie manuell ein Upgrade Ihrer Agents durch und stellen die Konnektivität wieder her:

1. Stoppen Sie den Connectivity Agent.
2. Stellen Sie sicher, dass die Agent-Voraussetzungen erfüllt sind:
   1. Stellen Sie sicher, dass der Konnektivitäts-Agent JDK 17 verwendet. Ist dies nicht der Fall, setzen Sie die Umgebungsvariablen JAVA_HOME und PATH auf JDK17.
   2. Stellen Sie sicher, dass der Agent die Datei PKCS12 KeyStore verwendet. Wenn dies nicht der Fall ist, konvertieren Sie es mit den folgenden Schritten.
      1. Erstellen Sie auf dem Server, der den Konnektivitäts-Agent hostet, ein Backup der Datei keystore.jks, die sich im folgenden Ordner befindet:

         Agent_Install_Location/agenthome/agent/cert

      2. Verschieben Sie die Backupdatei in einen anderen Ordner.
      3. Konvertieren Sie JKS KeyStore in PKCS12 KeyStore, indem Sie den folgenden Befehl über die Befehlszeile ausführen:

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

      4. Löschen Sie die Datei keystore.jks im folgenden Verzeichnis:

         Agent_Install_Location/agenthome/agent/cert

3. Laden Sie die ZIP-Datei des Agent-Installationsprogramms aus Oracle Integration 3 herunter.
   1. Klicken Sie im Navigationsbereich auf Entwurf, Agents.
   2. Klicken Sie auf Herunterladen, Konnektivitäts-Agent.
4. Extrahieren Sie oic_conn_agent_installer.zip in ein neues Verzeichnis auf dem Connectivity Agent-Server.
5. Löschen Sie den vorhandenen Ordner lib des Konnektivitäts-Agent unter Agent_Install_Location/agenthome/, und ersetzen Sie ihn durch den Ordner lib aus der ZIP-Datei.
6. Löschen Sie die vorhandene Datei version unter Agent_Install_Location/agenthome/, und ersetzen Sie sie durch die Datei version aus der ZIP-Datei.
7. Löschen Sie die vorhandene Datei connectivityagent.jar unter Agent_Install_Location, und ersetzen Sie sie durch die Datei connectivityagent.jar aus der ZIP-Datei.
8. Löschen Sie die vorhandene Datei cpi_upgradeutility.jar unter Agent_Install_Location, und ersetzen Sie sie durch die Datei cpi_upgradeutility.jar aus der ZIP-Datei.
9. Zeigen Sie in Oracle Integration 3 auf der Seite Agents mit der Maus auf die Agent-Gruppe, klicken Sie auf Aktionen , und wählen Sie Konfiguration herunterladen aus.

   In diesem Schritt wird eine vorkonfigurierte InstallerProfile.cfg-Datei für die Agent-Gruppe heruntergeladen.

10. Löschen Sie die vorhandene Datei InstallerProfile.cfg unter Agent_Install_Location, und ersetzen Sie sie durch die Datei InstallerProfile.cfg, die Sie im vorherigen Schritt heruntergeladen haben.
11. Starten Sie den Connectivity Agent neu, indem Sie den folgenden Befehl ausführen:

    java -jar connectivityagent.jar

12. Aktivieren Sie die Integrationen erneut, die sich in der upgegradeten Agent-Gruppe befinden.

Dateiserver: Fügen Sie der Ausnahmeliste der internen Firewall die IP-Adresse des Dateiservers hinzu

Die Oracle Integration-IP-Adresse der 2. Generation funktioniert nach dem Upgrade noch vier Monate lang. Dann werden sie von Oracle außer Betrieb genommen. Oracle empfiehlt jedoch, die Firewallausnahmeliste so zu aktualisieren, dass die neue IP-Adresse jetzt verwendet wird. Auf diese Weise können Sie nicht riskieren, die zukünftige Aktualisierung der Ausnahmeliste zu vergessen.

So rufen Sie die IP-Adresse des Dateisystems ab:

1. Melden Sie sich bei Oracle Integration 3 an.
2. Klicken Sie im Navigationsbereich auf Einstellungen, Dateiserver, Einstellungen.
3. Rufen Sie unter "Allgemein" die IP-Adresse für den SFTP-Server des Dateisystems ab.

Dateiserver: Aktualisieren Sie Integrationen und SFTP-Clients, um die neuen IP- und Portwerte zu verwenden

Die IP- und Portwerte von Oracle Integration der 2. Generation funktionieren nach dem Upgrade noch vier Monate lang. Dann werden sie von Oracle außer Betrieb genommen. Oracle empfiehlt jedoch, Ihre Integrationen und SFTP-Clients so zu aktualisieren, dass sie die neuen Werte sofort verwenden. So kann es nicht passieren, dass Sie die Aktualisierung dieser Werte später vergessen.

1. Melden Sie sich bei Oracle Integration 3 an.
2. Klicken Sie im Navigationsbereich auf Einstellungen, Dateiserver, Einstellungen.
3. Rufen Sie unter "Allgemein" die IP- und Portwerte für den SFTP-Server des Dateiservers ab.
4. Aktualisieren Sie alle Integrationen, die den Dateiserver aufrufen, sodass sie die neuen IP- und Portwerte verwenden.
5. Aktualisieren Sie alle SFTP-Clients so, dass sie die neuen IP- und Portwerte verwenden.

Integrierte Oracle Integration-API-Aufrufe von der Basisauthentifizierung in OAuth ändern

In Oracle Integration der 2. Generation können Sie die Basisauthentifizierung verwenden, um die Oracle Integration-REST-API und die REST-API für Dateiserver zu verwenden. In Oracle Integration 3 müssen Sie OAuth verwenden. Sie müssen alle Clients, Skripte, Integrationen und Befehle aktualisieren, die mit der Oracle Integration-REST-API oder der Dateiserver-REST-API eine Verbindung mit OAuth herstellen. Weitere Informationen zur Unterstützung von Authentifizierungsmethoden finden Sie unter Wann wird Basisauthentifizierung in Oracle Integration 3 unterstützt. Einzelheiten zur Verwendung von OAuth mit der Oracle Integration-REST-API finden Sie unter Sicherheit, Authentifizierung und Autorisierung oder mit der Dateiserver-REST-API finden Sie unter Sicherheit, Authentifizierung und Autorisierung.

Prüfen Sie Integrationen, wenn Sie Aktivierungsfehler ignorieren oder Fehler bei Startplan ignorieren ausgewählt haben

• Wenn Sie Aktivierungsfehler ignorieren ausgewählt haben, prüfen Sie den Status aller Integrationen, und aktivieren Sie Integrationen nach Bedarf.
• Wenn Sie Fehler bei Planstart ignorieren ausgewählt haben, prüfen Sie die Pläne Ihrer Integrationen, und starten Sie sie bei Bedarf manuell.

sich um alle Anforderungen kümmern, die während der Ausfallzeit des Upgrades abgelehnt wurden

Oracle Integration hat alle Anforderungen abgelehnt, die während der Upgradeausfallzeit gesendet wurden. Führen Sie bei Bedarf Aktionen für Anforderungen aus, die Clients während der Ausfallzeit an Oracle Integration gesendet haben.

Serviceinstanznamen ändern

Nach dem Upgrade von Oracle Integration der 2. Generation auf Oracle Integration 3 wird der Mandantenname am Ende des Serviceinstanznamens (Anzeigenamen der Serviceinstanz) im folgenden Format angehängt: <service instance name>-<tenancy name>. Beispiel: Wenn der Serviceinstanzname myinstance und der Mandantenname mytenancy lautet, wird er nach dem Upgrade auf Oracle Integration 3 in myinstance-mytenancy geändert. Wenn Ihre Integrationen also den Serviceinstanznamen verwenden, aktualisieren Sie die Integrationen so, dass sie den neuen Serviceinstanznamen verwenden. Andernfalls sind sie nicht erfolgreich.

• Oracle CX Sales und B2B Service-Adapter
• Oracle ERP Cloud-Adapter
• Oracle HCM Cloud-Adapter
• Oracle Field Service Cloud-Adapter
• Salesforce-Adapter
• ServiceNow-Adapter

Grundlegende Routingintegrationen: Grundlegende Routingintegrationen werden in Oracle Integration 3 nicht unterstützt und zeigen eine leere Leinwand an. Sie müssen diese Integrationen löschen und sie als anwendungsgesteuerte Integrationen neu erstellen.

• Automation Anywhere-Adapter
• Evernote-Adapter
• Oracle Messaging Cloud Service-Adapter
• Oracle Monetization Cloud-Adapter
• Oracle Taleo Business Edition-(TBE-)Adapter
• UiPath Robotic Process Automation-Adapter

Sie müssen REST-Adapterverbindungen erstellen, um die gelöschten nicht unterstützten Adapterverbindungen zu ersetzen.

Sie müssen diese Integrationen wie folgt überarbeiten:

1. Löschen Sie den Aufruf der nicht unterstützten Adapterverbindung, und ersetzen Sie ihn durch die neue REST-Adapterverbindung.
2. Nachdem die Integration konfiguriert und aktiviert wurde, starten Sie den Zeitplan.

Sie müssen neue Verbindungen mit entsprechenden Oracle Integration 3-Adaptern erstellen, um die gelöschten benutzerdefinierten Adapterverbindungen zu ersetzen.

Sie müssen diese Integrationen wie folgt überarbeiten:

1. Löschen Sie den Aufruf der benutzerdefinierten Adapterverbindung, und ersetzen Sie ihn durch die neu erstellte Verbindung.
2. Nachdem die Integration konfiguriert und aktiviert wurde, starten Sie den Zeitplan.

Sie müssen diese Integrationen überarbeiten, damit sie dieses Muster nicht verwenden. Beispiel: Verwenden Sie einen listFile-Vorgang, um die Dateien aufzulisten, und verwenden Sie eine for-each-Aktion, um jede Datei einzeln zu lesen.

• Metadatenkatalog-URL
• Swagger-Definitions-URL
• RAML-Definitions-URL

Sie müssen diese Verbindungen mit einer der folgenden Methoden aktualisieren:

• Wenn Sie RAML oder den Oracle-Metadatenkatalog verwendet haben, können Sie den REST-Serviceprovider nach einer Swagger-Definition fragen (sofern verfügbar). Für Oracle Fusion Applications muss eine Swagger-Option verfügbar sein, da dies eine Richtlinie für alle Oracle Fusion Applications ist.

  Wenn keine alternative Spezifikation verfügbar ist, verwenden Sie die Basisvorlage im REST-Adapter, indem Sie die REST-API-Basis-URL als Verbindungs-URL auswählen und die Ziel-API-Anforderung mit dem Konfigurationsassistenten für den Adapterendpunkt definieren.

• Wenn Sie RAML verwenden, können Sie auch RAML in eine OpenAPI-Spezifikation konvertieren.
• Wenn Sie die Swagger-Definitions-URL verwendet haben, können Sie mit der neuen einheitlichen Option des REST-Adapters alle OpenAPI-Spezifikationen in einem einzigen Feld angeben. Diese Option bietet robustere und vollständigere Unterstützung für die Swagger/OpenAPI-Spezifikationen.

Siehe Verbindungseigenschaften für den Aufruf von Verbindungen konfigurieren in REST-Adapter mit Oracle Integration 3 verwenden.

Sie müssen diese Integrationen wie folgt überarbeiten:

1. Integration aktivieren
2. Nachdem die Integration aktiviert wurde, starten Sie den Zeitplan.

Sie müssen den benutzerdefinierten Endpunkt neu erstellen.

Wenn Sie Visual Builder verwenden und über einen benutzerdefinierten Endpunkt oder alternative benutzerdefinierte Endpunkte verfügen, aktualisieren Sie den CNAME des benutzerdefinierten Endpunkt-DNS-Datensatzes mit dem Hostnamen der Visual Builder-Instanz.

Hinweis: Sie können nach dem Upgrade nicht denselben benutzerdefinierten Endpunkt sowohl für Visual Builder als auch für Oracle Integration verwenden. Wenn Sie denselben benutzerdefinierten Endpunkt verwenden, können Probleme auftreten.

Zusätzliche Aufgaben nach dem Upgrade abschließen

Vollständige Aktualisierungen erforderlich, damit die Integrationsinstanz-ID in alphanumerisch geändert wird

Diese Änderung wirkt sich auf Integrationsabläufe aus, die darauf basieren, dass die Integrationsinstanz-ID eine Ganzzahl ist (z.B. wenn die Integrationsinstanz-ID in einer Datenbankspalte mit einem numerischen Datentyp geparst wird). Wenn Sie diese Integrationen nach dem Upgrade unverändert ausführen, ohne Flowid als numerisches Post-Upgrade aktivieren in den Upgradeeinstellungen auszuwählen, wird ein Fehler bei der Konvertierungsausnahme angezeigt.

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

Um die Änderungen zu berücksichtigen, können Sie entweder die Zuordnung in jeder betroffenen Integration aktualisieren oder den Datentyp der Spalte aktualisieren, in der die Integrationsinstanz-IDs in Ihrer Datenbank gespeichert sind.

Hinweis: Die hier behandelten vorgeschlagenen Methoden basieren auf Oracle-Datenbankservices (wie Oracle Autonomous Database). Für andere Datenbanktypen sind möglicherweise zusätzliche Schritte erforderlich.

Methode 1: Mapping in jeder betroffenen Integration aktualisieren

Ordnen Sie in jeder betroffenen Integration das Zielattribut, das den Integrationsinstanz-ID-Wert enthält, einem neuen numerischen Wert (UNIX-Zeit) zu. Die UNIX-Zeit ist die Anzahl der Sekunden seit der UNIX-Epoche, die mit dem 1. Januar 1970 um 00:00:00 UTC beginnen. Dieser Wert wird jede Sekunde erhöht. Der Wert kann als Ganzzahl geparst werden und erfordert daher keine Datenbankänderungen.

Vor dem Upgrade sollten Sie angegeben haben, welche Integrationen betroffen sind, wie in der Vorabprüfung der Instanz-ID-Aktion beschrieben.

Führen Sie die folgenden Schritte für jede betroffene Integration aus:

1. Sie können eine aktive Integration nicht bearbeiten. Wenn die Integration also aktiv ist, deaktivieren Sie sie.
2. Öffnen Sie die Integration.
3. Doppelklicken Sie auf die Zuordnung, die die Integrationsinstanz-ID enthält.
4. Suchen Sie das Zielattribut, das den Wert für die Integrationsinstanz-ID enthält, und klicken Sie darauf.
5. Klicken Sie im Ausdruck-Generator auf .
6. Geben Sie den folgenden Ausdruck ein:

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

7. Klicken Sie auf , um den Ausdruck zu speichern.
8. Kehren Sie zur Integrationsleinwand zurück, und speichern Sie die Änderungen.

Methode 2: Datentyp der betroffenen Spalte in der Datenbank aktualisieren

Ändern Sie in der Datenbank den Datentyp der Spalte mit der Integrationsinstanz-ID in string (CHAR/VARCHAR). Dieser Ansatz beinhaltet keine Änderungen an Ihren Integrationen.

Hinweis: Die Lösung ist auf Datenbankaktionen beschränkt, die mit dem Vorgang SQL-Anweisung ausführen erstellt wurden.

Da die Datenbankspalte bereits ausgefüllt ist, können Sie nicht nur den Datentyp der Spalte ändern. Stattdessen führen Sie die folgenden Schritte durch. Führen Sie die folgenden Schritte in SQL Developer aus.

1. Notieren Sie sich den Spaltennamen der Instanz-ID.
2. Fügen Sie eine temporäre Spalte (z.B. TEMP) vom Typ VARCHAR hinzu.

   SQL-Syntax:

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

   Beispiel:

   ALTER TABLE FLOW_MANAGEMENT ADD TEMP VARCHAR2(50);

3. Kopieren Sie Werte aus der Quellspalte (die Instanz-IDs enthält) in die temporäre Spalte.

   SQL-Syntax:

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

   Beispiel:

   UPDATE FLOW_MANAGEMENT SET TEMP = FLOWID;

4. Setzen Sie die Quellspaltenwerte auf NULL.

   SQL-Syntax:

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

   Beispiel:

   UPDATE FLOW_MANAGEMENT SET FLOWID = NULL;

5. Aktualisieren Sie den Quellspaltentyp von NUMBER in VARCHAR.

   SQL-Syntax:

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

   Beispiel:

   ALTER TABLE FLOW_MANAGEMENT MODIFY FLOWID VARCHAR2(50);

6. Kopieren Sie die Instanz-ID-Werte aus der temporären Spalte zurück in die Quellspalte.

   SQL-Syntax:

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

   Beispiel:

   UPDATE FLOW_MANAGEMENT SET FLOWID = TEMP;

7. Entfernen Sie die temporäre Spalte.

   SQL-Syntax:

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

   Beispiel:

   ALTER TABLE FLOW_MANAGEMENT DROP COLUMN TEMP;

1. Melden Sie sich als Administrator bei Oracle Integration an.
2. Klicken Sie auf Einstellungen und dann auf Sonstiges.
3. Ändern Sie den Ablauf-ID-Typ in Alphanumerisch, und klicken Sie auf Speichern.

Verifizierungsaufgaben nach dem Upgrade Ihrer Organisation durchführen

Schließen Sie die Post-Upgrade-Verifizierungsaufgaben Ihrer Organisation ab, wie z.B. Regressionstests.

Führen Sie Integrationslasttests in einer Entwicklungs-/Stufeninstanz durch, bevor Sie Integrationen in eine Produktionsinstanz verschieben.