Automatisation des configurations de ressources de messagerie à l'aide de l'outil de scriptage wsadmin

La bibliothèque de scripts propose des procédures de script Jython pour vous aider à automatiser votre environnement. Utilisez les scripts de gestion des ressources pour configurer et gérer vos configurations JMS (Java™).

Pourquoi et quand exécuter cette tâche

La bibliothèque de scripts propose un ensemble de procédures permettant d'automatiser les fonctions d'administration de serveur d'applications les plus courantes. Vous pouvez utiliser la bibliothèque de scripts Jython de trois façons.
  • Exécutez des scripts de la bibliothèque de scripts Jython en mode interactif avec le noeud wsadmin. Vous pouvez lancer l'outil wsadmin et exécuter des scripts pris séparément inclus dans la bibliothèque de scripts en utilisant la syntaxe suivante :
    wsadmin>AdminServerManagement.createApplicationServer("myNode", "myServer", "default")
  • Utilisez un éditeur de texte pour combiner plusieurs scripts de la bibliothèque de scripts Jython, comme le montre l'exemple suivant :
    #
    # My Custom Jython Script - file.py
    #
    AdminServerManagement.createApplicationServer("myNode", "Server1", "default")
    AdminServerManagement.createApplicationServer("myNode", "Server2", "default")
    
    # Use one of them as the first member of a cluster
    AdminClusterManagement.createClusterWithFirstMember("myCluster", "APPLICATION_SERVER",
        "myNode", "Server1")
    
    # Add a second member to the cluster
    AdminClusterManagement.createClusterMember("myCluster", "myNode", "Server3")
    
    # Install an application
    AdminApplication.installAppWithClusterOption("DefaultApplication",
        "..\installableApps\DefaultApplication.ear", "myCluster") 
    
    # Start all servers and applications on the node
    AdminServerManagement.startAllServers("myNode")
    Enregistrez le script personnalisé et exécutez-le à partir de la ligne de commande, comme le montre la syntaxe suivante :
    bin>wsadmin -language jython -f path/to/your/jython/file.py
  • Utilisez le code de la bibliothèque de scripts Jython comme exemple de syntaxe pour écrire des scripts personnalisés. Chaque exemple de script de la bibliothèque utilise les valeurs recommandées pour l'écriture des scripts wsadmin. Le code de la bibliothèque de scripts se trouve dans le répertoire racine_serveur_app/scriptLibraries. Dans ce répertoire, les scripts sont organisés en sous-répertoires selon leur fonctionnalité. Par exemple, le sous-répertoire racine_serveur_app/scriptLibraries/application/V70 contient des procédures de gestion d'application valables pour la version 7.0 et les versions ultérieures du produit. Le sous-répertoire V70 dans les chemins d'accès aux bibliothèques de scripts ne contient pas forcément des scripts de version 7.0.
Les procédures de gestion des ressources de messagerie dans la bibliothèque de scripts se trouvent dans le sous-répertoire racine_serveur_app/scriptLibraries/resources/JMS/V70. Le chargement de chaque script de ce répertoire s'effectue automatiquement lorsque vous lancez l'outil wsadmin. Pour charger automatiquement vos scripts Jython personnalisés (*.py) lors du démarrage de l'outil wsadmin, enregistrez vos scripts d'automatisation dans un nouveau sous-répertoire du répertoire app_server_root/scriptLibraries.
Pratiques recommandées Pratiques recommandées: Pour créer des scripts personnalisés à l'aide des procédures de la bibliothèque de scripts, sauvegardez dans le nouveau sous-répertoire les scripts modifiés pour éviter d'écraser la bibliothèque. N'éditez pas les procédures de script dans la bibliothèque de scripts.bprac

Les scripts permettent de créer de nombreuses combinaisons de fonctions d'administration. Utilisez l'exemple de combinaison de procédures suivant pour créer un fournisseur JMS et configurer les ressources JMS du fournisseur JMS.

