Tâches à effectuer après la mise à niveau

Garantir l'accès à l'instance

Immédiatement après la mise à niveau

1. Vérifier la nouvelle instance Oracle Integration 3
2. Mettre à jour la stratégie IAM avec le nouvel OCID
3. Obtenir l'URL de la nouvelle instance et la partager

Garantir la connectivité

Immédiatement après la mise à niveau

1. Configuration complète des règles réseau
2. Télécharger de nouveaux certificats d'identité pour les connexions
3. Récupérer la connectivité avec les agents qui n'ont pas été mis à niveau
4. Serveur de fichiers : ajoutez l'adresse IP du serveur de fichiers à votre liste d'autorisation de pare-feu interne.

   Effectuez cette tâche dans la semaine qui suit la mise à niveau.

5. Serveur de fichiers : mettez à jour les intégrations et les clients SFTP pour utiliser les nouvelles valeurs d'adresse IP et de port

   Effectuez cette tâche dans la semaine qui suit la mise à niveau.

S'assurer que les intégrations fonctionnent

Immédiatement après la mise à niveau

1. Modifier l'API Developer pour les appels Oracle Integration 3 de l'authentification de base à OAuth
2. Vérifiez les intégrations si vous avez sélectionné Ignorer les échecs d'activation ou Ignorer les échecs de démarrage de programmation
3. Prenez en charge toutes les demandes qui ont été rejetées pendant le temps d'arrêt de la mise à niveau
4. Modifier le nom de l'instance du service
5. Assurez-vous que les intégrations sont mises à jour avec le dernier format pris en charge

Effectuer les tâches postérieures à la mise à niveau pour les échecs de prévérification ignorés

Immédiatement après la mise à niveau

Effectuer les tâches Visual Builder après la mise à niveau

Immédiatement après la mise à niveau

Tâches Process Automation après la mise à niveau

Immédiatement après la mise à niveau

Effectuer la vérification après la mise à niveau

Dans les deux semaines de la mise à niveau

Vérifiez la nouvelle instance Oracle Integration 3

La mise à niveau est terminée si l'interface ressemble à ce qui suit :

Mettre à jour la stratégie IAM avec le nouvel OCID

Administrateur de stratégie IAM

1. Connectez-vous à Oracle Cloud Console.
2. Obtenez la nouvelle valeur d'OCID de l'instance Oracle Integration 3. Reportez-vous à Affichage des détails de l'instance.
3. Mettez à jour l'OCID dans votre stratégie IAM. Pour obtenir des instructions sur la mise à jour des instructions dans une stratégie existante, reportez-vous à Utilisation de la console dans la documentation Oracle Cloud Infrastructure.

Obtenir l'URL de la nouvelle instance et la partager

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

Pour obtenir la nouvelle URL :

1. Connectez-vous à la console Oracle Cloud.
2. Ouvrez le menu de navigation et cliquez sur Services de développeur.
3. Sous Intégration d'application, cliquez sur Intégration.
4. Cliquez sur le nom de la nouvelle instance Oracle Integration 3.
5. A droite du champ URL de la console de service, cliquez sur Copier.
6. Partagez l'URL avec tous ceux qui en ont besoin.

Configuration complète des règles réseau

1. Connectez-vous à Oracle Cloud Console.
2. Obtenez la valeur d'OCID de l'instance Oracle Integration 3.

   Reportez-vous à Affichage des détails de l'instance.

3. Suivez les règles du service cible. Par exemple, pour Oracle Autonomous AI Database Serverless, reportez-vous à Configuration des listes de contrôle d'accès lors du provisionnement ou du clonage d'une instance dans Utilisation d'Oracle Autonomous AI Database Serverless.
4. Si le service Oracle Cloud Infrastructure auquel vous accédez se trouve dans une région différente de celle de votre instance Oracle Integration, mettez sur liste d'autorisation l'adresse d'adresse IP sortante OIC que vous avez collectée lorsque vous avez mis à jour vos autres listes d'autorisation avant la mise à niveau.

Télécharger de nouveaux certificats d'identité pour les connexions

Une seule personne de votre organisation doit effectuer ces étapes

Si votre instance inclut des connexions qui utilisent des certificats d'identité, ceux-ci auraient été enlevés lors de la mise à niveau. Vous devez donc générer de nouveaux certificats d'identité et configurer de nouveaux JKS.

