The following instructions explain how to create a cluster
with one cluster member. The benefit of using the administrative console
to create a cluster is that you can undo your changes as you go and
you can use a graphical user interface.
Before you begin
Before you create a cluster using the administrative console,
start the deployment manager.
About this task
The following procedure describes how to create a cluster
with one cluster member using the administrative console. Note that
the tasks performed from the administrative console that are described
in this topic can also be performed using administrative scripting.
For information on the createCluster parameters, see ClusterConfigCommands command group for the AdminTask
object in the WebSphere Application Server information center.
For
information on using the wsadmin tool to create cluster members, see Creating cluster members using scripting.
Consider
to create a cluster even if a single server is currently sufficient
for your high availability and scalability requirements because it
is easier to add more servers to the cluster later.
Procedure
- Log in to the administrative console and navigate to .
- Click New to display the Create
new cluster page.
- From the Create new cluster page,
enter basic cluster information:
- Type a name for the cluster in the Cluster
name field.
- Select Prefer local if you want
to enable host-scoped routing optimization. This option is enabled
by default. When this option is enabled, if possible, EJB requests
are routed to the client host. This option improves performance because
client requests are sent to local enterprise beans.
Note: If
you enable the preferLocal optimization, the deployment manager must
be running to affect the configuration. If the deployment manager
is shut down, preferLocal optimization is not performed and requests
might be dispersed across all the members of the cluster
- Select Configure HTTP session memory-to-memory replication
if you want a memory-to-memory replication domain created for this
cluster.
The replication domain is given the same name
as the cluster and is configured with the default settings for a replication
domain. When the default settings are in effect, a single replica
is created for each piece of data and encryption is disabled. Also,
the Web container for each cluster member is configured for memory-to-memory
replication.
To change these settings for the replication domain,
click . To modify the Web container settings, click . Then, in the Container settings section,
click settings in the administrative console. If you change
these settings for one cluster member, you might also need to change
them for the other members of this cluster.
- Click Next to go to the Create
first cluster member page.
- From the Create first cluster member page,
enter information about the cluster member.
- Enter the member name in the Member name field
- From the Select node list, click
the node in which you want to define the server.
- In the Weight field, enter the
weight value for the cluster member.
The weight value
controls the amount of work that is directed to the application server.
If the weight value for this server is greater than the weight values
that are assigned to other servers in the cluster, then this server
receives a larger share of the workload. The weight value represents
a relative proportion of the workload that is assigned to a particular
application server. The value can range from 0 to 20.
- On a z/OS system weight is used to balance some of the
workload types, but others are balanced by the z/OS system. For HTTP
requests, weights are used to distribute HTTP traffic between the
Web server plug-in and the controller handling the clustered application
server. Assign a higher weight value to the application server that
should receive the HTTP traffic.
- For Web services calls, information is transferred from a servant
in one application server to a controller in another application server.
The application server that receives the call has the highest weight
value.
- Weight has no affect on Internet Inter-ORB Protocol (IIOP) requests.
IIOP requests are distributed to the correct application server using
the sysplex distributor.
- Select Generate unique HTTP ports (the
default option) if you want to generate unique port numbers for every
HTTP transport that is defined in the source server.
When
this option is selected, this cluster member does not have HTTP transports
or HTTP transport channels that conflict with any of the other servers
that are defined on the same node. If you clear the Generate
unique HTTP ports check box, all of the cluster members
will share the same HTTP ports.
- From the section, Select basis for first cluster member,
select from the following options:
- Create the member using an application server template
This
is the typical way of creating a cluster. Select defaultProcessServer.
If you select this
option and click
Next, a blank form is displayed
which you can use to define additional cluster members. The server
you have just created is listed at the bottom of the screen.
- Click Next.
- Check the details on the summary screen and click Next.
- Save your configuration changes.
The cluster you have just created
is displayed in the list.
- Customize the port numbers to suit your configuration.
- Create the member using an existing application server as
a template
This option is not supported.
- Create the member by converting an existing application server
It
is required to use the
resourcesScope parameter
with the value
cluster for
IBM® Business Process Manager. The
resourcesScope parameter
is not currently exposed in the administrative console. Using the
administrative console to create a cluster using an existing single
server as the first cluster member is not supported on
IBM Business Process Manager. Selecting
this option will result in the following error message in the administrative
console or the SystemOut.log of the deployment manager:
resourcesScope parameter needs to be set to 'cluster' if creating a cluster from an existing server
Using
the command line to create a cluster using an existing single server
as the first cluster member is valid. You must set the value of the
resourcesScope to
Cluster.
For example,
$AdminTask createCluster {-clusterConfig
{-clusterName newcluster -preferLocal true}
-convertServer {-serverNode NODE1Node01 -serverName testserver
-resourcesScope cluster}}
For information on the
createCluster parameters,
see
ClusterConfigCommands command group for the AdminTask
object in the WebSphere Application Server information center.
For
information on using the wsadmin tool to create cluster members, see Creating cluster members using scripting.
- None
Works always.
- Click Next.
- Create additional cluster members.
Before
you create additional cluster members, check the configuration settings
of the first cluster member. These settings are displayed at the bottom
of the
Create additional cluster members panel
of the
Create a new cluster wizard. For each
additional member that you want to create:
- Specify a unique name for the member. The name must be unique
within the node.
- Select the node to which you want to assign the cluster member.
- Specify the weight you want given to this member. The weight value
controls the amount of work that is directed to the application server.
If the weight value for the server is greater than the weight values
that are assigned to other servers in the cluster, then the server
receives a larger share of the workload. The value can range from
0 to 20.
- Select Generate unique HTTP ports if you
want to generate unique port numbers for every HTTP transport that
is defined in the source server.
- Click Add member. You can edit the configuration
settings of any of the newly created cluster members other than the
first cluster member, or you can create additional cluster members.
Click Previous to edit the properties of the
first cluster member. The settings for the first cluster member become
the settings for the cluster member template that is automatically
created when you create the first cluster member.
- When you finish creating cluster members, click Next.
- View the summary of the cluster and then click Finish to
create the cluster, click Previous to return
to the previous wizard panel and change the cluster, or click Cancel to
exit the wizard without creating the cluster.
- To further configure a cluster, click , and then click
the name of the cluster. Only the Configuration and Local
Topology tabs display until you save your changes.
- Click Review to review your cluster
configuration settings. Repeat the previous step if you need to make
additional configuration changes.
- If you do not want to make any additional configuration
changes, select Synchronize changes with Nodes and
then click Save. Your changes are saved and
synchronized across all of your nodes.
Note: If you click Save ,
but do not select Synchronize changes with Nodes,
when you restart the cluster, the product does not start the cluster
servers because it cannot find them on the node. If you want to always
synchronize your configuration changes across your nodes, you can
select Synchronize changes with Nodes as one of your console preferences.
- Restart the cluster.
Results
The cluster is created with your chosen server in the selected
managed node as the first cluster member.
Important: If you use additional servers with unique ports, WebSphere® Application Server does not
automatically configure the virtual host for the server. Specifically, WebSphere Application Server does not
automatically add the host alias ports to a virtual host. However,
you can use the administrative console to add a new host alias for
each of the ports that are used by the new server. For more information,
see the WebSphere Application Server documentation
about configuring virtual hosts.