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

Assurez l'accès à l'instance

Immédiatement après la mise à niveau

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

Assurer la connectivité

Immédiatement après la mise à niveau

1. Configuration complète des règles de réseau
2. Charger de nouveaux certificats d'identité pour les connexions
3. Rétablir 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

   Terminez cette tâche dans la semaine suivant 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

   Terminez cette tâche dans la semaine suivant la mise à niveau.

Assurer le fonctionnement des intégrations

Immédiatement après la mise à niveau

1. Remplacez les appels de l'API Developer pour Oracle Integration 3 de l'authentification de base par OAuth
2. Vérifier les intégrations si vous avez sélectionné Ignorer les échecs d'activation ou Ignorer les échecs de démarrage de programmation
3. Prendre soin des demandes rejetées pendant le temps d'arrêt de la mise à niveau
4. Modifier le nom de l'instance de service
5. Assurez-vous que les intégrations sont mises à jour au format le plus récent pris en charge

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

Immédiatement après la mise à niveau

Effectuer les tâches post-mise à niveau de Visual Builder

Immédiatement après la mise à niveau

Effectuer les tâches d'automatisation des processus après la mise à niveau

Immédiatement après la mise à niveau

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

Dans les deux semaines suivant la mise à niveau

Vérifiez la nouvelle instance Oracle Integration 3

La mise à niveau est terminée si l'interface ressemble à ceci :

Mettre à jour la politique IAM avec le nouvel OCID

Administrateur de politique IAM

1. Connectez-vous à la console Oracle Cloud.
2. Obtenez la nouvelle valeur OCID de l'instance Oracle Integration 3. Voir Affichage des détails d'une instance.
3. Mettez à jour l'OCID dans votre politique IAM. Pour obtenir des instructions sur la mise à jour des énoncés dans une politique existante, voir Utilisation de la console dans la documentation sur 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 Oracle Cloud Console.
2. Ouvrez le menu de navigation et cliquez sur Services de développement.
3. Sous Intégration d'applications, cliquez sur Integration.
4. Cliquez sur le nom de la nouvelle instance Oracle Integration 3.
5. À droite du champ URL de la console de service, cliquez sur Copier.
6. Partagez l'URL avec toute personne qui en a besoin.

Configuration complète des règles de réseau

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

   Voir Affichage des détails d'une instance.

3. Suivez les règles pour votre service cible. Par exemple, pour Oracle Autonomous Database Serverless, voir Configurer des listes de contrôle d'accès lors du provisionnement ou du clonage d'une instance dans Utilisation d'Oracle Autonomous 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, ajoutez l'adresse IP sortante OIC que vous avez collectée lors de la mise à jour de vos autres listes d'autorisation avant la mise à niveau.

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é, les certificats d'identité auraient été supprimés lors de la mise à niveau. Vous devez donc générer de nouveaux certificats d'identité et configurer de nouveaux JKS.

Effectuez les étapes suivantes pour charger un nouveau certificat d'identité, tester les connexions qui utilisent le certificat d'identité et activer les intégrations qui utilisent les connexions :

1. Chargez un nouveau certificat d'identité.

   Voir Charger un certificat SSL dans Utilisation d'intégrations dans Oracle Integration 3.

2. Testez les connexions qui utilisent le certificat d'identité afin que leur statut passe de Draft (Provisoire) à Configured (Configuré).

   Voir Tester la connexion dans Utilisation d'intégrations dans Oracle Integration 3.

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

   Voir Activer une intégration dans Utilisation d'intégrations dans Oracle Integration 3.

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

Préalables

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

• Vous avez dû ajouter les adresses IP IAM et Oracle Integration 3 à vos listes d'autorisation avant la mise à niveau, comme décrit dans Mettre à jour les listes d'autorisation.
• Ajoutez l'adresse IP de conception d'Oracle Integration 3 à vos listes d'autorisation. Utilisez la commande suivante pour obtenir l'adresse IP de conception, en remplaçant region par la région à partir de votre 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éalables de l'agent sont terminés :
   1. Assurez-vous que l'agent de connectivité utilise JDK 17. Si ce n'est pas le cas, réglez les variables d'environnement JAVA_HOME et PATH à JDK17.
   2. Assurez-vous que l'agent utilise PKCS12 KeyStore. Si ce n'est pas le cas, convertissez-le à l'aide des étapes suivantes.
      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 JKS KeyStore en 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 volet de navigation, cliquez sur Conception, puis sur Agents.
   2. Cliquez sur Télécharger, puis sur Agent de connectivité.
4. Extrayez oic_conn_agent_installer.zip dans un nouveau répertoire sur votre serveur d'agent de connectivité.
5. Supprimez le dossier lib de votre agent de connectivité existant sous Agent_Install_Location/agenthome/ et remplacez-le par le dossier lib à partir 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, dans la page Agents (Agents), pointez le groupe d'agents sur le groupe, 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 qui se trouvent dans le 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 d'Oracle Integration Génération 2 continue de fonctionner pendant quatre mois après la mise à niveau, puis 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 risquez pas d'oublier de mettre à jour la liste d'autorisation à l'avenir.

Pour obtenir l'adresse IP du serveur de fichiers :