Pour télécharger un nouveau certificat d'identité, tester les connexions qui utilisent le certificat d'identité et activer les intégrations qui utilisent les connexions, procédez comme suit :

1. Téléchargez un nouveau certificat d'identité.

   Reportez-vous à Téléchargement d'un certificat SSL dans Utilisation des intégrations dans Oracle Integration 3.

2. Testez les connexions qui utilisent le certificat d'identité afin que leur statut passe de Brouillon à Configuré.

   Reportez-vous à Test de la connexion dans Utilisation des intégrations dans Oracle Integration 3.

3. Activez toutes les intégrations qui utilisent les connexions.

   Reportez-vous à Activation d'une intégration dans Utilisation des intégrations dans Oracle Integration 3.

Renouvelez la connectivité avec les agents qui n'ont pas été mis à niveau

Prérequis

Assurez la connectivité de vos agents de connectivité à Oracle Cloud Infrastructure Identity and Access Management (IAM) et à Oracle Integration 3 :

• Vous devez avoir ajouté les adresses IP IAM et Oracle Integration 3 à vos listes d'autorisation avant de procéder à la mise à niveau, comme décrit dans Mise à jour des listes d'autorisation.
• Ajoutez l'adresse IP de conception Oracle Integration 3 à vos listes d'autorisation. Utilisez la commande suivante pour obtenir l'adresse IP lors de la conception, en remplaçant region par la région à partir de l'URL Oracle Integration 3 :

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

Pour mettre à niveau manuellement vos agents et rétablir la connectivité avec eux :

1. Arrêtez l'agent de connectivité.
2. Assurez-vous que les prérequis de l'agent sont terminés :
   1. Assurez-vous que l'agent de connectivité utilise JDK 17. Si ce n'est pas le cas, définissez les variables d'environnement JAVA_HOME et PATH sur JDK17.
   2. Assurez-vous que l'agent utilise PKCS12 KeyStore. Si ce n'est pas le cas, convertissez-le en procédant comme suit.
      1. Sur le serveur qui héberge l'agent de connectivité, créez une sauvegarde du fichier keystore.jks, qui se trouve dans le dossier suivant :

         Agent_Install_Location/agenthome/agent/cert

      2. Déplacez le fichier de sauvegarde vers un autre dossier.
      3. Convertissez le fichier JKS KeyStore en fichier PKCS12 KeyStore en exécutant la commande suivante à partir de la ligne de commande :

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

      4. Supprimez le fichier keystore.jks à l'emplacement suivant :

         Agent_Install_Location/agenthome/agent/cert

3. Téléchargez le fichier ZIP du programme d'installation de l'agent à partir d'Oracle Integration 3.
   1. Dans le panneau de navigation, cliquez sur Concevoir, puis sur Agents.
   2. Cliquez sur Télécharger, puis sur Agent de connectivité.
4. Extrayez oic_conn_agent_installer.zip vers un nouveau répertoire sur le serveur de l'agent de connectivité.
5. Supprimez le dossier lib de l'agent de connectivité existant sous Agent_Install_Location/agenthome/ et remplacez-le par le dossier lib du fichier ZIP.
6. Supprimez votre fichier version existant sous Agent_Install_Location/agenthome/ et remplacez-le par le fichier version du fichier ZIP.
7. Supprimez votre fichier connectivityagent.jar existant sous Agent_Install_Location et remplacez-le par le fichier connectivityagent.jar du fichier ZIP.
8. Supprimez votre fichier cpi_upgradeutility.jar existant sous Agent_Install_Location et remplacez-le par le fichier cpi_upgradeutility.jar du fichier ZIP.
9. Dans Oracle Integration 3, sur la page Agents, positionnez le pointeur de la souris sur le groupe d'agents, cliquez sur Actions , puis sélectionnez Télécharger la configuration.

   Cette étape télécharge un fichier InstallerProfile.cfg préconfiguré pour le groupe d'agents.

10. Supprimez votre fichier InstallerProfile.cfg existant sous Agent_Install_Location et remplacez-le par le fichier InstallerProfile.cfg que vous avez téléchargé à l'étape précédente.
11. Redémarrez l'agent de connectivité en exécutant la commande suivante :

    java -jar connectivityagent.jar

12. Réactivez les intégrations du groupe d'agents mis à niveau.

