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 - Using Jacl:
- 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 - Using Jacl:
- 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 - Using Jacl:
- 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. - Using Jacl:
- Save the configuration, for example:
- Using Jacl:
$AdminConfig save
- Using Jython:
AdminConfig.save()
- Using Jacl:
- 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}
- Using Jacl: