Documentation Oracle Cloud Infrastructure

Terminer les tâches préalables à la mise à niveau

Vous devez effectuer plusieurs tâches à l'approche de la date de mise à niveau pour éviter les erreurs lors de la mise à niveau et pour effectuer une transition en douceur vers la nouvelle instance Oracle Integration 3 après la mise à niveau.

Récapitulatif des tâches préalables à la mise à niveau

Ce tableau récapitule les tâches préalables à la mise à niveau pour chaque zone. Les détails de chaque tâche sont liés dans le tableau et affichés dans les sections suivantes.

Aire Tâches
Agent de connectivité
Instances
B2B for Oracle Integration
Intégrations
Adaptateurs
Visual Builder
Autoriser les listes
Communication
Travaux de développement

Tâches préalables à la mise à niveau de l'agent de connectivité

Tâche Propriétaire standard Description des tâches

Préparation de la conversion en OAuth 2.0

 Équipe des opérations de développement Dans Oracle Integration Generation 2, l'agent de connectivité utilise l'autorisation de base pour appeler des adresses Oracle Integration. Oracle Integration 3 utilise plutôt l'authentification basée sur un jeton OAuth 2.0, ce qui est plus sécurisé. Au cours de la mise à niveau, les connexions des agents de connectivité sont automatiquement converties de l'authentification de base à l'utilisation de OAuth 2.0, de sorte que vous n'avez pas besoin de recréer manuellement les connexions vous-même.

Toutefois, avant la mise à niveau, vous devez préparer cette conversion en autorisant la sortie du réseau d'agent vers la conception et l'exécution Oracle Integration, et vers Oracle Identity Cloud Service ou le domaine d'identité, comme décrit dans Mise à jour des listes d'autorisation.

Et, après la mise à niveau, à la suite de la nouvelle méthode d'authentification, vous verrez un trafic supplémentaire vers votre pare-feu. Ce trafic supplémentaire se produit car l'agent de connectivité doit communiquer avec le serveur pour obtenir de nouveaux jetons.

Pour plus d'informations sur la prise en charge de OAuth 2.0 dans Oracle Integration 3, reportez-vous à Quand l'authentification de base est-elle prise en charge dans Oracle Integration 3 ?.

Mettre à jour les paramètres de la liste d'autorisation

 Équipe des opérations de développement Si votre organisation utilise des listes d'autorisation, vous devez mettre à jour vos paramètres de liste d'autorisation pour vos agents de connectivité. La colonne Statut de la liste d'autorisation de la section Statut de l'agent de connectivité affiche le statut de tous les agents de connectivité de votre instance, indiquant si la liste d'autorisation a été mise à jour de façon appropriée.

A l'approche de la fenêtre de mise à niveau, effectuez les tâches décrites dans Mise à jour des listes d'autorisation.

Les agents qui sont hors ligne pendant la mise à niveau ou ne répondent pas aux exigences de mise à niveau ne seront pas mis à niveau, auquel cas vous devrez effectuer des étapes de post-mise à niveau pour retrouver la connectivité.

Définir la propriété Cache du serveur proxy

 Équipe des opérations de développement Définissez la propriété Cache de votre serveur proxy pour que les URL Oracle Integration soient actualisées aussi fréquemment que possible.

Par exemple, si votre serveur proxy utilise la propriété Cache-ExpiresDefault, définissez-la sur now.

Tâches préalables à la mise à niveau d'instance

Tâche Propriétaire standard Description des tâches

Commencez à capturer le flux d'activités dans la console Oracle Cloud

 Administrateur Si vous ne le fais pas déjà, commencez de capturer le flux de données d'activités dans la console Oracle Cloud.

Voici pourquoi : le flux de données d'activités n'est pas migré. Toutefois, si vous capturez les données dans la console Oracle Cloud, vous consommez toujours l'accès aux données historiques. Reportez-vous à Capture du flux des données d'activités dans la console Oracle Cloud.

Configuration complète des règles réseau

 Administrateur réseau Cette tâche peut être effectuée avant la mise à niveau ou immédiatement après la mise à niveau.

Si l'une de vos connexions d'intégration cible un service Oracle Cloud Infrastructure qui prend en charge les règles réseau, telles qu'Oracle Cloud Infrastructure Object Storage ou Oracle Autonomous Database, et que vous avez activé ces règles, vous devez effectuer toute configuration de règles réseau, y compris l'ajout du VCN de service Oracle Integration à la règle.

Reportez-vous à Assurer la connectivité.

B2B pour les tâches préalables à la mise à niveau d'Oracle Integration

Tâche Propriétaire standard Description des tâches

Assurez-vous que tous les mots de passe B2B du fichier de clés correspondent

 Administrateur Assurez-vous que tous les mots de passe du fichier de clés sont identiques. Votre fichier de certificat d'identité (JKS) nécessite deux ensembles de mots de passe : Mots de passe de clé et Mot de passe de fichier de clés. Tous les mots de passe doivent être identiques. S'ils ne sont pas identiques, modifiez les mots de passe à mettre en correspondance et chargez de nouveau le fichier de clés d'accès.

Si vous ne disposez pas du dernier fichier de clés téléchargé, recréez le fichier.

Lors du téléchargement du certificat :

  • Pour Type, sélectionnez X.509 (SSL Transport).
  • Dans Catégorie, sélectionnez Identité.

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

