Creating WebLogic Domains Using the Configuration Wizard
Examples: Using the Configuration Wizard
This section provides information and examples for some common domain configuration tasks using the Configuration Wizard:
Creating a New Domain
The following example explains how to create a new WebLogic Server domain.
- Start the Configuration Wizard in graphical mode.
- On Windows:
Start—>Programs—>BEA Products—>Tools—>Configuration Wizard
- On UNIX:
Go to the /common/bin
subdirectory of the product installation directory. For example: cd $BEAHOME/weblogic91/common/bin
Enter sh config.sh
- In the Welcome window, select Create a new WebLogic domain and click Next.
- In the Select a Domain Source window:
- Select Generate a domain configured automatically to support the following BEA products.
Note that the WebLogic Server check box is selected by default since it is a prerequisite for all WebLogic domains.
- In the Configure Administrator Username and Password window, enter a valid username and password, and click Next. This username is used to boot the Administration Server and connect to it.
- In the Configure Server Start Mode and JDK window, specify whether to start the server in development mode or production mode, and select which JDK to use. For more information, see Specify the Server Start Mode and JDK. Click Next.
- In the Customize Environment and Services Settings window, indicate whether you want to change the distribution of your domain across servers, clusters, and machines, and to modify existing JDBC and JMS file store services. To add Managed Servers and clusters to your domain, or change JDBC and JMS settings, select Yes and click Next. The Configuration Wizard steps you through the process. To accept the default settings, leave No selected and click Next.
In this example, we are not customizing the domain. Leave No selected and click Next.
- In the Create WebLogic Domain window, enter a name for the domain and specify a location for the domain directory.
For example, since we are going to extend this domain in the next example using the Default WebLogic Server extension template, name the domain my_default_domain
.
By default, the domain is created in BEA_HOME
\user_projects\domains\
domain
, where BEA_HOME
is the directory that contains the product installation, and domain
is the domain name that you specify (my_default_domain
in this example). Click Create.
- In the Creating Domain window, once the domain has been created, do one of the following:
- If you are creating the domain on a Windows system and you want to start the server immediately, select the Start Admin Server check box and click Done.
- Click Done.
Extending an Existing Domain
The following example explains how to extend the WebLogic Server domain you created in Creating a New Domain using the Default WebLogic Server extension template.
Note: Make sure that the servers in the domain are not running; you cannot update an active domain.
- Start the Configuration Wizard in graphical mode.
- On Windows:
Start—>Programs—>BEA Products—>Tools—>Configuration Wizard
- On UNIX:
Go to the /common/bin
subdirectory of the product installation directory. For example: cd $BEAHOME/weblogic91/common/bin
Enter sh config.sh
- In the Welcome window, choose Extend an existing WebLogic domain and click Next.
- In the Select a WebLogic Domain Directory window, navigate to the domain directory that you want to extend. You must select a valid domain directory, which is indicated by the
icon. Select the domain to be extended and click Next.
For this example, navigate to BEA_HOME
\user_projects\domains
and select my_default_domain
. BEA_HOME
is the directory that contains your product installation.
- In the Select Extension Source window, you can choose to extend your domain by selecting product components or an extension template.
To extend your domain using the Default WebLogic Server extension template:
- Select Extend my domain using an existing extension template and click Browse.
- In the Select a Template window, select
wls_default.jar
and click OK.
- Click Next in the Select Extension Source window.
- In the Customize JDBC and JMS Settings window, you have the option to customize JDBC and JMS file store settings if they were previously defined in your domain or in the extension template you are using to extend your domain. To customize the JDBC and JMS file store settings, select Yes and click Next. The Configuration Wizard steps you through the process. To accept the default settings in your templates, leave No selected and click Next.
For this example, leave No selected and click Next.
- In the Extend WebLogic Domain window, you can specify an applications directory to contain the application files that are being added to the domain.
By default, this applications directory is BEA_HOME
\user_projects\applications\
domain
, where BEA_HOME
is the directory that contains the product installation, and domain
is the domain name that you specify (my_default_domain
in this example).
Click Extend.
- In the Creating Domain window, click Done to close the Configuration Wizard.
Creating a Domain with Managed Servers and Clusters
The following example explains how to create a new WebLogic Server domain that is based on the Basic WebLogic Server Domain domain template, as you did in Creating a New Domain. In this case, however, you customize your domain to include:
- Two Managed Servers
A Managed Server hosts application components and resources, which are deployed and managed as part of the domain. The two Managed Servers are in addition to the Administration Server.
- A single cluster
A cluster is a group of WebLogic Server instances that work together to provide scalability and high availability for applications. Clusters can improve performance and provide failover if a server instance becomes unavailable. The servers within a cluster can run on the same machine, or they can run on different machines. To the client, a cluster appears as a single WebLogic Server instance. In this example, all the servers and the cluster created by the Configuration Wizard are to run on your local machine.
- Start the Configuration Wizard in graphical mode.
- On Windows:
Start—>Programs—>BEA Products—>Tools—>Configuration Wizard
- On UNIX:
Go to the /common/bin
subdirectory of the product installation directory. For example: cd $BEAHOME/weblogic91/common/bin
Enter sh config.sh
- In the Welcome window, select Create a new WebLogic domain and click Next.
- In the Select a Domain Source window:
- Select Generate a domain configured automatically to support the following BEA products.
Note that the WebLogic Server check box is selected by default since it is a prerequisite for all WebLogic domains.
- In the Configure Administrator Username and Password window, enter a valid username and password, and click Next. This username is used to boot the Administration Server and connect to it.
- In the Configure Server Start Mode and JDK window, specify whether to start the server in development mode or production mode, and select which JDK to use. For more information, see Specify the Server Start Mode and JDK. Click Next.
- In the Customize Environment and Services Settings window, indicate whether you want to change the distribution of your domain across servers, clusters, and machines, and to modify existing JDBC and JMS file store services. To add Managed Servers and clusters to your domain, or change JDBC and JMS settings, select Yes and click Next.
- In the Configure the Administration Server window, define the configuration information for the Administration Server, including:
- Administration Server name
- Listen address
- Nonsecure and secure (optional) listen ports
Servers can be reached through the following URL: protocol
://
listen-address
:
listen-port
For more information, see Configure the Administration Server.
To configure the Administration Server in this example, enter the following values:
- Name:
MyAdminServer
- Listen Address:
127.0.0.1
- Listen Port:
7001
- SSL Enabled: Select this check box
- SSL Listen Port:
7002
Click Next to go to the Configure Managed Servers window.
- In the Configure Managed Servers window, define the configuration information for one or more Managed Servers, including:
- Managed Server name
- Listen address
- Nonsecure and secure (optional) listen ports
Servers can be reached through the following URL: protocol
://
listen-address
:
listen-port
.
For example, to add two Managed Servers named MS1
and MS2
to the domain, do the following:
- Click Add to add a Managed Server.
- Enter the following values, shown in bold, for the first Managed Server:
Name: MS1
Listen Address: 127.0.0.1
Listen Port: 8001
SSL Enabled: Select this check box
SSL Listen Port: 8011
- Click Add to add a second Managed Server and enter the following values shown in bold:
Name: MS2
Listen Address: 127.0.0.1
Listen Port: 8101
SSL Enabled: Select this check box
SSL Listen Port: 8111
- Click Next to go to the Configure Clusters window.
- In the Configure Clusters window, define the configuration information for one or more clusters, including:
- Cluster name
- Multicast address and port
- Cluster address that identifies the Managed Servers in the cluster
For example, to add a single cluster, MY_CLUSTER
, to the domain, do the following:
- Click Add to add a cluster.
- Enter the following values shown in bold:
Name: MY_CLUSTER
Multicast Address: 239.192.0.0
Multicast Port: 8050
Cluster Address: 127.0.0.1
Note: Because all the Managed Servers listen at the same IP address (relying on unique port numbers to keep them separate), you should set the Cluster Address to the same IP address as the Managed Servers.
- Click Next to go to the Assign Servers to Clusters window.
- In the Assign Servers to Clusters window, assign the available Managed Servers to a cluster within the domain. By default,
MY_CLUSTER
, the only cluster that is defined, is already selected in the Cluster pane.
In this example, all Managed Servers will be assigned to the cluster MY_CLUSTER
. To do so:
- Shift-click the name of each Managed Server on the Server pane so that all Managed Servers are selected.
- Click the right arrow to assign the Managed Servers to the cluster,
MY_CLUSTER
.
The names of the Managed Servers are removed from the Server pane and added, below the name of the target cluster, to the Cluster pane.
- Click Next to go to the Configure Machines window.
- In the Configure Machines window, you define the configuration information for the Windows and UNIX machines in the domain. This step is optional.
Note: In this example, all the servers in the domain are to reside on your local machine, so it is unnecessary to set up additional machines and target servers to them. Therefore, you can skip the machine configuration steps.
Click Next to go to the Review WebLogic Domain window.
- In the Review WebLogic Domain window, review the detailed configuration settings of your domain before the Configuration Wizard creates it.
The Domain Summary pane shows the Deployment view by default. By selecting different options from the Summary View drop-down list, you can see different views of the domain summary, for example, the Cluster view.
Select an item in the Domain Summary pane on the left and review the associated details in the Details pane on the right. You can make limited adjustments by clicking Previous to return to a prior window.
After reviewing the contents of your domain, click Next to go to the Create WebLogic Domain window.
- In the Create WebLogic Domain window, enter a name for the domain and specify a location for the domain directory.
In this example, name the domain myclusterdomain
.
By default, the domain is created in BEA_HOME
\user_projects\domains\
domain
, where BEA_HOME
is the directory that contains the product installation, and domain
is the domain name that you specify (myclusterdomain
in this example). Click Create.
- In the Creating Domain window, once the domain has been created, do one of the following:
- If you are creating the domain on a Windows system and you want to start the server immediately, select the Start Admin Server check box and click Done.
- Click Done.