Création, modification et suppression d'objets de configuration en utilisant un fichier de propriétés

Vous pouvez spécifier que vous voulez créer, modifier et supprimer des objets dans un fichier de propriétés. Vous pouvez exécuter la commande applyConfigProperties pour appliquer les modifications de configuration.

Avant de commencer

Déterminez les modifications à apporter aux objets de configuration.

Pourquoi et quand exécuter cette tâche

En utilisant le groupe de commandes PropertiesBasedConfiguration de l'objet AdminTask, vous pouvez utiliser des fichiers de propriétés pour créer, modifier et supprimer des objets de configuration dans l'environnement

Vous pouvez créer, supprimer et modifier des objets en utilisant un fichier de propriétés. Définissez DELETE=true dans l'en-tête de la section des propriétés pour supprimer la totalité d'un objet ou DELTEPROP=true pour supprimer une propriété d'objet et exécutez la commande applyConfigProperties pour appliquer le fichier de propriétés. En procédant ainsi, vous n'avez pas à exécuter la commande deleteConfigProperties pour supprimer un objet.

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 z/OS. Voir la rubrique relative à l'application des fichiers de propriétés portables dans plusieurs environnements.gotcha

Procédure

  1. Démarrez l'outil de scriptage wsadmin.
  2. Extrayez de votre configuration un fichier de propriétés du sous-type qui vous intéresse.
    La commande extractConfigProperties permet d'extraire le fichier de propriétés de la ressource qui vous intéresse. Dans l'exemple suivant, les propriétés de la ressource JDBCProvider sont extraites dans le fichier derby.props :
    AdminTask.extractConfigProperties('[-propertiesFileName derby.props -configData 
     Server=server1 -filterMechanism SELECTED_SUBTYPES -selectedSubTypes [JDBCProvider]]')
    Cette commande génère un fichier modèle semblable à l'exemple de modèle suivant :
    #
    # SubSection 1.0 # JDBCProvider attributes
    #
    ResourceType=JDBCProvider
    ImplementingResourceType=JDBCProvider
    ResourceId=Cell=!{cellName}:ServerCluster=!{clusterName}:JDBCProvider=Derby JDBC
     Provider (XA)
    #
    
    #
    #Properties
    #
    classpath={${DERBY_JDBC_DRIVER_PATH}/derby.jar}
    name=Derby JDBC Provider (XA) #required
    implementationClassName=org.apache.derby.jdbc.EmbeddedXADataSource #required
    isolatedClassLoader=false #boolean,default(false)
    nativepath={}
    description=Built-in Derby JDBC Provider (XA)
    providerType=Derby JDBC Provider (XA) #readonly
    xa=true #boolean,default(false)
  3. Modifiez le fichier de propriétés extrait pour indiquer qu'il crée, modifie ou supprime des objets de configuration.

    Pour créer un objet ou modifier ou supprimer un objet existant, modifiez le fichier de propriétés extrait. Vous pouvez définir une ou plusieurs opérations de création, de modification et de suppression dans un même fichier de propriétés.

    • Pour créer un objet, définissez des propriétés uniques pour l'objet. Affectez à l'attribut ResourceId une valeur qui n'existe pas dans la configuration.

      L'exemple suivant permet de créer l'objet DataSource, DefaultDatasource_1, qui n'existe pas dans la configuration :

      #
      # Créer un objet
      #
      ResourceType=DataSource
      ImplementingResourceType=GenericType
      ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:JDBCProvider=Derby JDBC Provider:DataSource=jndiName#DefaultDatasource_1
      #
      
      #
      #Properties
      #
      name=DefaultApp Datasource1 #required
      jndiName=DefaultDatasource_1
      manageCachedHandles=false #boolean,default(false)
      provider=Derby JDBC Provider #ObjectName(JDBCProvider),readonly
      description=Datasource for the WebSphere Default Application
      logMissingTransactionContext=true #boolean,default(true)
    • Pour modifier un objet, changer une ou plusieurs propriétés d'objet.

      L'exemple suivant permet de changer la propriété description de l'objet DefaultDatasource_1 en ajoutant _1 à la fin de la description :

      #
      # Modifier une propriété
      #
      ResourceType=DataSource
      ImplementingResourceType=GenericType
      ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:JDBCProvider=Derby JDBC Provider:DataSource=jndiName#DefaultDatasource_1
      #
      
      #
      #Properties
      #
      description=Datasource for the WebSphere Default Application_1
    • Pour supprimer une propriété d'objet existante, définissez DELETEPROP=true dans l'en-tête du fichier des propriétés.

      L'exemple suivant supprime la propriété description :

      #
      # Supprimer une propriété
      #
      ResourceType=DataSource
      ImplementingResourceType=GenericType
      ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:JDBCProvider=Derby JDBC Provider:DataSource=jndiName#DefaultDatasource_1
      DELETEPROP=true
      #
      
      #
      #Properties
      #
      description=Datasource for the WebSphere Default Application_1
    • Pour supprimer un objet existant, définissez DELETE=true dans l'en-tête du fichier des propriétés.

      L'exemple suivant supprime l'objet DefaultDatasource :

      #
      # Supprimer un objet existant
      #
      ResourceType=DataSource
      ImplementingResourceType=GenericType
      ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:JDBCProvider=Derby JDBC Provider:DataSource=jndiName#DefaultDatasource
      DELETE=true
      #
      
      #
      #Properties
      #
      name=DefaultApp Datasource #required
      jndiName=DefaultDatasource
  4. Exécutez la commande applyConfigProperties pour appliquer le fichier de propriétés et changer la configuration.

    L'exemple suivant applique le fichier de propriétés derby.props :

    AdminTask.applyConfigProperties('[-propertiesFileName derby.props]')
    La commande valide automatiquement le fichier de propriétés, puis applique les modifications à la configuration.
    Eviter les incidents Eviter les incidents: Si vous exécutez la commande applyConfigProperties avant d'ajouter l'attribut et la valeur DELETE=true au fichier de propriétés, la commande restaure la valeur par défaut de chaque propriété. Le système supprime complètement les propriétés n'ayant pas de valeurs par défaut.gotcha

Résultats

La commande d'administration s'exécute et applique le fichier de propriétés.

Que faire ensuite

Sauvegardez les modifications de la configuration.


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_prop_crud
Nom du fichier : txml_prop_crud.html