Modifying WAR class loader mode using wsadmin scripting

You can use scripting and the wsadmin tool to modify WAR class loader mode for applications.

Before you begin

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

About this task

Attention: If an application is running, changing an application setting causes the application to restart. On stand-alone servers, the application restarts after you save the change. On multiple-server products, the application restarts after you 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.

To modify WAR class loader mode for an application, complete the following steps:

Procedure

Set a reference to the deployment.xml document.

For example:

Using Jacl:

set deployments [$AdminConfig getid /Deployment:my_application/]

Example output:

application_name(cells/cell_name/applications/application_name.ear/deployments/
application_name|deployment.xml#Deployment_1276887608391)

Using Jython:

deployments = AdminConfig.getid('/Deployment:my_application/')

Table 1. Deployment configuration values. The following table describes the elements of the getid command.
Element	Definition
`set`	is a Jacl command
`deployments`	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
`Deployment`	is an attribute
`my_application`	is an application in the `profile_root`/config/cells/`cell_name`/applications/ directory

Set a reference to the deployedObject attribute within the deployment.xml document and set it to the deployedObject variable.

For example:

Using Jacl:

set deploymentObject [$AdminConfig showAttribute $deployments deployedObject]

Example output:

(cells/cell_name/applications/application_name.ear/deployments/
application_name|deployment.xml#ApplicationDeployment_1276887608391)

Using Jython:

deploymentObject = AdminConfig.showAttribute(deployments, 'deployedObject')

Table 2. Deployment configuration values. The following table describes the elements in this command.
Element	Definition
`set`	is a Jacl command
`deploymentObject`	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
showAttribute	is an AdminConfig command
`deployments`	is a variable to which the deployment.xml document is assigned
`deployedObject`	is an attribute within the deployment.xml document

List the modules for the deployedObject attribute and set the list to the myModules variable.

For example:

Using Jacl:

set myModules [lindex [$AdminConfig showAttribute $deploymentObject modules] 0]

Example output:

(cells/cell_name/applications/application_name.ear/deployments/
application_name|deployment.xml#WebModuleDeployment_1276887608391) 
(cells/cell_name/applications/application_name.ear/deployments/
application_name|deployment.xml#EJBModuleDeployment_1276887608391)

Using Jython:

myModules = AdminConfig.showAttribute(deploymentObject, 'modules')
myModules = myModules[1:len(myModules)-1].split(" ")
print myModules

Example output:

['(cells/cell_name/applications/application_name.ear/deployments/
application_name|deployment.xml#WebModuleDeployment_1276887608391)', 
'(cells/cell_name/applications/application_name.ear/deployments/
application_name|deployment.xml#EJBModuleDeployment_1276887608391)']

Table 3. Deployment configuration values. The following table describes the elements in this command.
Element	Definition
`set`	is a Jacl command
`myModules`	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
showAttribute	is an AdminConfig command
`deployedObject`	is an attribute within the deployment.xml document
`modules`	is an attribute within the deployment.xml document

Find the web module and set the mode for the class loader.

For example:

Using Jacl:

foreach module $myModules {
     if {[regexp WebModuleDeployment $module] == 1} {
        $AdminConfig modify $module {{classloaderMode mode}}}}

Using Jython

for module in myModules:
     if (module.find('WebModuleDeployment')!= -1):
        AdminConfig.modify(module, [['classloaderMode', 'mode']])

Table 4. Deployment configuration values. The following table describes the elements in this command.
Element	Definition
`foreach`	is a Jacl command
`for`	is a Jython command
`module`	is an object that is being modified
`$`	is a Jacl operator for substituting a variable name with its value
`myModules`	is a variable name
`regexp`	is a function to use regular expression is used for searching within the previous commands
`module.find`	is a function to use regular expression is used for searching within the previous commands
`AdminConfig`	is an object that represents the WebSphere Application Server configuration
modify	is an AdminConfig command
`classloaderMode`	is an attribute within the deployment.xml document
`mode`	is the class loader mode value that you want to set for the WAR module. The mode value is either PARENT_FIRST or PARENT_LAST. For more information, see the documentation about class loaders.

Save the configuration, for example:
- Using Jacl:
```
$AdminConfig save
```
- Using Jython:
```
AdminConfig.save()
```

Verify the changes that you made to the attribute value with the showall command.

For example:

Using Jacl:
```
$AdminConfig showall $module
```

Using Jython:

AdminConfig.showall(module)

Example output:

{applicationDeployment (cells/cell_name/applications/application_name.ear/deployments/
application_name|deployment.xml#ApplicationDeployment_1276887608391)}

{classloader (cells/cell_name/applications/application_name.ear/deployments/
application_name|deployment.xml#Classloader_1276887608392)}
{classloaderMode mode}
{configs {}}
{deploymentId 1}
{startingWeight 10000}
{targetMappings {(cells/cell_name/applications/application_nameear/deployments/
application_name|deployment.xml#DeploymentTargetMapping_1276887608392)}}
{uri WAR_file_name.war}