Modify configuration objects with the wsadmin tool

You can modify configuration objects using scripting and the wsadmin tool. Before starting this task, the wsadmin tool must be running. See the Starting the wsadmin scripting client article for more information.

Overview

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...

   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...

   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, 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 /temp/db2j.jar]]

   Using Jython list:

   AdminConfig.modify(jdbcProvider1, [['description', []]])
   
   AdminConfig.modify(jdbcProvider1, [['description', '/temp/db2j.jar']]

   Using Jython string:

   AdminConfig.modify(jdbcProvider1, '[]')
   
   AdminConfig.modify(jdbcProvider1, '[[description /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 Reference