Attention :

Si vous n'effectuez pas cette étape, la mise à niveau échouera.

Tâches préalables à la mise à niveau des intégrations

Tâche Propriétaire standard Description des tâches

Déterminer les actions à effectuer avec les instances en échec

 Équipe des opérations de développement Les instances d'intégration en échec appartiennent à l'une des catégories suivantes, qui détermine la façon dont vous pouvez les gérer :
  • Instances asynchrones en échec - récupérables

    Soumettez une nouvelle fois les instances en échec et videz la file d'attente. Reportez-vous à Nouvelle soumission des messages en échec.

    En cas d'échec d'une instance asynchrone lors de la mise à niveau de l'instance, vous ne pouvez pas la soumettre à nouveau dans Oracle Integration 3, du moins pas immédiatement. La resoumission est impossible car les données d'exécution, y compris les erreurs et toutes les données de flux d'activités, ne sont pas migrées vers Oracle Integration 3 dans le cadre de la mise à niveau. Cependant, une fois la mise à niveau terminée, vous pouvez exécuter l'intégration dans Oracle Integration 3, collecter les données d'erreur, puis effectuer une nouvelle soumission.

  • Instances synchrones en échec - non récupérable

    Vous ne pouvez pas soumettre à nouveau les instances d'intégration synchrones ; elles ne sont donc pas récupérables.

Remarque

Si vous capturez une donnée de flux d'activités dans la console Oracle Cloud, vous pouvez toujours visualiser l'activité historique de l'intégration. Reportez-vous à Utilisation d'OCI Logging pour analyser l'activité d'intégration.

Décider quoi faire avec les messages asynchrones

 Équipe des opérations de développement Décidez des actions à effectuer avec les messages asynchrones du côté client pendant la durée du temps d'arrêt.

Voici pourquoi : pendant le temps d'inactivité, Oracle Integration rejette toutes les demandes entrantes. Pour vous préparer, vous pouvez effectuer les opérations suivantes :

  • Avant le démarrage de la mise à niveau, suspendez tous les messages asynchrones côté client.

    Avec cette approche, le client n'envoie pas les messages et Oracle Integration ne les rejette pas.

    Si vous choisissez cette option, veillez à connaître les heures de début et de fin de la mise à niveau.

  • Une fois la mise à niveau terminée, déterminez les étapes suivantes appropriées pour les messages rejetés.

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

Développement Si vous n'avez pas déjà mis à jour vos appels d'API pour utiliser OAuth tout en remplissant les prérequis, faites-le maintenant ou immédiatement après la mise à niveau.

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.

Tâches préalables à la mise à niveau des adaptateurs

Tâche Propriétaire standard Description des tâches

Arrêter d'utiliser des adaptateurs Microsoft mis hors service

 Equipe de développement Microsoft a mis hors service les API REST de Microsoft Outlook en novembre 2022. Si vous utilisez l'un des adaptateurs suivants, vous devez plutôt utiliser les API REST Microsoft Graph.
  • Adaptateur de calendrier Microsoft Office 365

    Reportez-vous à Page Appeler des opérations dans le guide Utilisation de l'adaptateur Microsoft Office 365 avec Oracle Integration 3.

  • Adaptateur de contacts Microsoft Office 365

    Reportez-vous à Appel de la page Opérations dans le guide Utilisation de l'adaptateur Microsoft Office 365 People avec Oracle Integration 3.

  • Adaptateur Outlook Microsoft Office 365

    Reportez-vous à Appeler la page des opérations dans le guide Utilisation de l'adaptateur Microsoft Office 365 Outlook et d'Oracle Integration 3.

Tâches préalables à la mise à niveau de Visual Builder

Tâche Propriétaire standard Description des tâches
Préparez Visual Builder avec une adresse personnalisée utilisant SSL pour la mise à niveau Administrateur Si Visual Builder est activé, que vous utilisez une adresse personnalisée ou d'autres adresses personnalisées et que vous utilisez SSL, procédez comme suit :
  1. Afin d'autoriser l'accès à la clé secrète de certificat SSL pour la mise à niveau, ajoutez les stratégies suivantes, en remplaçant MySecretCompartment par le compartiment qui inclut les clés secrètes de certificat 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
  2. Mettez à jour les paramètres de locataire et d'application Visual Builder, ainsi que toutes les applications d'intégration, de sorte qu'ils pointent vers l'URL Oracle Integration Generation 2 d'origine plutôt que vers l'adresse personnalisée. Lors de la mise à niveau, l'adresse personnalisée sera configurée dans Visual Builder. Ainsi, après la mise à niveau, seules les applications Visual Builder seront accessibles via l'adresse personnalisée.

Préparer Visual Builder pour la mise à niveau

Équipe des opérations de développement Effectuez les tâches décrites dans Préparation de Visual Builder pour la mise à niveau dans Administration d'Oracle Visual Builder dans Oracle Integration 3.
Présentation des problèmes connus Équipe des opérations de développement Reportez-vous à Problèmes connus pour les applications en direct/en préparation après la mise à niveau vers Oracle Integration 3 dans Problèmes connus pour Oracle Integration 3 pour les problèmes susceptibles de faire en sorte que les applications en direct ou intermédiaires ne fonctionnent pas correctement après la mise à niveau vers Oracle Integration 3.