Skip navigation.
Downloads | Product Documentation | Support

Administration Console Online Help

# Clusters

[Attributes and Console Screen Reference for Clusters]

A cluster is multiple WebLogic Server instances running simultaneously and working together to provide increased scalability and reliability. A cluster appears to clients to be a single WebLogic Server instance. The server instances that constitute a cluster can run on the same machine, or be located on different machines. You can increase a cluster's capacity by adding additional server instances to it.

For more information, see Using WebLogic Server Clusters.

The following topics describe the cluster configuration and monitoring tasks you can perform with the Administration Console.

# Tasks

## Configuring a Cluster

There are multiple techniques and tools you can use to create and maintain a cluster configuration. For a list, see Methods of Configuring Clusters in Using WebLogic Server Clusters.

If you are configuring a new cluster in a new domain, BEA recommends that you use the using the Configuration Wizard. For more information, see Example: Creating a Domain with Administration Server and Clustered Managed Servers in Configuring and Managing WebLogic Server.

Follow these steps to configure a cluster using the Administration Console:

1. In the left pane, click the Clusters node.
2. In the right pane, click Configure a New Cluster.
3. Enter values for:

- Name—assign a unique name to the cluster. Each configurable resource in your WebLogic Server environment should have a unique name.
- Cluster Address—supply a cluster address that identifies the Managed Servers in the cluster. The cluster address is used in entity and stateless beans to construct the host name portion of URLs. If the cluster address is not set, EJB handles may not work properly.
- Default Load Algorithm
- WebLogic Plug-In Enabled
- Service Age Threshold
- Client Cert Proxy Enabled

4. Click Create to create the cluster.
5. Click the Multicast tab.
6. If necessary, edit the default values for:

- Multicast Address (use a value between 224.0.0.1 and 239.255.255.255)
- Multicast Port number
- Multicast Send Delay
- Multicast TTL
- Multicast Buffer Size

7. Click Apply.
8. In the right pane, click the Servers tab.
9. In the Available column, select one or more servers to assign to the cluster.
10. Click the right arrow button.
11. Click Apply.

## Cloning a Cluster

Clone a cluster to configure a new cluster based on the configuration of an existing cluster. Edit the attributes that must be unique for each cluster in a domain, such as Cluster Name and Cluster Address.

1. In the left pane, click Clusters.
2. Click the Clone icon in the row of the cluster you want to clone.
3. Enter values for:

- Name—Make sure the name is unique with respect to other configurable resources in the domain.
- Cluster Address
- Default Load Algorithm
- WebLogic Plug-In Enabled
- Service Age Threshold
- Client Cert Proxy Enabled

4. Click Clone to create the new cluster.
5. Click the Multicast tab.
6. As appropriate, edit the values for:

- Multicast Address (use a value between 224.0.0.1 and 239.255.255.255)
- Multicast Port number
- Multicast Send Delay
- Multicast TTL
- Multicast Buffer Size

7. Click Apply.
8. In the right pane, click the Servers tab.
9. In the Available column, select one or more servers to assign to the cluster.
10. Click the right arrow button.
11. Click Apply.

## Deleting a Cluster

1. In the left pane, click Clusters.
2. Click the Delete icon in the row of the cluster you want to delete.
3. At the confirmation question, click Yes.
4. Click Continue.

## Assigning Servers to a Cluster

Follow these steps to assign server instances to a cluster.

1. In the left pane, expand Clusters.
2. Click a cluster name that you want to add servers to.
3. In the right pane, click the Servers tab.
4. In the Available column, select one or more servers to assign to the cluster.
5. Click the right arrow button.
6. Click Apply.

## Monitoring a Cluster

The Cluster-->Monitoring page displays current status of the cluster, and statistics on the activity of each Managed server in the cluster.

1. In the left pane, expand Clusters.
2. Click a cluster name that you want to monitor.
3. In the right pane, click the Monitoring tab.
4. The Monitoring page displays the number of servers configured for the cluster, the number of servers currently participating in the cluster, and in tabular form, key statistics on each Managed Server's recent activity.

## Adding a Note to a Cluster Configuration

1. In the left pane, expand Clusters.
2. Click the name of a cluster to which you want to add a note.
3. Click the Notes tab. Type the note in the Notes field.
4. Click Apply to save your changes.

## Specifying a Server's Cluster Replication Group

A cluster is a set of WebLogic Server instances running simultaneously and working together to provide increased scalability and reliability. For more information about cluster replication groups, refer to "Using Replication Groups."

To specify a server's cluster replication group:

1. In the left pane of the Administration Console, expand the Server node. Then select a server.
2. Click the Configuration tab. Then click the Cluster tab.
3. In the right pane, in the Replication Group field, enter the name of a list of clustered instances for storing session state replicas.
4. In the Preferred Secondary Group field, enter the name of a secondary list of clustered instances for storing session state replicas.
5. Click Apply to save your changes.
6. Restart the server.

## Specifying a Server's Cluster Weight

A server's cluster weight determines the proportion of the load the server will bear relative to other servers in a cluster. If all servers have the same weight, they will each bear an equal proportion of the load. If one server has weight 50 and all other servers have weight 100, the 50-weight server will bear half as much as any other server. This algorithm makes it possible to apply the advantages of the round-robin algorithm to clusters that are not homogeneous. For more information, refer to "Weight-Based Load Balancing."

To specify a server's cluster weight:

