Association et liaison d'un ensemble de règles WS-ReliableMessaging à une application de services Web à 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 l'outil wsadmin pour associer l'ensemble de règles à votre application et, pour les qualités gérées du service, pour définir des liaisons à un bus d'intégration de services et un moteur de messagerie.

Avant de commencer

Vous pouvez associer un ensemble de règles WS-ReliableMessaging et définir des liaisons à l'aide de l'outil wsadmin, comme décrit dans cette tâche, ou bien associer et lier un ensemble de règles WS-ReliableMessaging via la console d'administration.

Pour cette tâche, vous devez avoir développé et installé l'application de service Web à laquelle vous souhaitez associer un ensemble de règles.

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 quelconque de ces ensembles de règles par défaut ou si vous avez configuré votre propre ensemble de règles de messagerie fiable, alors vous êtes prêt à accomplir cette tâche.

Pourquoi et quand exécuter cette tâche

Cette tâche vous permet d'effectuer les actions suivantes :
  1. Vous pouvez associer un ensemble de règles de messagerie fiables (un ensemble de règles par défaut ou un ensemble de règles que vous avez créé) à un aspect de votre application (c'est-à-dire le niveau d'application ou le niveau de service Web). Ces ensembles de règles définissent le niveau (qualité de service) et les autres options de configuration que vous voulez appliquer à votre application de messagerie fiable.
  2. Définissez les liaisons pour chaque association à un ensemble de règles qui indique une qualité de service gérée. C'est-à-dire que vous devez choisir le bus d'intégration de services et les moteur de messagerie à utiliser pour conserver l'état des qualités de service permanentes gérées et non permanentes gérées.

Pour associer un ensemble de règles WS-ReliableMessaging et définir des liaisons à l'aide de l'outil wsadmin, procédez comme suit :

Procédure

  1. Associez un ensemble de règles à votre application de messagerie fiable au niveau de l'application ou au niveau du service.
    Utilisez la commande createPolicySetAttachment comme décrit dans Création d'associations d'ensemble de règles à l'aide de l'outil wsadmin. Définissez le paramètre -policySet avec le nom de l'ensemble de règles de messagerie fiable que vous voulez utiliser. Par exemple : WS-I RSP ND
    Remarque :
    • Vous pouvez associer un ensemble de règles à chaque niveau.
    • Vous pouvez appliquer une règle WS-ReliableMessaging uniquement au niveau d'une application ou au niveau d'un service.
    • Si vous appliquez une messagerie fiable au niveau d'un service, tous les services doivent alors utiliser la même règle WS-ReliableMessaging ainsi que les mêmes valeurs de liaisons.
    • Vous pouvez associer un ensemble de règles au niveau des opérations. Pour un ensemble de règles incluant la règle WS-ReliableMessaging, l'association au niveau des opérations configure les autres composants de l'ensemble de règles (par exemple, WS-Security et WS-Addressing). Cependant, toute configuration WS-ReliableMessaging au niveau des opérations est ignorée.

    Cette commande renvoie un numéro d'ID association. Si l'ensemble de règles choisi désigne une qualité gérée du service, relevez ce numéro. A l'étape suivante, il vous servira à définir la liaison.

  2. Si l'ensemble de règles choisi indique une qualité de service gérée, définissez des liaisons vers un bus d'intégration de services et un moteur de messagerie.
    Si l'instance d'ensemble de règles indique une qualité de service non permanente gérée ou permanente gérée, choisissez le bus d'intégration de services et le moteur de messagerie pour gérer l'état. Utilisez la commande setBinding comme décrit dans Création d'associations d'ensemble de règles à l'aide de l'outil wsadmin. Affectez la valeur WSReliableMessaging au paramètre -policyType. Définissez le nom du bus et le nom du moteur de messagerie à l'aide de la syntaxe suivante pour le paramètre -attributes :
    -attributes "[[busName ReliableMessagingBus] 
                 [messagingEngineName messaging_engine_name]]"
    Le format du nom est nomNoeud.nomServeur-nomBus pour un moteur de messagerie sur un serveur et nomCluster.nnn-nomBus pour un moteur de messagerie dans un cluster.
    Remarque : L'utilisation du même moteur de messagerie par plusieurs applications peut affecter la performance. Les facteurs à prendre en considération sont le nombre d'applications déjà liées au moteur de messagerie, l'utilisation de l'unité centrale et le débit des messages. Pour améliorer les performances d'une configuration avec un serveur unique, créez un nouveau moteur de messagerie à lier à votre application.
  3. Sauvegardez les modifications dans la configuration principale.
    Pour sauvegarder les changements de configuration, entrez la commande suivante :
    AdminConfig.save()
[z/OS]

Que faire ensuite

Si l'ensemble de règles choisi indique une qualité de service gérée, définissez la propriété personnalisée sib.wsrm.tokenLockTimeout dans le moteur de messagerie que vous avez spécifié dans la liaison de règle. Affectez à la propriété une valeur inférieure au délai d'attente de la région de contrôle avant l'arrêt d'une région de serviteur inactive. En définissant cette valeur, la région de contrôle ne met pas fin à la région du serviteur lorsque les messages fiable WS sont verrouillés. Pour plus d'informations, voir Propriétés personnalisées d'intégration de services.


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_attach_bind_cli
Nom du fichier : twbs_wsrm_policy_attach_bind_cli.html