ClusterConfigCommands


Use the Jython or Jacl scripting languages to cluster application servers, generic servers, and proxy servers using scripting. The commands and parameters in the ClusterConfigCommands group can be used to create and delete server clusters and groups of servers known as cluster members.

The ClusterConfigCommands includes the following commands:

 

createCluster

The createCluster command creates a new server cluster. A server cluster consists of a group of servers that are referred to as cluster members. Optionally, a replication domain can be created for the new cluster, and an existing server can be included as the first cluster member. We can also use the createCluster command to apply proxy server settings to the cluster.

Target object

None

Steps

-clusterConfig (required)

Following configuration information for the new server cluster:

-clusterName

Name of the server cluster. (String)

-preferLocal

Optionally specifies whether to enable or disable node-scoped routing optimization within the cluster. The default value is false. Specify true to enable node-scoped routing optimization. (Boolean)

-clusterType

Optionally specifies the type of the server cluster to create. The default type is APPLICATION_SERVER. Valid values for this parameter include: APPLICATION_SERVER, PROXY_SERVER, and ONDEMAND_ROUTER. (String)

-replicationDomain (optional)

The system uses the replication domain properties for HTTP session data replication.

-createDomain

Specifies whether to create a replication domain in the cluster configuration.

The default value is false. Specify true to create a replication domain in the cluster configuration. (Boolean)

-convertServer (optional)

Specifies information about an existing appserver to convert to be the first member of the cluster. This command step is optional. The following parameters can be specified for this step:

-serverNode

The name of the node with the server to be converted to the first cluster member. You must also specify the serverName parameter. (String)

-serverName

The name of the appserver to be converted to the first cluster member. You must also specify the serverNode parameter. (String)

-memberWeight

The weight of the cluster member. The weight controls the amount of work directed to the appserver. If the weight is greater than the weight assigned to other cluster members, the server will receive a larger share of the workload. The value is a number between 0 and 100. If none is specified, the default is 2. (Integer)

-nodeGroup

The name of the node group which this cluster member"s node, and all future cluster members" nodes, must belong to. All cluster members must reside on nodes in the same node group. If specified, it must be one of the node groups which this member"s node belongs to. If not specified, the default value will be the first node group listed for this member's node. (String)

-replicatorEntry

Specifies whether to enable HTTP session data replication. The default value is false. Specify true to enable HTTP session data replication. Specify if the createDomain parameter was set to true in the replicationDomain command step. (String)

Examples

Batch mode example usage:

Interactive mode example usage:

 

createClusterMember

The createClusterMember command creates a member of a server cluster. A cluster member is an appserver that belongs to a cluster. If this is the first member of the cluster, specify a template to use as the model for the cluster member. The template can be either a default server template, or an existing appserver.

The first cluster member is used as a template to create subsequent members in the cluster. By creating a first cluster member, the template of the cluster member is stored under the scope of the cluster.

Since a cluster can contain members from nodes that run different versions of the appserver, the following conditions apply:

Target object Optionally specifies the configuration ID of the cluster to which the new member belongs. If we do not specify the configuration ID, specify the clusterName parameter.

Use the getid command for the AdminConfig object to get the configuration

ID of the cluster of interest.

Required parameters

-clusterName

The name of the cluster to which the new member will belong. If we do not specify this parameter, specify the cluster object ID in the command target. (String)

Steps

-memberConfig (required)

Configuration of a new member of the cluster.

memberNode

Node on which the system creates the cluster member. (String)

memberName

Name of the new cluster member. (String)

memberWeight

Optionally specifies the starting weight of the cluster member. (Integer)

memberUUID

Optionally specifies the UUID of the cluster member. (String)

genUniquePorts

Optionally specifies whether the system generates unique port numbers for each HTTP transport defined in the server. The new server will not have

HTTP transports which conflict with any other servers defined on the same node. The default value is true. If we do not want to generate unique port numbers, specify the value as false. (Boolean)

replicatorEntry

Optionally specifies whether the system creates a replicator entry for the new cluster member in the cluster replication domain. A replicator entry is used to provide HTTP session data replication. This command parameter is optional. The value is true or false which indicates whether the entry will be created. The default value is false. We can specify this parameter only if a replication domain has been created for the cluster. (Boolean)

-firstMember (optional)

Specifies additional information required to configure the first member of the cluster.

templateName

