CoreGroupManagement (AdminTask)

We can use the Jython or Jacl scripting languages to manage deployed applications. The commands and parameters in the CoreGroupManagement group 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 (AdminTask) includes the following commands:

• 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 you 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:

• 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:

• 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:

• 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:

• Jacl:

  $AdminTask getAllCoreGroupNames

• Jython string...

  AdminTask.getAllCoreGroupNames()

• Jython list:

  AdminTask.getAllCoreGroupNames()

Interactive mode:

• 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:

• 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:

• Jacl:

  $AdminTask getDefaultCoreGroupName

• Jython string...

  AdminTask.getDefaultCoreGroupName()

• Jython list:

  AdminTask.getDefaultCoreGroupName()

Interactive mode:

• 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 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:

• 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 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.moveServerToCoreGroup(['-source', 'OldCoreGroup', '-target', 'NewCoreGroup', '-nodeName', 'myNode', '-serverName', 'myServer'])

Interactive mode:

• Jacl:

  $AdminTask moveServerToCoreGroup {-interactive}

• Jython string...

  AdminTask.moveServerToCoreGroup ('[-interactive]')

• Jython list:

  AdminTask.moveServerToCoreGroup (['-interactive'])

Related tasks

Use the wsadmin scripting AdminTask object for scripted administration

Commands (AdminTask)