Ajout d'un chemin de distribution

Un chemin est créé pour envoyer les données de trace sur le réseau du processus Extract vers le processus Replicat, créant ainsi un chemin de trace. Avant de commencer à ajouter un chemin de distribution, assurez-vous d'établir une connexion de chemin. Pour configurer une connexion de chemin, reportez-vous à Ajouter une connexion de chemin.

Remarque : lorsqu'un chemin de distribution se connecte à un déploiement sécurisé, la cible doit avoir la chaîne de certificats complète (CA feuille, intermédiaire et racine) dans son magasin de certificats, tandis que la source doit uniquement faire confiance à l'autorité de certification racine en l'important en tant que certificat sécurisé. Si le paramètre config.securityDetails.network.inbound.authMode du déploiement sécurisé est défini sur clientOptional_server (default), aucun certificat client n'est requis. Toutefois, s'il est défini sur client_server, le client doit utiliser un certificat pour l'authentification et ce certificat doit également être ajouté en tant qu'utilisateur opérateur dans le déploiement cible. Si le certificat client est signé par un certificat d'autorité de certification racine différent du certificat d'autorité de certification racine du serveur, le certificat d'autorité de certification racine du client doit également être importé en tant que certificat sécurisé dans le magasin de certificats du serveur.

Vous pouvez commencer à ajouter un chemin de service de distribution à partir de la page d'accueil des microservices ou utiliser le volet de navigation de gauche pour accéder à la page Chemins de service de distribution, comme indiqué dans les étapes suivantes :

  1. Cliquez sur l'option Chemins de service de distribution dans le panneau de navigation de gauche pour ouvrir la page Chemins de service de distribution.

  2. Cliquez sur le signe plus (+) en regard de Chemins de service de distribution. L'assistant Ajouter un chemin s'affiche.

  3. Dans l'écran Informations sur le chemin, notez les boutons Par défaut et Avancé dans l'angle supérieur droit de l'assistant. Le bouton Par défaut est présélectionné. Il permet de configurer le chemin pour la plupart des configurations requises.

  4. Spécifiez les valeurs suivantes pour configurer le chemin du service de distribution :

    • Nom de chemin : sélectionnez le nom du chemin.

    • Description : indiquez une description. Par exemple, le nom des processus d'extraction et de réplication associés au chemin de distribution.

    • Avancé : sélectionnez le bouton Avancé pour activer le commutateur Air-Gap Security et configurer ses options.

    La configuration de la sécurité air-gap est destinée aux environnements dans lesquels la façon dont les fichiers trace sont envoyés de la source vers la cible n'est pas gérée par Oracle GoldenGate. Le processus Extract écrit les transactions dans un fichier trace (trail) et le chemin de distribution génère un fichier trace XML local. Ce fichier trace XML peut ensuite être envoyé à un autre déploiement où un chemin de distribution lira ce fichier trace et le mettra à la disposition d'un processus Replicat pour l'application des transactions.

    Sélectionnez l'une des options suivantes pour configurer le chemin de distribution pour la livraison sécurisée des données Air-Gap selon que vous envoyez ou recevez des données de piste :

     - **From: Unclassified/Low-Side**

 Select this option to configure an Air Gap Path that receives trail data from a secure source location. Provide a name and the required source and target details.

 - **To: Classified/High-Side**

 Select this option to configure an Air Gap Path that writes trail data to a secure target location. Provide a name and source details. Target configuration is simplified for air-gapped delivery.

    • Source

      • Extraction source : sélectionnez l'extraction source pour laquelle la distribution de trace sera effectuée par le chemin de distribution.

      • Nom de trace : nom du fichier trace source.

      • Début : sélectionnez le point à partir duquel vous devez consigner les données. Vous pouvez sélectionner les options Now, Custom Time, Position Log et CSN (au plus tard) dans la liste déroulante.

      • Journal source : indiquez les valeurs du journal source : Numéro de séquence, Décalage RBA,

    • Cible

      • Sélectionnez le protocole de transfert de données. Les options disponibles sont wss, ws et ogg.

      • Proxy inverse activé : sélectionnez cette option pour utiliser le proxy inverse.

      • Hôte cible : entrez l'URL de l'hôte cible, par exemple localhost, si la cible se trouve sur le même système.

      • Numéro de port : numéro de port du déploiement cible.

      • Fichier trace : nom du fichier trace source.

      • Méthode d'authentification cible : sélectionnez cette méthode dans la liste déroulante de l'authentification cible lorsque le fichier trace est reçu par le chemin de distribution. Les options sont les suivantes : OAuth, Certificat, UserIDAlias

  5. Cliquez sur Suivant.

  6. Cochez la case Cryptage pour définir les options de cryptage suivantes pour le chemin :

    REMARQUE : La case à cocher Chiffrement ne s'affiche pas si vous avez activé le commutateur Air-Gap Security.

    • Profil de cryptage : sélectionnez un profil de cryptage dans la liste déroulante, si nécessaire.

    • Algorithme de cryptage : algorithme de cryptage utilisé lors de l'envoi de la trace au déploiement cible. Les options incluent AES128, AES192 et AES256.

    • Modifier le cryptage : activez cette option pour autoriser la modification de l'algorithme de cryptage.

  7. Cochez la case Activer le filtrage pour appliquer des filtres sur les chemins de service du destinataire et cliquez sur Suivant. L'écran Filtrage apparaît lorsque vous cochez cette case.

  8. Dans l'écran Filtrage, spécifiez les options suivantes sur l'écran Options de filtrage pour ajouter les règles de filtrage :

    • Nom de la règle : nom de la règle à créer.

    • Action sur règle : sélectionnez l'une des règles Exclure ou Inclure. L'option Exclure permet de filtrer en fonction des options sélectionnées, tandis que l'option Inclure inclut les données en fonction des options spécifiées.

    • Type de filtre : sélectionnez l'une des options suivantes :

      • Type d'objet : sélectionnez l'un des trois types d'objet suivants : LMD, LDD et procédure.

      • Noms d'objet : sélectionnez cette option pour fournir un nom d'objet existant. Une convention de dénomination en trois parties varie selon que vous utilisez ou non une base de données Conteneur. Avec la CDB, vous devez utiliser une convention d'appellation en 3 parties. Sinon, une convention en 2 parties est obligatoire. La convention en 3 parties comprend le conteneur, le schéma et l'objet. La convention en 2 parties comprend le schéma et le nom d'objet.

      • Nom de la fonction de procédure : sélectionnez cette option pour filtrer en fonction du nom de la fonction de procédure existante.

      • Basé sur la colonne : si vous sélectionnez cette option, vous obtenez l'option permettant de saisir le nom de la table et de la colonne auxquelles la règle s'applique. Vous pouvez filtrer à l'aide de l'option de valeur de colonne avec des conditions LT, GT, EQ, LE, GE et NE. Vous pouvez également indiquer si vous souhaitez disposer d'une image avant ou après dans les données filtrées.

      • Balise : sélectionnez cette option pour définir le filtre en fonction des balises.

      • ID de bloc : affiche les détails de configuration des shards de base de données. Toutefois, les détails ne peuvent pas être modifiés.

    • Noms d'objet : nom de l'objet filtré.

    • Negate : Cochez cette case si vous devez annuler une règle existante.

  9. Cliquez sur Ajouter pour ajouter la règle, puis sur Suivant.

  10. Sur l'écran Vérifier, vérifiez les détails du chemin du service de distribution configuré et modifiez-les, si nécessaire. Si vous utilisez le paramètre Par défaut, vous pouvez configurer les options gérées comme suit :

    • Critique : activez cette option si vous souhaitez configurer le chemin de distribution pour la haute disponibilité.

    • Redémarrage automatique : activez ce commutateur pour ajuster les options de redémarrage automatique : Redémarrage automatique - Nouvelles tentatives, Délai de redémarrage automatique

  11. Sur l'écran Vérifier, cliquez sur le bouton Avancé pour configurer les options de formatage de trace et les options réseau.

    Options de format : développez la section et sélectionnez le type de trace dans la liste déroulante Type. Les options de format de trace sont Texte brut, XML, SQL. Selon le format de trace sélectionné, définissez les options de format de trace suivantes :

    • SQL

      • Utiliser le nom qualifié : sélectionnez cette option pour utiliser le nom qualifié complet du fichier des paramètres.

      • Inclure les informations sur la transaction : Activer pour inclure les informations sur la transaction.

      • Compatible avec : vous pouvez sélectionner la compatibilité avec Oracle, SQLPlus, SQLLOADER.

      • Aucune mise à jour de clé primaire : désactivée par défaut. Activez ce commutateur pour autoriser la mise à jour de clé primaire.

    • XML

      • Inclure les informations sur la transaction : Activer pour inclure les informations sur la transaction.

      • Inclure un objet LOB de grande taille : Activer pour inclure les transactions LOB de grande taille.

      • Inclure le jeton utilisateur : activez cette option pour inclure le jeton utilisateur

      • Fermer la transaction : permet de fermer une transaction une fois la transaction de journalisation du fichier trace terminée.

      • Utiliser les propriétés intégrées : activez cette option pour inclure les propriétés de format de trace incorporée.

      • Encodage : sélectionnez l'encodage dans la liste déroulante.

    • Texte brut

      • Compatible avec : sélectionnez l'utilitaire compatible avec le fichier de trace. Les options sont les suivantes : BCP, SQLLOADER, COMCAST

      • Précision de l'horodatage : indiquez la valeur d'horodatage du fichier de trace. Les options sont les suivantes : TS, Date, Heure

      • Colonnes supplémentaires : Inclut des espaces réservés pour des colonnes supplémentaires à la fin de chaque enregistrement. Utilisez cette option lorsqu'un tableau cible comporte plus de colonnes que le tableau source.

        Indiquez une valeur comprise entre 1 et 9.

      • Inclure SYSKEY : sélectionnez cette option si la configuration du processus Replicat inclut des tables avec SYSKEY.

      • Style de devis : sélectionnez le style de devis en fonction des exigences de la base de données. Les options sont les suivantes : single, none, embed

      • Inclure le nom de colonne : activez cette option pour inclure les noms des colonnes dans le fichier de trace.

      • NULL = espace : sélectionnez cette option pour indiquer que toute valeur NULL dans le fichier de trace correspond à un espace.

      • Inclure un espace réservé : génère un espace réservé pour les colonnes manquantes.

      • Inclure des champs d'en-tête : sélectionnez cette option pour inclure les champs d'en-tête dans le fichier de trace.

      • Délimiteur : autre caractère de délimitation.

      • Inclure le type d'opération : activez cette option pour inclure le type d'opération de trace dans les options de trace.

      • Inclure l'indicateur d'image : activez cette option pour inclure des détails sur l'image avant et après.

      • Inclure le nom d'objet : activez cette option pour inclure le nom d'objet dans les détails de trace.

      • Encodage : UTF-8

      • Utiliser le nom qualifié : sélectionnez cette option pour utiliser le nom qualifié complet du fichier des paramètres.

      • Inclure les informations sur la transaction : Activer pour inclure les informations sur la transaction.

    Options réseau : développez la section pour définir la configuration réseau suivante :

    • Proxy HTTP : activez ce commutateur pour autoriser les paramètres de proxy HTTP pour le chemin de distribution.

    • Activer la compression réseau : définissez la valeur de seuil d'activation de la compression si vous décidez d'activer cette option.

    • Seuil de compression : cette option apparaît lorsque vous activez la compression réseau. Indiquez la valeur du seuil de compression.

    • Longueur du numéro de séquence de trace cible : longueur du numéro de séquence de trace.

    • Délai Eof (centisecondes) : vous pouvez indiquer le délai Eof en centisecondes. Sur les plates-formes Linux, vous pouvez conserver les paramètres par défaut. Cependant, sur les autres plates-formes, vous devrez peut-être ajuster ce paramètre pour les réseaux à bande passante et latence élevées ou pour les réseaux ayant des paramètres de qualité de service (QoS) (DSCP et temps de service (ToS)).

    • Fréquence du point de reprise : fréquence du chemin qui prend le point de reprise (en secondes).

    • Octets de vidage TCP : saisissez la taille du vidage TCP en octets.

    • Secondes de vidage TCP : entrez l'intervalle de vidage TCP en secondes.

    • DSCP : sélectionnez la valeur DSCP (Point de code de services différenciés) dans la liste déroulante ou recherchez-la.

    • TOS : sélectionnez la valeur Type de service dans la liste déroulante.

    • TCP_NODELAY : activez cette option pour éviter tout retard lors de l'utilisation de l'option de Nagle.

    • Accusé de réception rapide : activez cette option pour envoyer un accusé de connexion rapide après réception des données.

    • TCP_CORK : activez cette option pour autoriser l'utilisation de l'option de blocage de l'algorithme de Nagle.

    • Taille du tampon d'envoi du système : vous pouvez définir la valeur de la taille du tampon d'envoi pour le contrôle de flux.

    • Taille du tampon de réception du système : vous pouvez définir la valeur de la taille du tampon de réception pour les contrôles de flux.

    • Maintien des connexions : délai d'expiration pour le maintien des sessions.

  12. Cliquez sur Créer un chemin ou sur Créer un chemin et exécuter, selon les besoins. Sélectionnez Annuler si vous devez sortir de la page Ajouter un chemin sans ajouter de chemin.

Vous revenez à la page d'accueil Chemin du service de distribution, qui inclut désormais votre nouveau chemin.

Une fois le chemin créé, vous pouvez le voir sur la page d'accueil Chemin du service de distribution. Vous pouvez également voir ce chemin de distribution sur la page d'accueil Chemin de service du destinataire.