Create a proxy server cluster using the wsadmin command

This page describes how to create a cluster of proxy servers, using the wsadmin command, that can route requests to applications in a cell.

The cluster includes the machines and nodes that are going to belong to the proxy server cluster. Consider how requests are routed to the proxy server cluster. For example, are requests routed using the DNS, the load balancer, or the proxy server.

Before you create a cluster, start the dmgr.

Create a proxy server cluster, as follows:

 

1. Start the wsadmin utility.

2. Create an empty cluster with no members, by typing:

   $AdminTask createCluster {-clusterConfig {-clusterName <name_of_cluster> -clusterType PROXY_SERVER}}

   Or, to create a cluster and add a specified proxy server to that cluster, type:

   $AdminTask createCluster { -clusterConfig {{<name_of_cluster> true PROXY_SERVER}} -convertServer {{<node_name> <name_of_proxy_server> "" "" ""}}}

   This proxy server serves as the template for all subsequent members that are added to the cluster.

3. Add one member at a time to the cluster, as follows:

   $AdminTask createClusterMember {-clusterName <name_of_cluster> -memberConfig {-memberNode <node_name> -memberName <name_of_proxy_server>}}

   If no members exist in the cluster, the first member that is added serves as the template for subsequent members that are added to the cluster.

   When a proxy server is added to a cluster, proxy-specific settings for it can only be configured using the wsadmin scripting client.

4. Save the configuration changes, as follows:

   $AdminConfig save

5. Start the proxy server cluster so that request routing is enabled.

6. Set requests to route to the proxy server. For DNS-based routing, associate the logical name of the site with the IP addresses of the proxy server cluster members in DNS.

   For Load balancer routing, configure the IP addresses of the cluster members as the target of the virtual cluster.

   For Edge proxy or IBM HTTP Server with WAS plug-in-based routing, generate the plug-in configuration file for the proxy server cluster, and configure the Edge proxy or the WAS plug-in with this information.

 

Results

The proxy server cluster is created with the members and is enabled for routing traffic.

 

Next steps

Monitor the traffic. See Monitor the proxy server with PMI for more information.

 

Related tasks

Starting clusters using scripting
Monitor the proxy server with PMI

 

Related

Generic server clusters collection
Generic server clusters configuration
Generic server cluster ports collection
Generic server cluster members
URI groups
URI group configuration