Creating WebLogic Domains Using the Configuration Wizard

Examples: Using the Configuration Wizard

This section provides information and examples for common domain configuration tasks that you can perform by using the Configuration Wizard:

• Creating a Domain

• Extending an Existing Domain

• Creating a Domain with Managed Servers and Clusters

Creating a Domain

The following example describes how to create a WebLogic Server domain.

1. Start the Configuration Wizard in graphical mode.

   • On Windows, choose Start > Programs > Oracle WebLogic > WebLogic Server 10gR3 > Tools > Configuration Wizard

   • On UNIX, go to the /common/bin subdirectory of the product installation directory, and enter sh config.sh.

2. In the Welcome window, select Create a new WebLogic domain and click Next.

3. In the Select a Domain Source window:

   1. Select Generate a domain configured automatically to support the following products.

      Note that the WebLogic Server check box is selected by default because it is a prerequisite for all WebLogic domains.

   2. Click Next.

4. 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.

5. In the Configure Server Start Mode and JDK window, specify whether to start the server in development mode or production mode, and select the JDK. Then, click Next.

6. In the Customize Environment and Services Settings window, indicate whether you want to change the distribution of your domain across servers, clusters, and machines, or 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.

   • 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.

7. In the Create WebLogic Domain window, enter a name for the domain and specify a location for the domain directory.

   For example, enter my_default_domain as the name.

   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 name that you specified (my_default_domain in this example).

   Click Create.

8. In the Creating Domain window, after the domain has been created, do one of the following:

   • If you want to start the server immediately, select the Start Admin Server check box and click Done. This option is available only for Windows systems.

   • If you do not want to start the server at this time, click Done.

Extending an Existing Domain

This example illustrates the procedure to extend the WebLogic Server domain that you created in Creating a Domain, by using the Workshop extension template.

Make sure that the servers in the domain are not running; you cannot update an active domain.

1. Start the Configuration Wizard in graphical mode.

   • On Windows, choose Start > Programs > Oracle WebLogic > WebLogic Server 10.3 > Tools > Configuration Wizard

     On UNIX, go to the /common/bin subdirectory of the product installation directory, and enter sh config.sh.

2. In the Welcome window, choose Extend an existing WebLogic domain and click Next.

3. In the Select a WebLogic Domain Directory window, navigate to the domain directory that you want to extend. Valid domain directories are 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.

4. In the Select Extension Source window, you can choose to extend your domain by selecting products or an extension template.

   To extend your domain by using the Workshop extension template:

   1. Select Extend my domain automatically to support the following added products.

   2. Select the Workshop for WebLogic check box and click Next.

5. 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 the domain or in the extension template.

   • To customize the JDBC and JMS file store settings, select Yes and click Next.

   • To accept the default settings, leave No selected and click Next.

     For this example, leave No selected and click Next.

6. In the Extend WebLogic Domain window, you can specify an applications directory to contain the application files that are being added to the domain.

   Click Extend.

7. In the Creating Domain window, click Done to close the Configuration Wizard.

Creating a Domain with Managed Servers and Clusters

This example describes the procedure to create a Workshop domain that is based on the basic WebLogic Server domain template, and to customize the domain to include the following:

• 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 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 intended to run on your local machine.

1. Start the Configuration Wizard in graphical mode.

   • On Windows, choose Start > Programs > Oracle WebLogic > WebLogic Server 10.3 > Tools > Configuration Wizard

     On UNIX, go to the /common/bin subdirectory of the product installation directory, and enter sh config.sh.

2. In the Welcome window, select Create a new WebLogic domain and click Next.

3. In the Select a Domain Source window:

   1. Select Generate a domain configured automatically to support the following products.

      Note that the WebLogic Server check box is selected by default since it is a prerequisite for all WebLogic domains.

   2. Select the Workshop for WebLogic check box and click Next.

4. 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.

5. In the Configure Server Start Mode and JDK window, specify whether to start the server in development mode or production mode, and select the JDK.

6. Click Next.

7. In the Customize Environment and Services Settings window, select Yes and click Next.

8. In the Configure RDBMS Security Store Database window, click Next.

9. In the Configure the Administration Server window,

   1. enter the following values:

   • Name: MyAdminServer

   • Listen address: 127.0.0.1

   • Listen port: 7001

   • SSL listen port: 7002

   1. Select the SSL enabled check box.

   2. Click Next.

10. In the Configure Managed Servers window, add two managed servers MS1 and MS2:

    1. Click Add, and configure the first managed server with the following details:

       Name: MS1

       Listen address: 127.0.0.1

       Listen port: 8001

       SSL listen port: 8011

    2. Click Add, and configure the second managed server with the following details:

       Name: MS2

       Listen address: 127.0.0.1

       Listen port: 8101

       SSL listen port: 8111

    3. Select the SSL enabled check box.

    4. Click Next.

11. In the Configure Clusters window, configure a cluster named MY_CLUSTER:

    1. Click Add and configure the cluster with the following details:

       Name: MY_CLUSTER

       Multicast address: 239.192.0.0

       Multicast port: 8050

       Cluster address: 127.0.0.1

       All the managed servers listen at the same IP address (relying on unique port numbers to keep them separate); so you should set the cluster address to the same IP address as that of the managed servers.

    2. Click Next.

12. In the Assign Servers to Clusters window, assign the MS1 and MS2 managed servers to the MY_CLUSTER cluster.

    1. In the Server pane, click MS1. Then, shift+click MS2.

    2. Click the right arrow that is situated in between the Server and Cluster panes.

       The names of the managed servers are moved from the Server pane to the Cluster pane.

    3. Click Next.

13. In the Configure Machines window, you define the configuration information for the Windows and UNIX machines in the domain. This step is optional.

    In this example, all the servers in the domain reside on your local machine, so it is not necessary to set up additional machines and assign target servers to them.

    Click Next.

14. In the Configure JDBC Data Sources window, leave the default settings, and click Next.

15. In the Configure JMS File Stores window, leave the default settings, and click Next.

16. 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.

    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 previous window.

    After reviewing the contents of your domain, click Next.

17. In the Create WebLogic Domain window, enter a name for the domain and specify a location for the domain directory.

    For this example, enter myclusterdomain as the name of the 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 (myclusterdomain in this example).

    Click Create.

18. In the Creating Domain window, after the domain has been created, do one of the following:

    • If you want to start the server immediately, select the Start Admin Server check box and click Done. This option is available only for Windows systems.

    • If you do not want to start the server at this time, click Done.