Procédure

  1. Facultatif : Démarrez l'outil wsadmin.
    Cette étape permet de lancer l'outil wsadmin et de se connecter à un serveur ou d'exécuter l'outil en mode local. Si vous lancez l'outil wsadmin, aidez-vous des exemples de mode interactif fournis dans cette rubrique pour exécuter les scripts.
    • Pour lancer l'outil wsadmin et vous connecter à un serveur, entrez la commande suivante à partir du répertoire bin :
      bin>wsadmin -lang jython
    • Pour lancer l'outil wsadmin en mode local en utilisant le langage de script Jython, entrez la commande suivante à partir du répertoire bin :
      bin>wsadmin -conntype none -lang jython
    Lors du lancement de l'outil wsadmin, le système charge tous les scripts de la bibliothèque de scripts.
  2. Configurez un fournisseur JMS.
    Exécutez la procédure createJMSProvider de la bibliothèque de scripts et indiquez les arguments obligatoires. Pour exécuter le script, indiquez le noeud, le serveur, le nom de fournisseur JMS, le nom de la fabrique contextuelle initiale externe, ainsi que l'adresse URL du fournisseur externe. Vous pouvez également indiquer d'autres attributs selon le format suivant : [["attr1", "valeur1"], ["attr2", "valeur2"]]. Le tableau suivant fournit des informations supplémentaires sur les arguments à indiquer :
    Tableau 1. createJMSProvider script arguments. Exécutez le script pour créer un fournisseur JMS.
    Argument Description
    Nom de noeud Indique le nom du noeud qui vous intéresse.
    Nom du serveur Indique le nom du serveur qui vous intéresse.
    Nom du fournisseur JMS Indique le nom à attribuer au nouveau fournisseur JMS.
    Nom de la fabrique de contexte initial externe Indique le nom de la classe Java de la fabrique de contexte initiale du fournisseur JMS.
    URL de fournisseur externe Spécifie l'URL du fournisseur JMS pour les recherches JNDI externes.
    L'exemple suivant crée un fournisseur JMS dans la configuration :
    bin>wsadmin -lang jython -c "AdminJMS.createJMSProvider("myNode", "myServer", "myJMSProvider", "extInitCF",
     "extPURL", [["description", "testing"], ["supportsASF", "true"], ["providerType", "jmsProvType"]])"
    Vous pouvez également utiliser le mode interactif pour exécuter la procédure de script, comme dans l'exemple suivant :
    wsadmin>AdminJMS.createJMSProvider("myNode", "myServer", "myJMSProvider", "extInitCF",
     "extPURL", [["description", "testing"], ["supportsASF", "true"], ["providerType", "jmsProvType"]])
    Le script renvoie l'ID de configuration du nouveau fournisseur JMS.
  3. Configurez une fabrique de connexions JMS générique.
    Exécutez la procédure createGenericJMSConnectionFactory de la bibliothèque de scripts et indiquez les arguments obligatoires. Pour exécuter le script, indiquez le noeud, le serveur, le nom de fournisseur JMS, le nom de la nouvelle fabrique de connexions, le nom JNDI, ainsi que le nom JNDI externe. Vous pouvez également indiquer d'autres attributs selon le format suivant : [["attr1", "valeur1"], ["attr2", "valeur2"]]. Le tableau suivant fournit des informations supplémentaires sur les arguments à indiquer :
    Tableau 2. createGenericJMSConnectionFactory script arguments. Exécutez le script pour créer une fabrique de connexions JMS générique.
    Argument Description
    Nom de noeud Indique le nom du noeud qui vous intéresse.
    Nom du serveur Indique le nom du serveur qui vous intéresse.
    Nom du fournisseur JMS Indique le nom du fournisseur JMS.
    Nom de la fabrique de connexions Indique le nom à attribuer à la nouvelle fabrique de connexions.
    Nom JNDI Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
    Nom JNDI externe Indique le nom JNDI employé pour lier la file d'attente à l'espace de nom du serveur d'applications. Par convention, utilisez le nom JNDI complet, par exemple sous la forme jms/Nom, Nom correspondant au nom logique de la ressource. Ce nom est utilisé pour lier les informations relatives à la liaison des plateformes. La liaison associe les ressources définies dans le descripteur de déploiement du module aux ressources réelles (physiques) liées sous JNDI par la plateforme.
    L'exemple suivant crée une fabrique de connexions JMS dans la configuration :
    bin>wsadmin -lang jython -c "AdminJMS.createGenericJMSConnectionFactory("myNode", "myServer", "myJMSProvider",
     "JMSCFTest", "jmsjndi", "extjmsjndi", [["XAEnabled", "true"], ["authDataAlias", "myalias"],
     ["description", "testing"]])"
    Vous pouvez également utiliser le mode interactif pour exécuter la procédure de script, comme dans l'exemple suivant :
    wsadmin>AdminJMS.createGenericJMSConnectionFactory("myNode", "myServer", "myJMSProvider", 
      "JMSCFTest", "jmsjndi", "extjmsjndi", [["XAEnabled", "true"], ["authDataAlias", "myalias"],
     ["description", "testing"]])
    Le script renvoie l'ID de configuration de la nouvelle fabrique de connexions JMS générique.
  4. Créez une destination JMS générique.
    Exécutez la procédure createGenericJMSDestination de la bibliothèque de scripts et indiquez les arguments obligatoires. Pour exécuter le script, indiquez le noeud, le serveur, le nom de fournisseur JMS, le nom de la destination JMS générique, le nom JNDI, ainsi que le nom JNDI externe. Vous pouvez également indiquer d'autres attributs selon le format suivant : [["attr1", "valeur1"], ["attr2", "valeur2"]]. Le tableau suivant fournit des informations supplémentaires sur les arguments à indiquer :
    Tableau 3. createGenericJMSDestination script arguments. Exécutez le script pour créer une destination JMS générique.
    Argument Description
    Nom de noeud Indique le nom du noeud qui vous intéresse.
    Nom du serveur Indique le nom du serveur qui vous intéresse.
    Nom du fournisseur JMS Indique le nom du fournisseur JMS.
    Nom de la destination JMS générique Indique le nom à attribuer à la nouvelle destination JMS générique.
    Nom JNDI Indique le nom JNDI que le système emploie pour lier la fabrique de connexions à l'espace de nom.
    Nom JNDI externe Indique le nom JNDI employé pour lier la file d'attente à l'espace de nom du serveur d'applications. Par convention, utilisez le nom JNDI complet, par exemple sous la forme jms/Nom, Nom correspondant au nom logique de la ressource. Ce nom est utilisé pour lier les informations relatives à la liaison des plateformes. La liaison associe les ressources définies dans le descripteur de déploiement du module aux ressources réelles (physiques) liées sous JNDI par la plateforme.
    L'exemple suivant crée une destination JMS générique dans votre configuration à partir d'un modèle :
    bin>wsadmin -lang jython -c "AdminJMS.createGenericJMSDestination("myNode", "myServer", "myJMSProvider",
     "JMSDest", "destjndi", "extDestJndi", [["description", "testing"], ["category", "jmsDestCatagory"],
       ["type", "TOPIC"]]))"
    Vous pouvez également utiliser le mode interactif pour exécuter la procédure de script, comme dans l'exemple suivant :
    wsadmin>AdminJMS.createGenericJMSDestination("myNode", "myServer", "myJMSProvider",
     "JMSDest", "destjndi", "extDestJndi", [["description", "testing"], ["category", "jmsDestCatagory"],
       ["type", "TOPIC"]]))
    Le script renvoie l'ID de configuration de la nouvelle destination JMS générique.

Résultats

Les bibliothèques de scripts wsadmin renvoient la même sortie que les commandes wsadmin correspondantes. Par exemple, le script AdminServerManagement.listServers() renvoie une liste de serveurs disponibles. Le script AdminClusterManagement.checkIfClusterExists() renvoie la valeur true si le cluster existe et false si le cluster n'existe pas. Si la commande ne renvoie pas le résultat attendu, les bibliothèques de scripts renvoient la valeur 1 lorsque l'exécution du script aboutit. En cas d'échec du script, les bibliothèques de scripts renvoient la valeur -1 et un message d'erreur reprenant l'exception.

Par défaut, l'option failonerror est désactivée dans le système. Pour activer cette option, indiquez true comme dernier argument de la procédure de script, comme dans l'exemple suivant :
wsadmin>AdminApplication.startApplicationOnCluster("myApplication","myCluster","true")

Que faire ensuite

Créez des scripts personnalisés pour automatiser votre environnement en combinant des procédures de script de la bibliothèque de scripts. Sauvegardez les scripts personnalisés dans un nouveau sous-répertoire sous racine_serveur_app/scriptLibraries.


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=txml_7libresource2
Nom du fichier : txml_7libresource2.html