Documentation sur Oracle Cloud Infrastructure

Effectuer les tâches de avant 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 permettre une transition en douceur vers la nouvelle instance Oracle Integration 3 après la mise à niveau.

Sommaire des tâches de pré-mise à niveau

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

Secteur Tâches
Agent de connectivité
Instances
B2B pour Oracle Integration
Intégrations
Adaptateurs
Visual Builder
Listes d'autorisation
Communication
Travail de développement

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

Tâche Responsable type Description des tâches

Préparez-vous à la conversion à OAuth 2.0

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

Toutefois, avant la mise à niveau, vous devez vous préparer à cette conversion en autorisant le trafic sortant du réseau de l'agent vers la conception et l'exécution d'Oracle Integration, ainsi que vers Oracle Identity Cloud Service ou le domaine d'identité tel que décrit dans Mettre à jour les listes d'autorisation.

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

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

Mettre à jour les paramètres de votre 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 correctement.

À l'approche de votre fenêtre de mise à niveau, effectuez les tâches décrites dans Mettre à jour les listes d'autorisation.

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

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

 Équipe des opérations de développement Définissez la propriété Cache de votre serveur mandataire pour que les URL Oracle Integration s'actualisent aussi fréquemment que possible.

Par exemple, si votre serveur mandataire utilise la propriété Cache-ExpiresDefault, réglez-la à now.

Tâches de pré-mise à niveau de l'instance

Tâche Responsable type Description des tâches

Commencez à saisir le flux de données d'activités dans la console Oracle Cloud

 Administrateur Si vous ne l'avez pas encore fait, commencez à saisir le flux de données d'activités dans la console Oracle Cloud.

Raison : Le flux de données d'activités n'est pas migré. Mais si vous capturez ces données dans la console Oracle Cloud, vous aurez toujours accès aux données historiques. Voir Saisie du flux de données de flux de données d'activités dans la console Oracle Cloud.

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

 Administrateur de 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 de réseau, telles que le service de stockage d'objets pour Oracle Cloud Infrastructure ou Oracle Autonomous Database, et que vous avez activé ces règles, vous devez effectuer toute configuration de règles de réseau, notamment ajouter le VCN du service Oracle Integration à la règle.

Voir Assurer la connectivité.

B2B pour les tâches de pré-mise à niveau d'Oracle Integration

Tâche Responsable type Description des tâches

Assurez-vous que tous les mots de passe B2B correspondent au magasin de clés

 Administrateur Assurez-vous que tous les mots de passe du fichier de magasin de clés sont identiques. Votre fichier de certificat d'identité (JKS) nécessite deux jeux de mots de passe : mots de passe clés et mot de passe du magasin de clés. Tous les mots de passe doivent être identiques. S'ils ne sont pas identiques, modifiez les mots de passe pour qu'ils correspondent, puis rechargez le fichier de magasin de clés.

Si vous n'avez pas le dernier fichier de magasin de clés chargé, recréez le fichier.

Lors du chargement du certificat :

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

Voir Charger un certificat SSL dans Utilisation d'intégrations dans Oracle Integration Génération 2.

Attention :

Si vous ne terminez pas cette étape, la mise à niveau échouera.

Tâches de pré-mise à niveau des intégrations

Tâche Responsable type Description des tâches

Déterminer ce qu'il faut faire avec les instances en échec

 Équipe des opérations de développement Les instances d'intégration qui ont échoué appartiennent à l'une des catégories suivantes, qui détermine comment les traiter :
  • Échec des instances asynchrones - Récupérable

    Resoumettez les instances qui ont échoué et effacez la file d'attente. Voir Resoumettre les messages qui ont échoué.

    Si vous avez un échec d'instance asynchrone lors de la mise à niveau de votre instance, vous ne pouvez pas la soumettre de nouveau dans Oracle Integration 3, du moins pas tout de suite. Vous ne pouvez pas resoumettre une instance, car les données d'exécution, y compris les erreurs et toutes les données de flux de données d'activités, ne sont pas migrées vers Oracle Integration 3 dans le cadre de la mise à niveau. Toutefois, lorsque la mise à niveau sera terminée, vous pourrez exécuter l'intégration dans Oracle Integration 3, collecter des données d'erreur, puis resoumettre.

  • Échec des instances synchrones - Non récupérable

    Vous ne pouvez pas soumettre à nouveau des instances d'intégration synchronisées, elles ne sont donc pas récupérables.

Note

Si vous saisissez des données de flux de données d'activités dans la console Oracle Cloud, vous pouvez toujours voir l'activité historique pour l'intégration. Voir Utiliser la journalisation OCI pour analyser l'activité d'intégration.

Décider quoi faire avec les messages asynchrones

 Équipe des opérations de développement Déterminez ce qu'il faut faire avec les messages asynchrones du côté client pendant la durée du temps d'arrêt.

Raison : Lors du temps d'arrêt, Oracle Integration rejette toutes les demandes entrantes. Pour vous préparer, vous disposez des options 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, vous devez 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.

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

Développeur Si vous n'avez pas déjà mis à jour vos appels d'API pour utiliser OAuth lors de l'exécution des préalables, faites-le maintenant ou immédiatement après la mise à niveau.

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.

Tâches de pré-mise à niveau des adaptateurs

Tâche Responsable type Description des tâches

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

 Équipe 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 de Microsoft Graph.
  • Adaptateur Microsoft Office 365 Calendar

    Voir Page Appeler les opérations dans Utilisation de l'adaptateur Microsoft Office 365 Calendar avec Oracle Integration 3.

  • Adaptateur Microsoft Office 365 People

    Voir Page Appeler des opérations dans Utilisation de l'adaptateur Microsoft Office 365 People avec Oracle Integration 3.

  • Adaptateur Microsoft Office 365 Outlook

    Voir la page Appeler les opérations dans Utilisation de l'adaptateur Microsoft Office 365 Outlook avec Oracle Integration 3.

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

Tâche Responsable type Description des tâches
Préparer le générateur visuel avec un point d'extrémité personnalisé à l'aide de SSL pour la mise à niveau Administrateur Si Visual Builder est activé, vous utilisez un point d'extrémité personnalisé ou d'autres points d'extrémité personnalisés et vous utilisez SSL, procédez comme suit :
  1. Pour autoriser l'accès à la clé secrète du certificat SSL pour la mise à niveau, ajoutez les politiques suivantes, en remplaçant MySecretCompartment par le compartiment qui inclut les clés secrètes du 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 vos paramètres de client et d'application Visual Builder, ainsi que toutes les applications d'intégration, afin qu'ils pointent vers l'URL initiale d'Oracle Integration Génération 2 plutôt que vers le point d'extrémité personnalisé. Lors de la mise à niveau, le point d'extrémité personnalisé sera configuré dans Visual Builder. Ainsi, après la mise à niveau, seules les applications Visual Builder seront accessibles au moyen du point d'extrémité personnalisé.

Préparer le générateur visuel pour la mise à niveau

Équipe des opérations de développement Effectuez les tâches décrites dans Préparer Visual Builder pour la mise à niveau sous Administration d'Oracle Visual Builder dans Oracle Integration 3.
Vérifier les problèmes connus Équipe des opérations de développement Consultez les problèmes connus pour les applications en direct ou en zone de préparation après la mise à niveau vers Oracle Integration 3 dans Problèmes connus pour Oracle Integration 3 pour les problèmes pouvant entraîner un mauvais fonctionnement des applications en direct ou en zone de préparation après la mise à niveau vers Oracle Integration 3.