Configuration de la passerelle multiprotocole

Procédez comme suit sur chaque passerelle multiprotocole que vous voulez afficher dans les topologies d'instance.

Procédure

Dans l'interface graphique Web, procédez comme suit pour chaque passerelle multiprotocole que vous voulez surveiller.

  1. Sur la page Configure Multi-Protocol Gateway, cliquez sur le nom de la passerelle multiprotocole que vous voulez configurer.
  2. Sur la page Multi-Protocol Gateway Policy, configurez la règle. Cliquez sur ….
  3. Sur la page Configure Multi-Protocol Gateway Style Policy, sélectionnez une règle Client to Server existante ou cliquez sur New Rule pour en créer une.
    1. Faites glisser une transformation vers le diagramme.
      Remarque :
      1. Si une règle Client to Server existe déjà, ajoutez-y le noeud de transformation.
      2. Si la règle Client to Server a un noeud Authentification, Autorisation et Audit (AAA), veillez à ce que le noeud de transformation qui inclut le fichier xslt de l'agent DataPower précède le noeud AAA.
    2. Cliquez deux fois sur la règle de transformation pour l'éditer.
    3. Dans la fenêtre Configure Transform with XSLT style sheet Action, en regard du fichier de transformation, sélectionnez apm_req.xsl dans le magasin de données vers lequel vous l'avez transféré. Par exemple, local:///

      Si le fichier n'existe pas, cliquez sur Upload pour le transférer à partir de l'emplacement installé.

      Conseil : Pour configurer une règle Client to Server afin de surveiller le trafic entre DataPower et WebSphere MQ, en plus du trafic SOAP et REST via le dispositif DataPower, appliquez le fichier apm_req_MQ.xsl à la place du fichier apm_req.xsl au cours de cette étape.
    4. Cliquez sur Terminé.
  4. Sur la page Configure Multi-Protocol Gateway Style Policy, sélectionnez une règle Server to Client existante ou cliquez sur New Rule pour en créer une.
    1. Faites glisser une transformation vers le diagramme.
    2. Cliquez deux fois sur la règle de transformation pour l'éditer.
    3. Dans la fenêtre Configure Transform with XSLT style sheet Action, en regard du fichier de transformation, sélectionnez apm_rsp.xsl dans le magasin de données vers lequel vous l'avez transféré. Par exemple, local:///

      Si le fichier n'existe pas, cliquez sur Upload pour le transférer à partir de l'emplacement installé.

      Conseil : Pour configurer une règle Server to Client afin de surveiller le trafic entre DataPower et WebSphere MQ, en plus du trafic SOAP et REST via le dispositif DataPower, appliquez le fichier apm_rsp_MQ.xsl à la place du fichier apm_rsp.xsl au cours de cette étape.
    4. Cliquez sur Terminé.
  5. Sur la page Configure Multi-Protocol Gateway Style Policy, sélectionnez une règle Error existante ou cliquez sur New Rule pour en créer une.
    1. Faites glisser une transformation vers le diagramme.
    2. Cliquez deux fois sur la règle de transformation pour l'éditer.
    3. Dans la fenêtre Configure Transform with XSLT style sheet Action, en regard du fichier de transformation, sélectionnez apm_error.xsl dans le magasin de données vers lequel vous l'avez transféré. Par exemple, local:///

      Si le fichier n'existe pas, cliquez sur Upload pour le transférer à partir de l'emplacement installé.

      Conseil : Pour configurer une règle error afin de surveiller le trafic entre DataPower et WebSphere MQ, en plus du trafic SOAP et REST via le dispositif DataPower, appliquez le fichier apm_error_mq.xsl à la place du fichier apm_error.xsl au cours de cette étape.
    4. Cliquez sur Terminé.
  6. Sur la page Configure Multi-Protocol Gateway Style Policy, dans l'onglet Advanced, définissez Monitor via Web Services Management Agent sur on et cliquez sur Apply.
  7. Cliquez sur Apply.

Que faire ensuite

Dans certains cas, l'ajout de transformations au Suivi des transactions amène DataPower à modifier la valeur des en-têtes Content-Type HTTP. De ce fait, vous pouvez voir des pages Web avec des images qui ne se chargent pas ou des fichiers binaires qui s'affichent avec du texte HTML déformé.

Le comportement de DataPower change lorsqu'il compare une règle ne comportant pas de transformations XSL à une règle comportant une ou plusieurs transformations XSL. Si le service traite des messages codés en MIME, MTOM, XOP ou autre, ce comportement peut être souhaité. Sinon, modifiez votre configuration DataPower en conséquence afin d'éviter ce comportement.

Pour empêcher DataPower de modifier l'en-tête Content-Type HTTP, définissez la variable dans chaque règle affectée (var://service/mpgw/proxy-content-type):

  1. Faites glisser un objet avancé vers la règle.
  2. Cliquez deux fois sur l'objet avancé pour l'éditer.
  3. Sélectionnez Définir variable et cliquez sur Suivant.
  4. Entrez le nom de variable service/mpgw/proxy-content-type et la valeur de variable 1, puis cliquez sur Terminé.
  5. Appliquez les modifications apportées à la configuration de service et de règle.
  6. Répétez les étapes 1 à 5 pour chaque règle affectée.