You can use the Jacl or Jython scripting languages to manage application editions. You can also use the AdminApp object to manage applications with specific editions.
The activateEdition command activates an edition.
Target object
None.
Parameters
Return value
Batch mode example usage
$AdminTask activateEdition {-appName BeenThere -edition 1.0}
AdminTask.activateEdition ('[-appName BeenThere -edition 1.0]')
AdminTask.activateEdition (['-appName', 'BeenThere', '-edition', '1.0'])
Interactive mode example usage
$AdminTask activateEdition {-interactive}
AdminTask.activateEdition ('[-interactive]')
AdminTask.activateEdition (['-interactive'])
The deactivateEdition command deactivates an edition.
Target object
None.
Parameters
Return value
Batch mode example usage
$AdminTask deactivateEdition {-appName BeenThere -edition 1.0}
AdminTask.deactivateEdition ('[-appName BeenThere -edition 1.0]')
AdminTask.deactivateEdition (['-appName', 'BeenThere', '-edition', '1.0'])
Interactive mode example usage
$AdminTask deactivateEdition {-interactive}
AdminTask.deactivateEdition ('[-interactive]')
AdminTask.deactivateEdition (['-interactive'])
The rolloutEdition command rolls out an edition and specifies the group size.
Target object
None.
Parameters
DEFAULT: Cluster members and servers quiesce when active dialogs and sessions complete.
INTERVAL: Cluster members and servers quiesce after a specified interval. You must also specify the quiesceInterval as an integer value in number of seconds.
Return value
Batch mode example usage
$AdminTask rolloutEdition {-appName BeenThere -edition 1.0 -params “{rolloutStrategy grouped}{resetStrategy soft}{groupSize 1}{drainageInterval 30}”}
$AdminTask rolloutEdition {-appName BeenThere -edition 1.0 -params “{quiesceStrategy INTERVAL}{quiesceInterval 30}”}
AdminTask.rolloutEdition ('[-appName BeenThere -edition 1.0 -params “{rolloutStrategy grouped}{resetStrategy soft}{groupSize 1}{drainageInterval 30}”]')
AdminTask.rolloutEdition ('[-appName BeenThere -edition 1.0 -params “{quiesceStrategy INTERVAL}{quiesceInterval 30}”]')
AdminTask.rolloutEdition ('[-appName BeenThere -edition 1.0 -params [[rolloutStrategy grouped][resetStrategy soft][groupSize 1][drainageInterval 30]]]')
AdminTask.rolloutEdition (['-appName', 'BeenThere', '-edition', '1.0', '-params', '{rolloutStrategy grouped}{resetStrategy soft}{groupSize 1}{drainageInterval 30}'])
AdminTask.rolloutEdition (['-appName', 'BeenThere', '-edition', '1.0', '-params', '{quiesceStrategy INTERVAL}{quiesceInterval 30}'])
AdminTask.rolloutEdition (['-appName', 'BeenThere', '-edition', '1.0', '-params', '[[rolloutStrategy grouped][resetStrategy soft][groupSize 1][drainageInterval 30]]'])
Interactive mode example usage
$AdminTask rolloutEdition {-interactive}
AdminTask.rolloutEdition ('[-interactive]')
AdminTask.rolloutEdition (['-interactive'])
The validateEdition command validates an edition.
Target object
None.
Parameters
Return value
Batch mode example usage
$AdminTask validateEdition {-appName BeenThere -edition 1.0 -params “{dynClusterMaxSize 2}{dynClusterMinSize 1}”}
AdminTask.validateEdition ('[-appName BeenThere -edition 1.0 -params “{dynClusterMaxSize 2}{dynClusterMinSize 1}”]')
AdminTask.validateEdition ('[-appName BeenThere -edition 1.0 -params [[dynClusterMaxSize 2][dynClusterMinSize 1]]]')
AdminTask.validateEdition (['-appName', 'BeenThere', '-edition', '1.0', '-params', '{dynClusterMaxSize 2}{dynClusterMinSize 1}'])
AdminTask.validateEdition (['-appName', 'BeenThere', '-edition', '1.0', '-params', '[[dynClusterMaxSize 2][dynClusterMinSize 1]]'])
Interactive mode example usage
$AdminTask validateEdition {-interactive}
AdminTask.validateEdition ('[-interactive]')
AdminTask.validateEdition (['-interactive'])
The listEditions command provides a list of all the installed editions of the application.
Target object
None.
Parameters
Return value
Batch mode example usage
$AdminTask listEditions {-appName HelloWorld}
AdminTask.listEditions ('[-appName HelloWorld]')
AdminTask.listEditions (['-appName', 'HelloWorld'])
Interactive mode example usage
$AdminTask listEditions {-interactive}
AdminTask.listEditions ('[-interactive]')
AdminTask.listEditions (['-interactive'])
The isEditionExists command verifies that the specified edition exists for the particular application.
Target object
None.
Parameters
Return value
Batch mode example usage
$AdminTask isEditionExists {-appName HelloWorld -edition 2.0}
AdminTask.isEditionExists ('[-appName HelloWorld -edition 2.0]')
AdminTask.isEditionExists (['-appName', 'HelloWorld', '-edition', '2.0'])
Interactive mode example usage
$AdminTask isEditionExists {-interactive}
AdminTask.isEditionExists ('[-interactive]')
AdminTask.isEditionExists (['-interactive'])
The cloneDynamicCluster command clones a dynamic cluster to use a different node group.
Target object
None.
Parameters
For more information about operational modes, see Dynamic clusters.
Batch mode example usage
$AdminTask cloneDynamicCluster {-clusterName SourceCluster -newClusterName newCluster -nodeGroupName CloneNodeGroup -opMode supervised}
$AdminTask cloneDynamicCluster {-clusterName SourceCluster -newClusterName newCluster -nodeGroupName CloneNodeGroup -opMode supervised –templateName xdCell/xdNode/SourceCluster_member1}
AdminTask.cloneDynamicCluster ('[-clusterName SourceCluster -newClusterName newCluster -nodeGroupName CloneNodeGroup -opMode supervised]')
AdminTask.cloneDynamicCluster ('[-clusterName SourceCluster -newClusterName newCluster -nodeGroupName CloneNodeGroup -opMode supervised –templateName xdCell/xdNode/SourceCluster_member1]')
AdminTask.cloneDynamicCluster (['-clusterName', 'SourceCluster', '-newClusterName', 'newCluster', '-nodeGroupName', 'CloneNodeGroup', '-opMode', 'supervised'])
AdminTask.cloneDynamicCluster (['-clusterName', 'SourceCluster', '-newClusterName', 'newCluster', '-nodeGroupName', 'CloneNodeGroup', '-opMode', 'supervised', '–templateName', 'xdCell/xdNode/SourceCluster_member1'])
Interactive mode example usage
$AdminTask cloneDynamicCluster {-interactive}
AdminTask.cloneDynamicCluster ('[-interactive]')
AdminTask.cloneDynamicCluster (['-interactive'])
The cancelValidation command cancels the validation mode on an application edition.
The getEditionState command returns the state of the application edition. The state of an existing edition can be either ACTIVE, INACTIVE or VALIDATE. For a non-existent application or edition the method returns null.
Target object
None.
Parameters
Return value
Batch mode example usage
$AdminTask cancelValidation {-appName BeenThere -edition 1.0}
AdminTask.cancelValidation ('[-appName BeenThere -edition 1.0]')
AdminTask.cancelValidation (['-appName', 'BeenThere', '-edition', '1.0'])
Interactive mode example usage
$AdminTask cancelValidation {-interactive}
AdminTask.cancelValidation ('[-interactive]')
AdminTask.cancelValidation (['-interactive'])
The getEditionState command returns the state of the application edition. The state of an existing edition can be either ACTIVE, INACTIVE or VALIDATE. For a non-existent application or edition, the method returns null.
Target object
None.
Parameters
Return value
Batch mode example usage
$AdminTask getEditionState {-appName BeenThere -edition 1.0}
AdminTask.getEditionState ('[-appName BeenThere -edition 1.0]')
AdminTask.getEditionState (['-appName', 'BeenThere', '-edition', '1.0'])
Interactive mode example usage
$AdminTask getEditionState {-interactive}
AdminTask.getEditionState ('[-interactive]')
AdminTask.getEditionState (['-interactive'])
Use the AdminApp install command to install an application with an edition. You must pass the -edition parameter to specify the edition identifier.
$AdminApp install /tmp/BeenThere1.0.ear {-appname BeenThere -edition 1.0 -nopreCompileJSPs -distributeApp -nouseMetaDataFromBinary -nodeployejb -createMBeansForResources -noreloadEnabled -nodeployws -validateinstall warn -noprocessEmbeddedConfig -filepermission .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 -noallowDispatchRemoteInclude -noallowServiceRemoteInclude -MapModulesToServers {{"BeenThere WAR" BeenThere.war,WEB-INF/web.xml WebSphere:cell=TestCell,cluster=TestClusterB} {"BeenThere EJB" BeenThere.jar,META-INF/ejb-jar.xml WebSphere:cell=TestCell,cluster=TestClusterB}}}
AdminApp.install("/tmp/BeenThere1.0.ear", '[-appname BeenThere -edition 1.0 -nopreCompileJSPs -distributeApp -nouseMetaDataFromBinary -nodeployejb -createMBeansForResources -noreloadEnabled -nodeployws -validateinstall off -processEmbeddedConfig -filepermission .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 -buildVersion Unknown -noallowDispatchRemoteInclude -noallowServiceRemoteInclude -MapModulesToServers [["BeenThere WAR" BeenThere.war,WEB-INF/web.xml WebSphere:cell=TestCell,cluster=TestClusterB] ["BeenThere EJB" BeenThere.jar,META-INF/ejb-jar.xml WebSphere:cell=TestCell,cluster=TestClusterB]]]')
Use the AdminApp update command to update an application with an edition. Pass the full application name, which is the name of the application and the edition, to specify the edition.
$AdminApp update BeenThere-edition1.0 app {-operation update -contents /tmp/BeenThereE1-update.ear -nopreCompileJSPs -distributeApp -nouseMetaDataFromBinary -nodeployejb -createMBeansForResources -noreloadEnabled -nodeployws -validateinstall warn -noprocessEmbeddedConfig -filepermission .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 -noallowDispatchRemoteInclude -noallowServiceRemoteInclude}
AdminApp.update('BeenThere-edition1.0', 'app', '[-operation update -contents /tmp/BeenThereE1-update.ear -nopreCompileJSPs -distributeApp -nouseMetaDataFromBinary -nodeployejb -createMBeansForResources -noreloadEnabled -nodeployws -validateinstall warn -noprocessEmbeddedConfig -filepermission .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 -noallowDispatchRemoteInclude -noallowServiceRemoteInclude]')
Use the AdminApp edit command to edit an application with an edition. Pass the full application name, which is the name of the application and the edition, to specify the edition.
$AdminApp edit BeenThere-edition1.0 {-CtxRootForWebMod {{"BeenThere WAR" BeenThere.war,WEB-INF/web.xml /beenthere}}}
AdminApp.edit('BeenThere-edition1.0', '[-CtxRootForWebMod [["BeenThere WAR" BeenThere.war,WEB-INF/web.xml /beenthere]]]')
Use the AdminApp uninstall command to uninstall an application with an edition. Pass the full application name, which is the name of the application and the edition, to specify the edition.
$AdminApp uninstall BeenThere-edition1.0
AdminApp.uninstall('BeenThere-edition1.0')