Creating configuration objects using the wsadmin tool

 

Creating configuration objects using the wsadmin tool

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

Perform this task if you want to create an object. To create new objects from the default template, use the create command. Alternatively, you can create objects using an existing object as a template with the createUsingTemplate command.

  1. Use the AdminConfig object listTemplates command to list available templates:

    • Using Jacl: 
      $AdminConfig listTemplates JDBCProvider

    • Using Jython:
      AdminConfig.listTemplates('JDBCProvider')

    where:

    $ is a Jacl operator for substituting a variable name with its value
    AdminConfig is an object representing the WebSphere Application Server configuration
    listTemplates is an AdminConfig command
    JDBCProvider is an object type

  2. Assign the ID string that identifies the existing object to which the new object is added. You can add the new object under any valid object type. The following example uses a node as the valid object type:

    • Using Jacl: 
      set n1 [$AdminConfig getid /Node:mynode/]

    • Using Jython:
      n1 =  AdminConfig.getid('/Node:mynode/')

    where:

    set is a Jacl command
    $ is a Jacl operator for substituting a variable name with its value
    n1 is a variable name
    AdminConfig is an object representing the WebSphere Application Server configuration
    getid is an AdminConfig command
    Node is an object type
    mynode is the host name of the node where the new object is added

  3. Specify the template that you want to use:

    where:

    set is a Jacl command
    $ is a Jacl operator for substituting a variable name with its value
    t1 is a variable name
    AdminConfig is an object representing the WebSphere Application Server configuration
    listTemplates is an AdminConfig command
    JDBCProvider is an object type
    DB2 JDBC Provider (XA) is the name of the template to use for the new object
    If you supply a string after the name of a type, you get back a list of templates with display names that contain the string you supplied. In this example, the AdminConfig listTemplates command returns the JDBCProvider template whose name matches DB2 JDBC Provider (XA). This example assumes that the variable that you specify here only holds one template configuration ID. If the environment contains multiple templates with the same string, for example, DB2 JDBC Provider (XA), the variable will hold the configuration IDs of all of the templates. Be sure to identify the specific template that you want to use before you perform the next step, creating an object using a template.

  4. Create the object with the following command:

    • Using Jacl: 
      $AdminConfig createUsingTemplate JDBCProvider $n1 {{name newdriver}} $tl

    • Using Jython:
      AdminConfig.createUsingTemplate('JDBCProvider', n1, [['name', 'newdriver']], t1)

    where:

    $ is a Jacl operator for substituting a variable name with its value
    AdminConfig is an object representing the WebSphere Application Server configuration
    createUsingTemplate is an AdminConfig command
    JDBCProvider is an object type
    n1 evaluates the ID of the host node specified in step number 3
    name is an attribute of JDBCProvider objects
    newdriver is the value of the name attribute
    t1 evaluates the ID of the template specified in step number 4

    All create commands use a template unless there are no templates to use. If a default template exists, the command creates the object.

  5. Save the configuration changes. See the Saving configuration changes with the wsadmin tool article for more information.

  6. In a network deployment environment only, synchronize the node. See the Synchronizing nodes with the wsadmin tool article for more information.


Related concepts
AdminConfig object for scripted administration

Related reference
Commands for the AdminConfig object