CoreGroupManagement
Use the Jython or Jacl scripting languages to manage deployed applications. The commands in the CoreGroupManagement group can be used to manage core groups. A core group is a high availability domain that consists of a set of processes in the same cell that can directly establish high availability relationships. A cell must contain at least one core group.
The CoreGroupManagement commands include:
- createCoreGroup
- deleteCoreGroup
- doesCoreGroupExist
- getAllCoreGroupNames
- getCoreGroupNameForServer
- getDefaultCoreGroupName
- moveClusterToCoreGroup
- moveServerToCoreGroup
createCoreGroup
The createCoreGroup command creates a new core group. The core group that we create contains no members.
Target object: None
Parameters and return values
- -coreGroupName
- The name of the core group that we are creating. (String required)
Examples
Batch mode example usage:
- Jacl:
$AdminTask createCoreGroup {-coreGroupName MyCoreGroup} AdminConfig.save()
Optionally, we can use the following sample script to add a description for the new core group:
set core [$AdminConfig getid /Cell:myCell/CoreGroup:MyCoreGroup/]
$AdminConfig modify $core {{description "My Description"}}
$AdminConfig save
- Jython string:
AdminTask.createCoreGroup('[-coreGroupName MyCoreGroup]')
Optionally, we can use the following sample script to add a description for the new core group:
core = AdminConfig.getid('/Cell:myCell/CoreGroup:MyCoreGroup/') AdminConfig.modify(core, [['description', "This is my new description"]]) AdminConfig.save()
- Jython list:
AdminTask.createCoreGroup(['-coreGroupName', 'MyCoreGroup'])
Optionally, we can use the following sample script to add a description for the new core group:
core = AdminConfig.getid('/Cell:myCell/CoreGroup:MyCoreGroup/') AdminConfig.modify(core, [['description', "This is my new description"]]) AdminConfig.save()
Interactive mode example usage:
- Jacl:
$AdminTask createCoreGroup {-interactive}
- Jython string:
AdminTask.createCoreGroup ('[-interactive]')
- Jython list:
AdminTask.createCoreGroup (['-interactive'])
deleteCoreGroup
The command deletes an existing core group. The core group specified must not contain any members. We cannot delete the default core group.
Target object: None
Parameters and return values
- -coreGroupName
- The name of the existing core group that will be deleted. (String required)
Examples
Batch mode example usage:
- Jacl:
$AdminTask deleteCoreGroup {-coreGroupName MyCoreGroup}
- Jython string:
AdminTask.deleteCoreGroup('[-coreGroupName MyCoreGroup]')
- Jython list:
AdminTask.deleteCoreGroup(['-coreGroupName', 'MyCoreGroup'])
Interactive mode example usage:
- Jacl:
$AdminTask deleteCoreGroup {-interactive}
- Jython string:
AdminTask.deleteCoreGroup ('[-interactive]')
- Jython list:
AdminTask.deleteCoreGroup ('[-interactive]')
doesCoreGroupExist
The doesCoreGroupExist command returns a boolean value that indicates if the core group specified exists.
Target object: None
Parameters and return values
- -coreGroupName
- The name of the core group. (String, required)
Examples
Batch mode example usage:
- Jacl:
$AdminTask doesCoreGroupExist {-coreGroupName MyCoreGroup}
- Jython string:
AdminTask.doesCoreGroupExist('[-coreGroupName MyCoreGroup]')
- Jython list:
AdminTask.doesCoreGroupExist(['-coreGroupName', 'MyCoreGroup'])
Interactive mode example usage:
- Jacl:
$AdminTask doesCoreGroupExist {-interactive}
- Jython string:
AdminTask.doesCoreGroupExist ('[-interactive]')
- Jython list:
AdminTask.doesCoreGroupExist (['-interactive'])
getAllCoreGroupNames
The getAllCoreGroupNames command returns a string containing the names of all of the existing core groups
Target object: None
Parameters and return values
- Parameters: None
- Returns: String array (String[ ])
Examples
Batch mode example usage:
- Jacl:
$AdminTask getAllCoreGroupNames
- Jython string:
AdminTask.getAllCoreGroupNames()
- Jython list:
AdminTask.getAllCoreGroupNames()
Interactive mode example usage:
- Jacl:
$AdminTask getAllCoreGroupNames {-interactive}
- Jython string:
AdminTask.getAllCoreGroupNames ('[-interactive]')
- Jython list:
AdminTask.getAllCoreGroupNames (['-interactive'])
getCoreGroupNameForServer
The getCoreGroupNameForServer command returns the name of the core group in which the server specified is currently a member.
Target object: None
Parameters and return values
- -nodeName
- The name of the node containing the server. (String, required)
- -serverName
- The name of the server. (String, required)
Examples
Batch mode example usage:
- Jacl:
$AdminTask getCoreGroupNameForServer {-nodeName myNode -serverName myServer}
- Jython string:
AdminTask.getCoreGroupNameForServer('[-nodeName myNode -serverName myServer]')
- Jython list:
AdminTask.getCoreGroupNameForServer (['-nodeName', 'myNode', '-serverName', 'myServer'])
Interactive mode example usage:
- Jacl:
$AdminTask getCoreGroupNameForServer {-interactive}
- Jython string:
AdminTask.getCoreGroupNameForServer ('[-interactive]')
- Jython list:
AdminTask.getCoreGroupNameForServer (['-interactive'])
getDefaultCoreGroupName
The command returns the name of the default core group.
Target object: None
Parameters and return values
- Parameters: None
- Returns: String
Examples
Batch mode example usage:
- Jacl:
$AdminTask getDefaultCoreGroupName
- Jython string:
AdminTask.getDefaultCoreGroupName()
- Jython list:
AdminTask.getDefaultCoreGroupName()
Interactive mode example usage:
- Jacl:
$AdminTask getDefaultCoreGroupName {-interactive}
- Jython string:
AdminTask.getDefaultCoreGroupName ('[-interactive]')
- Jython list:
AdminTask.getDefaultCoreGroupName (['-interactive'])
moveClusterToCoreGroup
The moveClusterToCoreGroup command moves all of the servers in a cluster specified from a core group to another core group. All of the servers in a cluster must be members of the same core group.
Target object: None
Parameters and return values
- -source
- The name of the core group containing the cluster to move. The core group must exist prior to running this command. The cluster specified must be a member of this core group. (String, required)
- -target
- The name of the core group where we want to move the cluster. (String, required)
- -clusterName
- The name of the cluster to move. (String, required)
Examples
Batch mode example usage:
- Jacl:
$AdminTask moveClusterToCoreGroup {-source OldCoreGroup -target NewCoreGroup -clusterName ClusterOne}
- Jython string:
AdminTask.moveClusterToCoreGroup('[-source OldCoreGroup -target NewCoreGroup -clusterName ClusterOne]')
- Jython list:
AdminTask.moveClusterToCoreGroup (['-source', 'OldCoreGroup', '-target', 'NewCoreGroup', '-clusterName', 'ClusterOne'])
Interactive mode example usage:
- Jacl:
$AdminTask moveClusterToCoreGroup {-interactive}
- Jython string:
AdminTask.moveClusterToCoreGroup ('[-interactive]')
- Jython list:
AdminTask.moveClusterToCoreGroup (['-interactive'])
moveServerToCoreGroup
The moveServerToCoreGroup command moves a server to a core group specified. When the server is added to the core group specified, it is removed from the core group where it originally resided.
Target object: None
Parameters and return values
- -source
- The name of the core group containing the server to move. The core group must already exist with the server specified being a member of the core group. (String, required)
- -target
- The name of the core group where we want to move the server. The core group specified must exist prior to running the command. (String, required)
- -nodeName
- The name of the node containing the server to move. (String, required)
- -serverName
- The name of the server to move. (String, required)
Examples
Batch mode example usage:
- Jacl:
$AdminTask moveServerToCoreGroup {-source OldCoreGroup -target NewCoreGroup -nodeName myNode -serverName myServer}
- Jython string:
AdminTask.moveServerToCoreGroup('[-source OldCoreGroup -target NewCoreGroup -nodeName myNode -serverName myServer]')
- Jython list:
AdminTask.moveServerToCore Group(['-source', 'OldCore Group', '-target', 'NewCoreGroup', '-node Name', 'myNode', '-serverName', 'myServer'])
Interactive mode example usage:
- Jacl:
$AdminTask moveServerToCoreGroup {-interactive}
- Jython string:
AdminTask.moveServerToCoreGroup ('[-interactive]')
- Jython list:
AdminTask.moveServerToCoreGroup (['-interactive'])
wsadmin AdminTask Commands for the AdminTask object