Editing application configurations using the wsadmin scripting tool

Use the wsadmin tool to configure application settings.

Use the AdminApp edit or editInteractive command to change an entire application or a single application module.

We can set or update a configuration value using options in batch mode. To identify which configuration object is to be set or updated, the values of read only fields are used to find the corresponding configuration object. All the values of read only fields have to match with an existing configuration object, otherwise the command fails.

Use pattern matching to simplify the task of supplying required values for certain complex options. Pattern matching only applies to fields required or read only.

If an application is running, changing an application setting causes the application to restart. On stand-alone servers, the application restarts after we save the change. On multiple-server products, the application restarts after we save the change and files synchronize on the node where the application is installed. To control when synchronization occurs on multiple-server products, deselect Synchronize changes with nodes on the Console preferences page.

Tasks

1. Start the wsadmin scripting tool.

2. Edit the entire application or a single application module. Using one of the following commands:
   • The following command uses the installed application and the command option information to edit the application:
     • Jacl:

       $AdminApp edit appname {options}
       

     • Jython list:

       AdminApp.edit('appname', ['options'])
       

     • Jython string:

       AdminApp.edit('appname', '[options]')
       

     Element	Description
     $	is a Jacl operator for substituting a variable name with its value
     AdminApp	is an object that supports application object management
     edit	is an AdminApp command
     appname	is the name of application or application module to edit. For the application module name, use the module name returned from listModules command as the value.
     {options}	is a list of edit options and tasks similar to the ones for the install command

   • The following command changes the application information by prompting you through a series of editing tasks:
     • Jacl:

       $AdminApp editInteractive appname
       

     • Jython:

       AdminApp.editInteractive('appname')
       

     Element	Description
     $	is a Jacl operator for substituting a variable name with its value
     AdminApp	is an object that supports application object management
     editInteractive	is an AdminApp command
     appname	is the name of application or application module to edit. For the application module name, use the module name returned from listModules command as the value.

3. Save the configuration changes.

   AdminConfig.save()
   

4. In a network deployment environment only, synchronize the node.

   Use the syncActiveNode or syncNode scripts in the AdminNodeManagement script library to propagate the configuration changes to node or nodes.

   • Use the syncActiveNodes script to propagate the changes to each node in the cell:

     AdminNodeManagement.syncActiveNodes()
     

   • Use the syncNode script to propagate the changes to a specific node:

     AdminNodeManagement.syncNode("myNode")
     

Start the wsadmin scripting client

Synchronize nodes

Use the script library to automate the application serving environment

wsadmin AdminApp

Commands for the AdminApp object