1. In the left pane of the Administration Console, expand the Server node. Then select a server.
2. Click the Configuration tab. Then click the Cluster tab.
3. In the right pane, in the Cluster Weight field, enter a value in the range 1-100.
4. Click Apply to save your changes.
5. Restart the server.

## Specifying the Address of a Server's NIC Card for Cluster Communication

To specify the address of a server's NIC card for communication in a cluster:

1. In the left pane of the Administration Console, expand the Server node. Then select a server.
2. Click the Configuration tab. Then click the Cluster tab.
3. In the right pane, in the Interface Access field, enter the interface address to handle multicast traffic.
4. Click Apply to save your changes.
5. Restart the server.

## Start all Managed Servers

Use this command to start clustered Managed Servers with Node Manager.

Note: To start a Managed Server from the Administration Console using Node Manager, a Node Manager process must be running on each machine that hosts Managed Servers in the cluster. For more information, refer to Starting Node Manager in Configuring and Managing WebLogic Server.

To start all of the Managed Servers in a cluster:

1. Start the Administration Server for the domain.
2. In the Administration Console, expand the Clusters node in the left panel.
3. Click the cluster whose members you want to start.
4. Click the Start all Managed Servers... link in the right panel.
5. When the Administration Console prompts you to confirm the command, click Yes.
6. As Node Manager starts each Managed Server, the status of the operation is displayed in the Transition Activity table. When an operation is complete for a Managed Server, TASK COMPLETED appears in the Status column.

## Resume all Managed Servers

Use this command to resume cluster members in standby state with Node Manager. For information on placing a server in the standby state, refer to Starting a Managed Server in the STANDBY State.

Notes: To control a Managed Server from the Administration Console using Node Manager, a Node Manager process must be running on each machine that hosts Managed Servers in the cluster. For more information, refer to Starting Node Manager in Configuring and Managing WebLogic Server.

To resume clustered Managed Servers:

1. Start the Administration Server for the domain.
2. In the Administration Console, expand the Clusters node in the left panel.
3. Click the cluster whose members you want to resume.
4. Click the Resume all Managed Servers... link in the right panel.
5. When the Administration Console prompts you to confirm the command, click Yes.
6. As Node Manager resumes each Managed Server, the status of the operation is displayed in the Transition Activity table. When an operation is complete for a Managed Server, TASK COMPLETED appears in the Status column.

## Graceful Shutdown of all Servers

Use this command to gracefully shutdown the Managed Servers in a cluster with Node Manager. During a graceful shutdown, WebLogic Server subsystems complete in-flight work and suspend themselves in an specific sequence and in a synchronized fashion. For details, see Graceful Shutdown in Configuring and Managing WebLogic Server.

Note: To control a Managed Server from the Administration Console using Node Manager, a Node Manager process must be running on each machine that hosts Managed Server in the cluster. For more information, refer to Starting Node Manager in Configuring and Managing WebLogic Server.

To gracefully shutdown clustered Managed Servers:

1. Start the Administration Server for the domain.
2. In the Administration Console, expand the Clusters node in the left panel.
3. Click the cluster whose members you want to shutdown.
4. Click the Graceful shutdown of all servers... link in the right panel.
5. When the Administration Console prompts you to confirm the command, click Yes.
6. The right panel displays shutdown settings.

- If you want to drop all sessions, select Ignore Sessions During Shutdown.
- If you want to set a timeout for the graceful shutdown to complete, enter the timeout period in seconds in the Graceful Shutdown Timeout box.

Click Apply.

7. As the shutdown process proceeds, status is displayed in the Transition Activity table. When an operation is complete for a Managed Server, TASK COMPLETED appears in the Status column.

## Force Shutdown of all Servers

Use this command to force shutdown the Managed Servers in a cluster with Node Manager.

Note: To control a Managed Server from the Administration Console using Node Manager, a Node Manager process must be running on each machine that hosts Managed Server in the cluster. For more information, refer to Starting Node Manager in Configuring and Managing WebLogic Server.

To force shutdown clustered Managed Servers:

1. Start the Administration Server for the domain.
2. In the Administration Console, expand the Clusters node in the left panel.
3. Click the cluster whose members you want to shutdown.
4. Click the Force shutdown of all servers... link in the right panel.
5. When the Administration Console prompts you to confirm the command, click Yes.
6. As the shutdown process proceeds, status is displayed in the Transition Activity table. When an operation is complete for a Managed Server, TASK COMPLETED appears in the Status column.

## Start/Stop a Server

Use the Start/Stop button in the Transition Activity table to start a Managed Server that is shutdown, or to gracefully shutdown a Managed Server that is running.

Note: To control a Managed Server from the Administration Console using Node Manager, a Node Manager process must be running on each machine that hosts Managed Server in the cluster. For more information, refer to Starting Node Manager in Configuring and Managing WebLogic Server.

To start or stop a Managed Server in the current cluster:

1. Start the Administration Server for the domain.
2. In the Administration Console, expand the Clusters node in the left panel.
3. Click the cluster to which the Managed Server belongs.
4. The Transition Activity table lists the Managed Server in the cluster.
5. Click the Force shutdown of all servers... link in the right panel.
6. When the Administration Console prompts you to confirm the command, click Yes.
7. The right panel displays shutdown settings.

- If you want to drop all sessions, select Ignore Sessions During Shutdown.
- If you want to set a timeout for the graceful shutdown to complete, enter the timeout period in seconds in the Graceful Shutdown Timeout box.

Click Apply.

8. As the shutdown process proceeds, status is displayed in the Transition Activity table. When an operation is complete for a Managed Server, TASK COMPLETED appears in the Status column.