A WebLogic Server cluster consists of multiple WebLogic Server 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 the cluster on an existing machine, or you can add machines to the cluster to host the incremental server instances. Each server instance in a cluster must run the same version of WebLogic Server. For more information on clusters, see Understanding WebLogic Server Clustering.
This chapter describes how to monitor, control, and configure clusters.
This chapter includes the following sections:
This section describes how to monitor clusters. This section includes the following tasks:
To monitor the runtime status of all clusters configured in a domain:
From the WebLogic Domain dropdown menu, select Environment, then select Clusters.
The Clusters table displays information about the clusters that have been configured in the current domain, such as:
Cluster Name
Status
Servers
Cluster Address
Cluster Messaging Mode
For more information about these fields, see Configuration Options.
Optionally, select View to access the following table options:
Columns: add or remove the columns displayed in the table
Detach: detach the table (viewing option)
Sort: sort the columns in ascending or descending order
Reorder: change the order of the columns displayed
Query by Example
Select the name of the cluster for which you want to view configuration information, such as the cluster's default network communications.
To monitor the status of servers in a cluster:
From the WebLogic Domain dropdown menu, select Environment, then select Clusters.
In the Clusters table, select the name of the cluster you want to monitor.
An overview page displays information related to the cluster.
From the WebLogic Cluster dropdown menu, select Monitoring, then select Summary.
The Summary table displays information about the status of all servers in a cluster, such as:
Name
State
Machine
Listen Address
Listen Port
For more information about these fields, see Configuration Options.
Optionally, select View to access the following table options:
Columns: add or remove the columns displayed in the table
Detach: detach the table (viewing option)
Sort: sort the columns in ascending or descending order
Reorder: change the order of the columns displayed
Query by Example
To monitor the health of a cluster:
From the WebLogic Domain dropdown menu, select Environment, then select Clusters.
In the Clusters table, select the name of the cluster you want to monitor.
An overview page displays information related to the cluster.
From the WebLogic Cluster dropdown menu, select Monitoring, then select Health.
The Health summary page allows you to monitor health information for the cluster and its subsystems.
For more information, see Configuration Options.
To monitor the server instances in a cluster:
From the WebLogic Domain dropdown menu, select Environment, then select Clusters.
In the Clusters table, select the name of the cluster you want to monitor.
An overview page displays information related to the cluster.
From the WebLogic Cluster dropdown menu, select Monitoring, then select Servers.
The Servers table displays information about the servers in a cluster, such as:
Server
Status
Cluster
Machine
State
For more information about these fields, see Configuration Options.
Optionally, select View to access the following table options:
Columns: add or remove the columns displayed in the table
Detach: detach the table (viewing option)
Sort: sort the columns in ascending or descending order
Reorder: change the order of the columns displayed
Query by Example
To monitor all deployments in a cluster:
From the WebLogic Domain menu, select Environment, then select Clusters.
In the Clusters table, select the name of the cluster you want to monitor.
An overview page displays information related to the cluster.
From the WebLogic Cluster dropdown menu, select Monitoring, then select Deployments.
The Deployments table on the summary page displays information about all applications and modules deployed to the cluster, such as:
Name
Status
State
Health
Type
Deployment Order
Targets
For more information about these fields, see Configuration Options.
Optionally, select View to access the following table options:
Columns: add or remove the columns displayed in the table
Detach: detach the table (viewing option)
Sort: sort the columns in ascending or descending order
Reorder: change the order of the columns displayed
Query by Example
To monitor cluster deployment information, select the appropriate pages:
Web Applications: monitor Web applications deployed to your cluster; includes information about the application such as the machine and server instance on which the application is deployed and statistics about the servlets and sessions associated with the Web application
Resource Adapters: monitor the status of inbound listeners and outbound connection pools
EJBs: monitor statistics and information about stateless, stateful, entity, singleton, and message-driven EJBs
Web Services: monitor all the Web services that are deployed to this cluster
Web Service Clients: monitor all Web service clients in this cluster
JAX-RS Applications: monitor all the JAX-RS applications that are running in this cluster
Workload: monitor statistics for the Work Managers, constraints, and policies that are configured for application deployments in this cluster
To monitor the JDBC data sources associated with a specific cluster:
From the WebLogic Domain dropdown menu, select Environment, then select Clusters.
In the Clusters table, select the name of the cluster you want to monitor.
An overview page displays information related to the cluster.
From the WebLogic Cluster dropdown menu, select Monitoring, then select JDBC Data Sources.
The JDBC data sources table displays information the status of all JDBC data sources, such as:
Name
Type
Server Name
State
Enabled
For more information about these fields, see Configuration Options.
Optionally, select View to access the following table options:
Columns: add or remove the columns displayed in the table
Sort: sort the columns in ascending or descending order
Reorder: change the order of the columns displayed
To monitor the status of JMS servers associated with a cluster:
From the WebLogic Domain menu, select Environment, then select Clusters.
In the Clusters table, select the name of the cluster you want to monitor.
An overview page displays information related to the cluster.
From the WebLogic Cluster dropdown menu, select Monitoring, then select Messaging.
To monitor messaging information for this cluster, select the appropriate pages:
Store-and-Forward Agents: monitor SAF agent statistics and perform message management operations, such as pausing incoming requests to the agent
JMS Resources: monitor all JMS resources that have been created for all the JMS system modules, including queue and topic destinations, connection factories, JMS templates, destination sort keys, destination quota, distributed destinations, foreign servers, and store-and-forward parameters
JMS Modules: monitor the JMS modules created in this cluster
Messaging Bridges: monitor the status of all messaging bridges configured on active servers in this cluster
Optionally, select View to access the following table options on any of the pages:
Columns: add or remove the columns displayed in the table
Detach: detach the table (viewing option)
Sort: sort the columns in ascending or descending order
Reorder: change the order of the columns displayed
Query by Example
To monitor failover information for a cluster:
From the WebLogic Domain dropdown menu, select Environment, then select Clusters.
In the Clusters table, select the name of the cluster you want to monitor.
An overview page displays information related to the cluster.
From the WebLogic Cluster dropdown menu, select Monitoring, then select Failover.
The Failover summary page displays the following information:
Total primary sessions
Total session replicas
Total number of session updates to the backup cluster
Total number of sessions retrieved from the database
Communications between clusters is currently...
The Failover table displays further failover and status information for the cluster, such as:
Server
Type
Machine
State
Backup Server
For more information about these fields, see Configuration Options.
Optionally, select View to access the following table options:
Columns: add or remove the columns displayed in the table
Detach: detach the table (viewing option)
Sort: sort the columns in ascending or descending order
Reorder: change the order of the columns displayed
Query by Example
To monitor the performance summary of a cluster:
From the WebLogic Domain dropdown menu, select Environment, then select Clusters.
In the Clusters table, select the name of the cluster you want to monitor.
An overview page displays information related to the cluster.
From the WebLogic Cluster dropdown menu, select Monitoring, then select Performance Summary.
The Performance Summary page displays general performance information, as well as performance information about the servlets, JSPs, and data sources associated with this cluster.
Click Show Metric Palette to select the metrics you want to view.
Select View to access table options.
Select Overlay to access additional table options.
Because some administrative tasks (such as deployments, service migrations, and attempts to start or stop Managed Servers) are completed immediately and others take varying amounts of time to complete, the Asynchronous Tasks summary page allows you to monitor the completion status of all tasks.
To monitor the status of asynchronous tasks in a cluster:
From the WebLogic Domain dropdown menu, select Environment, then select Clusters.
In the Clusters table, select the name of the cluster you want to monitor.
An overview page displays information related to the cluster.
From the WebLogic Cluster dropdown menu, select Monitoring, then select Asynchronous Tasks.
The Asynchronous Tasks summary page allows you to monitor the completion status of all tasks by displaying information such as:
Description
Type
Status
Begin Time
End Time
Targets
For more information about these fields, see Configuration Options.
Optionally, select View to access the following table options:
Columns: add or remove the columns displayed in the table
Detach: detach the table (viewing option)
Sort: sort the columns in ascending or descending order
Reorder: change the order of the columns displayed
Query by Example
You can start, resume, suspend, or shutdown the servers assigned to a cluster. For information on how the servers in a cluster transition from STANDBY
or ADMIN
to the RUNNING
state, see "Understanding Server Life Cycle" in Managing Server Startup and Shutdown for Oracle WebLogic Server.
Before you begin:
Control operations on Managed Servers require starting the Node Manager. Starting Managed Servers in Standby mode requires the domain-wide administration port.
To change the state of servers assigned to a cluster:
From the WebLogic Domain dropdown menu, select Environment, then select Clusters.
The Clusters table displays information about the clusters that have been configured in the current domain.
In the table, select the name of the cluster you want to manage, and then select one of the following control operations:
Start: moves server instances from the SHUTDOWN
state to RUNNING
.
Resume: moves server instances from the STANDBY
or the ADMIN
state to RUNNING
.
Suspend: select an option to transition a server instance from the RUNNING
state to the ADMIN
state:
When work completes: moves server instances from the RUNNING
state to the ADMIN
state, allowing work in process to be handled gracefully. While in the SUSPENDING
state, Work Managers complete in-flight processing for pending work in application threads.
Force shutdown now: immediately moves server instances from the RUNNING
state to the ADMIN
state, without handling work in process gracefully.
Shutdown: select an option to shutdown a server instance:
When work completes: gracefully stops server instances in the domain. New requests are rejected but in-flight requests are completed before the server instance stops.
Force suspend now: immediately stops server instances in the domain. In-flight requests are dropped, no new requests are accepted, and the server instance immediately stops.
Restart SSL: restarts the SSL listen sockets so that keystore changes take effect.
For more information, see Configuration Options.
This section describes how to configure clusters. This section includes the following tasks:
To configure general settings for a cluster:
From the WebLogic Domain menu, select Environment, then select Clusters.
In the Clusters table, select the name of the cluster you want to configure.
An overview page displays information related to the cluster.
From the WebLogic Cluster menu, select Administration, then select General Settings.
From the General Settings page you can define the general settings for a cluster, such as:
Default Load Algorithm
Cluster Address
Number of Servers in Cluster Address
For more information about these fields, see Configuration Options.
Optionally, expand Advanced to define advanced settings for this cluster.
Click Save.
To configure JTA for a cluster:
From the WebLogic Domain menu, select Environment, then select Clusters.
In the Clusters table, select the name of the cluster you want to configure.
An overview page displays information related to the cluster.
From the WebLogic Cluster menu, select Administration, then select Java Transaction API (JTA).
From the Java Transaction API (JTA) page you can define the JTA settings for a cluster, such as:
Timeout Seconds
Abandon Timeout Seconds
Before Completion Iteration Limit
Max Transactions
Max Unique Name Statistics
Checkpoint Interval Seconds
Forget Heuristics
Unregister Resource Grace Period
Execute XA Calls in Parallel
Enable Two Phase Commit
Enable Tightly Coupled Transactions
Enable Cluster-Wide Recovery
For more information about these fields, see Configuration Options.
Optionally, expand Advanced to define advanced settings for this cluster.
Click Save.
Clusters use messaging for sharing session, load balancing and failover, JMS, and other information between cluster members. Clusters can use either unicast or multicast messaging. Multicast is a simple broadcast technology that enables multiple applications to subscribe to a given IP address and port number and listen for messages, but requires hardware configuration and support. Unicast does not have these requirements.
To configure messaging for a cluster:
From the WebLogic Domain menu, select Environment, then select Clusters.
In the Clusters table, select the name of the cluster you want to configure.
An overview page displays information related to the cluster.
From the WebLogic Cluster menu, select Administration, then select Messaging.
From the Messaging page, you can define the messaging settings for your cluster, such as:
Messaging Mode
Unicast Broadcast Channel
Multicast Port
For more information about these fields, see Configuration Options.
Optionally, expand Advanced to define advanced settings for this cluster.
Click Save.
To configure server instances in a cluster:
From the WebLogic Domain menu, select Environment, then select Clusters.
In the Clusters table, select the name of the cluster you want to configure.
An overview page displays information related to the cluster.
From the WebLogic Cluster menu, select Administration, then select Servers.
From the Servers page, you can define settings for server instances in the cluster, such as:
Dynamic Servers Pool
Server Template
Maximum Number of Servers
Enable Calculated Listen Ports
Enable Calculated Machine Associations
Machine Name Prefix
For more information about these fields, see Configuration Options.
Click Save.
To configure replication for a cluster:
From the WebLogic Domain menu, select Environment, then select Clusters.
In the Clusters table, select the name of the cluster you want to configure.
An overview page displays information related to the cluster.
From the WebLogic Cluster menu, select Administration, then select Replication.
From the Replication page, you can configure how WebLogic Server will replicate HTTP session state across a cluster, including settings such as:
Cross-cluster Replication Type
Remote Cluster Address
Replication Channel
Data Source for Session Persistence
Persist Sessions on Shutdown
Secure Replication Enabled
For more information about these fields, see Configuration Options.
Optionally, expand Advanced to define advanced settings for this cluster.
Click Save.
If a clustered server fails, Node Manager can automatically restart the server instance and its services on another machine. You can specify the machines where Node Manager can restart migratable servers and also the data source used during server migration.
To configure server migration in a cluster:
From the WebLogic Domain menu, select Environment, then select Clusters.
In the Clusters table, select the name of the cluster you want to configure.
An overview page displays information related to the cluster.
From the WebLogic Cluster menu, select Administration, then select Migration.
From the Migration page, you can specify settings related to cluster migration, such:
Candidate Machines for Migratable Servers
Migration Basis
Data Source for Automatic Migration
Auto Migration Table Name
Member Death Detector Enabled
Member Discovery Timeout
Leader Heartbeat Period
Additional Migration Attempts
Pause Time Between Migration Attempts
For more information about these fields, see Configuration Options.
Click Save.
This section describes how to configure and control singleton services.
This section includes the following sections:
To configure general settings for a cluster singleton service:
From the WebLogic Domain menu, select Environment, then select Clusters.
In the Clusters table, select the name of the cluster you want to configure.
An overview page displays information related to the cluster.
From the WebLogic Cluster menu, select Administration, then select Singleton Services.
Select Configuration, then select General.
From the General page, you can define settings for the class associations of this singleton service, such as:
Name
Class Name
Additional Migration Attempts
Sleep Time Between Attempts
For more information about these fields, see Configuration Options.
Click Save.
To configure migration for a cluster singleton service:
From the WebLogic Domain menu, select Environment, then select Clusters.
In the Clusters table, select the name of the cluster you want to configure.
An overview page displays information related to the cluster.
From the WebLogic Cluster menu, select Administration, then select Singleton Services.
Select Configuration, then select Migration.
From the Migration page, you can define migration settings for this singleton service, such as:
Name
User Preferred Server
Constrained Candidate Servers
For more information about these fields, see Configuration Options.
Click Save.
To migrate a cluster singleton service:
From the WebLogic Domain menu, select Environment, then select Clusters.
In the Clusters table, select the name of the cluster you want to configure.
An overview page displays information related to the cluster.
From the WebLogic Cluster menu, select Administration, then select Singleton Services.
Select the Control page.
The Singleton Services table displays information about the singleton services, such as:
Name
Active
Current Server
Preferred Server
Candidate Servers
For more information about these fields, see Configuration Options.
In the table, select the row of the singleton service you want to migrate.
Click Migrate.
On the Migrate Singleton Services page, select a hosting server from the New Hosting Server menu.
Click OK.
Job scheduling makes Java CommonJ timers cluster-aware and provides the ability to execute jobs periodically anywhere in a cluster without dependency on a particular server instance.
To configure job scheduling in a cluster:
From the WebLogic Domain menu, select Environment, then select Clusters.
In the Clusters table, click the name of the cluster you want to configure.
An overview page displays information related to the cluster.
From the WebLogic Cluster menu, select Administration, then select Scheduling.
From the Scheduling page, you can define configuration settings that specify how information is shared across servers in a cluster.
In the Data Source for Job Scheduler field, select the data source to use.
In the Job Scheduler Table Name field, enter a table name to use for storing timers active with the job scheduler.
Click Save.
For more information, see Configuration Options.
To configure overload for a cluster:
From the WebLogic Domain menu, select Environment, then select Clusters.
In the Clusters table, click the name of the cluster you want to configure.
An overview page displays information related to the cluster.
From the WebLogic Cluster menu, select Administration, then select Overload.
From the Overload page, you can configure the cluster-wide defaults that control how WebLogic Server instances in this cluster should react in the case of an overload or failure condition. The settings you can define include:
Shared Capacity for Work Managers
Failure Action
Panic Action
Free Memory Percent High Threshold
Free Memory Percent Low Threshold
Max Stuck Thread Time
Stuck Thread Count
For more information about these fields, see Configuration Options.
Click Save.
WebLogic Server provides a self-health monitoring capability to improve the reliability and availability of servers in a WebLogic Server domain. Selected subsystems within each server instance monitor their health status based on criteria specific to the subsystem
To configure health monitoring characteristics for a cluster:
From the WebLogic Domain menu, select Environment, then select Clusters.
In the Clusters table, click the name of the cluster you want to configure.
An overview page displays information related to the cluster.
From the WebLogic Cluster menu, select Administration, then select Health Monitoring.
From the Health Monitoring page, you can configure health monitoring characteristics for this cluster, such as:
Inter-Cluster Comm Link Health Check Interval
Health Check Interval
Health Check Periods Until Fencing
Fencing Grace Period
For more information about these fields, see Configuration Options.
Click Save.
To configure HTTP settings for a cluster:
From the WebLogic Domain menu, select Environment, then select Clusters.
In the Clusters table, click the name of the cluster you want to configure.
An overview page displays information related to the cluster.
From the WebLogic Cluster menu, select Administration, then select HTTP.
From the HTTP page, you can define the HTTP settings for this cluster, such as:
Frontend Host
Frontend HTTP Port
Frontend HTTPS Port
For more information about these fields, see Configuration Options.
Click Save.
To configure Coherence settings for a cluster:
From the WebLogic Domain menu, select Environment, then select Clusters.
In the Clusters table, click the name of the cluster you want to configure.
An overview page displays information related to the cluster.
From the WebLogic Cluster menu, select Administration, then select Coherence.
From the Coherence page, you can select the Coherence cluster you want to use for this cluster and define settings such as:
Local Storage Enabled
Coherence Web Local Storage Enabled
For more information about these fields, see Configuration Options.
Click Save.