# How Do I: Configure a Cluster for a WebLogic Workshop Application?

This topic provides step by step instructions for configuring a domain for a cluster of WebLogic Servers. These instructions apply only to Windows installations of Workshop. For information about cluster hardware configuration see Setting up WebLogic Clusters in the WebLogic 8.1 documentation.

The tasks in setting up and deploying to a cluster are:

- To create a domain and configure the administration and managed servers
- To configure the software proxy server
- To start the clustered servers
- To deploy the application EAR file to the cluster

### To Create a Domain and Configure the Administration and Managed Servers

1. Select Start-->BEA WebLogic Platform 8.1-->Configuration Wizard
2. In the Create or Extend a Configuration dialog, select Create a New WebLogic Configuration. (Note the other options are primary used for creating development environments, not production environments.).
3. In the Select a Configuration Template dialog, select the desired configuration template.
4. In the Choose Express or Custom Configuration dialog, select Custom.
5. In the Configure the Administration Server dialog, enter the following information:
   - Name
     The Name must consist of alphanumeric characters with no spaces.
   - Listen Address
     For the information about populating the Listen Address field see DNS Names or IP Addresses in the WebLogic Server 8.1 documentation.
   - Listen Port and SSL Listen Port
     Any port numbers between 1 and 65535 is valid.
   SSL Enabled
   Check this box if the applications you plan to deploy use SSL.
6. In the Managed Server, Clusters, and Machines Options dialog, click Yes.
7. In the Configure Managed Servers dialog, enter the Name, Listen Address, Listen Port, and SSL Listen Port for each managed server you will to add to the domain.
8. In the Configure Clusters dialog, enter the following information for each cluster you wish to add to the domain:

- Cluster Name
  This gives the name of the cluster as a whole.
- Cluster Multicast Address
  Allowable values are in the range 224.0.0.0 - 239.255.255.255
- Cluster Multicast Port
  Any number between 1 and 65535 is valid.
- Cluster Address
  The Cluster Address defaults to the address:port combinations for each server instance in the cluster.

9. In the Assign Server to Clusters dialog, associate managed servers with a cluster.
10. In the Configure Machines dialog, enter the machines you wish to add to the domain.
11. In the Assign Servers to Machines dialog, choose the which servers to run on which available machines.
12. In the Database Options and Messaging Options dialogs, configure the domain as is appropriate to the applications that will be deployed on your cluster.
13. In the Configure Administrative Username and Password dialog, enter a username and password for the administrative user for this domain.
14. In the Configure Windows Options dialog, choose whether you want to place a link to the administration server on the Windows Start Menu.
15. In the Build Start Menus Entries dialog, choose the start up script used to start your cluster. (A default start up script is automatically provided for your new domain.)
16. In the Configure Server Start Up Mode and Java SDK dialog, select Production Mode.
17. In the Create WebLogic Configuration dialog, click Create.
    The WebLogic Configuration Wizard generates your domain and generates the domain's config.xml file according to the values specified.

### To Configure the Software Proxy Server

If you are using a software proxy server, you must build and configure the proxy application that will service requests from clients. For information about software proxy server see Configure Proxy Plug-Ins in the WebLogic Server 8.1 documentation.

### To Start the Cluster

To start a cluster, you must first start the administration server and then each of the managed servers. Do not start the managed servers until the administration server has been started.

To start the administration server:

1. Open a command shell, and cd to the domain root directory.
2. Enter the following command:
   startWebLogic production.

For details on the startWebLogic command, see the Help topic startWebLogic Command.

To start a managed server:

1. Open a command shell, and cd to the domain root directory.
2. Enter the following command:
   startManagedWeblogic [managed server DNS name or IP address] [URL of the administration server:port]
   For example,
   startManagedWeblogic managedServer1 http://adminServer:7133

Repeat steps 1 and 2 for each managed server in the cluster.

### To Deploy the Application EAR File to the Cluster

Before you deploy a WebLogic Workshop application to a server cluster, you must first generate an EAR file for the application.

To learn more about generating an EAR file for a WebLogic Workshop application, see How Do I: Deploy a WebLogic Workshop Application to a Production Server?

Related Topics

How Do I: Deploy a WebLogic Workshop Application to a Production Server?