WebSphere Application Server Network Deployment, Version 6.0.x   Operating Systems: AIX, HP-UX, Linux, Solaris, Windows
             [TIP: Focusing the table of contents and search results]

Modifying configuration objects with the wsadmin tool

You can modify configuration objects using scripting and the wsadmin tool.

Before you begin

Before starting this task, the wsadmin tool must be running. See the Starting the wsadmin scripting client article for more information.

About this task

When using the modify command for the AdminConfig object, use the configuration object ID to modify the attribute you want to change. If you use the parent object ID to modify the attribute, the command resets all other attributes that are not specified to the default values. For example, you use the modify command to change the monitoring policy settings through its parent object, the process definition object. All attributes for the process definition object that were not modified with the command, such as the pingInterval and pingTimeout attributes, are reset to their default values.

Perform the following steps to modify a configuration object:

Procedure

  1. Retrieve the configuration ID of the objects that you want to modify, for example:
    • Using Jacl:

      set jdbcProvider1 [$AdminConfig getid /JDBCProvider:myJdbcProvider/]
      
    • Using Jython:
      jdbcProvider1 = AdminConfig.getid('/JDBCProvider:myJdbcProvider/')
    where:
    set is a Jacl command
    jdbcProvider1 is a variable name
    $ is a Jacl operator for substituting a variable name with its value
    AdminConfig is an object that represents the WebSphere Application Server configuration
    getid is an AdminConfig command
    /JDBCProvider:myJdbcProvider/ is the hierarchical containment path of the configuration object
    JDBCProvider is the object type
    myJdbcProvider is the optional name of the object
  2. Show the current attribute values of the configuration object with the show command, for example:
    • Using Jacl:

      $AdminConfig show $jdbcProvider1
    • Using Jython:
      AdminConfig.show(jdbcProvider1)
    where:
    $ is a Jacl operator for substituting a variable name with its value
    AdminConfig is an object that represents the WebSphere Application Server configuration
    show is an AdminConfig command
    jdbcProvider1 evaluates to the ID of the host node that is specified in step number 1
  3. Modify the attributes of the configuration object, for example:
    • Using Jacl:

      $AdminConfig modify $jdbcProvider1 {{description "This is my new description"}}
    • Using Jython list:
      AdminConfig.modify(jdbcProvider1, [['description', "This is my new description"]])
    • Using Jython string:
      AdminConfig.modify(jdbcProvider1, '[[description "This is my new description"]]')
    where:
    $ is a Jacl operator for substituting a variable name with its value
    AdminConfig is an object that represents the WebSphere Application Server configuration
    modify is an AdminConfig command
    jdbcProvider1 evaluates to the ID of the host node that is specified in step number 1
    description is an attribute of server objects
    This is my new description is the value of the description attribute
    You can also modify several attributes at the same time. For example:
    • Using Jacl:

      {{name1 val1} {name2 val2} {name3 val3}}
    • Using Jython list:
      [['name1', 'val1'], ['name2', 'val2'], ['name3', 'val3']]
    • Using Jython string:
      '[[name1 val1] [name2 val2] [name3 val3]]'
  4. List all of the attributes that can be modified:
    • Using Jacl:

      $AdminConfig attributes JDBCProvider
    • Using Jython:
      print AdminConfig.attributes('JDBCProvider')
    Example output:
    $AdminConfig attributes JDBCProvider
    "classpath String*"
    "description String"
    "implementationClassName String"
    "name String"
    "nativepath String*"
    "propertySet J2EEResourcePropertySet"
    "providerType String"
    "xa boolean"
  5. Modify an attribute that has a type of list and collection. By default, if you try to modify an attribute that has a type of list and collection, and the attribute has an existing value in the list, it will append the new value to the existing values. An attribute that has a type of list and collection will have a star (*). In the following example, the attribute classpath has an type of list and collection and the value is String. If you want to replace the existing value, you must change the classpath to be an empty list before you modify the new value. For example:
    • Using Jacl:

      $AdminConfig modify $jdbcProvider1 {{classpath {}}}
      
      $AdminConfig modify $jdbcProvider1 [list [list classpath c:/temp/db2j.jar]]
    • Using Jython list:

      AdminConfig.modify(jdbcProvider1, [['description', []]])
      
      AdminConfig.modify(jdbcProvider1, [['description', 'c:/temp/db2j.jar']]
    • Using Jython string:

      AdminConfig.modify(jdbcProvider1, '[]')
      
      AdminConfig.modify(jdbcProvider1, '[[description c:/temp/db2j.jar]]')
  6. Save the configuration changes. See the Saving configuration changes with the wsadmin tool article for more information.
  7. In a network deployment environment only, synchronize the node. See the Synchronizing nodes with the wsadmin tool article for more information.



Related tasks
Using the AdminConfig object for scripted administration
Related reference
Commands for the AdminConfig object
Task topic    

Terms of Use | Feedback

Last updated: Mar 8, 2007 8:14:28 PM CST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/txml_calladminconfig.html

© Copyright IBM Corporation 2002, 2006. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)