Serveur de fichiers : ajoutez l'adresse IP du serveur de fichiers à votre liste d'autorisation de pare-feu interne.

L'adresse IP Oracle Integration Generation 2 continue de fonctionner quatre mois après la mise à niveau. Ensuite, Oracle les met hors service. Cependant, Oracle recommande de mettre à jour votre liste d'autorisation de pare-feu pour utiliser la nouvelle adresse IP maintenant. De cette façon, vous ne pouvez pas oublier de mettre à jour la liste d'autorisation à l'avenir.

Pour obtenir l'adresse IP du serveur de fichier, procédez comme suit :

1. Connectez-vous à Oracle Integration 3.
2. Dans le panneau de navigation, cliquez sur Paramètres, sur Serveur de fichiers, puis sur Paramètres.
3. Sous Général, obtenez l'adresse IP du serveur SFTP du serveur de fichiers.

Serveur de fichiers : mettez à jour les intégrations et les clients SFTP pour utiliser les nouvelles valeurs d'adresse IP et de port.

Les valeurs d'adresse IP et de port Oracle Integration Generation 2 continuent de fonctionner pendant quatre mois après la mise à niveau. Ensuite, Oracle les met hors service. Cependant, Oracle vous recommande de mettre à jour les intégrations et les clients SFTP pour qu'ils utilisent immédiatement les nouvelles valeurs. De cette façon, vous ne risquez pas d'oublier de mettre à jour ces valeurs à l'avenir.

1. Connectez-vous à Oracle Integration 3.
2. Dans le panneau de navigation, cliquez sur Paramètres, sur Serveur de fichiers, puis sur Paramètres.
3. Sous Général, obtenez les valeurs d'adresse IP et de port pour le serveur SFTP du serveur de fichiers.
4. Mettez à jour toutes les intégrations qui appellent le serveur de fichiers afin qu'elles utilisent les nouvelles valeurs d'adresse IP et de port.
5. Mettez à jour tous les clients SFTP afin qu'ils utilisent les nouvelles valeurs d'adresse IP et de port.

Modifier l'API Developer pour les appels Oracle Integration 3 de l'authentification de base à OAuth

Dans Oracle Integration Generation 2, vous pouvez utiliser l'authentification de base pour utiliser l'API REST Oracle Integration et l'API REST de serveur de fichiers. Dans Oracle Integration 3, vous devez utiliser OAuth. Vous devez mettre à jour les clients, scripts, intégrations et commandes qui utilisent l'API de développeur pour Oracle Integration 3 ou l'API de développeur pour le serveur de fichiers pour la connexion à l'aide de OAuth. Pour plus d'informations sur la prise en charge des méthodes d'authentification, reportez-vous à Quand l'authentification de base est-elle prise en charge dans Oracle Integration 3 dans Provisionnement et administration d'Oracle Integration 3. Pour plus de détails sur l'utilisation de OAuth, reportez-vous à Sécurité, authentification et autorisation dans API de développeur pour Oracle Integration 3 ou à Sécurité, authentification et autorisation dans API de développeur pour le serveur de fichiers dans Oracle Integration 3.

Vérifiez les intégrations si vous avez sélectionné Ignorer les échecs d'activation ou Ignorer les échecs de démarrage de programmation

• Si vous avez sélectionné Ignorer les échecs d'activation, vérifiez le statut de toutes vos intégrations et activez-les si nécessaire.
• Si vous avez sélectionné Ignorer les échecs de démarrage de programmation, vérifiez les programmations de vos intégrations et démarrez-les manuellement si nécessaire.

Prenez en charge toutes les demandes qui ont été rejetées pendant le temps d'arrêt de la mise à niveau

Oracle Integration rejette toutes les demandes envoyées pendant le temps d'inactivité de mise à niveau. Si nécessaire, effectuez des actions sur les demandes envoyées par des clients à Oracle Integration pendant le temps d'arrêt.

Modifier le nom d'instance de service

Après la mise à niveau d'Oracle Integration Generation 2 vers Oracle Integration 3, le nom de location est ajouté à la fin du nom d'instance de service (nom d'affichage d'instance de service) au format suivant : <service instance name>-<tenancy name>. Par exemple, si le nom d'instance de service est myinstance et le nom de location est mytenancy, il sera remplacé par myinstance-mytenancy après la mise à niveau vers Oracle Integration 3. Par conséquent, si vos intégrations utilisent le nom d'instance de service, mettez à jour les intégrations afin qu'elles utilisent le nouveau nom d'instance de service ; sinon, elles échoueront.

