使用一个属性文件来创建、修改和删除配置对象

您可以指定在一个属性文件中创建、修改和删除对象。您运行 applyConfigProperties 命令以应用配置更改。

开始之前

确定您要对配置对象进行的更改。

关于此任务

使用 AdminTask 对象的 PropertiesBasedConfiguration 命令组,您可以使用属性文件,在环境中创建、修改和删除配置对象。

您可以使用一个属性文件来创建、删除和修改对象。 在属性部分的头中指定 DELETE=true 以删除整个对象或指定 DELTEPROP=true 以删除对象属性,然后运行 applyConfigProperties 命令来应用属性文件。对于此方式,您无需运行 deleteConfigProperties 命令来删除对象。

避免故障 避免故障: 无法将 z/OS® 操作系统属性文件直接应用到分布式操作系统。类似地,您无法将分布式操作系统属性文件直接应用到 z/OS 操作系统。请参阅关于在多个环境之间应用可移植的属性文件的主题。gotcha

过程

  1. 启动 wsadmin 脚本编制工具。
  2. 从配置中抽取相关子类型的属性文件。
    使用 extractConfigProperties 命令来抽取相关资源的属性文件。以下示例将 JDBCProvider 资源的属性抽取到 derby.props 文件:
    AdminTask.extractConfigProperties('[-propertiesFileName derby.props -configData 
     Server=server1 -filterMechanism SELECTED_SUBTYPES -selectedSubTypes [JDBCProvider]]')
    此命令会生成类似以下样本模板的模板文件:
    #
    # 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. 编辑抽取的属性文件以指定它创建、修改或删除配置对象。

    要创建新对象、修改或者删除现有对象,请编辑抽取的属性文件。您可以在同一属性文件中指定一个或多个创建、修改和删除操作。

    • 要新建对象,请为对象指定唯一的属性。 将 ResourceId 属性设置为您配置中不存在的值。

      以下示例新建 DataSource 对象 DefaultDatasource_1,在配置中不存在此对象:

      #
      # Create a new object
      #
      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)
    • 要修改现有对象,请更改一个或多个对象属性。

      以下示例通过将 _1 添加到描述末尾来更改 DefaultDatasource_1 对象的 description 属性:

      #
      # Modify a property
      #
      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
    • 要删除现有对象属性,请在属性文件头中指定 DELETEPROP=true

      以下示例删除 description 属性:

      #
      # Delete a property
      #
      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
    • 要删除现有对象,请在属性文件头中指定 DELETE=true

      以下示例删除 DefaultDatasource 对象:

      #
      # Delete an existing object
      #
      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. 运行 applyConfigProperties 命令来应用属性文件并更改您的配置。

    以下示例命令应用 derby.props 属性文件:

    AdminTask.applyConfigProperties('[-propertiesFileName derby.props]')
    该命令自动验证属性文件,然后将更改应用于您的配置。
    避免故障 避免故障: 如果在将 DELETE=true 属性和值添加到属性文件之前运行 applyConfigProperties 命令,那么此命令会将每个属性重置为缺省值。系统会完全除去不含缺省值的属性。gotcha

结果

管理命令运行并应用属性文件。

下一步做什么

将更改保存到配置。


指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_prop_crud
文件名:txml_prop_crud.html