Crear, modificar y suprimir objetos de configuración utilizando un archivo de propiedades

Puede especificar la creación, modificación y supresión de objetos en un archivo de propiedades. Ejecute el mandato applyConfigProperties para aplicar los cambios de configuración.

Antes de empezar

Determinar los cambios que desea realizar en los objetos de configuración.

Acerca de esta tarea

Con el grupo de mandatos PropertiesBasedConfiguration para el objeto AdminTask, puede utilizar archivos de propiedades para crear, modificar y eliminar objetos de configuración de sus entornos.

Puede crear, suprimir y modificar objetos utilizando un archivo de propiedades. Especifique en la cabecera de la sección de las propiedades DELETE=true para suprimir un objeto completo o DELTEPROP=true para suprimir una propiedad de objeto y, a continuación, ejecute el mandato applyConfigProperties para aplicar el archivo de propiedades. Con este procedimiento, no es necesario que ejecute el mandato deleteConfigProperties para eliminar un objeto.

Avoid trouble Avoid trouble: No puede aplicar directamente un archivo de propiedades del sistema operativo z/OS a un sistema operativo distribuido. De manera similar, no puede aplicar directamente un archivo de propiedades de sistema operativo distribuido a un sistema operativo z/OS. Consulte el tema sobre la aplicación de archivos de propiedades portátiles en varios entornos.gotcha

Procedimiento

  1. Inicie la herramienta de scripts wsadmin.
  2. Extraiga un archivo de propiedades para el subtipo relevante para su configuración.
    Utilice el mandato extractConfigProperties para extraer el archivo de propiedades para el recurso que le interese. El ejemplo siguiente extrae las propiedades para el recurso JDBCProvider en el archivo derby.props:
    AdminTask.extractConfigProperties('[-propertiesFileName derby.props -configData 
     Server=server1 -filterMechanism SELECTED_SUBTYPES -selectedSubTypes [JDBCProvider]]')
    El mandato genera un archivo de plantilla parecido a la plantilla de ejemplo siguiente:
    #
    # SubSección 1.0 # Atributos de JDBCProvider
    #
    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. Edite el archivo de propiedades extraído para especificar que cree, modifique o suprima objetos de configuración.

    Para crear un nuevo objeto o modificar o suprimir un objeto existente, edite el archivo de propiedades extraído. Puede especificar una o más operaciones de creación, modificación y supresión en el mismo archivo de propiedades.

    • Para crear un nuevo objeto, especifique propiedades exclusivas para un objeto. Establezca el atributo ResourceId en un valor que no exista en la configuración.

      En el ejemplo siguiente se crea un nuevo objeto DataSource, DefaultDatasource_1, que no existe en la configuración:

      #
      # Crear un nuevo objeto
      #
      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)
    • Para modificar un objeto existente, cambie una o más propiedades del objeto.

      En el ejemplo siguiente se cambia la propiedad description del objeto DefaultDatasource_1 añadiendo _1 al final de la descripción:

      #
      # Modificar una propiedad
      #
      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
    • Para suprimir una propiedad del objeto existente, especifique DELETEPROP=true en la cabecera del archivo de propiedades.

      En el ejemplo siguiente se suprime la propiedad description:

      #
      # Suprimir una propiedad
      #
      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
    • Para suprimir un objeto existente, especifique DELETE=true en la cabecera del archivo de propiedades.

      En el ejemplo siguiente se suprime el objeto DefaultDatasource:

      #
      # Suprimir un objeto existente
      #
      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. Ejecute el mandato applyConfigProperties para aplicar el archivo de propiedades y cambiar la configuración.

    El mandato de ejemplo siguiente se aplica al archivo de propiedades derby.props:

    AdminTask.applyConfigProperties('[-propertiesFileName derby.props]')
    El mandato valida automáticamente el archivo de propiedades y, a continuación, aplica los cambios a la configuración.
    Avoid trouble Avoid trouble: Si ejecuta el mandato applyConfigProperties antes de añadir el atributo DELETE=true y el valor al archivo de propiedades, el mandato restablece las propiedades a sus valores predeterminados. El sistema elimina completamente las propiedades que no tengan valores predeterminados.gotcha

Resultados

El mandato administrativo se ejecuta y aplica el archivo de propiedades.

Qué hacer a continuación

Guarde los cambios en la configuración.


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_prop_crud
File name: txml_prop_crud.html