Creating WebLogic Domains Using the Configuration Wizard

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

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.

  1. Start the Configuration Wizard in graphical mode.
    • On Windows:
    • StartArrow symbolProgramsArrow symbolBEA ProductsArrow symbolToolsArrow symbolConfiguration Wizard

    • On UNIX:
    • Go to the /common/bin subdirectory of the product installation directory. For example: cd $BEAHOME/wlserver_10.0/common/bin

      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 BEA products.
    2. Note that the WebLogic Server check box is selected by default since it is a prerequisite for all WebLogic domains.

    3. 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 which JDK to use. For more information, see Specify the Server Start Mode and JDK. 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, 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.
  7. In this example, we are not customizing the domain. Leave No selected and click Next.

  8. In the Create WebLogic Domain window, enter a name for the domain and specify a location for the domain directory.
  9. For example, since we are going to extend this domain in the next example using the WebLogic Portal 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.

  10. 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 the procedure to extend the WebLogic Server domain you created in Creating a New Domain using the WebLogic Portal extension template.

Note: 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:
    • StartArrow symbolProgramsArrow symbolBEA ProductsArrow symbolToolsArrow symbolConfiguration Wizard

    • On UNIX:
    • Go to the /common/bin subdirectory of the product installation directory. For example: cd $BEAHOME/wlserver_10.0/common/bin

      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. You must select a valid domain directory, which is indicated by the domain directory folder icon icon. Select the domain to be extended and click Next.
  4. For this example, navigate to BEA_HOME\user_projects\domains and select portal_domain. BEA_HOME is the directory that contains your product installation.

  5. In the Select Extension Source window, you can choose to extend your domain by selecting product components or an extension template.
  6. To extend your domain using the WebLogic Portal extension template:

    1. Select Extend my domain using an existing extension template and click Browse.
    2. In the Select a Template window, select wlp.jar and click OK.
    3. Click Next in the Select Extension Source window.
  7. 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.
  8. For this example, leave No selected and click Next.

  9. In the Extend WebLogic Domain window, you can specify an applications directory to contain the application files that are being added to the domain.
  10. 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 (portal_domain in this example).

    Click Extend.

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

Creating a Domain with Managed Servers and Clusters

The following example explains the procedure to create a new WebLogic Portal domain that is based on the Basic WebLogic Server Portal domain template, as you did in Creating a New Domain. In this case, however, you customize your domain to include:

  1. Start the Configuration Wizard in graphical mode.
    • On Windows:
    • StartArrow symbolProgramsArrow symbolBEA ProductsArrow symbolToolsArrow symbolConfiguration Wizard

    • On UNIX:
    • Go to the /common/bin subdirectory of the product installation directory. For example: cd $BEAHOME/wlserver_10.0/common/bin

      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 BEA products.
    2. Note that the WebLogic Server check box is selected by default since it is a prerequisite for all WebLogic domains.

    3. Select the WebLogic Portal checkbox, 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 which JDK to use. For more information, see Specify the Server Start Mode and JDK. 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, 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.
  7. 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.

  8. 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:

    1. Click Add to add a Managed Server.
    2. Enter the following values, shown in bold, for the first Managed Server:
    3. Name: MS1

      Listen Address: 127.0.0.1

      Listen Port: 8001

      SSL Enabled: Select this check box

      SSL Listen Port: 8011

    4. Click Add to add a second Managed Server and enter the following values shown in bold:
    5. Name: MS2

      Listen Address: 127.0.0.1

      Listen Port: 8101

      SSL Enabled: Select this check box

      SSL Listen Port: 8111

    6. Click Next to go to the Configure Clusters window.
  9. 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:

    1. Click Add to add a cluster.
    2. Enter the following values shown in bold:
    3. 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.
    4. Click Next to go to the Assign Servers to Clusters window.
  10. 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.
  11. In this example, all Managed Servers will be assigned to the cluster MY_CLUSTER. To do so:

    1. Shift-click the name of each Managed Server on the Server pane so that all Managed Servers are selected.
    2. Click the right arrow to assign the Managed Servers to the cluster, MY_CLUSTER.
    3. 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.

    4. Click Next to go to the Configure Machines window.
  12. In the Configure Machines window, you define the configuration information for the Windows and UNIX machines in the domain. This step is optional.
  13. 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.

  14. In the Review WebLogic Domain window, review the detailed configuration settings of your domain before the Configuration Wizard creates it.
  15. 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.

  16. In the Create WebLogic Domain window, enter a name for the domain and specify a location for the domain directory.
  17. 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.

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

  Back to Top       Previous  Next