In a flexible
management environment, you can submit the Create
cluster member job to create a server to add to a cluster.
A cluster is a set of servers that you manage together to balance
workload. The cluster can group application servers, proxy servers,
or on-demand routers. Each server in the cluster is a cluster member.
The job creates a cluster member that runs on a deployment manager
node. The cluster member becomes a managed resource of the job manager.
Before you begin
Start the job
manager, the deployment manager on which
the cluster resides, and federated nodes of the deployment manager.
A cluster must exist on a deployment manager node.
Determine
how you want to configure the cluster member:
- Review topics
on clusters and workload management, especially
the information about setting cluster weights.
- Determine the
target to which to add the first cluster member.
The target must be a managed target of the job manager.
- Determine
the appropriate configuration settings for the first
cluster member. A copy of the first cluster member that you create
is stored as part of the cluster data and becomes the template for
all additional cluster members that you create.
Your
ID at the job manager must be authorized for the
administrator role or the operator role to submit jobs. When you submit
a job, you can specify a user name and password for authentication
and authorization at the target or targets. When you submit a job
to multiple targets, the user name and password or the credentials
for the submitter must apply to all the job targets.
About this task
You can use the administrative console of the job manager
or the deployment manager to create a cluster member for one or more
managed clusters. From the console, choose the Create cluster
member job, select the clusters to which to add members,
specify job options, review the summary, and submit the job.
Instead
of using a console, you can run the createClusterMember job script
in the AdministrativeJobs command group. See the Administrative job
types topic.
Procedure
- Click from
the navigation tree of the administrative console.
-
Choose a job to create a cluster member.
-
Select the Create cluster member job
type from the list.
- Optionally specify
a description of the job.
- Click Next.
- Choose the job targets on which
to add the cluster member.
Select one or more managed
deployment manager nodes that
have the target cluster.
- Select
a group of targets from the list, or select Target
names.
- If you selected Target
names,
then specify a target name and click Add, or
click Find and specify the chosen targets on
the Find targets page.
- If user authentication
is required, specify a user name,
password, or any other authentication values as needed.
- Click Next.
- Specify parameters for the create cluster
member job.
- For Cluster name,
specify the
name of the cluster to which you want to add a member. For
example, suppose a managed deployment manager cell, myCellmanager01,
has a managed cluster, cluster2. Specify the name
of the cluster that is managed by the job manager:
cluster2
- For Member node, specify the
name of the node on which the target cluster resides. For
example, suppose the Target resources page shows that the deployment
manager node on which cluster2 resides is named myNode01.
Specify the member node name:
myNode01
- For Member name, specify
a cluster
member name that is unique on the target cluster. For
example, suppose a target cluster, cluster2, has
one cluster member, cluster_member_1. Specify a name
that is unique to cluster2:
cluster_member_2
-
If you want the new cluster member to have a Member
weight value other than 2, the default,
specify a different weight value.
A valid weight value
is a number between 0 and 100. The
weight controls the amount of work directed to the server. If the
weight is greater than the weight assigned to other cluster members,
the server receives a larger share of the workload.
- Optionally, specify a universally unique identifier
(UUID) for the cluster member.
If you do not specify
a value, the product generates a UUID.
-
If you do not want the product to generate unique port
numbers for the cluster member, clear Generate unique ports.
By default, the product generates unique port numbers for
HTTP transports defined in the server. The default value is selected
(true).
- If the
cluster has a replication domain and you want
to create a replicator entry for the new cluster member in the cluster
replication domain, select Replicator entry (true).
The product uses a replication domain for HTTP session data
replication. By default, the product does not create a replicator
entry for a cluster member in the cluster replication domain. The
default value is clear (false).
- If you are creating a cluster on a z/OS target, optionally
specify a cluster member short name.
If you do not specify
a value, the product generates a unique short name.
- Optionally, expand Additional job parameters and
specify values that further define the cluster member.
Table 1. Additional Create cluster
member job parameters. Specify job parameters as needed.Parameter name |
Description |
Template
name |
If you want to use a
specific cluster member
template, specify the name of the template. |
Template node name |
If you want to use an existing cluster member
as a template, specify the name of the node that has a cluster member
to use as a template for the new cluster member. |
Template server name |
If you want to use a specific server as a template
for the new cluster member, specify the server name. |
Node group |
If you want the cluster member to belong to
a node group, specify the name of the node group. |
Core group |
If you want the cluster member to belong to
a core group, specify the name of the core group. |
- Click Next.
- Schedule the job.
The
times and dates that
you specify are relative to the job manager.
- Optionally specify one or more email addresses where
notifications are sent when the job finishes.
If you
specify multiple email addresses, separate them with commas.
- Select when the job is available for submission.
- Select the job expiration.
- Optionally specify a recurring interval for the job,
a start date and time for the interval, and an end date and time for
the interval.
- Click Next.
- Review the summary, and click Finish to
submit the job.
Results
The targets run the
job and attempt to create a cluster
member of the target cluster.
What to do next
On the Job status
page, click the ID of the create cluster
member job and view the job status. If the job is not successful,
view any error messages that result from running the job, correct
the error condition, and submit the job again.
If the job is
successful, click to see the new cluster member
in the list of resources. The status of the member is Stopped.
After
creating the cluster member, you can run a job that starts the cluster.
Starting the cluster also starts the cluster member.