Gestion des configurations d'environnement avec des fichiers de propriétés à l'aide de l'outil de scriptage wsadmin

Cette rubrique permet de modifier votre environnement à l'aide de fichiers de propriétés. Vous pouvez utiliser l'outil wsadmin pour générer, valider et appliquer des fichiers de propriétés dans vos configurations de serveur d'applications, profil, noeud ou autre.

Pourquoi et quand exécuter cette tâche

Le groupe de commandes PropertiesBasedConfiguration de l'objet AdminTask permet d'extraire les attributs et les valeurs de configuration de votre environnement vers des fichiers de propriétés. Cette fonctionnalité est utilisable pour divers objectifs, notamment pour :
  • modifier la configuration existante à partir d'un emplacement unique, plutôt que de configurer plusieurs panneaux de la console d'administration ou d'exécuter de nombreuses commandes ;
  • améliorer le cycle de vie du développement d'applications.
Cette rubrique permet de gérer les ressources suivantes dans votre environnement :
  • les serveurs d'applications,
  • Noeuds
  • Profils
  • Hôtes virtuels
  • Tables d'autorisation
  • Domaines de réplication de données
  • Mappes de variables
  • Fournisseurs JDBC (Java™ Database Connectivity)
  • Fournisseurs d'URL (Uniform Resource Locator)
  • Fournisseurs de messagerie
  • Fournisseur d'environnement de ressources
  • Adaptateurs de ressources J2C (Java™ 2 Connector)
Eviter les incidents Eviter les incidents: Un fichier de propriétés du système d'exploitation z/OS n'est pas directement applicable dans un système d'exploitation réparti. De même, un fichier de propriétés de système d'exploitation réparti n'est pas directement applicable à un système d'exploitation z/OS. gotcha
Effectuez les opérations ci-après pour extraire un fichier de propriétés d'un serveur d'applications, éditer les propriétés et les appliquer à votre configuration. Vous pouvez également utiliser le mode interactif avec ces commandes, tel qu'illustré dans la syntaxe ci-après :
AdminTask.commandName('-interactive')

Procédure

Modifiez la configuration d'un serveur d'applications et appliquez les modifications à l'aide d'un fichier de propriétés.
  1. Démarrez l'outil wsadmin.
  2. Extrayez la configuration de serveur d'applications à modifier.
    Utilisez la commande extractConfigProperties pour extraire la configuration de l'objet, tel qu'illustré dans l'exemple Jython suivant :
    AdminTask.extractConfigProperties('-propertiesFileName ConfigProperties_server1.props 
    -configData Server=server1')
    Le système extrait le fichier de propriétés qui contient les attributs et les objets de configuration du serveur d'applications server1.
  3. Ouvrez le fichier de propriétés et éditez manuellement les valeurs d'attribut qui vous intéressent.
    Eviter les incidents Eviter les incidents: Etant donné que vous éditez manuellement le fichier de propriétés, faites-en au préalable une copie de sauvegarde. gotcha
    L'exemple suivant affiche une section d'un fichier de propriétés de serveur d'applications :
    #
    # Configuration properties file for
    cells/myCell/nodes/myNode/servers/server1|server.xml#
    # Extracted on Thu Sep 06 00:27:26 CDT 2007
    #
    #
    # Section 1.0 ##
    cells/myCell/nodes/myNode/servers/server1|server.xml#server1
    #
    #
    # SubSection 1.0 # Server Section
    #
    ResourceType=Server
    ImplementingResourceType=Server
    ResourceId=cells/myCell/nodes/myNode/servers/server1|server.xml#server1
    #
    #
    #Properties
    #
    shortName=null
    serverType=APPLICATION_SERVER
    developmentMode=false #boolean
    name=server1
    parallelStartEnabled=true #boolean
    clusterName=C
    modelId=null
    uniqueId=null
    #
    Pour modifier le serveur d'applications pour qu'il s'exécute en mode développement et désactiver le démarrage parallèle, modifiez les attributs developmentMode et parallelStartEnabled, comme dans l'exemple suivant :
    #
    # Configuration properties file for
    cells/myCell/nodes/myNode/servers/server1|server.xml#
    # Extracted on Thu Sep 06 00:27:26 CDT 2007
    #
    #
    # Section 1.0 ##
    cells/myCell/nodes/myNode/servers/server1|server.xml#server1
    #
    #
    # SubSection 1.0 # Server Section
    #
    ResourceType=Server
    ImplementingResourceType=Server
    ResourceId=cells/myCell/nodes/myNode/servers/server1|server.xml#server1
    #
    #
    #Properties
    #
    shortName=null
    serverType=APPLICATION_SERVER
    developmentMode=true #boolean
    name=server1
    parallelStartEnabled=false #boolean
    clusterName=C
    modelId=null
    uniqueId=null
    #
  4. Validez le fichier de propriétés.
    Pratiques recommandées Pratiques recommandées: L'une des meilleures pratiques consiste à utiliser la commande validateConfigProperties pour valider le fichier de propriétés modifié avant d'appliquer les modifications, tel qu'illustré dans l'exemple Jython suivant :bprac
    AdminTask.validateConfigProperties('-propertiesFileName ConfigProperties_server1.props
     -reportFileName report.txt')

    La commande renvoie la valeur true si le système valide le fichier de propriétés. La commande renvoie la valeur false si le système ne valide pas le fichier de propriétés.

  5. Appliquez les modifications au serveur d'applications.
    La commande applyConfigProperties permet d'appliquer les modifications au serveur d'applications.
    AdminTask.applyConfigProperties('-propertiesFileName ConfigProperties_server1.props 
    -validate true')
  6. Sauvegardez les modifications.
    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=txml_7modenvconfig
Nom du fichier : txml_7modenvconfig.html