Modification des objets de configuration à l'aide de l'outil de scriptage wsadmin

Modification des objets de configuration à l'aide du scriptage et de l'outil wsadmin

Avant de commencer

Avant de commencer cette tâche, assurez-vous que l'outil wsadmin est démarré et actif. Pour plus d'informations, reportez-vous à la rubrique Démarrage du client de scriptage wsadmin.

Pourquoi et quand exécuter cette tâche

Avec la commande modify de l'objet AdminConfig, utilisez l'ID objet de configuration pour modifier l'attribut voulu. Si vous employez l'ID objet parent pour modifier l'attribut, la commande réinitialise tous les autres attributs non indiqués à leur valeur par défaut. Par exemple, vous utilisez la commande modify pour modifier les paramètres de règle de contrôle à l'aide de l'objet parent associé, l'objet de définition de processus. Dans ce cas, tous les attributs de l'objet de définition de processus non modifiés par la commande (par exemple, les attributs pingInterval et pingTimeout) sont réinitialisés à leur valeur par défaut.

Pour modifier un objet de configuration, procédez comme suit :

Procédure

  1. Extrayez l'ID configuration des objets à modifier comme suit :
    • A l'aide de Jacl :

      set jdbcProvider1 [$AdminConfig getid /JDBCProvider:myJdbcProvider/]
    • Avec Jython :
      jdbcProvider1 = AdminConfig.getid('/JDBCProvider:myJdbcProvider/')
    Tableau 1. Description de la commande AdminConfig getid. Appelez une commande depuis une ligne de commande wsadmin.
    Elément Description
    set est une commande Jacl
    jdbcProvider1 est un nom de variable
    $ est un opérateur Jacl permettant de remplacer un nom de variable par sa valeur
    AdminConfig est un objet qui représente la configuration du produit
    getid est une commande AdminConfig
    /JDBCProvider:myJdbcProvider/ est le chemin d'imbrication hiérarchique de l'objet de configuration
    JDBCProvider est le type d'objet
    myJdbcProvider est le nom facultatif de l'objet
  2. Affichez les valeurs d'attributs en cours de l'objet de configuration à l'aide de la commande show comme suit :
    • Avec Jacl :

      $AdminConfig show $jdbcProvider1
    • Avec Jython :
      AdminConfig.show(jdbcProvider1)
    Tableau 2. Description de la commande AdminConfig show. Appelez une commande depuis une ligne de commande wsadmin.
    Elément Description
    $ est un opérateur Jacl permettant de remplacer un nom de variable par sa valeur
    AdminConfig est un objet qui représente la configuration du produit
    show est une commande AdminConfig
    jdbcProvider1 a pour valeur l'ID du noeud hôte spécifié à l'étape numéro 1
  3. Modifiez les attributs de l'objet de configuration.

    Exemples :

    • Avec Jacl :

      $AdminConfig modify $jdbcProvider1 {{description "Voici ma nouvelle description"}}
      $AdminConfig modify $outPort {{retargettedURI "endpoint address"}}   
    • Avec une liste Jython :
      AdminConfig.modify(jdbcProvider1, [['description', "Voici ma nouvelle description"]])
      AdminConfig.modify(outPort, [['retargettedURI', "endpoint address"]])
    • A l'aide de la chaîne Jython :
      AdminConfig.modify(jdbcProvider1, '[[description "Voici ma nouvelle description"]]')
      AdminConfig.modify(outPort, '[[retargettedURI "endpoint address"]]')
    Où :
    Tableau 3. Description de la commande AdminConfig modify. Appelez une commande depuis une ligne de commande wsadmin.
    Elément Description
    $ est un opérateur Jacl permettant de remplacer un nom de variable par sa valeur
    AdminConfig est un objet qui représente la configuration du produit
    modify est une commande AdminConfig
    jdbcProvider1 a pour valeur l'ID du noeud hôte spécifié à l'étape numéro 1
    description est un attribut des objets serveur
    Voici ma nouvelle description est la valeur de l'attribut description
    outPort est le nom de l'élément SIBWSOutboundPort créé à l'aide de la commande addSIBWSOutboundPort. Vous pouvez également utiliser la commande AdminConfig pour modifier les autres attributs de commande SIBWSOutboundPort.
    retargettedURI est l'attribut des objets outport. Cet attribut spécifique correspond à la modification de la valeur indiquée pour la propriété d'adresse de noeud final sur la console d'administration.
    adresse du noeud final est la valeur de l'attribut retargettedURI.
    Vous pouvez également modifier plusieurs attributs en même temps. Exemple :
    • A l'aide de Jacl :

      {{name1 val1} {name2 val2} {name3 val3}}
    • Avec une liste Jython :
      [['name1', 'val1'], ['name2', 'val2'], ['name3', 'val3']]
    • A l'aide de la chaîne Jython :
      '[[name1 val1] [name2 val2] [name3 val3]]'
  4. Listez tous les attributs modifiables :
    • A l'aide de Jacl :

      $AdminConfig attributes JDBCProvider
    • Avec Jython :
      print AdminConfig.attributes('JDBCProvider')
    Exemple de sortie :
    $AdminConfig attributes JDBCProvider
    "classpath String*"
    "description String"
    "implementationClassName String"
    "name String"
    "nativepath String*"
    "propertySet J2EEResourcePropertySet"
    "providerType String"
    "xa boolean"
  5. Modifiez un attribut associé à un type de liste et une collection.

    Par défaut, si vous tentez de modifier un attribut associé à un type de liste et une collection, et si l'attribut comporte une valeur dans la liste, la nouvelle valeur est ajoutée aux valeurs existantes. Un attribut associé à un type de liste et une collection est signalé par un astérisque (*). Dans l'exemple suivant, le chemin de classe de l'attribut est associé à un type de liste et une collection et la valeur est 'String' (chaîne). Pour remplacer la valeur existante, vous devez modifier le chemin de classe (classpath) pour définir une liste vide avant de modifier la nouvelle valeur. Exemple :

    • A l'aide de Jacl :

      [AIX Solaris HP-UX Linux Windows]
      $AdminConfig modify $jdbcProvider1 {{classpath {}}}
      
      $AdminConfig modify $jdbcProvider1 [list [list classpath c:/temp/db2j.jar]]
      [IBM i][z/OS]
      $AdminConfig modify $jdbcProvider1 {{classpath {}}}
      
      $AdminConfig modify $jdbcProvider1 [list [list classpath /temp/db2j.jar]]
    • Avec une liste Jython :

      [AIX Solaris HP-UX Linux Windows]
      AdminConfig.modify(jdbcProvider1, [['description', []]])
      
      AdminConfig.modify(jdbcProvider1, [['description', 'c:/temp/db2j.jar']]
      [IBM i][z/OS]
      AdminConfig.modify(jdbcProvider1, [['description', []]])
      
      AdminConfig.modify(jdbcProvider1, [['description', '/temp/db2j.jar']]
    • A l'aide de la chaîne Jython :

      [AIX Solaris HP-UX Linux Windows]
      AdminConfig.modify(jdbcProvider1, '[]')
      
      AdminConfig.modify(jdbcProvider1, '[[description c:/temp/db2j.jar]]')
      [IBM i][z/OS]
      AdminConfig.modify(jdbcProvider1, '[]')
      
      AdminConfig.modify(jdbcProvider1, '[[description /temp/db2j.jar]]')
  6. Sauvegardez les modifications de configuration.
    Entrez l'exemple de commande suivante pour sauvegarder les modifications de configuration :
    AdminConfig.save()
  7. Dans un environnement de déploiement en réseau uniquement, synchronisez le noeud.
    Utilisez les scripts syncActiveNode ou syncNode de la bibliothèque de scripts AdminNodeManagement pour propager les modifications de configuration sur un ou plusieurs noeudsµµ.
    • Utilisez le script syncActiveNodes pour propager les modifications sur chacun des noeuds dans la cellule, comme dans l'exemple suivant :
      AdminNodeManagement.syncActiveNodes()
    • Utilisez le script syncNode pour propager les modifications sur un noeud spécifique, comme dans l'exemple suivant :
      AdminNodeManagement.syncNode("myNode")

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_calladminconfig
Nom du fichier : txml_calladminconfig.html