1. Connectez-vous à Oracle Integration 3.
2. Dans le volet de navigation, cliquez sur Paramètres, puis successivement sur Serveur de fichiers et 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 d'Oracle Integration Génération 2 continuent de fonctionner pendant quatre mois après la mise à niveau, avant d'être mises hors service par Oracle. Cependant, Oracle recommande de mettre à jour les intégrations et les clients SFTP pour utiliser les nouvelles valeurs maintenant. 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 volet de navigation, cliquez sur Paramètres, puis successivement sur Serveur de fichiers et 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.

Remplacez les appels de l'API Developer pour Oracle Integration 3 de l'authentification de base par OAuth

Dans Oracle Integration Génération 2, vous pouvez utiliser l'authentification de base pour utiliser l'API REST d'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éveloppement pour Oracle Integration 3 ou l'API de développement pour serveur de fichiers pour se connecter à l'aide de OAuth. Pour plus d'informations sur la prise en charge des méthodes d'authentification, voir 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, voir Sécurité, authentification et autorisation dans API de développement pour Oracle Integration 3 ou Sécurité, authentification et autorisation dans API de développement 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 intégrations s'il y a lieu.
• Si vous avez sélectionné Ignorer les échecs de démarrage de programmation, vérifiez les programmations d'intégration et démarrez-les manuellement si nécessaire.

Prendre soin des demandes rejetées pendant le temps d'arrêt de la mise à niveau

Oracle Integration a rejeté toutes les demandes envoyées pendant le temps d'arrêt de la mise à niveau. Si nécessaire, effectuez des actions sur les demandes que des clients ont envoyées à Oracle Integration pendant le temps d'arrêt.

Modifier le nom de l'instance de service

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

Assurez-vous que les intégrations sont mises à jour au format le plus récent 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 d'acheminement de base : Les intégrations d'acheminement 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 basées sur l'application.

• Adaptateur Automation Anywhere
• Adaptateur Evernote
• Adaptateur Oracle Messaging Cloud Service
• Adaptateur Oracle Monetization Cloud
• Adaptateur Oracle Taleo Business Edition (TBE)
• Adaptateur d'automatisation des processus par la robotique UiPath

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 à l'aide des étapes suivantes :

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 de nouvelles connexions à l'aide d'adaptateurs Oracle Integration 3 équivalents pour remplacer les connexions d'adaptateur personnalisé supprimées.

Vous devez retravailler ces intégrations à l'aide des étapes suivantes :

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, lancez 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 lister les fichiers et utilisez une action for-each pour lire chaque fichier individuellement.

• URL de catalogue de métadonnées
• URL de définition de la spécification 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'une directive pour toutes les applications Oracle Fusion Applications.

  Si aucune autre spécification n'est disponible, utilisez le modèle de base dans 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 de configuration du point d'extrémité de l'adaptateur.

• Une autre option si vous utilisiez RAML est de convertir RAML en 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 spécifier toutes les spécifications OpenAPI dans un seul champ. Cette option assure une prise en charge plus robuste et complète des spécifications Swagger/OpenAPI.

Voir Configurer les 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 à l'aide des étapes suivantes :

1. Activer l'intégration
2. Une fois l'intégration activée, lancez la programmation.

Vous devez recréer votre point d'extrémité personnalisé.

Note : Vous ne pouvez pas utiliser le même point d'extrémité personnalisé pour Visual Builder et Oracle Integration après la mise à niveau. Si vous utilisez le même point d'extrémité personnalisé, vous risquez de rencontrer des problèmes.

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

Mises à jour complètes requises pour le passage de l'ID instance d'intégration à des valeurs alphanumériques

Cette modification a une incidence sur les flux d'intégration qui sont basés sur le fait que l'instance d'intégration est un nombre entier (par exemple, lorsque l'instance d'intégration est analysée 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 flowid 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 tenir compte de la modification, vous pouvez mettre à jour le mappage dans chaque intégration touchée ou mettre à jour le type de données de la colonne qui stocke les ID instances d'intégration dans votre base de données.

Note : 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 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 touchée, mappez l'attribut cible qui contient la valeur de l'ID instance d'intégration à une nouvelle valeur numérique, l'heure UNIX. L'heure UNIX est le nombre de secondes qui se sont écoulées depuis l'époque UNIX, à partir du 1er janvier 1970 à 00:00:00 UTC. Cette valeur augmente chaque seconde. La valeur peut être analysée en tant qu'entier et ne nécessite donc aucune modification de la base de données.

Avant la mise à niveau, vous devriez avoir noté quelles intégrations sont touchées, comme décrit dans la vérification préalable à l'action d'ID instance.

Effectuez les étapes suivantes pour chaque intégration touchée :

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 le mappage qui inclut l'ID instance d'intégration.
4. Recherchez l'attribut cible qui contient la valeur de l'ID 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. Retournez au canevas d'intégration et enregistrez vos modifications.

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

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

Note : La solution est limitée aux actions de base de données créées à l'aide de l'opération Exécuter un énoncé SQL.

Comme la colonne de base de données est déjà alimentée, vous ne pouvez pas simplement modifier le type de données de la colonne. Au lieu de cela, 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 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. Réglez les valeurs de colonne source à 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 à 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 de l'ID 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. Remplacez le type d'ID flux par Alphanumeric, puis cliquez sur Save (Enregistrer).

Effectuer les tâches de vérification après la mise à niveau de votre organisation

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

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