Assurez-vous que les intégrations sont mises à jour avec le dernier format pris en charge

Si vous activez votre intégration sans effectuer les étapes ci-dessus, vous risquez de rencontrer des problèmes pour les instances d'exécution.

• Adaptateur Oracle CX Sales et B2B Service
• Adaptateur Oracle ERP Cloud
• Adaptateur Oracle HCM Cloud
• Adaptateur Oracle Fusion Field Service
• Adaptateur Salesforce
• Adaptateur ServiceNow

Intégrations de routage de base : les intégrations de routage de base ne sont pas prises en charge dans Oracle Integration 3 et affichent un canevas vide. Vous devez supprimer ces intégrations et les recréer en tant qu'intégrations orientées application.

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

Vous devez créer des connexions d'adaptateur REST pour remplacer les connexions d'adaptateur non prises en charge supprimées.

Vous devez retravailler ces intégrations en procédant comme suit :

1. Supprimez l'appel correspondant à la connexion d'adaptateur non prise en charge et remplacez-le par la nouvelle connexion d'adaptateur REST.
2. Une fois l'intégration configurée et activée, lancez la programmation.

Vous devez créer des connexions à l'aide d'adaptateurs Oracle Integration 3 équivalents pour remplacer les connexions d'adaptateur personnalisé supprimées.

Vous devez retravailler ces intégrations en procédant comme suit :

1. Supprimez l'appel correspondant à la connexion d'adaptateur personnalisée et remplacez-le par la nouvelle connexion que vous avez créée.
2. Une fois l'intégration configurée et activée, démarrez la programmation.

Vous devez retravailler ces intégrations pour qu'elles n'utilisent pas ce modèle. Par exemple, utilisez une opération listFile pour répertorier les fichiers et utilisez une action for-each pour lire chaque fichier individuellement.

• URL de catalogue de métadonnées
• URL de définition Swagger
• URL de définition RAML

Vous devez mettre à jour ces connexions à l'aide de l'une des méthodes suivantes :

• Si vous utilisiez RAML ou le catalogue de métadonnées Oracle, vous pouvez demander à votre fournisseur de services REST une définition Swagger (si disponible). Oracle Fusion Applications doit disposer d'une option Swagger car il s'agit d'un guide pour toutes les applications Oracle Fusion Applications.

  Si aucune autre spécification n'est disponible, utilisez le modèle de base de l'adaptateur REST en sélectionnant l'URL de base de l'API REST comme URL de connexion et en définissant la demande d'API cible à l'aide de l'assistant Configuration de l'adresse d'adaptateur.

• Une autre option si vous utilisiez RAML est de convertir RAML en une spécification OpenAPI.
• Si vous utilisiez l'URL de définition Swagger, vous pouvez utiliser la nouvelle option unifiée de l'adaptateur REST pour indiquer toutes les spécifications OpenAPI dans un seul champ. Cette option fournit une prise en charge plus robuste et complète des spécifications Swagger/OpenAPI.

Reportez-vous à Configuration des propriétés de connexion pour appeler des connexions dans Utilisation de l'adaptateur REST avec Oracle Integration 3.

Vous devez retravailler ces intégrations en procédant comme suit :

1. Activation de l'intégration
2. Une fois l'intégration activée, démarrez la programmation.

Vous devez recréer votre adresse personnalisée.

Remarque : vous ne pouvez pas utiliser la même adresse personnalisée à la fois pour Visual Builder et Oracle Integration après la mise à niveau. Si vous utilisez la même adresse personnalisée, vous risquez de rencontrer des problèmes.

Effectuer des tâches supplémentaires après la mise à niveau

Mises à jour complètes requises pour la modification de l'ID instance d'intégration en alphanumérique

