Configuration d'un ensemble de règles WS-ReliableMessaging à l'aide de l'outil wsadmin

Pour configurer une application de service web pour qu'elle utilise WS-ReliableMessaging, associez un ensemble de règles qui contient un type de règle WS-ReliableMessaging. Ce type de règle fournit un éventail de qualités de service : permanente gérée, non permanente gérée ou non permanente non gérée. Utilisez les scripts de commandes pour configurer un ensemble de règles pour la messagerie fiable.

Avant de commencer

Vous pouvez configurer un ensemble de règles de la messagerie fiable à l'aide de l'outil wsadmin, comme décrit dans cette tâche, ou bien configurer un ensemble de règles de la messagerie fiable via la console d'administration.

Les ensembles de règles par défaut sont compatibles avec les applications WS-ReliableMessaging :
  • WS-I RSP
  • WS-I RSP ND
  • LTPA WS-I RSP
  • Username WS-I RSP
  • WSReliableMessaging 1_0
  • WSReliableMessaging par défaut
  • WSReliableMessaging permanent
Pour plus d'informations, voir Ensembles de règles par défaut WS-ReliableMessaging.

Si vous pouvez utiliser l'un de ces ensembles de règles par défaut sans avoir à modifier leur configuration, cette tâche n'est pas nécessaire. Vous êtes prêt à associer votre application à l'ensemble de règles par défaut et définir les liaisons à utiliser.

A n'importe quelle étape, c'est-à-dire avant ou après avoir créé votre application de service Web fiable ou configuré vos ensembles de règles, vous pouvez définir une propriété qui configure des noeuds finaux de façon à prendre en charge uniquement les clients qui utilisent la messagerie fiable. Ce paramètre est pris en compte par WS-Policy s'il est sélectionné.

Pourquoi et quand exécuter cette tâche

Pour configurer un ensemble de règles de la messagerie fiable à l'aide de l'outil wsadmin, procédez comme suit :

Procédure

  1. Créez un ensemble de règles. Utilisez la commande createPolicySet pour créer un ensemble de règles, ou la commande copyPolicySet pour en copier et en renommer un existant (que vous avez créé auparavant ou qui est l'un des deux Ensembles de règles par défaut WS-ReliableMessaging. Pour plus d'informations, voir Création et copie d'ensembles de règles à l'aide de l'outil wsadmin.
  2. Si l'ensemble de règles n'inclut pas les deux types de règles WSReliableMessaging et WSAddressing, ajoutez-les à l'aide de la commande addPolicyType, comme décrit dans Création et copie d'ensembles de règles à l'aide de l'outil wsadmin. Exemple :
    AdminTask.addPolicyType('[-policySet PolicySet1 -policyType WSReliableMessaging]')
    AdminTask.addPolicyType('[-policySet PolicySet1 -policyType WSAddressing]')
    Ces types de règles contiennent les options de configuration prenant en charge la messagerie WS fiable (WS-ReliableMessaging). WS-Addressing fournit les fonctions de demande et de réponse asynchrones pour WS-ReliableMessaging, et est également requis pour la messagerie synchrone WS-ReliableMessaging Version 1.1.
    Remarques :
    • Si vous souhaitez utiliser une conversation sécurisée ainsi que des règles de messagerie fiable dans le même ensemble de règles, les liaisons de la conversation sécurisée doivent être configurées de manière à ce qu'elles exigent des en-têtes de messagerie fiable signés. Les ensembles de règles par défaut de profils sécurisés fiables (WS-I RSP et WS-I RSP ND) sont spécifiquement conçus et configurés pour utiliser une conversation sécurisée et une messagerie fiable dans le même ensemble de règles. Si vous utilisez une copie d'un des ensembles de règles par défaut de profils sécurisés fiables (WS-I RSP et WS-I RSP ND), il n'est plus nécessaire de configurer les liaisons de la conversation sécurisée. Sinon, voir Configuration de WS-SecureConversation de manière à ce qu'elle soit compatible avec WS-ReliableMessaging.
    • La messagerie WS-ReliableMessaging Version 1.1 requiert WS-Addressing. Si vous utilisez un ensemble de règles incluant des règles WS-ReliableMessaging et WS-Addressing, et si la règle WS-Addressing est configurée comme facultative, WebSphere Application Server remplace le paramètre WS-Addressing et active automatiquement WS-Addressing.
  3. Configurez les attributs du type de règles WS-ReliableMessaging.

    En ce qui concerne la règle WS-ReliableMessaging, vous pouvez configurer la version de la norme WS-ReliableMessaging à utiliser, l'ordre dans lequel les messages sont distribués et la qualité de service requise (le niveau de fiabilité) pour la distribution des messages. Pour des informations détaillées sur ces attributs configurables, voir Paramètres WS-ReliableMessaging.

    Utilisez la commande setPolicyType pour configurer ces attributs. Exemple :
    AdminTask.setPolicyType('-policySet PolicySet1 -policyType WSReliableMessaging -attributes "[[inOrderDelivery false][specLevel 1.0]
    [enabled true][qualityOfService managedPersistent][type WSReliableMessaging]]" -replace'
  4. Le cas échéant, configurez les attributs du type de règles WS-Addressing. Par exemple, le type de messagerie par défaut des règles WS-Addressing est synchrone et asynchrone pour spécifier qu'il n'existe pas de restriction sur la cible des messages de réponse. Toutefois, si vous activez le partage de règle, l'infrastructure WS-Policy détermine le type à utiliser et il utilise de préférence le modèle demande-réponse synchrone. Etant donné que l'infrastructure WS-Policy est proritaire, les messages fiables sont envoyés dans une structure demande/réponse synchrone, même si le client appelle le service de manière asynchrone. Pour appliquer la messagerie asynchrone, spécifiez le type asynchrone pour la messagerie des règles WS-Addressing uniquement.
    Utilisez la commande setPolicyType pour configurer ces attributs. Exemple :
    AdminTask.setPolicyType('[-policySet PolicySet1 -policyType WSAddressing 
    -attributes "[[wsaMode WSA_ASYNC]]"]')
    Pour plus de détails sur ces attributs configurables, voir Paramètres de la règle WS-Addressing.
  5. Sauvegardez les modifications dans la configuration principale.
    Pour sauvegarder les changements de configuration, entrez la commande suivante :
    AdminConfig.save()

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_wsrm_policy_config_cli
Nom du fichier : twbs_wsrm_policy_config_cli.html