Optionally specifies The name of an appserver template to use when creating the new cluster member. If we specify a template, we cannot specify the templateServerNode and templateServerName parameters to use an existing appserver as a template. we are required to specify either the templateName parameter, or the templateServerNode and templateServerName parameters in this step. (String)

templateServerNode

Optionally specifies the name of the node with an existing application server to use as the template when creating the new cluster member. If we specify the templateServerNode parameter, also specify the templateServerName parameter, and we cannot specify the templateName parameter. we are required to specify either the templateName parameter, or the templateServerNode and templateServerName parameters, in this step. (String)

templateServerName

Optionally specifies the name of the existing appserver to use as the model when creating the new cluster member. If specify the templateServerName parameter, also specify the templateServerNode parameter, and you cannot specify the templateName parameter. we are required to specify either the templateName parameter, or the templateServerNode and templateServerName parameters, in this command step. (String)

nodeGroup

Optionally specifies the name of the node group to which the new cluster member and each additional cluster member belongs. Each cluster member must reside on nodes in the same node group. If specified, it must be one of the node groups which this member node belongs to. If we do not specify this parameter, the system assigns the first node group listed for the member node. (String)

coreGroup

Optionally specifies the name of the core group to which the new cluster member and each additional cluster member belongs. Each cluster members must belong to the same core group. If we do not specify this parameter, the system assigns the default core group in the cell. (String)

Examples

Batch mode example usage:

First member creation using server and node for template:

AdminTask.createClusterMember('[-clusterName cluster1 -memberConfig [[-memberNode node1 -memberName member1 -genUniquePorts true -replicatorEntry false]] -firstMember [[-templateServerNode node1 -templateServerName server1]]]')

Second member creation:

AdminTask.createClusterMember('[-clusterName cluster1 -memberConfig [[-memberNode node1 -memberName member1 -genUniquePorts true -replicatorEntry false]]]')

 

deleteCluster

The deleteCluster command deletes the configuration of a server cluster. A server cluster consists of a group of servers that are referred to as cluster members. The system deletes each cluster member for the cluster of interest.

Use the deleteClusterMember command to delete the configuration of an individual cluster member.

Target object Optionally specifies the configuration object ID of the cluster to delete. If we do not specify the object ID for the cluster, then specify the clusterName parameter. Use the getid command for the AdminConfig object to get the configuration

ID of the cluster.

Required parameters

-clusterName

Name of the cluster to delete. If specify the configuration

ID of the cluster, do not specify a value for the clusterName parameter. (String)

Steps

-replicationDomain (optional step)

-deleteRepDomain

Specifies whether to delete the replication domain. The default value is false. Specify true to delete the replication domain. (Boolean)

Examples

Batch mode example usage:

Interactive mode example usage:

 

deleteClusterMember

The deleteClusterMember command deletes the configuration of a cluster member. A cluster member is an appserver that belongs to a server cluster.

Use the deleteCluster command to delete the configuration of a cluster.

Target object Optionally specifies the configuration object ID of the cluster member to delete. If we do not specify the configuration ID, then specify the clusterName, memberNode and memberName parameters.

Use the getid command for the AdminConfig object to get the configuration

ID of the cluster.

Required parameters

-clusterName

Name of the cluster to which the member of interest belongs. If this parameter is specified, then the memberName and memberNode parameters must also be specified. If this is not specified, then the member object ID must be specified in the command target. (String)

-memberNode

Name of the node to which the cluster member belongs. If this parameter is specified, then the memberName and clusterName parameters must also be specified. If this is not specified, then the cluster member object ID must be specified in the command target. (String)

-memberName

Server name of the member to delete from the cluster. If this parameter is specified, then the clusterName and memberNode parameters must also be specified. If this is not specified, then the member object ID must be specified in the command target. (String)

Steps

replicatorEntry (optional)

Removal of a replicator entry for this cluster member. This command step is optional.

The following parameters can be specified for this step:

-deleteEntry

Delete the replicator entry having the cluster member name from the cluster replication domain. Specify the value as true to delete the replicator entry. The default value is false.

Examples

Batch mode example usage:

Interactive mode example usage:





 

Related tasks


Automating application configurations using the scripting library
Create cluster members using scripting
Create a proxy server cluster using the wsadmin
Use AdminTask for scripted administration

 

Related


Cluster configuration scripts
Commands for AdminTask