Cette modification affecte les flux d'intégration qui reposent sur le fait que l'ID d'instance d'intégration est un entier (par exemple, lorsque l'ID d'instance d'intégration est analysé dans une colonne de base de données avec un type de données numérique). Après la mise à niveau, si vous exécutez ces intégrations sans modification, sans sélectionner Activer l'ID de flux en tant que valeur numérique après la mise à niveau dans les paramètres de mise à niveau, vous obtiendrez une erreur d'exception de conversion.

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

Pour prendre en compte la modification, vous pouvez soit mettre à jour le mappage dans chaque intégration concernée, soit mettre à jour le type de données de la colonne qui stocke les ID d'instance d'intégration dans votre base de données.

Remarque : les méthodes suggérées décrites ici sont basées sur les services de base de données Oracle (tels qu'Oracle Autonomous AI Database). Des étapes supplémentaires peuvent être requises pour d'autres types de base de données.

Méthode 1 : Mettre à jour le mapping dans chaque intégration affectée

Dans chaque intégration affectée, mappez l'attribut cible qui contient la valeur d'ID d'instance d'intégration avec une nouvelle valeur numérique, l'heure UNIX. L'heure UNIX est le nombre de secondes écoulées depuis l'époque UNIX, à partir du 1er janvier 1970 à la valeur 00:00:00 UTC. Cette valeur est incrémentée toutes les secondes. La valeur peut être analysée sous forme d'entier et ne nécessite donc aucune modification de la base de données.

Avant la mise à niveau, vous devez avoir noté les intégrations concernées, comme décrit dans la prévérification de l'action d'ID d'instance.

Pour chaque intégration concernée, procédez comme suit :

1. Vous ne pouvez pas modifier une intégration active. Par conséquent, si l'intégration est active, désactivez-la.
2. Ouvrez l'intégration.
3. Cliquez deux fois sur la carte qui inclut l'ID d'instance d'intégration.
4. Recherchez l'attribut cible qui contient la valeur d'ID d'instance d'intégration, puis cliquez dessus.
5. Dans le Générateur d'expressions, cliquez sur .
6. Entrez l'expression suivante :

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

7. Cliquez sur pour enregistrer l'expression.
8. Revenez au canevas d'intégration et enregistrez vos modifications.

Méthode 2 : Mettre à jour le type de données de la colonne concernée dans la base de données

Dans la base de données, remplacez le type de données de la colonne contenant l'ID d'instance d'intégration par string (CHAR/VARCHAR). Cette approche n'implique aucune modification de vos intégrations.

Remarque : la solution est limitée aux actions de base de données créées à l'aide de l'opération Exécuter une instruction SQL.

La colonne de base de données étant déjà renseignée, vous ne pouvez pas simplement modifier le type de données de la colonne. A la place, vous allez effectuer les étapes suivantes. Exécutez les étapes suivantes dans SQL Developer.

1. Notez le nom de la colonne Instance ID.
2. Ajoutez une colonne temporaire (par exemple, TEMP) de type VARCHAR.

   Syntaxe SQL :

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

   Exemple :

   ALTER TABLE FLOW_MANAGEMENT ADD TEMP VARCHAR2(50);

3. Copiez les valeurs de la colonne source (celle contenant les ID d'instance) dans la colonne temporaire.

   Syntaxe SQL :

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

   Exemple :

   UPDATE FLOW_MANAGEMENT SET TEMP = FLOWID;

4. Définissez les valeurs de colonne source sur NULL.

   Syntaxe SQL :

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

   Exemple :

   UPDATE FLOW_MANAGEMENT SET FLOWID = NULL;

5. Mettez à jour le type de colonne source de NUMBER vers VARCHAR.

   Syntaxe SQL :

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

   Exemple :

   ALTER TABLE FLOW_MANAGEMENT MODIFY FLOWID VARCHAR2(50);

6. Copiez les valeurs d'ID d'instance de la colonne temporaire dans la colonne source.

   Syntaxe SQL :

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

   Exemple :

   UPDATE FLOW_MANAGEMENT SET FLOWID = TEMP;

7. Supprimez la colonne temporaire.

   Syntaxe SQL :

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

   Exemple :

   ALTER TABLE FLOW_MANAGEMENT DROP COLUMN TEMP;

1. Connectez-vous à Oracle Integration en tant qu'administrateur.
2. Cliquez sur Paramètres, puis sur Divers.
3. Définissez le type d'ID de flux sur Alphanumérique, puis cliquez sur Enregistrer.

Effectuer les tâches de vérification post-mise à niveau de votre organisation

Effectuez les tâches de vérification postérieures à la mise à niveau de votre organisation, telles que les tests de régression.

Effectuer des tests de charge d'intégration dans une instance de développement/étape avant de déplacer les intégrations vers une instance de production.